Emitted when a bulk return created, either on the fly at the warehouse or through an integration to Two Boxes.
{
"id": "c67e3019-61f6-43cf-97a0-f1b4cc286e46",
"event_type": "return-line-item-archived",
"event_data": {
"return_bulk_details": {
"external_po": "12345",
"external_ro": "45678",
"order_number": "0123",
"retailer": "Demo Retailer",
"return_reason": "Extra Stock",
"sender": "Store A"
},
"return": {
"captured_rma": null,
"comments": null,
"completed_at": null,
"customer": {
"email": "[email protected]",
"first_name": "Demo",
"full_name": "Demo Customer",
"last_name": "Customer",
"tags": null
},
"grading_status": "ready",
"kind": "production",
"line_items": [
{
"id": "289b38d1-20f2-4ef7-addd-769b8733d53c",
"3pl": {
"id": "a3cbee36-2dab-3162-0bd2-221bcad231b",
"name": "Two Boxes Demo 3PL"
},
"barcode": "760537081759",
"captured_lpn": null,
"carrier": null,
"child_reason": "Wrong Size",
"comments": null,
"consolidation_code": null,
"consolidation_provider": null,
"disposition": "Not Yet Set",
"expected_quantity": 10,
"expiration_date": null,
"graded_attributes": [],
"grading_ended_at": null,
"links": {
"actions": null,
"portal": "https://portal.twoboxes.com/3pls/5c949afb-e493-4b67-a7fd-8d5928d23ee7/returns/a8006401-43d7-4365-b642-0b9eff0c6071",
"self": "https://api.twoboxes.io/api/v1/returns/a8006401-43d7-4365-b642-0b9eff0c6071/line-items/0c3259db-2d97-4325-bcf6-f2893148f3cf""
},
"lot_code": null,
"lpn": "TB-00000597",
"merchant": {
"id": "d7f98be6-12a3-4b0f-a2f9-d679f8ecb11e"
},
"parent_reason": "Unhappy with purchase",
"product_variant": {
"barcode": "760537081759",
"id": "fa1eeedc-c7ce-4788-bcef-a7cfd90ea769",
"name": "Elevation Ball Cap™ - Black",
"sku": "FW17-LH-HU-BLK"
},
"put_away_bin": null,
"quantity": 100,
"rma_line_item_id": "9d0dc15c-8a2e-4c3d-87c7-565cba3e84a9",
"site": {
"id": "f01bee36-b5bb-4464-a03d-157217f33a92",
"name": "Two Boxes Demo"
},
"sku": "FW17-LH-HU-BLK",
"storefront_line_item_id": "940eb41b-4310-457a-ba0d-6c0109194f87",
"storefront_order_id": "order285}",
"storefront_order_name": "order285",
"storefront_order_number": "order285",
"storefront_product_id": null,
"storefront_variant_id": "3447346200589",
"tracking_number": "ups4296100888285",
"transform_sku": null,
"transform_upc": null,
"upc": null,
"work_capture": false
},
{
"id": "7474042a-4584-408c-a285-4b569a278c5a",
"barcode": "810047100256",
"carrier": null,
"child_reason": "Not correct style",
"comments": null,
"consolidation_code": null,
"consolidation_provider": null,
"disposition": "Not Yet Set",
"expected_quantity": 20,
"expiration_date": null,
"graded_attributes": [],
"grading_ended_at": null,
"links": {
"actions": null,
"portal": "https://portal.twoboxes.com/3pls/5c949afb-e493-4b67-a7fd-8d5928d23ee7/returns/a8006401-43d7-4365-b642-0b9eff0c6071",
"self": "https://api.twoboxes.io/api/v1/returns/a8006401-43d7-4365-b642-0b9eff0c6071/line-items/0c3259db-2d97-4325-bcf6-f2893148f3cf""
},
"lot_code": null,
"lpn": "TB-00000595",
"merchant": {
"id": "d7f98be6-12a3-4b0f-a2f9-d679f8ecb11e"
},
"parent_reason": "Not as Described",
"product_variant": {
"barcode": "810047100256",
"id": "fb9426bd-6427-44a4-9452-1b4a47b73734",
"name": "Spark Half-Zip - Purple / XL",
"sku": "XL-SHZ-PUR"
},
"put_away_bin": null,
"quantity": 50,
"rma_line_item_id": "86b6b841-b01d-485a-b64a-bb2cd371df48",
"site": {
"id": "f01bee36-b5bb-4464-a03d-157217f33a92",
"name": "Two Boxes Demo"
},
"sku": "XL-SHZ-PUR",
"storefront_line_item_id": "d2c5c002-9274-4c37-bbd5-d32e382d8dea",
"storefront_order_id": "order285",
"storefront_order_name": "order285",
"storefront_order_number": "order285",
"storefront_product_id": null,
"storefront_variant_id": "9887833924",
"tracking_number": "ups4296100888285",
"transform_sku": null,
"transform_upc": null,
"upc": null,
"work_capture": false
}
],
"linked_line_items": [],
"links": {
"actions": null,
"portal": "https://portal.twoboxes.com/3pls/5c949afb-e493-4b67-a7fd-8d5928d23ee7/returns/a8006401-43d7-4365-b642-0b9eff0c6071",
"self": "https://api.twoboxes.io/api/v1/returns/a8006401-43d7-4365-b642-0b9eff0c6071"
},
// BEING DEPRECATED DEC 30, 2025
"merchant_integration": {
"id": "c1b14fad-b84f-4f08-bb79-322d4a645976",
"merchant": {
"id": "fb31bc87-6397-468c-8e65-4de80f020c02",
"name": "Two Boxes Demo"
},
"name": "Two Boxes Demo",
"site": {
"id": "4f85a652-5cf8-473f-8b12-582249b4c881",
"name": "Demos"
}
},
//
"return_provider": "webhooks",
"return_type": "rma",
"rma": "rma285",
"rma_address": {
"address_1": "",
"address_2": null,
"city": null,
"company": null,
"country_code": null,
"phone_number": null,
"province_code": null,
"zip": ""
},
"rma_return_id": "24373ab8-40ef-4021-b099-4a78740e033f",
"rts": false,
"store_front_provider": "noop",
"undeliverable_shipping_charge": null,
"work_capture": false
}
}R