Mudanças

Ir para: navegação, pesquisa

Manuais:ERP.Net/API/EBoleto

7 166 bytes adicionados, 00h08min de 16 de maio de 2018
Criou página com '<big>'''E-Boleto - Sistema emissor de boletos eletrônicos.'''</big> ==Acessando a API== Para realizar o acesso à API é necessário estar logado no serviço. <br/>Verifiq...'
<big>'''E-Boleto - Sistema emissor de boletos eletrônicos.'''</big>

==Acessando a API==

Para realizar o acesso à API é necessário estar logado no serviço.
<br/>Verifique como realizar a autenticação na página [[Manuais:ERP.Net/API/Auth|Autenticando na API]].

==Realizando a emissão de um boleto==
===Caso de Sucesso===
<div class="center">
<table style="border: 1px solid black;border-collapse: collapse;width: 800px;">
<tr style="border: 1px solid black;">
<td style="text-align: center;padding: 7px;border: 1px solid black;">Endpoint</td>
<td style="text-align: left;border: 1px solid black;">https://erpnet.online/api/eboleto/emitir</td>
</tr>
<tr style="border: 1px solid black;">
<td style="text-align: center;padding: 7px;border: 1px solid black;">Método</td>
<td style="text-align: left;border: 1px solid black;">POST</td>
</tr>
<tr style="border: 1px solid black;">
<td style="text-align: center;padding: 7px;border: 1px solid black;">Body<br/>(JSON)</td>
<td style="text-align: left;border: 1px solid black;"><pre>{
"Boleto": {
"Agencia": "Número da sua agência",
"Posto": "Número do seu posto",
"Cedente": "Número do Cedente",
"NossoNumero": "",
"CodigoPagador": "",
"TipoPessoa": 1,
"CpfCnpj": "02664340026",
"Nome": "teste",
"Endereco": "dolores alcaras",
"Cidade": "portoalegre",
"UF": "rs",
"CEP": "91760110",
"Telefone": "5188888888",
"Email": "[email protected]",
"EspecieDocumento": "B",
"CodigoSacadorAvalista": "000",
"SeuNumero": "1234567891",
"DataVencimento": "26/08/2016",
"Valor": 10,
"TipoDesconto": 1,
"TipoJuros": 1,
"Informativo": "teste1",
"Mensagem": "teste",
"CodigoMensagem": ""
},
"CodigoBanco": 748
}</pre>

O código do banco utilizado é o 748, pois apenas o Sicredi é aceito até o momento.</td>
</tr>
<tr style="border: 1px solid black;">
<td style="text-align: center;padding: 7px;border: 1px solid black;">Retorno<br/>(DATA)</td>
<td style="text-align: left;border: 1px solid black;"><pre>{
"Data": {
"Aceite": "N",
"Arquivo": null,
"CodigoBanco": 748,
"CodigoBeneficiario": "94914",
"CpfCnpjBeneficiario": "06117473000150",
"CpfCnpjPagador": "02664340026",
"DataDocumento": "2018-05-15T00:00:00",
"DataEmissao": null,
"DataLimiteDesconto": null,
"DataLiquidacao": null,
"DataProcessamento": "2018-05-15T00:00:00",
"DataVencimento": "0001-01-01T00:00:00",
"EnderecoBeneficiario": "R. ANTONIO FELIPE, 1500",
"EnderecoPagador": "DOLORES ALCARAS",
"Especie": "REAL",
"EspecieDocumento": "B",
"JurosMulta": 0,
"LinhaDigitavel": "74891118100002420718513949141074886950000001000",
"NomeBeneficiario": "UNIMAKE SOLUCOES CORPORATIVAS",
"NomePagador": "TESTE",
"NossoNumero": "181000242",
"OoperativaBeneficiario": null,
"PostoBeneficiario": "13",
"SeuNumero": "1234567891",
"Situacao": null,
"Valor": 0,
"ValorDesconto": 0,
"ValorDocumento": 10,
"ValorLiquidado": null,
"Codigo": null,
"Mensagem": null,
"Success": true
},
"Message": null,
"Success": true,
"Version": {
"Major": 1,
"Minor": 1,
"Build": -1,
"Revision": -1,
"MajorRevision": -1,
"MinorRevision": -1
},
"Content": null,
"StatusCode": 200,
"ReasonPhrase": "OK",
"Headers": [],
"RequestMessage": null,
"IsSuccessStatusCode": true
}</pre>

É retornado o boleto emitido em caso de sucesso. Propriedade ''Success = true''.<br/>
Caso seja retornado ''Success = false'' verifique a mensagem de erro em ''Message''</td>
</tr>
</table>
</div>

===Caso de falha===
<div class="center">
<table style="border: 1px solid black;border-collapse: collapse;width: 800px;">
<tr style="border: 1px solid black;">
<td style="text-align: center;padding: 7px;border: 1px solid black;">Endpoint</td>
<td style="text-align: left;border: 1px solid black;">https://erpnet.online/api/eboleto/emitir</td>
</tr>
<tr style="border: 1px solid black;">
<td style="text-align: center;padding: 7px;border: 1px solid black;">Método</td>
<td style="text-align: left;border: 1px solid black;">POST</td>
</tr>
<tr style="border: 1px solid black;">
<td style="text-align: center;padding: 7px;border: 1px solid black;">Body<br/>(JSON)</td>
<td style="text-align: left;border: 1px solid black;"><pre>{
"Boleto": {
"NossoNumero": "",
"CodigoPagador": "",
"TipoPessoa": 1,
"CpfCnpj": "02664340026",
"Nome": "teste",
"Endereco": "dolores alcaras",
"Cidade": "portoalegre",
"UF": "rs",
"CEP": "91760110",
"Telefone": "5188888888",
"Email": "[email protected]",
"EspecieDocumento": "B",
"CodigoSacadorAvalista": "000",
"SeuNumero": "1234567891",
"DataVencimento": "26/08/2016",
"Valor": 10,
"TipoDesconto": 1,
"TipoJuros": 1,
"Informativo": "teste1",
"Mensagem": "teste",
"CodigoMensagem": ""
},
"CodigoBanco": 748
}</pre>

O código do banco utilizado é o 748, pois apenas o Sicredi é aceito até o momento.</td>
</tr>
<tr style="border: 1px solid black;">
<td style="text-align: center;padding: 7px;border: 1px solid black;">Retorno<br/>(DATA)</td>
<td style="text-align: left;border: 1px solid black;"><pre>{
"Data": {
"Aceite": null,
"Arquivo": null,
"CodigoBanco": 0,
"CodigoBeneficiario": null,
"CpfCnpjBeneficiario": null,
"CpfCnpjPagador": null,
"DataDocumento": null,
"DataEmissao": null,
"DataLimiteDesconto": null,
"DataLiquidacao": null,
"DataProcessamento": null,
"DataVencimento": null,
"EnderecoBeneficiario": null,
"EnderecoPagador": null,
"Especie": null,
"EspecieDocumento": null,
"JurosMulta": null,
"LinhaDigitavel": null,
"NomeBeneficiario": null,
"NomePagador": null,
"NossoNumero": null,
"OoperativaBeneficiario": null,
"PostoBeneficiario": null,
"SeuNumero": null,
"Situacao": null,
"Valor": 0,
"ValorDesconto": null,
"ValorDocumento": null,
"ValorLiquidado": null,
"Codigo": "E0010",
"Mensagem": "Campo obrigatorio em branco.",
"Success": false
},
"Message": "Campo obrigatorio em branco.",
"Success": false,
"Version": {
"Major": 1,
"Minor": 1,
"Build": -1,
"Revision": -1,
"MajorRevision": -1,
"MinorRevision": -1
},
"Content": null,
"StatusCode": 500,
"ReasonPhrase": "OK",
"Headers": [],
"RequestMessage": null,
"IsSuccessStatusCode": false
}</pre>
</tr>
</table>
</div>

Perceba que não colocamos os campos ''Agencia'', ''Posto'' e ''Cedente'' na requisição. O retorno foi ''Success = false'' com a propriedade ''Message'' preenchida com o erro.

A propriedade ''Data'' possui o resultado original do banco em questão. Pode variar de banco para banco.

Menu de navegação