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
}
]
}
]
}
}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