Este documento detalha o uso do endpoint para consultar cotações de frete.
1. Consulta de Cotação de Frete
Este endpoint permite consultar os detalhes de uma cotação de frete específica utilizando seu ID.
Endpoint
GET /api/slgCotacaoFrete
Parâmetros de Consulta (Query Parameters)
idCotacao: (obrigatório) O ID da cotação que será consultada.Exemplo de uso:
GET /api/slgCotacaoFrete?idCotacao=28522
dataEmissao: (obrigatório) deve ser menor ou igual a 30 dias formato da data(yyyy-mm-dd)Exemplo de uso:
GET /api/slgCotacaoFrete?dataEmissao=2025-06-03
tomadorCNPJ e dataEmissao: (obrigatórios) deve ser menor ou igual a 30 dias formato da data(yyyy-mm-dd)Exemplo de uso:
GET ?tomadorCNPJ=60934551000405&dataEmissao=2025-06-03
Autenticação
Tipo:
Basic AuthCredenciais: O nome de usuário e a senha devem ser obtidos com a empresa.
2. Resposta (Response)
A chamada retorna um objeto JSON contendo os detalhes completos da cotação e informações associadas.
Exemplo de Resposta JSON
Jon Doy{
"executado": true,
"resultado": "Ok",
"codigoResultado": 1,
"quantidadeCotacoes": 2,
"cotacoes": [
{
"cotacao": {
"idCotacaoFrete": 28438,
"dataEmissao": "2025-06-03",
"contato": "NOME DO CONTATO",
"tomadorFreteCodigo": 1,
"tomadorFreteDescricao": "REMETENTE",
"classificacaoTomador": null,
"tipoCarregamento": 1,
"tipoCarregamentoDescricao": "FRACIONADO",
"tipoCalculoFreteCodigo": "1",
"tipoCalculoFreteDescricao": "REMETENTE ATÉ DESTINATÁRIO",
"tipoCarregamentoEspecieCodigo": "1",
"tipoCarregamentoEspeceDescricao": "CAIXA",
"peso": 295,
"cubagem": 1.55,
"valor": 17,
"valorNF": 22218,
"KM": 334,
"cobraColeta": 1,
"cobraEntrega": 1,
"freteCombinado": 0,
"baseICMS": 386.19,
"aliquotaICMS": 12,
"valorICMS": 46.340000000000003,
"valorFrete": 386.19,
"tipoEncomendaCodigo": "0",
"tipoEncomenda": "PADRÃO",
"modal": "1",
"modalDescricao": "RODOVIARIO"
},
"veiculo": {
"placa": null,
"tipoVeiculoCodigo": 0,
"tipoVeiculoDescricao": null
},
"remetente": {
"cnpj": "99999999999999",
"inscricaoEstadual": "999999999999",
"nome": "NOME DO CLIENTE",
"endereco": "ENDERECO DO CLIENTE",
"numero": "2457",
"bairro": "BAIRRO DO CLIENTE",
"UF": "SP",
"CEP": "17280000",
"cidade": "PEDERNEIRAS",
"codigoIBGE": 0
},
"destinatario": {
"cnpj": "99999999999999",
"inscricaoEstadual": "999999999999",
"nome": "NOME DO CLIENTE",
"endereco": "ENDERECO DO CLIENTE",
"numero": "82",
"bairro": "BAIRRO DO CLIENTE",
"UF": "MG",
"CEP": "31720050",
"cidade": "BELO HORIZONTE",
"codigoIBGE": 0
},
"recebedor": {
"cnpj": "99999999999999",
"inscricaoEstadual": "999999999999",
"nome": "NOME DO CLIENTE",
"endereco": "ENDERECO DO CLIENTE",
"numero": "311",
"bairro": "BAIRRO DO CLIENTE",
"UF": "SP",
"CEP": "07223075",
"cidade": "GUARULHOS",
"codigoIBGE": 0
},
"tomador": {
"cnpj": "99999999999999",
"inscricaoEstadual": "999999999999",
"nome": "NOME DO CLIENTE",
"endereco": "ENDERECO DO CLIENTE",
"numero": "2457",
"bairro": "BAIRRO DO CLIENTE",
"UF": "SP",
"CEP": "17280000",
"cidade": "PEDERNEIRAS",
"codigoIBGE": 0
}
},
{
"cotacao": {
"idCotacaoFrete": 28440,
"dataEmissao": "2025-06-03",
"contato": "NOME DO CONTATO",
"tomadorFreteCodigo": 1,
"tomadorFreteDescricao": "REMETENTE",
"classificacaoTomador": null,
"tipoCarregamento": 1,
"tipoCarregamentoDescricao": "FRACIONADO",
"tipoCalculoFreteCodigo": "1",
"tipoCalculoFreteDescricao": "REMETENTE ATÉ DESTINATÁRIO",
"tipoCarregamentoEspecieCodigo": "13",
"tipoCarregamentoEspeceDescricao": "PALLET",
"peso": 2878,
"cubagem": 28.25,
"valor": 22,
"valorNF": 61866.239999999998,
"KM": 0,
"cobraColeta": 1,
"cobraEntrega": 1,
"freteCombinado": 0,
"baseICMS": 3347.6500000000001,
"aliquotaICMS": 12,
"valorICMS": 401.72000000000003,
"valorFrete": 3347.6500000000001,
"tipoEncomendaCodigo": "0",
"tipoEncomenda": "PADRÃO",
"modal": "1",
"modalDescricao": "RODOVIARIO"
},
"veiculo": {
"placa": null,
"tipoVeiculoCodigo": 0,
"tipoVeiculoDescricao": null
},
"remetente": {
"cnpj": "99999999999999",
"inscricaoEstadual": "999999999999",
"nome": "NOME DO CLIENTE",
"endereco": "ENDERECO DO CLIENTE",
"numero": "35",
"bairro": "BAIRRO DO CLIENTE",
"UF": "SP",
"CEP": "17280888",
"cidade": "PEDERNEIRAS",
"codigoIBGE": 0
},
"destinatario": {
"cnpj": "99999999999999",
"inscricaoEstadual": "999999999999",
"nome": "NOME DO CLIENTE",
"endereco": "ENDERECO DO CLIENTE",
"numero": "180",
"bairro": "BAIRRO DO CLIENTE",
"UF": "SP",
"CEP": "08900000",
"cidade": "GUARAREMA",
"codigoIBGE": 0
},
"tomador": {
"cnpj": "99999999999999",
"inscricaoEstadual": "999999999999",
"nome": "NOME DO CLIENTE",
"endereco": "ENDERECO DO CLIENTE",
"numero": "35",
"bairro": "BAIRRO DO CLIENTE",
"UF": "SP",
"CEP": "17280888",
"cidade": "PEDERNEIRAS",
"codigoIBGE": 0
}
}
]
}
3. Endpoints para Códigos de Referência
Para preencher os campos da cotação, você pode usar os seguintes endpoints para buscar os códigos e descrições disponíveis.
Tipos de Pessoa (tomadorFreteCodigo)
Todos os tipos:
/api/slgCotacaoFrete?tipoPessoa=*Tipo específico:
/api/slgCotacaoFrete?tipoPessoa=1
Tipos de Carregamento (tipoCarregamento)
Todos os tipos:
/api/slgCotacaoFrete?tipoCarregamento=*Tipo específico:
/api/slgCotacaoFrete?tipoCarregamento=1
Tipos de Cálculo de Frete (tipoCalculoFreteCodigo)
Todos os tipos:
/api/slgCotacaoFrete?tipoCalculoFrete=*Tipo específico:
/api/slgCotacaoFrete?tipoCalculoFrete=1
Tipos de Espécie de Carregamento (tipoCarregamentoEspecieCodigo)
Todos os tipos:
/api/slgCotacaoFrete?tipoEspecie=*Tipo específico:
/api/slgCotacaoFrete?tipoEspecie=1