Ir para o conteúdo

Conhecimento de Transporte

POST https://freterapido.com/api/external/transportadora/v1/quotes/invoices/ctes?token={seu_token}

Método que permite receber os componentes de um conhecimento de transporte vinculado à uma nota fiscal.

Permite também que o Embarcador acompanhe os valores atualizados a serem cobrados pelos serviços contratados.

Para registrar um novo Conhecimento, basta informar os dados abaixo em uma requisição.

This is a alt text.

Envio:

Parâmetros da URL:

Nome Descrição Formato / Exemplo Obrigatório
token Token de integração String de 32 caracteres *
* Dados obrigatórios

Parâmetros do corpo da requisição:

Nome Descrição Formato / Exemplo Obrigatório
cnpj_transportadora CNPJ da transportadora String *
conhecimentos Array de conhecimentos de transporte Array de conhecimentos *
 acao Código da ação do CT-e String (vide códigos anexo) *
 cte_substituido Array com CT-e substituídos Array Opcional
  chave_acesso Chave do CT-e substituído String de 44 caracteres Caso acao = ST
  numero Número do CT-e substituído Integer Caso acao = ST
  serie Série do CT-e substituído Integer Caso acao = ST
 cnpj_embarcador CNPJ do embarcador String de 14 caracteres *
 cnpj_consignatario CNPJ do consignatário String de 14 caracteres Opcional
 cnpj_emissor_conhecimento CNPJ do emissor do Conhecimento String de 14 caracteres Opcional
 numero Número do CT-e Integer *
 serie Série do CT-e Integer *
 chave_acesso Chave de acesso do CT-e String de 44 caracteres *
 protocolo Número do Protocolo da CT-e na SEFAZ String Opcional
 data_emissao Data e hora de emissão do Conhecimento pela Transportadora DateTime ("YYYY-MM-DD hh:mm:ss") *
 processamento Data e hora do processamento do EDI na Transportadora DateTime ("YYYY-MM-DD hh:mm:ss") Opcional
 numero_nf Número da nota fiscal Integer *
 serie_nf Série da nota fiscal Integer *
 tipo_frete Tipo de frete String (C or F) *
 peso_taxado Peso considerado no cálculo Float Opcional
 peso_bruto Peso bruto da mercadoria Float Opcional
 valor Valor total do frete Float *
 base_calculo_icms Base ICMS utilizado Float Opcional
 percentual_icms Alíquota ICMS Float Opcional
 valor_icms ICMS calculado Float Opcional
 quantidade_volumes Quantidade de volumes Integer Opcional
 valor_frete_peso_volume Valor frete peso Float Opcional
 valor_coleta Valor da taxa de coleta Float Opcional
 valor_despacho Valor da taxa de despacho Float Opcional
 valor_redespacho Valor da taxa redespacho Float Opcional
 valor_adicional Outras taxas extras Float Opcional
 pedagio Valor taxa de pedágio Float Opcional
 aliquota_difal_origem Alíquota DIFAL de origem Float Opcional
 aliquota_difal_destino Alíquota DIFAL de origem Float Opcional
 difal_icms_origem Percentual DIFAL origem Float Opcional
 difal_icms_destino Percentual DIFAL destino Float Opcional
 advalorem Ad Valorem Float Opcional
 ademe Valor da taxa de ADEME Float Opcional
 sec_cat Valor taxa SEC/CAT Float Opcional
 itr Valor taxa ITR Float Opcional
 tep Valor do TEP Float Opcional
 trt Valor do TRT Float Opcional
 tas Valor do TAS Float Opcional
 suframa Valor da taxa de SUFRAMA Float Opcional
 iss Valor da taxa de ISS Float Opcional
 gris Valor do GRIS Float Opcional
 pis Valor do tributo PIS Float Opcional
 cofins Valor do tributo COFINS Float Opcional
 cubagem Cubagem da mercadoria Float Opcional
 substituicao_tributaria Se tem ou não substituição tributária Boolean (true or false) Opcional
 cfop Código de CFOP Integer Opcional
 tipo_operacao Código do tipo de operação String (vide códigos anexo) *
 tipo_transporte Código do tipo de transporte String (vide códigos anexo) Opcional

* Dados Obrigatórios

Códigos propriedade “acao”:

 I = incluir;

 C = complementar;

 E = excluir;

 ST = substituir;

