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.