Create a purchase order from an external provider payload

1 min

POST

https://developer.digitail.io/api/v1/external-purchase-orders

Permissions needed: CREATE_ORDERS.

Imports a purchase order from an external provider payload (the same payload shape consumed by the Vetcove webhook), under standard API authentication.

The authenticated vet becomes the purchase order's vet. The target clinic is resolved from the auth context via the X-ClinicId header; when omitted it falls back to the authenticated vet's active clinic. The clinic is never read from the request body.

For each item the importer finds or creates the product (and its manufacturer/producer), computes cogs from unit_price and units, and creates the purchase order line. The supplier is matched or created from supplier.name. The created purchase order is returned synchronously with status PENDING, document type INVOICE, and series EXTERNAL.

acceptstringGenerated from available response content types

X-ClinicIdintegerId of the clinic to create the purchase order for. Must be a clinic the authenticated vet is employed by. Defaults to the vet's active clinic.

bodyobject

201Purchase order created successfully.

curl --request POST \
     --url https://developer.digitail.io/api/v1/external-purchase-orders \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "timestamp": "2025-06-11T10:00:00.000Z",
     "id": "",
     "supplier": {
     "name": "Covetrus"
     },
     "items": [
     {
     "id": "",
     "is_linked": true,
     "provider_item_id": "",
     "sku": "026143",
     "name": "GlycoFlex 3 Bite-Sized Chews: 120 Count",
     "quantity": 4,
     "unit_price": 2000,
     "units": 120,
     "unit_measurement": "chew",
     "manufacturer_name": "Vetri-Science"
     }
     ]
     }'