# Como Homologar É possível criar a própria política de logística ao implantar uma URL de frete que será responsável pela cotação do cálculo (de frete) para os produtos integrados. Abaixo é apresentada a estrutura esperada para a cotação do frete via URL. Uma vez desenvolvida, a URL deverá ser encaminhada ao time de API para que sejam realizadas as devidas validações. ### Regras para a implementação Para garantir uma boa experiência para os compradores, o serviço de frete deve responder em **até ****400 ms**. Caso o serviço demore mais do que 400 ms para responder, o cálculo de frete será realizado através da **planilha de contingência** cadastrada pelo *seller* no portal do marketplace. Em relação a cotação para o cliente, o marketplace Americanas irá apresentar a opção mais barata entre as disponíveis; o segundo ponto é a entrega mais rápida, seguindo as regras do *buybox*, caso haja mais de uma resposta de cotação positiva. {% hint style="warning" %} **Importante ressaltar que o servidor da Americanas se localiza na Virgínia.** A localização do servidor deve ser levada em consideração para que a URL seja capaz de responder em tempo adequado. {% endhint %} Os dados utilizados para a homologação são fictícios, não possuindo vínculo com nenhuma conta em produção, ou seja, serão realizadas requisições com dados aleatórios de um produto de teste que não pertencerá a uma loja em produção, porém espera-se **sucesso** na requisição. Caso a URL a ser validada possua regras que impeçam o sucesso ao ser informado um SKU fictício não será possível dar andamento ao processo de homologação. {% hint style="info" %} A homologação consiste em garantir que a URL informada esteja respondendo em tempo hábil (até **400 ms**) e que não existam impeditivos para a cotação do frete, que deverá levar em consideração especialmente as informações de **CEP** e **dimensões** apresentadas. {% endhint %} ### POST - Teste unitário para homologação Para validação serão realizadas requisições unitárias do método POST para a URL desenvolvida. {% hint style="warning" %} Todas as requisições contarão com dados fictícios e por este motivo é imprescindível que a URL não possua bloqueios de SKU. {% endhint %} #### Request body: ``` { "destinationZip": 22041001, "volumes": [ { "sku": "SKU_1", "quantity": 2, "price": 15.20, "height": 0.55, "length": 0.63, "width": 0.21, "weight": 1.00 }, { "sku": "SKU_2", "quantity": 1, "price": 53.99, "height": 0.3, "length": 0.2, "width": 0.1, "weight": 1.75 } ] } ``` #### Formato dos dados:
Campo JSONTipo de DadoDescrição
Campo JSONTipo de DadoDescrição
destinationZipinteiroCEP de destino que será passado como um inteiro.
Por exemplo: 5010010 para o CEP “05010-010″
volumesarrayLista de itens
skustringSKU do Parceiro *
quantityintegerUnidades da venda
pricedoublePreço de venda do produto
heightdoubleAltura em metros
widthdoubleLargura em metros
lengthdoubleComprimento em metros
weightdoublePeso em quilos (Kg)
{% hint style="info" %} (\*) Em caso de produto variável, o SKU na requisição será o da **variação**. {% endhint %} #### Example request: ``` curl --location --request POST 'https://URL_PARCEIRO' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "destinationZip": 22041001, "volumes": [ { "sku": "SKU_1", "quantity": 2, "price": 15.20, "height": 0.55, "length": 0.63, "width": 0.21, "weight": 1.00 }, { "sku": "SKU_2", "quantity": 1, "price": 53.99, "height": 0.3, "length": 0.2, "width": 0.1, "weight": 1.75 } ] }' ``` ### Resposta (response) esperada Ao executar a requisição apresentada acima, a API espera como resposta um JSON válido contendo as seguintes informações: #### Response esperado: {% hint style="success" %} 200 \[Success] - OK: Deverá ser retornado um body cujo padrão pode ser visualizado a seguir: {% endhint %} ``` { "shippingQuotes": [ { "shippingCost": 13, "deliveryTime": 3, "shippingEstimateId": "b413bfe83d704c76bd4f81f99abf30c9", "shippingMethodId": "8-Correios", "shippingMethodName": "Sedex", "shippingMethodDisplayName": "Sedex" } ] } ``` #### Formato dos dados:
Campo JSONTipo de DadoDescrição
Campo JSONTipo de DadoDescrição
shippingQuotesarrayLista com resultados do cálculo de frete. Só será considerada a PRIMEIRA posição
shippingCostdoubleValor do frete
deliveryTimeintegerObjeto que trará as informações de prazo da entrega
shippingEstimateIdstringIdentificador único gerado durante o cálculo do frete
shippingMethodIdstringID da transportadora/tipo de frete selecionado
shippingMethodNamestringNome da transportadora/tipo de frete selecionado
shippingMethodDisplayNamestringNome do frete selecionado exibido para o cliente
{% hint style="danger" %} **Todos os campos do response devem ser apresentados conforme descritos.** Caso esteja informando em caixa alta uma letra que deve ser em caixa baixa, a requisição retornará erro. {% endhint %} ### Exceções Caso não haja atendimento para um determinado range de CEP, basta retornar o erro HTTP **404** \[not found]. Sugerimos a inclusão de uma mensagem padrão conforme exemplo abaixo: ``` { "message": "Região de entrega não atendida". } ``` {% hint style="warning" %} **Importante reforçar que caso o tempo de resposta ultrapasse o limite de ****400 ms**** haverá um retorno ****499**** \[timeout] e a ****tabela de contingência**** será acionada.** Neste caso, é essencial que a loja possua uma tabela de contingência cadastrada e atualizada no portal da Americanas, evitando que perca vendas. {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://desenvolvedores.skyhub.com.br/frete/como-homologar-frete.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.