Documentation
Feedback
Guides
API Reference

API Reference
Filter By
Post
Get
Put
Delete
Patch

Logistics API

Logistics or fulfillment is the process of planning and executing the transportation, storage of merchandise, and shipping orders to customers. You can accomplish all of this with the VTEX platform, which allows you to manage your inventory, shipping rates, pickup points and more.

Logistics API Index

Shipping Policies

Freight Values

Scheduled Delivery

Docks

Warehouses

Inventory

Batch operations

This feature is in early access, which means that we are working to improve it. If you want to use this feature, please contact our Support Center.

Holidays

Reservations

SLA

Pickup points

Polygons

Common parameters

Parameter name Description Type
{{accountName}} Name of the VTEX account. Used as part of the URL. Server variable.
{{environment}} Environment to use. Used as part of the URL. The default value is vtexcommercestable. Server variable.
X-VTEX-API-AppKey Unique identifier of the API key. Authentication header. Must be used together with X-VTEX-API-AppToken. Not necessary when using VtexIdclientAutCookie.
X-VTEX-API-AppToken Secret token of the API key. Authentication header. Must be used together with X-VTEX-API-AppKey. Not necessary when using VtexIdclientAutCookie.
VtexIdclientAutCookie User token, valid for 24 hours. Authentication header. Not necessary when using X-VTEX-API-AppKey and X-VTEX-API-AppToken.

Endpoints

Scheduled delivery

SummaryMethodPath
Retrieve blocked delivery windowsGET/api/logistics/pvt/configuration/carriers/{carrierId}/getdayofweekblocked
Add blocked delivery windowsPOST/api/logistics/pvt/configuration/carriers/{carrierId}/adddayofweekblocked
Remove blocked delivery windowsPOST/api/logistics/pvt/configuration/carriers/{carrierId}/removedayofweekblocked
Search capacity reservations in time rangeGET/api/logistics-capacity/resources/carrier@{capacityType}@{shippingPolicyId}/time-frames
Get capacity reservation usage by windowGET/api/logistics-capacity/resources/carrier@{capacityType}@{shippingPolicyId}/time-frames/{windowDay}F{windowStartTime}T{windowEndTime}

Shipping policies

SummaryMethodPath
Retrieve shipping policy by IDGET/api/logistics/pvt/shipping-policies/{id}
Delete shipping policy by IDDELETE/api/logistics/pvt/shipping-policies/{id}
Update shipping policy by IDPUT/api/logistics/pvt/shipping-policies/{id}
List shipping policiesGET/api/logistics/pvt/shipping-policies
Create shipping policyPOST/api/logistics/pvt/shipping-policies

Docks

SummaryMethodPath
Create or update dockPOST/api/logistics/pvt/configuration/docks
List all docksGET/api/logistics/pvt/configuration/docks
List dock by IDGET/api/logistics/pvt/configuration/docks/{dockId}
Delete dockDELETE/api/logistics/pvt/configuration/docks/{dockId}
Activate dockPOST/api/logistics/pvt/configuration/docks/{dockId}/activation
Deactivate dockPOST/api/logistics/pvt/configuration/docks/{dockId}/deactivation

Warehouses

SummaryMethodPath
Create or update warehousePOST/api/logistics/pvt/configuration/warehouses
List all warehousesGET/api/logistics/pvt/configuration/warehouses
List warehouse by IDGET/api/logistics/pvt/configuration/warehouses/{warehouseId}
Remove warehouseDELETE/api/logistics/pvt/configuration/warehouses/{warehouseId}
Activate warehousePOST/api/logistics/pvt/configuration/warehouses/{warehouseId}/activation
Deactivate warehousePOST/api/logistics/pvt/configuration/warehouses/{warehouseId}/deactivation

Inventory

