Cotar fretes API 2.0
Realiza a cotação dos itens nas logísticas informadas para a integração já configurada na Olist e retorna as informações por tipo de entrega, respeitando as configurações da conta da empresa.
Parâmetros da URL
| Parâmetro | |
|---|---|
| idEcommerce |
int Obrigatório. Identificador da integração na Olist. |
Cabeçalhos
| Parâmetro | |
|---|---|
| Token |
string Obrigatório. Token da conta na Olist. |
Corpo da requisição
O corpo da requisiçao deve ser enviado no formato JSON na seguinte estrutura:
Campos
| Campos | |
|---|---|
| cep_origem |
string Opcional. Se não informado, irá buscar o CEP da empresa. |
| cep_destino |
string Obrigatório. CEP de destino. |
| itens |
Item Obrigatório. Estrutura dos itens a serem cotados. |
| opcoes |
Opcoes Opcional. Opções de cotação. |
Item
| Campos | |
|---|---|
| sku |
string Obrigatório. Identificador do anúncio. |
| quantidade |
int Opcional. Padrão 1. |
| peso |
float Opcional. Peso da embalagem, em quilos. Por padrão, busca a informação do cadastro do produto na Olist. |
| altura |
float Opcional. Altura da embalagem, em centimetros. Por padrão, busca a informação do cadastro do produto na Olist. |
| largura |
float Opcional. Largura da embalagem, em centimetros. Por padrão, busca a informação do cadastro do produto na Olist. |
| comprimento |
float Opcional. Comprimento da embalagem, em centimetros. Por padrão, busca a informação do cadastro do produto na Olist. |
Opcoes
| Campos | |
|---|---|
| cotar_agrupado |
boolean Opcional. Determina se as cotações serão separadas por itens ou de forma agrupada. Padrão false. |
| considerar_dias_preparacao |
boolean Opcional. Determina se deve somar os dias para preparação, informados no cadastro do produto na Olist, ao prazo da cotação. Padrão true. |
| agrupar_tipo_entrega |
boolean Opcional. Determina se deve agrupar as cotações por tipo de entrega. Caso false, retornará todas opções disponíveis. Padrão true. |
Retorno do serviço
Em caso de sucesso, o corpo da resposta contém os dados conforme a estrutura abaixo:
Exemplo de retorno de cotação agrupada:
Para respostas com status HTTP diferente de 200, o corpo da resposta contém a estrutura abaixo:
Campos da cotação
| Campos | |
|---|---|
| tipo_entrega |
string Código do tipo de entrega. Podendo ser "normal", "expressa", "economica", "super_expressa", "agendada", "retirada" ou "nao_definida". |
| preco |
float Valor do frete. |
| prazo |
int Prazo de entrega em dias. |
| id_forma_envio |
int Identificador da forma de envio na Olist |
| nome_forma_envio |
string Nome da forma de envio na Olist |
| id_forma_frete |
int Identificador da forma de frete na Olist |
| nome_forma_frete |
string Nome da forma de frete na Olist |
