iotoms Docs

Get the purchase order PDF

GET
/api/v1/procurement/purchase-orders/{id}/pdf

Returns a download link for the purchase order PDF rendered from the merchant's active purchase order template. If the order or the active template changed since the last render, a fresh PDF is generated first.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

id*string

ID of the record (UUID).

Formatuuid

Header Parameters

X-TenantID*string

Your merchant's tenant code — the value typed in the Domain field on the iotoms login screen. See Concepts.

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when the request worked, ERROR when it did not.

message*string

Short human-readable message describing the result, for logs or display; do not parse it.

data?|

Key-value result. For PDF endpoints: pdfUrl (a temporary signed download link), templateId, templateVersion, generatedAt plus document keys such as dayCycleId.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/procurement/purchase-orders/497f6eca-6276-4993-bfeb-53cbbbba6f08/pdf' \  -H 'X-TenantID: your-tenant-code'
Example Response
{  "status": "string",  "message": "string",  "data": {    "property1": {},    "property2": {}  }}