All Collections
Developer API
Inventory API: Receiving Tickets
Inventory API: Receiving Tickets

Retrieve and update receiving tickets for your third-party warehouse

Mike Maloney avatar
Written by Mike Maloney
Updated over a week ago

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

Next steps

Did this answer your question?