Receiving Tickets
Receiving tickets in third-party warehouses are really called production order deliveries in Uphance. Such deliveries can only be created in Uphance but third-party applications can retrieve these receiving tickets and can update them to mark them received. See Webhooks to learn about getting notified when a receiving ticket is created or deleted in Uphance.
Get all receiving tickets
Retrieve details for all receiving tickets, optionally filtered in some way. This endpoint will return 100 receiving tickets at most (see the Pagination section to learn how to access all pages).
$ curl https://api.uphance.com/receiving_tickets \
-H "Authorization: ACCESS_TOKEN"
You can pass filter parameters to scope the pick tickets returned. For example, you can request for Receiving Tickets with receiving ticket ID greater than the last receiving ticket ID retrieved in the previous call.
$ curl https://api.uphance.com/receiving_tickets?since_id= RECEIVING_TICKET_ID \
-H "Authorization: ACCESS_TOKEN"
Similarly, you can request for Receiving Tickets with creation date time greater than that of the last receiving ticket ID retrieved in the previous call.
$ curl https://api.uphance.com/receiving_tickets?since_created_at= RECEIVING_TICKET_DATE_TIME \
-H "Authorization: ACCESS_TOKEN"
Get a single receiving ticket
Retrieve details of an existing receiving ticket.
$ curl https://api.uphance.com/receiving_tickets/RECEIVING_TICKET_ID \
-H "Authorization: ACCESS_TOKEN"
Example response:
{
"receiving_ticket": {
"id": 19295,
"created_at": "2018-11-11T18:56:33.000+00:00",
"updated_at": "2018-11-11T18:57:22.000+00:00",
"items_total": "424.0",
"items_tax": "0.0",
"subtotal": "424.0",
"total_tax": "0.0",
"grand_total": "424.0",
"total_quantity": 53,
"organisation_id": 9579,
"production_order_id": 20270,
"tax_calc_method": "SUB_TOTAL",
"line_items": [
{
"id": 146241,
"product_id": 77633,
"product_name": "Nice Dress",
"variation_id": 163786,
"color": "Blue",
"unit_tax": "0.0",
"tax_level": "0.0",
"unit_price": "8.0",
"original_price": "8.0",
"percentage_discount": "0.0",
"line_quantities": [
{
"id": 756065,
"size": "XS",
"quantity": 21,
"sku_id": 1127538
},
{
"id": 756066,
"size": "S",
"quantity": 2,
"sku_id": 867869
},
{
"id": 756067,
"size": "M",
"quantity": 0,
"sku_id": 867870
},
{
"id": 756068,
"size": "L",
"quantity": 0,
"sku_id": 867871
},
{
"id": 756069,
"size": "XL",
"quantity": 0,
"sku_id": 1127542
},
{
"id": 756070,
"size": "XXL",
"quantity": 0,
"sku_id": 1130587
},
{
"id": 756071,
"size": "XXXL",
"quantity": 0,
"sku_id": 1130591
}
]
},
{
"id": 146242,
"product_id": 77633,
"product_name": "Nice Dress",
"variation_id": 163787,
"color": "Black",
"unit_tax": "0.0",
"tax_level": "0.0",
"unit_price": "8.0",
"original_price": "8.0",
"percentage_discount": "0.0",
"line_quantities": [
{
"id": 756072,
"size": "XS",
"quantity": 10,
"sku_id": 1127539
},
{
"id": 756073,
"size": "S",
"quantity": 0,
"sku_id": 867872
},
{
"id": 756074,
"size": "M",
"quantity": 0,
"sku_id": 867873
},
{
"id": 756075,
"size": "L",
"quantity": 0,
"sku_id": 867874
},
{
"id": 756076,
"size": "XL",
"quantity": 0,
"sku_id": 1127543
},
{
"id": 756077,
"size": "XXL",
"quantity": 0,
"sku_id": 1130588
},
{
"id": 756078,
"size": "XXXL",
"quantity": 0,
"sku_id": 1130592
}
]
},
{
"id": 146243,
"product_id": 77633,
"product_name": "Nice Dress",
"variation_id": 163788,
"color": "Red",
"unit_tax": "0.0",
"tax_level": "0.0",
"unit_price": "8.0",
"original_price": "8.0",
"percentage_discount": "0.0",
"line_quantities": [
{
"id": 756079,
"size": "XS",
"quantity": 10,
"sku_id": 1127540
},
{
"id": 756080,
"size": "S",
"quantity": 0,
"sku_id": 867875
},
{
"id": 756081,
"size": "M",
"quantity": 0,
"sku_id": 867876
},
{
"id": 756082,
"size": "L",
"quantity": 0,
"sku_id": 867877
},
{
"id": 756083,
"size": "XL",
"quantity": 0,
"sku_id": 1127544
},
{
"id": 756084,
"size": "XXL",
"quantity": 0,
"sku_id": 1130589
},
{
"id": 756085,
"size": "XXXL",
"quantity": 0,
"sku_id": 1130593
}
]
},
{
"id": 146244,
"product_id": 77633,
"product_name": "Nice Dress",
"variation_id": 163789,
"color": "Yellow",
"unit_tax": "0.0",
"tax_level": "0.0",
"unit_price": "8.0",
"original_price": "8.0",
"percentage_discount": "0.0",
"line_quantities": [
{
"id": 756086,
"size": "XS",
"quantity": 10,
"sku_id": 1127541
},
{
"id": 756087,
"size": "S",
"quantity": 0,
"sku_id": 867878
},
{
"id": 756088,
"size": "M",
"quantity": 0,
"sku_id": 867879
},
{
"id": 756089,
"size": "L",
"quantity": 0,
"sku_id": 867880
},
{
"id": 756090,
"size": "XL",
"quantity": 0,
"sku_id": 1127545
},
{
"id": 756091,
"size": "XXL",
"quantity": 0,
"sku_id": 1130590
},
{
"id": 756092,
"size": "XXXL",
"quantity": 0,
"sku_id": 1130594
}
]
}
]
}
}
POST a receiving ticket
Creates a receiving ticket from a confirmed production order.
POST https://api.uphance.com/receiving_tickets
Example request body:
{
"receiving_ticket": {
"production_order_id": 22216,
"warehouse_id": 1623,
"reference": "REF-001",
"notes": "Handle with care",
"in_warehouse_date": "2026-05-19",
"carrier_name": "DHL",
"carrier_service_name": "Express",
"tracking_number": "TRACK123",
"line_items_attributes": [
{
"id": 133107, //PO line item id
"line_quantities_attributes": [
{ "id": 700232, "quantity": 10 }, // PO line quantity id
{ "id": 700233, "quantity": 10 }
]
}
]
}
}
Field Reference:
Main Receiving Ticket Object -
production_order_id (integer, required): ID of the confirmed production order.
warehouse_id (integer, optional): Default is production order warehouse id.
reference (string, optional): Reference stored on the receiving ticket.
notes (string, optional): Notes stored on the receiving ticket.
in_warehouse_date (date, optional): In-warehouse date, for example `2026-05-19`.
carrier_name (string, optional): Carrier name stored on the receiving ticket.
carrier_service_name (string, optional): Carrier service name.
tracking_number (string, optional): Tracking number stored on the receiving ticket.
line_items_attributes (array, optional): Production order line items to be used in delivery.
Line Item Object (within line_items_attributes) -
id (integer, required): Production Order Line Item ID, can be fetched using get single PO by id endopoint
line_quantities_attributes (array, optional): PO Line quantities to be used in delivery.
Line Quantity Object (within line_quantities_attributes) -
id (integer, required): Production order line quantity ID
quantity (integer, optional): Quantity for the SKU in receiving ticket.
Update Receiving Ticket
Updates a receiving ticket's metadata and, when the ticket is not checked in, updates delivery line quantities.
PUT https://api.uphance.com/receiving_tickets/:id
Example request body:
{
"receiving_ticket": {
"reference": "REF-002",
"notes": "Handle with the care",
"carrier_name": "Fedx",
"carrier_service_name": "Ground",
"tracking_number": "TRACK12345",
"in_warehouse_date": "2026-05-19",
"line_items_attributes": [
{
"id": 147020, // receiving ticket line item id
"line_quantities_attributes": [
{
"id": 755575, // receiving ticket line quantity id
"quantity": 5
}
]
}
]
}
}
Important Notes
production_order_id is required when creating a receiving ticket. The production order must belong to the authenticated organisation and must be confirmed.
Use the receiving ticket line item and line quantity IDs returned in the create, show, or update response for later update requests.
If warehouse_id is not provided on create, Uphance uses the production order warehouse.
After quantity updates, receiving ticket totals are recalculated and saved.
warehouse_id and line items attributes are ignored after the receiving ticket is checked in.
Update Receiving Ticket Status
Mark the status of the receiving ticket to checked-in.
PUT https://api.uphance.com/receiving_tickets/RECEIVING_TICKET_ID/received
{
line_quantities: [
{
id: LINE QUANTITY ID
quantity: 2
},
{
id: LINE QUANTITY ID
quantity: 2
},
...]
}
Reverse the check-in of a Receiving Ticket
PUT https://api.uphance.com/receiving_tickets/RECEIVING_TICKET_ID/reverse