Cálculo de frete

Nesta seção explicamos um pouco sobre os recursos disponível para consulta do cálculo de frete

Para o Marketplace obter informações comerciais sobre SKUs, tais como, preço, estoque, frete e prazos de entrega o “postalCode” deve ser preenchido no request e será obrigatório para o retorno das informações de logística.

O Marketplace poderá enviar um objeto contendo uma série de itens para obter as informações correspondente a composição.

O tempo máximo que os de resposta da API será de 2 segundos. Depois disso, o produto poderá ser considerado como indisponível ou inativo.

Endpoint

Fulfillment Simulation

POST https://{environmentSeller}/pvt/orderForms/simulation

Path Parameters

Name	Type	Description
{environmentSeller}*	string	URL da API do Seller

Headers

Name	Type	Description
X-VTEX-API-AppKey*	string	{{appKey}}
X-VTEX-API-AppToken*	string	{{appToken}}
Accept*	string	application/json
Content-Type*	string	application/json

200: OK Se a notificação for realizada com sucesso

Consulte o Swagger API

400: Bad Request Se a requisição não atender os requisitos mínimos

{
  "errorCode": "string",
  "message": "string"
}

401: Unauthorized Se a requisição não for autenticada

403: Forbidden As credenciais não estão ativas para acessar o serviço

429: Too Many Requests Muitos requests simultâneos

500: Internal Server Error Se ocorrer um erro no servidor

{
  "errorCode": "string",
  "message": "string"
}

Exemplo do Request

{
  "items": [
    {
      "id": "SGEFDT860BCNZ",
      "quantity": 1,
      "seller": "FSH"
    }
  ],
  "postalCode": "02976030",
  "country": null,
  "geoCoordinates": []
}

Exemplo do Response (200 - OK)

{
    "country": null,
    "items": [
        {
            "attachmentOfferings": null,
            "id": "SGEFDT860BCNZ",
            "listPrice": 86178,
            "measurementUnit": "un",
            "merchantName": null,
            "offerings": null,
            "price": 86178,
            "priceTags": null,
            "priceValidUntil": null,
            "quantity": 1,
            "requestIndex": 0,
            "seller": "FSH",
            "unitMultiplier": 1
        }
    ],
    "logisticsInfo": [
        {
            "itemIndex": 0,
            "quantity": 1,
            "shipsTo": [
                "BRA"
            ],
            "slas": [
                {
                    "id": "KAIVEHUB_Normal_33",
                    "deliveryChannel": "delivery",
                    "name": "Normal",
                    "price": 1386,
                    "shippingEstimate": "4bd",
                    "availableDeliveryWindows": [],
                    "pickupStoreInfo": {
                        "isPickupStore": false,
                        "friendlyName": null,
                        "address": null,
                        "additionalInfo": null
                    }
                }
            ],
            "stockBalance": 553,
            "deliveryChannels": [
                {
                    "id": "delivery",
                    "stockBalance": 553
                }
            ]
        }
    ],
    "geoCoordinates": null,
    "postalCode": "02976030"
}

Descrições dos campos consulte o "Swagger API"

A API permite até 5 requisições por segundo, caso ultrapasse esse limite será retornado status 429: Too Many Request

Informações importantes do Response:

• Quando retornado a lista "logisticsInfo" vazia significa que não há estoque dos itens informados.

• Quando não tiver opção de entrega para os itens informados será retornado a lista "logisticsInfo":"sla" vazia.