v1

latestOpenAPI 3.1.02026-08-0458234268.6 KB

purchaseOrders

Bulk create or update purchase orders

Creates or updates multiple purchase orders in a single request. Maximum 100 purchase orders and 1000 total line items per request. Processing is always asynchronous via Celery and returns a batch tracking ID for polling progress.

post/purchase-orders/bulk

Headers

Authorizationstring required

OAuth2 authentication flows. Auth server URLs will vary by environment

X-Api-Keystring required

API key for authentication

X-API-Versionstring

API version to use (optional, defaults to latest). Supported values: 1.0.0, 1.1.0.

Idempotency-Keystring

Client-generated unique key (UUID/ULID recommended). JSON requests: the first 2xx response is cached for 24h and replayed on a same-key retry with a matching body; a different body returns 422. Non-JSON requests (e.g. file uploads): the key is single-use — any same-key retry returns 422 regardless of body. See Idempotency for full details.

Request body

ottimate_company_idinteger required

Company ID for all purchase orders in this batch

ottimate_location_idinteger required

Default location ID for all purchase orders in this batch

Response

Asynchronous processing started. Poll batch_url for progress.

versionstring

status'processing' required

batch_idstring required

batch_urlstring

results_urlstring