Shipping documents & your dues

Two things integrators building against a supplier portal usually expect — a waybill you can download, and a period statement of what you’re owed — work differently here than you might expect. This page states both plainly so you don’t go looking for an endpoint that doesn’t exist.

Waybills

There is no waybill-generation or waybill-download endpoint anywhere on this API, for either an outbound shipment or a return.

• Outbound (fulfilling an order): Linra never issues you a waybill. You ship using your own carrier account, and the only thing you report back is the tracking reference and carrier — see Pushing fulfilment status. There is nothing to download because there is nothing Linra generates.
• Returns (a customer sending an item back to you, model A): the return waybill is issued and recorded by Linra staff on their side — it never appears on your read of the return request. You don’t need it: you’re the destination, not the shipper, for this leg.

This isn’t a gap waiting to be filled in — no shipping-aggregator contract is currently signed, so carrier/tracking integration today is deliberately a manual abstraction (a person keys in the tracking number and carrier; there’s no automated label/waybill generation on either side of this API to build against). A real carrier-aggregator adapter is only scoped once a contract exists.

Fees, dues & statements

Two fees are recorded against your fulfilled groups today — a flat per-group handling fee, and, under model A, a zone-based shipping fee (within-Riyadh vs. outside). Both are stamped as facts at order time on Linra’s side.

Neither is exposed anywhere on this API yet, and there is no period-statement endpoint. This is deliberate, not an oversight: this phase of the platform only guarantees the facts are recorded accurately (the fee amounts, custody outcomes, and any deduction/recovery facts from a return) — the supplier ledger/statement subsystem that would let you query them is a separate, later roadmap effort. Reconcile your dues off-platform (your own commercial agreement/invoicing with Linra) until that effort ships; this page will be updated with the real endpoints the moment it does.