Manuais:ERP.Net/API
Documentação sobre as APIs do ERP.Net
Índice
Conhecimentos necessários para a utilização das APIs do ERP.Net
A integração deverá ser realizada por uma pessoa que possua os seguintes conhecimentos:
- Desenvolver em linguagem de programação que permita acesso à WebAPI;
- Estar familiarizado com a comunicação utilizando métodos REST API;
- Conhecer a sintaxe JSON, pois todo o envio de dados e retorno é feito utilizando-se JSON
Dicas
- Em todo retorno recebido da API, verifique sempre as propriedades Success e StatusCode.
- A propriedade Success sempre irá retornar true se a requisição foi aceita pelo servidor e realizada com sucesso. Caso seja false, verifique a mensagem de erro em Message ou o StatusCode.
Sobre as requisições
No início da explicação de cada requisição, são informados os parâmetros de entrada e saída de cada endpoint utilizado, bem como o método REST que deverá ser utilizado.
Exemplo
| Endpoint | Endereço completo do endpoint |
| Método | Definição do método que deverá ser utilizado:
|
| Body (JSON) |
{
JSON válido para realizar a requisição. Cada endpoint requer um json diferente para ser consumido.
}
|
| Retorno (Tipo de Retorno) |
{
"Data": "Pode possuir algum resultado em JSON",
"Message": "",
"Success": true,
"StatusCode": 200
}
|
Os tipos de retorno podem ser:
- COOKIE
- Define que o retorno deverá ser lido nos cookies de resposta. Até o momento, é utilizado apenas para realizar login na API.
- DATA
- Indica que o retorno deverá ser lido, no formato JSON, na propriedade DATA do objeto de resposta da requisição.
Requisições da API
Antes de realizar qualquer requisição às APIs do ERP.Net, é necessário realizar o login na API para que não seja lançado o erro 401 (Unauthorized)
Autenticando na API
Descreve como deverá ser realizado o login na API.
EBoleto
Sistema emissor de boleto eletrônico.
- Bancos homologados:
- Sicredi
