Cotação de fretes
Busca a cotação de preços e prazos do envio de um pacote no gateway configurado.
Configurações
Acesse Menu → Configurações → Aba Vendas → Gateways Logísticos e selecione seu gateway de testes.
Localize os campos URL's para webhooks e informe a URL em que deseja receber os dados das cotações no campo URL para cotação de fretes.
Após a homologação da plataforma, as opções disponíveis para o usuário configurar serão as mesmas do gateway de testes. Os dados serão enviados ao webhook conforme as configurações selecionadas pelo usuário.
Payload enviado
| Elemento | tipo | Tamanho | Ocorrência | Descrição | Exemplo |
|---|---|---|---|---|---|
| cnpj | string | - | obrigatório | CNPJ/CPF da conta Tiny que está enviando o payload | 48404755000188 |
| tipo | string | - | obrigatório | Identificador do tipo do webhook | cotacao |
| versao | string | - | obrigatório | Versão do Webhook | 1.0.0 |
| dados | object | - | obrigatório | Elemento utilizado para representar os dados enviados pelo webhook | Baixar exemplo de payload dos dados da cotação |
| dados.cep_origem | string | - | obrigatório | CEP de origem | 95705026 |
| dados.cep_destino | string | - | obrigatório | CEP de destino | 95730000 |
| dados.itens[].identificador | string | - | obrigatório | Identificador do produto ou do volume | - |
| dados.itens[].qtd | int | - | obrigatório | Quantidade | - |
| dados.itens[].peso | float | - | obrigatório | Peso da embalagem, em quilos | - |
| dados.itens[].descricao | string | - | obrigatório | Descrição do produto ou do pacote | - |
| dados.itens[].altura | float | - | obrigatório | Altura da embalagem, em centímetros | - |
| dados.itens[].largura | float | - | obrigatório | Largura da embalagem, em centímetros | - |
| dados.itens[].comprimento | float | - | obrigatório | Comprimento da embalagem, em centímetros | - |
Confirmação de recebimento
A consulta é síncrona, ou seja, o Tiny espera o retorno do integrador no momento do envio.
Para que a consulta seja considerada como de sucesso, o webhook deverá retornar o status HTTP 200 e o payload exibido abaixo.
| Elemento | Tipo | Tamanho | Ocorrência | Descrição | Exemplo |
|---|---|---|---|---|---|
| cotacoes[] | array | - | obrigatório | Lista a qual deve conter as cotações. | Baixar exemplo de payload esperado como retorno |
| cotacoes[].codigo | string | - | obrigatório | Identificador da forma de frete para que o usuário possa fazer o relacionamento com a forma de envio por meio do campo "Código externo". | - |
| cotacoes[].preco | float | - | obrigatório | Valor da cotação. | - |
| cotacoes[].prazo | int | - | obrigatório | Prazo mínimo para a entrega, em dias. | - |
| cotacoes[].error | string | - | opcional | Erro que ocorreu isoladamente para a forma de frete a ser exibido para o usuário | - |
| error | string | - | opcional | Erro que impossibilitou a cotação a ser exibido para o usuário | - |
