Receive Purchase Order Lines | Ply

curl -X POST https://api.getply.com/api/v1/purchase-orders/550e8400-e29b-41d4-a716-446655440000/reconcile \
     -H "API_KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "items": [
    {
      "purchaseOrderItemId": "f7a8b9c0-d1e2-3456-fabc-456789012345",
      "locationId": "e5f6a7b8-c9d0-1234-efab-567890123456",
      "quantity": 4,
      "price": 4.85
    }
  ]
}'

[
  {
    "id": "b9c0d1e2-f3a4-5678-bcde-678901234567",
    "createdAt": "2026-03-20T14:30:00",
    "updatedAt": "2026-03-20T14:30:00",
    "purchaseOrderItemId": "f7a8b9c0-d1e2-3456-fabc-456789012345",
    "material": {
      "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
      "name": "3/4 inch PVC Pipe (10ft)"
    },
    "location": {
      "id": "e5f6a7b8-c9d0-1234-efab-567890123456",
      "name": "Main Warehouse"
    },
    "quantity": 4,
    "price": 4.85
  }
]

Rejects the whole request if any line or location cannot be resolved.

Only a purchase order in PAID, PARTIALLY_RECEIVED or RECEIVED status can be received, and any other status returns 409. A purchase order that has already been fully received also returns 409 — undo receiving first.

A line may be received in a larger quantity than was ordered, but a line whose received quantity already equals or exceeds its ordered quantity returns 409 — undo its receipt first.

Requires scope: purchase_orders:write

Receives purchase order lines into stock. Raises on-hand quantities, writes inventory layers, recomputes landed cost and records activity — the same bookkeeping as reconciling a delivery in the app. Rejects the whole request if any line or location cannot be resolved. Only a purchase order in `PAID`, `PARTIALLY_RECEIVED` or `RECEIVED` status can be received, and any other status returns `409`. A purchase order that has already been fully received also returns `409` — undo receiving first. A line may be received in a larger quantity than was ordered, but a line whose received quantity already equals or exceeds its ordered quantity returns `409` — undo its receipt first. Requires scope: `purchase_orders:write`

Authentication

API_KEYstring

API Key authentication via header

Path parameters

idUUIDRequired

Purchase order ID.

Request

This endpoint expects an object.

itemslist of objectsRequired

Lines being received. At least one, at most 500.

Response

This endpoint returns a list of objects.

idUUID

Unique identifier for the received record.

createdAtdatetime

ISO 8601 timestamp when the record was created.

updatedAtdatetime

ISO 8601 timestamp when the record was last updated.

purchaseOrderItemIdUUIDOptional

The purchase order line this was received against.

materialobjectOptional

The material received.

variationobjectOptional

The variation received.

locationobjectOptional

Where it was received.

quantitydoubleOptional

Quantity received.

pricedoubleOptional

Unit cost paid.

costForClientdoubleOptional

Unit price charged to the client.

notestringOptional

Note recorded with the receipt.

serialNumberslist of stringsOptional

Serial numbers received.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Rate Limit Error

Rejects the whole request if any line or location cannot be resolved.

A line may be received in a larger quantity than was ordered, but a line whose received quantity already equals or exceeds its ordered quantity returns 409 — undo its receipt first.

Requires scope: purchase_orders:write