Freight Simulation

A freight simulation endpoint.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Query Parameters

NameTypeShort Description
ShouldCheckStockboolChecks SKU stock availability.
AllowPackageSplitboolAllows split delivery between stores.
AllowUnavailableItemboolAllows quoting non-existent SKUs.
PersistboolSaves quote for up to 15 days.
UseCatalogMeasureboolUses product catalog dimensions.
MaxResultsintLimits number of results.
ShouldPackagedIndividuallyboolQuotes items separately.
IgnoredSellerCodesstring[]Blocked seller codes (CNPJs).
SellerCodesstring[]Allowed seller codes (CNPJs).
UniqueSlasboolReturns only one SLA per item.

Request Body Fields

FieldTypeDescription
originIdentifierstringCNPJ (seller code) used as the shipping origin.
postalCodestringDestination postal code for the quote.
itemsarrayList of SKUs to simulate.
items[].skustringSKU code.
items[].quantityintQuantity requested for the SKU.
items[].pricedecimalUnit price of the SKU.
items[].dimensionsobjectObject with physical measures of the SKU (required if UseCatalogMeasure=false).
items[].dimensions.widthdecimalWidth in centimeters.
items[].dimensions.depthdecimalDepth in centimeters.
items[].dimensions.weightdecimalWeight in kilograms.
items[].dimensions.heightdecimalHeight in centimeters.

Response Fields

FieldTypeDescription
idstringSimulation identifier.
packagesarrayList of generated delivery packages.
packages[].itemsarraySKUs included in that package.
packages[].items[].sellersarraySellers with available stock for the SKU.
packages[].freightsarrayShipping options available for that package.
unavailablesarraySKUs that were not available for any seller.
combinationsarrayPossible combinations of packages or sellers (if applicable).
Path Params
string
required
Defaults to stringPlataformId

Identification of an plataform string

string
required
Defaults to stringClientId

Retailer identification value

Query Params
boolean
Defaults to false

Indicates whether the system should check the integrated SKU stock before returning results.

boolean
Defaults to false

Allows the order to be split among different stores if availability conditions permit.

boolean
Defaults to false

Allows quoting items that don’t exist in the catalog (for integrations that use only dimensions).

boolean
Defaults to false

Defines whether the quote should be saved for later consultation (valid for up to 15 days).

boolean
Defaults to false

Forces the use of product catalog dimensions, making it unnecessary to send Dimensions in the request.

int32
Defaults to 1

Limits the maximum number of results returned by the quote.

boolean
Defaults to false

Forces the quote to be calculated per item, even when multiple items are requested.

IgnoredSellerCodes
array of strings
Defaults to ["19761043000118"]

List of seller CNPJs (codes) that should be ignored, even if they have stock.

IgnoredSellerCodes
SellerCodes
array of strings
Defaults to ["19761043000118"]

List of seller CNPJs allowed for the quote.

SellerCodes
boolean
Defaults to false

Returns only a single SLA per item to simplify the response.

Body Params
string
Defaults to 80730280

Store ZipCode to specify the shipping simulation location

string
required
Defaults to 00000000

Buyer zipCode to determinate delivery route

items
array of objects
required

A list of freightItem

items*
Response

Language
URL
LoadingLoading…
Response
Choose an example:
application/json