SummaryMethodPath
List inventory by SKUGET/api/logistics/pvt/inventory/skus/{skuId}
List inventory per warehouseGET/api/logistics/pvt/inventory/items/{skuId}/warehouses/{warehouseId}
Update inventory by SKU and warehousePUT/api/logistics/pvt/inventory/skus/{skuId}/warehouses/{warehouseId}
Update inventory quantity by SKU and warehousePATCH/api/logistics/pvt/inventory/skus/{skuId}/warehouses/{warehouseId}/quantity
Update inventory lead time by SKU and warehousePATCH/api/logistics/pvt/inventory/skus/{skuId}/warehouses/{warehouseId}/lead-time
List inventory per dockGET/api/logistics/pvt/inventory/items/{skuId}/docks/{dockId}
List inventory per dock and warehouseGET/api/logistics/pvt/inventory/items/{skuId}/docks/{dockId}/warehouses/{warehouseId}
List inventory with dispatched reservationsGET/api/logistics/pvt/inventory/items/{itemId}/warehouses/{warehouseId}/dispatched
List supply lotsGET/api/logistics/pvt/inventory/items/{skuId}/warehouses/{warehouseId}/supplyLots
Save supply lotPUT/api/logistics/pvt/inventory/items/{skuId}/warehouses/{warehouseId}/supplyLots/{supplyLotId}
Transfer supply lotPOST/api/logistics/pvt/inventory/items/{skuId}/warehouses/{warehouseId}/supplyLots/{supplyLotId}/transfer

Batch operations

SummaryMethodPath
Create batch inventory jobPOST/availability/v1/inventory/batch
Commit batch inventoryPOST/availability/v1/inventory/batch/{batchId}/commit
Get batch inventory statusGET/availability/v1/inventory/batch/{batchId}/status
Get batch inventory errorsGET/availability/v1/inventory/batch/{batchId}/errors

Holidays

SummaryMethodPath
Create or update holidayPUT/api/logistics/pvt/configuration/holidays/{holidayId}
List holiday by IDGET/api/logistics/pvt/configuration/holidays/{holidayId}
Delete holidayDELETE/api/logistics/pvt/configuration/holidays/{holidayId}
List all holidaysGET/api/logistics/pvt/configuration/holidays

Reservations

SummaryMethodPath
Create reservationPOST/api/logistics/pvt/inventory/reservations
List reservation by IDGET/api/logistics/pvt/inventory/reservations/{reservationId}
Confirm reservationPOST/api/logistics/pvt/inventory/reservations/{reservationId}/confirm
Acknowledgment reservationPOST/api/logistics/pvt/inventory/reservations/{reservationId}/acknowledge
Cancel reservationPOST/api/logistics/pvt/inventory/reservations/{reservationId}/cancel
List reservation by warehouse and SKUGET/api/logistics/pvt/inventory/reservations/{warehouseId}/{skuId}

SLA

SummaryMethodPath
Calculate SLAPOST/api/logistics/pvt/shipping/calculate

Pickup points

SummaryMethodPath
List pickup pointsGET/api/logistics/pvt/configuration/pickuppoints
Create or update pickup pointPUT/api/logistics/pvt/configuration/pickuppoints/{pickupPointId}
List pickup point by IDGET/api/logistics/pvt/configuration/pickuppoints/{pickupPointId}
Delete pickup pointDELETE/api/logistics/pvt/configuration/pickuppoints/{pickupPointId}
List paged pickup pointsGET/api/logistics/pvt/configuration/pickuppoints/_search

Polygons

SummaryMethodPath
List paged polygonsGET/api/logistics/pvt/configuration/geoshape
Create or update polygonPUT/api/logistics/pvt/configuration/geoshape
List polygon by IDGET/api/logistics/pvt/configuration/geoshape/{polygonName}
Delete polygonDELETE/api/logistics/pvt/configuration/geoshape/{polygonName}

Freight values

SummaryMethodPath
Create or update freight valuesPOST/api/logistics/pvt/configuration/freights/{carrierId}/values/update
List freight valuesGET/api/logistics/pvt/configuration/freights/{carrierId}/{cep}/values

Loading API specification...