Setup & Credentials¶
Overview¶
Before using the Cargonizer Connector, you must connect Business Central to your Cargonizer account using the Setup Wizard. This stores your API credentials and retrieves your carrier configuration.
Prerequisites¶
- A Cargonizer account (production or sandbox). Register at cargonizer.no or sandbox.cargonizer.no.
- Your Cargonizer API key (available in the Cargonizer portal under your account settings).
- The Cargonizer Connector and Consignment Management apps installed in your Business Central environment.
- The DYP CA Carg Admin permission set assigned to the user performing setup.
Running the Setup Wizard¶
- In Business Central, search for Cargonizer Setup Wizard and open it.
- Select the environment type:
- Production — connects to
https://cargonizer.no - Sandbox — connects to
https://sandbox.cargonizer.no(for testing) - Enter your API Key. Business Central stores the key on the Cargonizer Setup record and sends it in the
X-Cargonizer-Keyrequest header. The key is readable on the setup page. Restrict that page to administrators. - Enter your Sender ID (the default sender for your account; individual locations can override this).
- Choose whether to enable automatic creation and sending of transport orders as global defaults.
- Complete the wizard. It retrieves your carrier, product, and printer data.
Manual Setup (Advanced)¶
If you prefer to configure each setting individually, open Cargonizer Setup directly:
| Setting | Description |
|---|---|
| Environment | Production or Sandbox |
| Sender ID | Default Cargonizer Sender ID for all locations |
| Automatically create Transport Orders when Orders are Shipped | Create transport order on shipment posting |
| Automatically Send Transport Orders when Orders are Shipped | Dispatch to Cargonizer on posting (requires auto-create) |
| Automatically Print Labels | Print label after dispatch |
| Default Return Transport Agreement | Carrier for auto-generated return shipments |
| Default Return Product Code | Service level for return shipments |
| Transport Profit Type | Fixed Amount, Percentage, or Gross Price |
| Transport Profit Value | Markup to apply on top of net carrier price |
| Freight Charge Item / G/L Account | Item or G/L account for auto-added freight lines on sales orders |
| Email Return Label to Customer | Auto-email return labels after dispatch |
Retrieving Carrier Account Data¶
After completing setup, run Retrieve Cargonizer Account Data (from the Cargonizer Setup page or the Transport Orders list).
This action:
1. Fetches Transport Agreements (carriers) from GET /transport_agreements.xml.
2. Fetches Printers from GET /printers.xml.
3. Populates the Transport Agreement, Product, Service, and Printer tables in Business Central.
Repeat this action whenever you add new carriers, products, or printers in Cargonizer.
Scheduled Sync¶
To keep carrier data current automatically, configure a Job Queue Entry to run the account data sync on a schedule (e.g., nightly). The job is available under the Job Queue setup in Business Central.
Permission Sets¶
| Permission Set | Purpose |
|---|---|
| DYP CA Carg Admin | Full access including setup pages, wizard, and carrier sync |
| DYP CA Carg User | Standard user operations: create, send, and print transport orders |
Assign DYP CA Carg User to warehouse and shipping staff. Reserve DYP CA Carg Admin for logistics coordinators and system administrators.
Verifying the Connection¶
Run Retrieve Cargonizer Account Data on the Cargonizer Setup page (or Synchronize Logistra Cargonizer Account Data in the wizard). If your credentials are valid, Business Central imports carriers, products, and printers. If the sync fails, verify: - The API key is correct (copy it directly from the Cargonizer portal). - The correct environment (Production / Sandbox) is selected. - Your Business Central environment can reach the Cargonizer URL (check firewall rules if needed).