Skip to main content
POST
/
inventory
/
purchase-orders
/
{id}
/
take-delivery
Take Delivery
curl --request POST \
  --url https://api.decodahealth.com/inventory/purchase-orders/{id}/take-delivery \
  --header 'API-KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'TENANT: <tenant>' \
  --data '
{
  "deliveries": [
    {
      "lineItemId": "<string>",
      "quantity": 123,
      "conversionFactor": 1,
      "lotNumber": "<string>",
      "expiryDate": "2023-11-07T05:31:56Z",
      "sku": "<string>"
    }
  ]
}
'
{
  "supplierId": "<string>",
  "id": "<string>",
  "status": "PENDING",
  "issueDate": "2023-11-07T05:31:56Z",
  "completedDate": "2023-11-07T05:31:56Z",
  "supplier": {
    "name": "<string>",
    "description": "<string>",
    "website": "<string>",
    "email": "<string>",
    "preferredContactMethod": "<string>",
    "phoneNumber": "<string>",
    "addressLineOne": "<string>",
    "addressLineTwo": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zipCode": "<string>",
    "country": "<string>",
    "shipmentTime": 123,
    "isArchived": false,
    "defaultNotes": [
      {
        "content": "<string>",
        "id": "<string>",
        "supplierId": "<string>",
        "name": "<string>"
      }
    ],
    "id": "<string>"
  },
  "lineItems": [
    {
      "supplierToStockUomId": "<string>",
      "locationId": "<string>",
      "quantity": 123,
      "id": "<string>",
      "purchaseOrderId": "<string>",
      "status": "PENDING",
      "quantityReceived": 1,
      "supplierToStockUom": {
        "supplierPartNumber": "<string>",
        "uom": "AMPOULES",
        "id": "<string>",
        "supplierToStockId": "<string>",
        "supplierToStock": {
          "supplierId": "<string>",
          "stockId": "<string>",
          "id": "<string>",
          "stock": {
            "name": "<string>",
            "unit": "AMPOULES",
            "id": "<string>",
            "description": "<string>",
            "notes": "<string>",
            "category": "<string>",
            "minStockLevel": 123,
            "isArchived": false
          }
        },
        "conversionFactor": 1,
        "isDefault": false,
        "displayLabel": "<string>",
        "price": 123,
        "leadTime": 1,
        "createdDate": "2023-11-07T05:31:56Z",
        "updatedDate": "2023-11-07T05:31:56Z",
        "isArchived": false
      },
      "location": {
        "id": "<string>",
        "name": "<string>",
        "isVirtual": true
      },
      "cost": 1,
      "createdDate": "2023-11-07T05:31:56Z",
      "updatedDate": "2023-11-07T05:31:56Z"
    }
  ],
  "notes": [
    {
      "content": "<string>",
      "id": "<string>",
      "purchaseOrderId": "<string>",
      "name": "<string>"
    }
  ],
  "createdDate": "2023-11-07T05:31:56Z",
  "updatedDate": "2023-11-07T05:31:56Z",
  "isArchived": false,
  "leadTimeDays": 123
}

Headers

TENANT
string
required

The tenant you are making this request on behalf of

API-KEY
string
required

Your api key

Path Parameters

id
string
required

Body

application/json

Request to take delivery of one or more line items.

deliveries
TakeDeliveryLineItem · object[]
required
Minimum array length: 1

Response

Successful Response

Purchase order response with computed lead time.

supplierId
string
required

ID of the supplier

id
string

Unique identifier for the purchase order

status
enum<string>
default:PENDING

Status of the purchase order

Available options:
PENDING,
PLACED,
COMPLETED,
CANCELLED
issueDate
string<date-time> | null

Date when the purchase order was sent to supplier

completedDate
string<date-time> | null

Date when all shipments are DELIVERED (purchase order completed)

supplier
Supplier · object

Optional supplier details

lineItems
PurchaseOrderLineItemWithDetails · object[] | null

Line items with details

notes
PurchaseOrderNote · object[] | null

Notes attached to this purchase order

createdDate
string<date-time> | null

Date and time the purchase order was created

updatedDate
string<date-time> | null

Date and time the purchase order was last updated

isArchived
boolean
default:false

Whether the purchase order is archived

leadTimeDays
integer | null

Maximum lead time in days across all line items (estimated delivery time from order placement)