vtex.local – Logistics-API
Check the . We created this guide to improve the onboarding experience for developers at VTEX. It assembles all documentation on our Developer Portal about fulfillment and is organized by focusing on the developer's journey.
Logistics or fulfillment is the module responsible for shipping calculation and inventory management.
The variable {{environment}} can be filled with vtexcommercestable or vtexcommercebeta, depending on the environment you want to test.
- Homepage
- https://api.apis.guru/v2/specs/vtex.local:Logistics-API/1.0.json
- Provider
- vtex.local:Logistics-API / Logistics-API
- OpenAPI version
- 3.0.0
- Spec (JSON)
- https://api.apis.guru/v2/specs/vtex.local/Logistics-API/1.0/openapi.json
- Spec (YAML)
- https://api.apis.guru/v2/specs/vtex.local/Logistics-API/1.0/openapi.yaml
Tools (55)
Extracted live via the executor SDK.
-
docks.activateDockActivates dock through dock ID.
-
docks.allDocksInforms a list of all docks.
-
docks.createUpdateDockCreates or updates docks to be used in your logistic operation.
-
docks.deactivateDockDeactivate dock by dock ID
-
docks.dockDeletes dock by dock ID.
-
docks.dockByIdInforms a given dock's information, searching by dock ID.
-
freightValues.createUpdateFreightValuesCreates or updates the freight values of your store's carriers. Learn more in .
-
freightValues.getLogisticsPvtConfigurationFreightsValuesLists freight values apointed to your store's carriers, searching by carrier ID and postal code (
cep). -
holidays.allHolidaysLists information of all holidays.
-
holidays.createUpdateHolidayCreates or updates holidays through holiday ID.
-
holidays.holidayDeletes given holidays set up in your store.
-
holidays.holidayByIdLists holiday's information by holiday ID.
-
inventory.getinventorywithdispatchedreservationsLists inventory with dispatched reservations. When the number of active reservations is more than 2000 the return is an error with status code 400 (BadRequest) and the message: Too many active reservations.
-
inventory.getSupplyLotsReturns a list of the supply lots of an SKU in a specific warehouse.
-
inventory.inventoryBySkuLists your store's inventory by SKU ID
-
inventory.inventoryperdockLists inventory information per dock set up in your store.
-
inventory.inventoryperdockandwarehouseLists information of inventory per dock and warehouse.
-
inventory.inventoryperwarehouseLists inventory information per warehouse on your store.
-
inventory.saveSupplyLotCreates a new Supply Lot. A Supply Lot lets the store sell products that are not currently available in stock but whose arrival is already scheduled.
Check out our about this feature.
-
inventory.transferSupplyLotTransfers an SKU from a Supply Lot to the currently available inventory.
Check out how this transfer works in further detail by reading our about this feature.
-
inventory.updateInventoryBySkuandWarehouseUpdates inventory for a given SKU and warehouse.
-
pickupPoints.createUpdatePickupPointCreates or updates in your store by Pickup Point ID.
-
pickupPoints.deleteDeletes a given pickup point for your store, by pickup point ID.
-
pickupPoints.getByIdLists your store's pickup points while searching by ID.
-
pickupPoints.getpagedLists paged pickup points in your store.
-
pickupPoints.listAllPickupPpointsLists all of your store's pickup points.
-
polygons.createUpdatePolygonCreates or updates your store's polygons by geoshape coordinates and polygon name.
-
polygons.deletePolygonDeletes polygon set up in your store, by polygon name.
-
polygons.pagedPolygonsLists stored polygons.
-
polygons.polygonbyIdLists your store's polygons by searching through polygon name
-
reservations.acknowledgmentReservationAcknowledges reservations made by reservation ID.
-
reservations.cancelReservationCancels reservation by reservation ID.
-
reservations.confirmReservationConfirms reservation by reservation ID.
-
reservations.createReservationCreates .
-
reservations.reservationByIdLists reservation's information by ID.
-
reservations.reservationbyWarehouseandSkuLists reservations in your store, by searching through warehouse and SKU.
-
scheduledDelivery.addBlockedDeliveryWindowsAdds blocked delivery windows for your store's shipping policies.
Note that, while most of our API endpoints return time fields in UTC, this endpoint returns time adjusted to the configured time zone of the account.
-
scheduledDelivery.getApiLogisticsCapacityResourcesCarrierCapacityTypeShippingPolicyIdTimeFramesGet information on all capacity reservations made to scheduled delivery windows in a given time range.
Note that, while most of our API endpoints return time fields in UTC, this endpoint returns time adjusted to the configured time zone of the account.
Note that the combined string
carrier@{capacityType}@{shippingPolicyId}can be referred to as a "resource" in the API's messages. -
scheduledDelivery.getApiLogisticsCapacityResourcesCarrierCapacityTypeShippingPolicyIdTimeFramesWindowDayFWindowStartTimeTWindowEndTimeRetrieves capacity usage of a specific scheduled delivery reservation window.
Note that, while most of our API endpoints return time fields in UTC, this endpoint returns time adjusted to the configured time zone of the account.
Note that the combined string
carrier@{capacityType}@{shippingPolicyId}can be referred to as a "resource" in the API's messages. -
scheduledDelivery.removeBlockedDeliveryWindowsRemoves the blocked delivery windows set to your store's shipping policies.
Note that, while most of our API endpoints return time fields in UTC, this endpoint returns time adjusted to the configured time zone of the account.
-
scheduledDelivery.retrieveBlockedDeliveryWindowsLists all blocked delivery windows of your store's shipping policies, searching by carrier ID.
Note that, while most of our API endpoints return time fields in UTC, this endpoint returns Scheduled Delivery related time fields adjusted to the configured time zone of the account.
-
shippingPolicies.deleteApiLogisticsPvtShippingPoliciesIdThis endpoint deletes existing shipping policies from carriers in your store, searching by their IDs.
-
shippingPolicies.getApiLogisticsPvtShippingPoliciesThis endpoint lists existing shipping policies from carriers in your store.
Note that, while most of our API endpoints return time fields in UTC, this endpoint returns Scheduled Delivery related time fields adjusted to the configured time zone of the account.
-
shippingPolicies.getApiLogisticsPvtShippingPoliciesIdThis endpoint lists existing from carriers in your store, searching by their IDs.
Note that, while most of our API endpoints return time fields in UTC, this endpoint returns Scheduled Delivery related time fields adjusted to the configured time zone of the account.
-
shippingPolicies.postApiLogisticsPvtShippingPoliciesThis endpoint creates new shipping policies from carriers in your store.
Note that, while most of our API endpoints return time fields in UTC, this endpoint returns Scheduled Delivery related time fields adjusted to the configured time zone of the account.
-
shippingPolicies.putApiLogisticsPvtShippingPoliciesIdThis endpoint updates information on existing Shipping Policies from carriers.
Note that, while most of our API endpoints return time fields in UTC, this endpoint returns Scheduled Delivery related time fields adjusted to the configured time zone of the account.
-
sla.calculateSlaEndpoint used by the checkout to calculate the Service Level Agreement (SLA), a contract between the store and shoppers on the order's fulfillment conditions, such as the shipping estimated date.
The calculation of the estimated date considers the and related to the order.
-
warehouses.activateWarehouseActivates a given warehouse, by warehouse ID.
-
warehouses.allWarehousesLists information about all warehouses set up in your store.
-
warehouses.createUpdateWarehouseCreates or updates your store's warehouses
-
warehouses.deactivateWarehouseDeactivates a given warehouse by warehouse ID.
-
warehouses.removeWarehouseDeletes given warehouse by warehouse ID.
-
warehouses.warehouseByIdLists the information of a given warehouse, searching by warehouse ID.
-
openapi.previewSpecPreview an OpenAPI document before adding it as a source
-
openapi.addSourceAdd an OpenAPI source and register its operations as tools