Códigos propriedade “tipo_operacao”:

 N = NORMAL;

 C = COMPLEMENTAR;

 D = CONHECIMENTO DE DEVOLUÇÃO;

 E = NORMAL DE ENTRADA;

 O = NORMAL DE RETORNO;

 R = CONHECIMENTO DE REENTREGA;

 S = NORMAL DE SAÍDA;

 T = NORMAL DE TRANSFERÊNCIA INTERNA;

 W = COMPLEMENTAR DE RETORNO;

 X = COMPLEMENTAR DE ENTRADA;

 Y = COMPLEMENTAR DE SAÍDA E

 Z = COMPLEMENTAR DE TRANSF. INTERNA

Códigos propriedade “tipo_transporte”:

 12 = NAVIO TANQUE

 21 = VAGÃO FERROVIÁRIO TANQUE

 23 = VAGÃO FERROVIÁRIO GRANELEIRO

 25 = EXPRESSO FERROVIÁRIO

 31 = CAMINHÃO (CARGA SECA)

 32 = CAMINHÃO TANQUE (CARGA LÍQUIDA)

 34 = REMESSA EXPRESSA RODOVIÁRIA

 41 = FRETE AÉREO

 43 = EXPRESSO AÉREO

 51 = ENCOMENDA POSTAL

 52 = CORREIO EXPRESSO

 55 = CORREIO AÉREO

 101 = MENSAGEIRO EXPRESSO

 BR01 = PERUAS (KOMBI, BESTA, ETC.)

 BR02 = CAMINHONETE 0,5 TON (SAVEIRO, ETC.)

 BR03 = TOCO ABERTO

 BR04 = TOCO FECHADO

 BR05 = TRUCK ABERTO

 BR06 = TRUCK FECHADO

 BR07 = CARRETA ABERTA

 BR08 = CARRETA FECHADA

 BR10 = TRUCK REFRIGERADO

 BR11 = CARRETA REFRIGERADA

 BR12 = TRUCK SIDER

 BR13 = CARRETA SIDER

 BR50 = FURGÃO 3,5 TON. (SPRINTER, ETC.)

 BR51 = CAMINHONETE 1 TON (F1000, S10, ETC.)

 BR60 = CARRETA 60 METROS CÚBICOS

 BR80 = CARRETA 80 METROS CÚBICOS

 CTB = CONTAINER BUGGY

 C20 = CONTAINER 20 PÉS (*)

 C40 = CONTAINER 40 PÉS (*)

 C4H = CONTAINER 40 PÉS HC (*)

 C2R = CONTAINER 20 PÉS REFRIGERADO (*)

 C4R = CONTAINER 40 PÉS REFRIGERADO (*)

Exemplo de envio:

        {
            "cnpj_transportadora": "",
            "conhecimentos": [
                {
                    "acao": "",
                    "cnpj_embarcador": "",
                    "cnpj_consignatario": "",
                    "cnpj_emissor_conhecimento": "",
                    "numero": "",
                    "serie": "",
                    "data_emissao": "",
                    "processamento": "",
                    "cte_substituido": {
                        "chave_acesso": "",
                        "numero": "",
                        "serie": ""
                    },
                    "numero_nf": "",
                    "serie_nf": "",
                    "chave_acesso": "",
                    "protocolo": "",
                    "tipo_frete": "",
                    "peso_taxado": 0.00,
                    "peso_bruto": 0.00,
                    "valor": 0.00,
                    "base_calculo_icms": 0.0,
                    "percentual_icms": 0.0,
                    "valor_icms": 0.0,
                    "quantidade_volumes": 0,
                    "valor_frete_peso_volume": 0.0,
                    "valor_coleta": 0.0,
                    "valor_despacho": 0.0,
                    "valor_redespacho": 0.0,
                    "valor_adicional": 0.0,
                    "pedagio": 0.0,
                    "aliquota_difal_origem": 0.0,
                    "aliquota_difal_destino": 0.0,
                    "difal_icms_origem": 0.0,
                    "difal_icms_destino": 0,
                    "advalorem": 0.0,
                    "ademe": 0.0,
                    "sec_cat": 0.0,
                    "itr": 0.0,
                    "tep": 0.0,
                    "trt": 0.0,
                    "tas": 0.0,
                    "suframa": 0.0,
                    "iss": 0.0,
                    "gris": 0.0,
                    "pis": 0.0,
                    "cofins": 0.0,
                    "cubagem": 0.0,
                    "substituicao_tributaria": true,
                    "cfop": 0,
                    "tipo_operacao": "",
                    "tipo_transporte": ""
                }
            ]
        }        

Resposta:

  • Se a requisição obtiver sucesso, deve ser retornado o código de resposta HTTP 200. Senão, pode ser retornado uma mensagem de erro para que possamos investigar.
Voltar ao topo