Within the Catch Marketplace system there are three types of order related IDs.
- commercial order ID
- this ID is created when a customer makes their purchase on Catch. This is the order number for their entire order, this could include both Catch in-stock product and marketplace product. (example - [commercial_order_id])
- logistic order ID
- a logistic order is a logical grouping of order line items representing a shipment. Logistic orders are always specific to a single seller. (example - [commercial_order_id]-A)
- order line ID
- an order line item represents an offer and its quantity in the customer’s shopping cart. The same logistic order can group together one or more order line items.
- Our platform creates each order line items which are part of a logistic order. The platform can also generate the identifiers of these lines, the "order_line_id". But as for the "commercial_order_id", the operator can specify the "order_line_id" at the order creation. (example - [logistic_order_id]-1)
Catch then uses the following rules to split a commercial order into multiple logistic orders when required.
If a commercial order contains:
- offers from multiple sellers, the order is split into as many logistic orders as there are sellers
offers from a single seller, with different delivery methods associated to each offer, the order is split into as many logistic orders as there are delivery methods
- offers from multiple sellers, with different delivery methods associated to each offer, the order is split into as many logistic orders as there are sellers and delivery methods
- offers from a single seller, with a single delivery method but with a different lead time to ship associated to each offers, the order is split into as many logistic orders as there are different lead times to ship
Example: C12345-A and C12345-B would have both been order in the same checkout (commercial ID C12345).
However, if an item is ready to ship now, and another item is 3-5day lead time the system will drop to the marketplace system 2 order_ids (C12345-A, C21345-B) so the customer gets 2 packages for the 1 commercial order.
To retrieve via API, you only need to use the commercial order ID.
e.g. GET /api/orders?order_ids=C12345