First Apaczka Setup

Create an Apaczka account and enable the module in Business Central, then enter your API credentials. Set up PRO Self if you use your own carrier agreement.

1️⃣ Create an Account or Sign In to Apaczka

If you do not have an Apaczka account yet:

  1. Open the Apaczka registration form.
  2. Select the Entrepreneur account type.
  3. Enter the required details: country, tax ID, company name, email address, password, repeated password, and phone number.
  4. Accept the required consents and select Create an account.
  5. If you receive an activation message, confirm your email address according to the instructions in the message.

If you already have an account, open Apaczka sign in and enter your email address or login and password.

2️⃣ Enable the Apaczka Module

  1. Open TMS | Setup.
  2. In the TMS | Modules section, find the Apaczka line.
  3. Select the Enabled field.
  4. Close TMS | Setup.
  5. Open TMS | Setup again.

After reopening the page, the 🔗 Integration: Apaczka section is available. You can now set up the integration.

3️⃣ Obtain and Enter API Credentials

Open the Apaczka panel and sign in. Keep TMS | Setup open in Business Central:

  1. In the Apaczka panel, select Web API from the menu on the left.
  2. If the panel requires it, enable API permissions for your account.
  3. Create application credentials or open your existing integration credentials.
  4. Copy App ID and enter it in App Id under 🔗 Integration: Apaczka in Business Central.
  5. Copy App Secret and enter it in App Secret in the same section.
  6. Select Test Connection.

After a successful test, a message confirms that you are ready to send orders with Apaczka.

Keep App Secret in a safe place and do not share it with unauthorized people. If you cannot see Web API or cannot generate application credentials, contact Apaczka support.

4️⃣ Connect Your Own Agreement with PRO Self

If you have your own agreement with a carrier, first enable and configure it in the Apaczka panel through PRO Self. Selecting the field in Business Central does not add the agreement to Apaczka.

Learn more on the Apaczka PRO Self page.

  1. Open the Apaczka panel.
  2. In the blue menu on the left, select Apaczka PRO.
  3. Under PRO Self, select Konfiguracja umów własnych (configure your own agreements).
  4. Under Dodaj własnego płatnika (add your own payer), select the carrier you have an agreement with.
  5. Enter the authentication details required for that carrier.
  6. Return to TMS | Setup and select Custom Contract under 🔗 Integration: Apaczka.

If PRO Self is unavailable, see the Apaczka PRO activation instructions or contact Apaczka support.

5️⃣ Manage Additional Services

The list of additional services is synchronized with Apaczka automatically whenever you open the page, but no more often than once every 24 hours.

To manage the visibility of add-ons in the wizard:

  1. In 🔗 Integration: Apaczka, select Your Additional Services.
  2. In the Available for Selection column, enable or disable the selected add-ons.

Disabled add-ons are not displayed while creating an order.

🔗 Next Step

Prepare package mapping.