SaguiLog - Integração de API de Encomendas para Clientes Finais
Saguitech LTDA
Última atualização há 4 anos
Acesso à API
O SaguiLog possui uma API que permite a integração entre sistemas de clientes finais e o SaguiLog. Esta API permite consultar encomendas solicitadas, bem como os eventos de rastreio.
O acesso à API é dado em dois passos:
- Obtenção do Token do Azure AD;
- Acesso com o Token à API do SaguiLog.
Para realizar a integração com a API solicite a liberação do seu acesso juntamente com o seu fornecedor logístico.
Obtendo o Token
Para obter o token do Azure AD, você precisará do ClientID, ClientSecret e Tenant do Azure AD gerado por seu fornecedor logístico. Com essas informações em mãos realize um chamada HTTP com os seguintes parâmetros.
Header
Content-Type: application/json
Requisição: POST
URL: https://login.microsoftonline.com/<TENANT-AZURE-AD>/oauth2/token
Body
Tipo: form-data
Key - Descrição
client_id - <O valor do ClientID>
client_secret - <O valor do ClientSecret>
grant_type - client_credentials
resource - https://saguitech.com.br/saguicontrolapi
Resposta
Será um Json com o Token no parâmetro access_token. Esse Token será utilizado para chamar o SaguiLog. Esse token valerá por 1 hora.
Acesso à API do SaguiLog
Após possuir o Token do Azure AD, você poderá realizar uma requisição ao SaguiLog. Para realizar a consulta de uma Encomenda pelo número da NF-e realize uma chamada HTTP conforme os parâmetros abaixo:
Header
Content-Type: application/json
Requisição: POST
Authorization: Bearer + <token recebido anteriormente>
Body
Tipo: Json
Key - Descrição
NotaFiscal <O número da nota fiscal com a série separado por traço. Exemplo: Nota Fiscal número 5567 e série 1. {"NotaFiscal": "5567-1"}
Resposta
Será um Json com os dados completos da encomenda incluindo os eventos em um array encomendaOcorrencias. Exemplo:
[
{
"encomendaId": 1,
"data": "2020-07-14T03:00:00",
"cte": "2223232",
"remetente": "TESTE",
"destinatario": "TESTE",
"destinatarioCnpj": null,
"remetenteEndereco": null,
"remetenteCnpj": "03481110000101",
"remetenteCidade": null,
"remetenteUf": null,
"endereco": "RUA TESTE 131",
"cidade": "PARANAGUA",
"uf": "PR",
"peso": 20.000,
"pesoTaxado": 20.000,
"notaFiscal": "44455-4",
"valorFrete": 75.12,
"valorMercadoria": 3528.90,
"status": "TRANSFERENCIA",
"cepOrigem": "11111223",
"cepDestino": "12345678",
"nomeRecebedor": null,
"documentoRecebedor": null,
"dataEvento": "2020-07-14T03:00:00",
"dataPrevisao": "2020-07-21T03:00:00",
"cfop": 0,
"naturezaOperacao": null,
"modal": 0,
"tipoServico": 0,
"recebedorRetira": 0,
"tomadorPapel": 0,
"empresaId": 24,
"remetenteClienteId": 0,
"destinatarioClienteId": 0,
"expedidorClienteId": 0,
"recebedorClienteId": 0,
"valorTotalServico": 0.00,
"valorReceber": 0.00,
"icmsSituacaoTributaria": 0,
"icmsValorBaseCalculo": 0.00,
"icmsAliquota": 0.00,
"icmsValorImposto": 0.00,
"icmsPercentualReducaoBaseCalculo": 0.00,
"valorCarga": 0.00,
"produtoPredominante": null,
"rntc": null,
"observacoesGerais": null,
"cteId": 0,
"cteChaveAcesso": null,
"local": null,
"encomendaComponenteValores": [],
"encomendaQuantidadeCargas": [],
"encomendaDocumentos": [],
"encomendaOcorrencias": [
{
"encomendaOcorrenciaId": 123,
"data": "2020-07-14T03:00:00",
"status": "TRANSFERENCIA",
"local": null,
"observacao": null,
"encomendaId": 123,
"saguiClienteId": 19
}
],
"saguiClienteId": 19
}
]