Documentação API de Cotação v1.2

Este documento foi desenvolvido para orientar o desenvolvimento de comunicações com a API de cotação de frete da Alfa Transportes. Para consumir esta API, é necessário primeiramente entrar em contato com o comercial da matriz e solicitar uma chave de acesso único. Essa chave é a garantia da comunicação segura de ambos os lados. Com os exemplos e testes práticos abaixo, será possível realizar todos os testes antes de implementar em seu sistema.

URL Base: https://api.alfatransportes.com.br/cotacao/v1.2/

Parâmetros

A requisição deverá ser do tipo POST, com um JSON no corpo da requisição que pode conter os seguintes campos.

Campo	Descrição	Tipo	Tamanho	Obrigatório
idr	Chave de acesso (Identificação da Empresa Remetente)	String	30 - 40	Sim
cliTip	Tipo do Cliente (1=Pessoa Jurídica, 2=Pessoa Física)	Inteiro	1	Sim
cliCnpj	CNPJ ou CPF do cliente destinatário da mercadoria (Apenas números)	Numérico	11 - 14	Não
cliCep	CEP do cliente destinatário da mercadoria (Apenas números)	Numérico	8	Sim
merVlr	Valor da mercadoria	Numérico	13	Sim
merPeso	Peso bruto da mercadoria	Numérico	13	Sim
merM3	Metro cúmico da mercadoria.	Numérico	13	Sim
merVol	Volume da mercadoria	Inteiro	5	Não
quim	Indica se possui produtos químicos ou não (0=Não, 1=Sim)	Booleano	1	Não
dtEmbarque	Data de embarque	Data	8	Não
cepRem	CEP do Remetente (Apenas números)	Numérico	8	Não
modoJson	Retorno em JSON ou XML (0=XML, 1=JSON)	Booleano	1	Não
cnpjRem	CNPJ do remetente	Numérico	11 - 14	Não
zonaRural	Destinatario se encontra como zona rural (0=Não, 1=Sim)	Booleano	1	Não
tipoPagador	Pagador do Frete (1=CIF, 2=FOB)	Inteiro	1	Não

Dados do Remetente

Chave da API*

CEP Remetente (Apenas Números)

Data de Embarque

Dados do Destinatário

CNPJ Destinatário (Apenas Números)

CEP Destinatário (Apenas Números)*

Dados da Mercadoria

Valor (Apenas Números) *

Volume (Apenas Números)

Peso (Apenas Números) *

Metro Cúbico (Apenas Números) *

URL Requisitada:

Corpo da requisição

Resposta

Exemplo de Retorno Completo XML

<?xml version="1.0" encoding="utf-8"?>
<wsCotacao>
	<cot versao="1.0" id="COT0008328211080924069505447">
	<cotStatus stsCd="1">COTACAO CONCLUIDA COM SUCESSO</cotStatus>
		<emi>
			<rem remCnpj="82110818001101">ALFA TRANSPORTES LTDA</rem>
			<emiTransp transpCnpj="82110818001101">ALFA TRANSPORTES LTDA</emiTransp>
			<emiUnid>BAURU</emiUnid>
		</emi>
		<vlr>
			<cotVlrIni>265.29</cotVlrIni>
			<cotVlrPed>17.46</cotVlrPed>
			<cotVlrSeg>4.08</cotVlrSeg>
			<cotVlrTax>33.64</cotVlrTax>
			<cotVlrImp>24.12</cotVlrImp>
			<cotVlrTot>344.59</cotVlrTot>
		</vlr>
		<ent>
			<entDes desCnpj="82110818001101">ALFA TRANSPORTES LTDA</entDes>
			<entUnid>BRASILIA</entUnid>
			<entCid>PATU</entCid>
			<entPrev>3 DIAS UTEIS</entPrev>
		</ent>
	</cot>
</wsCotacao>

Exemplo de Retorno Completo JSON

{
	"id": "COT0008328211080924069506172",
	"status": {
		"numero": 1,
		"descricao": "COTACAO CONCLUIDA COM SUCESSO"
	},
	"cotacao": {
		"codigoCotacao": "9506172",
		"emissao": {
			"remetente": {
				"cnpjRemetente": "82110818001101",
				"nomeRemetente": "ALFA TRANSPORTES LTDA"
			},
			"detinatario": {
				"cnpjDestinatario": "82110818001101",
				"nomeDestinatario": "ALFA TRANSPORTES LTDA",
				"cidadeDestinatario": "PATU"
			},
			"transportadora": {
				"cnpjTransportadora": "82110818001101",
				"nomeTransportadora": "ALFA TRANSPORTES LTDA",
				"cidadeTransportadora": "BAURU"
			},
			"valoresCotacao": {
				"valorInicial": 265.28,
				"valorPedagio": 17.46,
				"valorSeguro": 4.08,
				"valorTaxa": 33.64,
				"valorImposto": 24.12,
				"valorTotal": 344.59
			},
			"diasEntrega": "3 DIAS UTEIS"
		}
	}
}

Códigos de Retorno

Código	Descrição
1	COTACAO CONCLUIDA COM SUCESSO
2	ERRO NA API, FAVOR CONTATAR O TI (desenvolvimento@alfatransportes.com.br)
3	FALTA IDENTIFICACAO
4	FALHA AO VERIFICAR IDENTIFICACAO
5	IDENTIFICACAO NAO ENCONTRADA
6	FALHA AO RECUPERAR OS VALORES DA COTACAO
7	FALTA TIPO DO DESTINATARIO (PESSOA FISICA OU JURIDICA)
8	FALTA CNPJ-CPF DO DESTINATARIO
9	FALTA CEP DO DESTINATARIO
10	FALTA VALOR DA MERCADORIA
11	FALTA PESO DA MERCADORIA
12	FALTA METRO CUBICO DA MERCADORIA
13	FALHA AO CALCULAR COTACAO, ENTRAR EM CONTATO COM O COMERCIAL DA MATRIZ
14	PRACA DESTINO ATENDIDA POR TERCEIRO
15	PRACA DESTINO NAO ATENDIDA
16	FALHA AO PESQUISAR REGIAO DO REMETENTE
17	FALHA AO PESQUISAR REGIAO DO DESTINATARIO
18	REGIAO DO REMETENTE NAO ENCONTRADA
19	REGIAO DO DESTINATARIO NAO ENCONTRADA
20	CNPJ NAO CONFERE COM O TIPO DE PESSOA JURIDICA
21	CPF NAO CONFERE COM O TIPO DE PESSOA FISICA
22	FALTANDO DADOS DO CADASTRO DO CNPJ, FAVOR ENTRAR EM CONTATO COM O VENDEDOR RESPONSÁVEL
23	DUPLICIDADE DE TIPO DE CLIENTE