CargoPlug← Back to cargo-plug.com

Documentation & Setup Guide

1. Requirements

• WordPress 6.0 or newer, WooCommerce (HPOS supported), PHP 7.4 or newer with the SOAP extension enabled (standard on almost every host).
• An active commercial agreement with the Raben Group and EDI access credentials (see next section).
• A CargoPlug license or an active 14-day trial (runs on the Unlimited plan, no shipment limit, no card required).
• Optional: a free PrintNode account for automatic label printing.

2. Your Raben credentials

CargoPlug talks directly to the Raben TMS over the official SOAP API (GS1 XML 3.2). To connect, ask your Raben customer care specialist for EDI/web-service access. You will receive:

Raben provides two environments: test-osb.raben-group.com for trials (shipments are not physically executed) and osb.raben-group.com for real orders. Credentials usually differ between the two — start on test, then switch.

3. Installation & license

1. In WordPress go to Plugins → Add New → Upload Plugin, choose the cargo-plug.zip file you received after purchase, install and activate.
2. On first activation CargoPlug asks you to connect the site (this powers license checks and updates). Confirm, then either start the free 14-day trial or enter the license key from your purchase email.
3. The license box at the top of the settings page shows your plan, the shipment counter for the current month and a button to manage the account. Licenses can be moved between sites at any time (Remove license from this site).

Updates are delivered through the standard WordPress updates screen for as long as the subscription is active.

4. Connection settings

Open WooCommerce → Raben TMS. Every field has an (i) tooltip with a short explanation — hover over it if in doubt. In the Connection to the Raben service section:

• Environment — Test (test-osb) or Production (osb). Use test until your first successful shipment.
• EDI login / EDI password — the WSS credentials from Raben. The password field stays empty after saving — leave it empty to keep the stored one.
• EDI sender identifier, Raben business unit, EDI customer number, Raben department number, Payer identifier — enter exactly as provided by Raben (see table above).

Save the settings. If anything is wrong with the credentials you will see the exact API error when creating your first test shipment.

5. Shipper address & default shipment parameters

• Shipper address — your pickup location (company name, street, postcode, city, two-letter country code). It is printed on transport orders and labels.
• Raben product — PROD01 Cargo Classic or PROD02 Cargo Premium, according to your contract.
• Cargo type — default goods type (neutral, food, chemicals…).
• Default transport unit and Default weight [kg] — preselected unit for new shipments and the fallback weight used when products have no weight set.
• Cash on delivery — when enabled, the COD amount is filled automatically from the order total for COD orders, in the order’s currency.
• Order status after creating a shipment — optionally switch the order to Processing or Completed automatically once the shipment is created.
• Default label format / size — PDF (A4, A5, A6 or 100×150 mm) or raw ZPL for Zebra-compatible thermal printers.
• Default additional services — e.g. document return, SMS notice, phone advice; availability depends on your Raben contract.

6. Automatic label printing (PrintNode)

1. Create a free account at printnode.com, install the PrintNode client on the computer connected to your printer and generate an API key (API Keys tab).
2. Paste the key into PrintNode API key, save, then click Fetch printer list and pick your printer.
3. Enable Print automatically — the label is sent to the printer right after the shipment is created; if the TMS has not generated it yet, CargoPlug retries on its own.

7. Creating shipments

Open any WooCommerce order. The Raben TMS box shows a pre-filled form: receiver from the shipping address, weight calculated from the products, COD amount for cash-on-delivery orders. Adjust the units (pallets, half-pallets, cartons…), quantities and services, then click Create shipment. The consignment number comes back within seconds and is saved on the order.

Split shipments: tick the split checkbox to create a separate consignment note per unit — e.g. an order with 4 pallets produces 4 consignment numbers and 4 labels, each downloadable and printable individually. For COD orders the full amount is attached to the first consignment only, so the customer is not charged twice.

8. Labels & tracking

• Download label saves the PDF/ZPL to disk in your chosen size; Print sends it to the PrintNode printer.
• Check status fetches the full tracking history from the TMS with one click and stores it in the order notes, so the whole team sees where the pallet is.

9. Raben as a shipping method at checkout

Go to WooCommerce → Settings → Shipping, open a shipping zone and add the Raben TMS method. Besides a fixed price and a free-shipping threshold you can build cost rules evaluated top to bottom — the first matching rule wins:

• Conditions: always, cart price, weight, item count, user role, shipping class, product category, specific product, day of week, and time of day (24h clock; e.g. 15.5 means 15:30).
• If no rule matches, the method is hidden at checkout — handy for offering pallet delivery only above a certain weight.
• Maximum COD amount — when the customer picks cash on delivery and the order exceeds the limit (Raben accepts roughly 2,500 EUR or ~11,000 PLN), the method is hidden automatically.

10. Plan limits

Shipments are counted per calendar month per licensed site: Starter 50, Business 100, Pro 300, Max 700, Unlimited — no cap. The counter is always visible on the settings page and in the order box; when you reach the limit, creating new shipments pauses until the next month or an upgrade — upgrades apply immediately and existing shipments, labels and tracking keep working. The Unlimited plan removes the monthly cap entirely. Unused shipments do not carry over.

11. Troubleshooting

Still stuck? Write to support@cargo-plug.com — include your WordPress/WooCommerce versions, the plugin version and, if possible, the exact error message. We reply within one business day.