Skip to main content

Create R2S batch shipment

POST 
/partner/batch/r2s

Creates a batch of ready-to-ship (R2S) items for warehouse processing. All SKUs must exist in the product catalog, and none may be on the storage blocklist. A WMS logistics document is created with all items for warehouse intake, and the batch is returned in requested — each entry carries the batch_id you will quote to the warehouse.

Validate the payload yourself before sending. This endpoint does not check price, quantity or size against the product, and it does not bound the size of listings. A wrong value is accepted and becomes a warehouse intake record that has to be corrected manually. In particular:

  • send price as a positive THB number and quantity as a positive integer;
  • send a size that exists for that SKU — confirm it against GET /partner/lowest/{sku}, whose size_map keys are the valid sizes;
  • keep a batch to a few hundred items. A very large listings array fails the whole request with a 500 after the catalog lookups have run.

items_quantity on the resulting batch counts entries in listings, not the sum of their quantity values. Send one entry per physical unit if you want the warehouse's expected count to match what you ship.

There is no idempotency key and no cancel endpoint. A retry creates a second batch — contact your account manager to void one.

Request​

Responses​

Batch created