Every planSettings → Integrations
Accounting systems
Xero, Sage Accounting and SAP Business One each have a row. For Xero and Sage, an owner or manager presses Connect, signs in to that system and chooses the organisation — DockLedger never sees the password, and there is no app to create. For SAP Business One, your SAP partner gives you a Service Layer address and an integration user, entered once and kept encrypted. Despatches become sales invoices (drafts, by default) with the weight that actually left, approved supplier invoices become bills, contacts are created as needed and product codes come back nightly. Each run, with anything it refused and why, is listed under Runs; a despatch or an approved invoice can also be sent at once from its own row. Disconnect deletes DockLedger’s access; nothing already sent is touched.
The orders API
For an EDI hub or a customer’s own system. Create a key — shown once — and they post orders to the orders API; a key tied to one customer can only order for that customer. The request format is on the tab.
Webhooks
The other direction: your WMS, TMS or ERP is told the moment something happens on the dock. Add an endpoint (https only), tick the events — everything, or a slot requested, approved, declined or moved; a vehicle dispatched, arrived, at the gate, checked, released or departed; a no-show; order and purchase-order events — and copy the signing secret, shown once.
- One signed POST per event. Verify X-DockLedger-Signature: HMAC-SHA256 of timestamp + ‘.’ + the raw body, with your secret. Reject anything older than five minutes.
- Answer 2xx within ten seconds. Anything else is retried with backoff for eight tries, then marked dead; the last five deliveries per endpoint are on the tab with a Retry button.
- An endpoint that fails fifty times in a row is paused by itself. Send test fires a ping so the other side can check its plumbing before anything real happens.
- Rotate the secret whenever a person who knew it leaves; the other system must be given the new one before the next event.