Esta referência ajuda a implementar a API do SULTS v1. Essa API usa um formato JSON para saída e é capaz de manipular solicitações CORS (Cross-Origin Resource Sharing).
A API é sem estado – todas as solicitações são validadas em um token da API. O token da API será disponibilizado pela equipe da SULTS.
Autenticação
Todas as chamadas de serviços devem ser autenticadas por um token, garantindo a segurança e a confidencialidade no tráfego dos dados de cada parceiro.
O método de autenticação da API é o Basic Auth, que é um método de controle de acessos a recursos Web realizado em cima do protocolo HTTP.
O API KEY (token) consiste apenas em um único valor e deve ser enviado em um cabeçalho HTTP “Authorization” que será disponibilizado pela SULTS.
Formatação de datas
Todas os campos de datas na API de Compras são padronizados nos seguintes formatos:
- Data e Hora: yyyy-MM-ddTHH:mm:ssZ
Todas as datas e horas são apresentados no formato UTC ISO 8601.
Máscaras
Informações que possuem máscaras (formatações de dígitos) como CNPJ, telefone, CEP, etc., são retornadas sem máscaras, por exemplo:
- Celular: 11987654321
- CEP: 38026000