Orders made through marketplaces as FOB (Free on board, Mercado Full Envios, B2W Entrega), where the type of delivery and payment and issue of the label are all defined by the marketplace, do not select a carrier when entering in VTEX.
This procedure avoids the order being unnecessarily validated, simplifies the integration settings and avoids failure to integrate because these details are blocked. However, some doubts may arise and it may be necessary to upgrade integration with the ERP for marketplace orders.
Inventory
The following rules must always be applied when selecting the inventories to serve an SKU:
- Fewest available SKU amount.
So inventories with small item quantities are not blocked out.
- Shortest travel time between warehouse and loading dock.
- Lowest travel price between warehouse and loading dock.
If there is more than one warehouse available according to these criteria and priorities, the final choice will be random.
If an order has several units of an SKU, one of the warehouses must have the full number, otherwise the order will be barred by VTEX, which will indicate inventory shortage.
OMS
Since delivery will be made by the marketplace, the OMS does not indicate delivery time or cost, since this is agreed between upon between the marketplace and the buyer of the product, at no cost to the store. The information pertaining to the deadline, found in the order, is a shipping simulation done when integrating the order, rather than what the marketplace had informed VTEX about.
Instead of carrier identification and the type of delivery, vtex:fob_1111
is shown, with 1111
being the ID of the loading dock.
API
As with the OMS interface, the API shows vtex:fob_1111
in the selectedSla, deliveryCompany and courierName fields. The shippingEstimate time will be 0bd
.
It is important that the ERP is able to accept data in this format.

Label
The order is mailed under an agreement between Correios (national postal services) and the marketplace itself. In this case, they issue a label for the store to print and use on its packages, without the need for other procedures with the Post Office - it is only necessary to mail the packages.
The label can be accessed directly through OMS, under the order list. Just click on the link and a new window will open with the label in PDF format.

If you want to make use of the label in your ERP, it is also available in the Marketplace Protocol API, more information in New Order Integration.