Pular para o conteúdo principal

Tabela de frete

A tabela de frete é um cadastro essencial no NDD Elog para o cálculo de fretes e tarifas adicionais durante a formação de cargas. Para enviar uma nova tabela de frete via integração, siga as referências.

Exemplo de requisição

  • Método: POST
  • URL: [URL_BASE]/api/v1/TabelaFrete

Cabeçalhos

Content-Type: application/json
Authorization: Bearer {accessToken}

Corpo

CampoObrigatórioDescrição
AtivoNãoIndica se o registro está ativo (true / false).
TipoTabelaNãoTipo da tabela de frete. Valores possíveis:
1 - Origem x Destino Valor Fixo
2 - Origem x Destino Peso
3 - Origem x Destino Valor Mercadoria
4 - Origem x Destino Quantidade de Volumes
5 - Origem x Destino Tipo de Veículo
DataAtivacaoNãoData de ativação da tabela (formato ISO 8601).
DataExpiracaoNãoData de expiração da tabela (formato ISO 8601).
FatorConversaoCubagemNãoFator usado para conversão de cubagem.
PercentualDevolucaoNãoPercentual aplicado para devoluções.
PercentualReentregaNãoPercentual aplicado para reentregas.
ICMSInclusoNãoIndica se o ICMS está incluso no valor (true / false).
ISSInclusoNãoIndica se o ISS está incluso no valor (true / false).
IdentificadorNãoCódigo identificador único do registro.
TrechosNãoLista de trechos associados à tabela (detalhes abaixo).
PrestadorSimDados do prestador do serviço (CNPJ, nome, dados bancários, etc.).
TipoOperacaoSimTipo de operação relacionada (frete, transporte, etc.).

Detalhamento da estrutura Trechos

CampoObrigatórioDescrição
IdentificadorNãoCódigo identificador do trecho.
TipoOrigemNãoTipo da origem: 1 (Região), 2 (Estado), 3 (Cidade).
UFOrigemNãoUnidade federativa (sigla) da origem.
IBGECidadeOrigemNãoCódigo IBGE da cidade de origem.
RegiaoOrigemNãoObjeto com informações da região de origem.
TipoDestinoNãoTipo do destino: 1 (Região), 2 (Estado), 3 (Cidade).
UFDestinoNãoUnidade federativa (sigla) do destino.
IBGECidadeDestinoNãoCódigo IBGE da cidade de destino.
RegiaoDestinoNãoObjeto com informações da região de destino.
ValorMinimoNãoValor mínimo para aplicação do trecho.
DiasParaEntregaNãoNúmero de dias previstos para entrega.
CustosBase
SequenciaNãoOrdem sequencial do custo base no trecho.
ComponenteFreteSimObjeto que representa o componente do frete (descrição e código).
TipoFaixaValorSimTipo da faixa de valor: 1 (Monetário), 2 (Percentual).
FaixaInicialNãoValor inicial da faixa para aplicação do custo.
FaixaFinalNãoValor final da faixa para aplicação do custo.
TipoValorSimTipo do valor: 1 (Fixo), 2 (Variável).
ValorSimValor do custo base, conforme tipo definido.
TipoVeiculoNãoObjeto que indica o tipo de veículo ao qual o custo se aplica.
TaxasAdicionais
SequenciaNãoOrdem sequencial da taxa adicional no trecho.
ComponenteFreteSimObjeto que representa o componente do frete (descrição e código).
TipoFaixaValorSimTipo da faixa de valor: 1 (Monetário), 2 (Percentual).
FaixaInicialNãoValor inicial da faixa para aplicação da taxa.
FaixaFinalNãoValor final da faixa para aplicação da taxa.
TipoValorSimTipo do valor: 1 (Fixo), 2 (Variável).
ValorSimValor da taxa adicional, conforme tipo definido.
CriterioAplicacaoSimCritério para aplicação da taxa:
1 - Sempre
2 - Peso
3 - Valor da mercadoria
4 - Quantidade de volumes
5 - Dificuldade de entrega no destinatário
6 - Dificuldade de acesso no destinatário
CondicaoSimCondição para aplicação da taxa:
1 - Igual a
2 - Maior que
3 - Menor que
4 - Estiver entre
5 - A cada
ValorCondicaoNãoValor associado à condição para aplicação da taxa.
AplicacaoSimBase de cálculo para aplicação da taxa:
1 - Valor da mercadoria
2 - Frete base
3 - Peso excedido

Próximos passos

Envie os pedidos e viagens. Veja mais em Planejamento e expedição.