Shipments (create, amend, cancel), despatch write-back with multi-parcel tracking, available stock with batch and best-before detail, product create and update, inbound deliveries with cancellation, goods received confirmations, returns and carrier lookups.
Not in the API: the supplier master, order holds, proof of delivery and webhook subscription.
Install LataSys 3PL Connector: byrd Adapter alongside the core app. The provider appears in the instance form's Provider list as soon as the module is installed - no configuration is needed to register it.
| Field | Value |
|---|---|
| Provider | byrd |
| Base URL | required - the host from your byrd API pack |
| API Key | the byrd token, sent in the Authorization header |
Press Test Connection - it reads the carrier list available on your account.
Warehouses. byrd routes across its own European network from your account configuration, so there is no warehouse catalogue to fetch. Warehouse mappings still decide which Odoo warehouse the stock belongs to.
Carriers. Press Fetch Carriers to fill the carrier map with the codes available on your account, or set a Default Carrier.
Statuses. Press Load Missing Defaults: Open, Processing, Shipped, Delivered, Blocked, Cancelled.
| Field | Meaning |
|---|---|
| Default Carrier | byrd carrier code sent when no mapping resolves one. Leave empty to let byrd choose from its network rules. |
Orders are shipments, inbound are deliveries. byrd's vocabulary differs from Odoo's; the connector maps both automatically.
Mixed API versions. Shipments sit at /v3/shipments while products,
deliveries, returns, lots and carriers are unversioned. The adapter
routes each call to the right prefix in one place so the mix cannot
drift.
Lots live in their own collection. Batch and best-before detail
comes from /lots rather than being embedded in stock rows, so it is
only fetched when the instance has lot tracking switched on - accounts
that do not use batches do not pay for the extra calls.
Available, not gross. Stock sync reports sellable stock, with reserved quantities removed.
Weights are grams. Odoo kilograms are converted on product push.
| Symptom | Cause and fix |
|---|---|
| "No byrd Base URL on the instance" | byrd issues the host per account; take it from your API pack. Staging and production differ. |
| "byrd credentials missing" | Paste the token from your API pack into the API Key field. |
| No batch numbers on stock | Turn on the instance's lot-tracking option - without it the connector skips the /lots walk entirely. |
| Amendment refused | byrd has released the shipment to the floor. Contact byrd. |
| No Fetch Warehouses button | Expected - byrd routes across its network rather than exposing a warehouse catalogue. |
Part of the LataSys 3PL Connector. Support: support@latasys.com | Help Center