Orda TMS API

Orda TMS plans and runs deliveries. Through the open API your system (1C, SAP, your own CRM or web shop) sends orders and gets routes and delivery statuses back — no manual entry, no spreadsheets.

What the API does

Task	How	Guide
Send orders (one by one or up to 1000 per call)	POST /orders, POST /orders/bulk	Importing orders
Directories: delivery points, warehouses, vehicles, drivers	/customers, /warehouses, /vehicles, /drivers	API reference
Build and approve the routes of a day	POST /plans, POST /plans/{id}/approve	Getting routes
Learn about deliveries at once, without polling	webhooks signed with HMAC	Webhooks
Retry safely after a network failure	Idempotency-Key header	Idempotency

Principles

• REST + JSON at https://<API host>/api/v1/...; the contract is OpenAPI 3 (openapi.json) — import it into Postman or Insomnia, or generate a client.
• Access with a company API key with limited permissions. A key sees only its own company’s data; company isolation is covered by automated tests on every change.
• Updates without duplicates: every record has an externalId — the document code in your system. Sending the same order again updates it.
• Stable version: within v1 we only add fields and endpoints, never remove or rename. Ignore unknown fields.
• Dates are YYYY-MM-DD, route times are HH:MM in the company’s time zone (Asia/Tashkent, Asia/Almaty…), timestamps are ISO 8601 UTC. Amounts are in major units of the company currency (sum, tenge…), see currency.

Where to start

1. Quick start — the first order in 10 minutes.
2. Ask your Orda manager for a sandbox — a test company with a key (Sandbox and go-live).
3. No developer? Orders can be uploaded as Excel/CSV files exported from 1C — see No developer.