Get Goods Receipts

Returns what the warehouse actually received back for an order, grouped by goods receipt — one receiving session.

An order can be received back more than once: several shipments coming back, or a return order following a shipment. GET /api/v2/public/order/{omisell_order_number}/receive sums every session into one flat row per SKU, so it cannot say which quantities came from which session. This endpoint keeps the sessions apart, newest first, each with its own status, timestamp and per-SKU detail.

Two things to be aware of:

Totals here can be higher than /receive. This endpoint reports exactly what the warehouse recorded: a SKU that is not on the order is still reported, and quantities are not capped at the ordered quantity. /receive applies both of those filters.

omisell_shipment_number is per line, not per goods receipt. One return can gather products that went out on several different shipments.

Not paginated — an order has only a handful of goods receipts.

Returns 404 when the order does not exist or does not belong to the caller. An order that exists but has never been received back returns 200 with an empty data.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.omisell.com/api/v2/public/order//goods-receipts' \ --header 'Seller-ID;' \ --header 'Country;' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json'

{ "data": [ { "omisell_goods_receipt_number": "IBV260911AB12CD34", "goods_receipt_type": "order_return", "status": "checked", "status_display": "Checked", "received_time": 1789000000.0, "note": "", "omisell_return_order_number": "RTNVN26081234ABCDEF", "items": [ { "inventory_sku": "EH-NA27PN645", "quantity": 2, "accepted": 1, "damaged": 1, "destroy": 0, "lost": 0, "note": "Outer box crushed", "received_time": 1789000000.0, "omisell_shipment_number": "SPVN2606031E8B4B3F" } ] }, { "omisell_goods_receipt_number": "IBV260905EF56AB78", "goods_receipt_type": "shipment", "status": "checked", "status_display": "Checked", "received_time": 1788500000.0, "note": "", "omisell_return_order_number": null, "items": [ { "inventory_sku": "EH-NA27PN645", "quantity": 1, "accepted": 1, "damaged": 0, "destroy": 0, "lost": 0, "note": "", "received_time": 1788500000.0, "omisell_shipment_number": "SPVN2606031E8B4B3F" } ] } ], "error": false, "error_code": 200, "attr_error": null, "messages": "", "request_id": "6a9b21c74f3e8d150ab7e421" }

Request

Responses