Mudanças entre as edições de "Manuais:ERP.Net/API/EBoleto"

De unimake
Ir para: navegação, pesquisa
(→‎Realizando a emissão de um boleto)
Linha 7: Linha 7:
  
 
==Realizando a emissão de um boleto==
 
==Realizando a emissão de um boleto==
 +
 +
===Definição das propriedades de envio===
 +
 +
Antes de iniciarmos com os exemplos. Verifique as definições dos campos para o envio dos boletos.
 +
 +
<div class="center">
 +
<table border=1 cellpadding=0 cellspacing=0 style='width: 800px;border-collapse: collapse;'>
 +
<tr>
 +
<th>Nome</th>
 +
<th>Tipo</th>
 +
<th>Descrição</th>
 +
<th>Obrigatoriedade</th>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">agencia</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Código da Cooperativa do beneficiário</td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">posto</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Código do Posto do beneficiário</td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">cedente</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Código do Convênio de Cobrança do beneficiário</td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">nossoNumero</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Nosso Número </td>
 +
<td style="text-align: left;">Opcional</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">codigoPagador</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Código Pagador </td>
 +
<td style="text-align: left;">Opcional</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">tipoPessoa</td>
 +
<td style="text-align: left;">Domínios:
 +
<br/>1
 +
<br/>2
 +
</td>
 +
<td style="text-align: left;">Tipo de pessoa do pagador, podendo ser:
 +
<br/>1 - PESSOA FISICA
 +
<br/>2 - PESSOA JURIDICA
 +
</td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">cpfCnpj</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">CPF e/ou CNPJ do pagador </td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">nome</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Nome do pagador </td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">endereco</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Endereço do pagador</td>
 +
<td style="text-align: left;">Opcional. Será obrigatório se o código do pagador não for informado.</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">cidade</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Cidade do pagador</td>
 +
<td style="text-align: left;">Opcional. Será obrigatório se o código do pagador não for informado.</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">uf</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Estado do pagador</td>
 +
<td style="text-align: left;">Opcional. Será obrigatório se o código do pagador não for informado.</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">cep</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">CEP do pagador </td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">telefone</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Telefone mais DDD do pagador</td>
 +
<td style="text-align: left;">Opcional. Será obrigatório se o código do pagador não for informado.</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">email</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Endereço de E mail do pagador.</td>
 +
<td style="text-align: left;">Opcional. Será obrigatório se o código do pagador não for informado.</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">especieDocumento</td>
 +
<td style="text-align: left;">Domínios:
 +
<br/>A
 +
<br/>B
 +
<br/>C
 +
<br/>D
 +
<br/>E
 +
<br/>G
 +
<br/>H
 +
<br/>I
 +
<br/>J
 +
<br/>K
 +
<br/>O
 +
</td>
 +
<td style="text-align: left;">Espécie de documento do título,</td>
 +
<td style="text-align: left;">Obrigatório
 +
<br/>Podendo ser:
 +
<br/>A - DUPLICATA MERCANTIL (DM)
 +
<br/>B - DUPLICATA RURAL (DR)
 +
<br/>C - NOTA PROMISSOR IA (NP)
 +
<br/>D - NOTA PROMISSOR IA RURAL (NR)
 +
<br/>E - NOTA DE SEGURO (NS)
 +
<br/>G - RECIBO (RC)
 +
<br/>H - LETRA DE CAMBIO (LC)
 +
<br/>I - NOTA DE DEBITO (ND)
 +
<br/>J - DUPLICATA DE SERVICO (DS)
 +
<br/>K - OUTROS (OS)
 +
<br/>O - BOLETO OFERTA (OFE)
 +
</td>
 +
</tr>
 +
<td style="text-align: left;">codigoSacador Avalista </td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Código do sacador avalista. Se não existir, enviar ‘000'</td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">seuNumero</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Número de controle interno do beneficiário que referência o pagador.</td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">dataVencimento</td>
 +
<td style="text-align: left;">Data</td>
 +
<td style="text-align: left;">Data de vencimento do boleto</td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">valor</td>
 +
<td style="text-align: left;">Decimal</td>
 +
<td style="text-align: left;">Valor do boleto</td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">tipoDesconto</td>
 +
<td style="text-align: left;">Domínios:
 +
<br/>A 
 +
<br/>B
 +
</td>
 +
<td style="text-align: left;">Tipo de desconto, podendo ser: 
 +
<br/>A - VALOR 
 +
<br/>B - PERCENTUAL
 +
</td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">valorDesconto 1</td>
 +
<td style="text-align: left;">Decimal</td>
 +
<td style="text-align: left;">Valor de desconto 1</td>
 +
<td style="text-align: left;">Opcional. Será obrigatório se o dataDesconto1 for informado.</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">dataDesconto1</td>
 +
<td style="text-align: left;">Data</td>
 +
<td style="text-align: left;">Data limite para a concessão de desconto 1</td>
 +
<td style="text-align: left;">Opcional. Será obrigatório se o valorDesconto1 for informado.</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">valorDesconto 2</td>
 +
<td style="text-align: left;">Decimal</td>
 +
<td style="text-align: left;">Valor de desconto 2</td>
 +
<td style="text-align: left;">Opcional. Será obrigatório se o dataDesconto2 for informado.</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">dataDesconto2</td>
 +
<td style="text-align: left;">Data</td>
 +
<td style="text-align: left;">Data limite para a concessão de desconto 2</td>
 +
<td style="text-align: left;">Opcional. Será obrigatório se o valorDesconto2 for informado.</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">valorDesconto 3</td>
 +
<td style="text-align: left;">Decimal</td>
 +
<td style="text-align: left;">Valor de desconto 3</td>
 +
<td style="text-align: left;">Opcional. Será obrigatório se o dataDesconto3 for informado.</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">dataDesconto3</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Data limite para a concessão de desconto 3</td>
 +
<td style="text-align: left;">Opcional. Será obrigatório se o valorDesconto3 for informado.</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">tipoJuros</td>
 +
<td style="text-align: left;">Domínios:
 +
<br/>A
 +
<br/>B
 +
</td>
 +
<td style="text-align: left;">Tipo de Juros, podendo ser: 
 +
<br/>A - VALOR 
 +
<br/>B - PERCENTUAL
 +
</td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">juros</td>
 +
<td style="text-align: left;">Decimal</td>
 +
<td style="text-align: left;">Valor de juros a cobrar por dia </td>
 +
<td style="text-align: left;">Opcional</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">multas</td>
 +
<td style="text-align: left;">Decimal</td>
 +
<td style="text-align: left;">Valor de multas a cobrar </td>
 +
<td style="text-align: left;">Opcional</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">descontoAntecipado</td>
 +
<td style="text-align: left;">Decimal</td>
 +
<td style="text-align: left;">Valor de desconto antecipado a cobrar</td>
 +
<td style="text-align: left;">Opcional. Deve ser menor que o valor.
 +
            </td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">Informativo</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Texto do Informativo </td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">mensagem</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Texto da linha da mensagem. </td>
 +
<td style="text-align: left;">Obrigatório</td>
 +
</tr>
 +
<tr>
 +
<td style="text-align: left;">codigoMensagem</td>
 +
<td style="text-align: left;">String</td>
 +
<td style="text-align: left;">Código da mensagem </td>
 +
<td style="text-align: left;">Opcional</td>
 +
</tr></table>
 +
</div>
 +
 
===Caso de Sucesso===
 
===Caso de Sucesso===
 
<div class="center">
 
<div class="center">

Edição das 14h52min de 16 de maio de 2018

E-Boleto - Sistema emissor de boletos eletrônicos.

Acessando a API

Para realizar o acesso à API é necessário estar logado no serviço.
Verifique como realizar a autenticação na página Autenticando na API.

Realizando a emissão de um boleto

Definição das propriedades de envio

Antes de iniciarmos com os exemplos. Verifique as definições dos campos para o envio dos boletos.

</tr>

Nome Tipo Descrição Obrigatoriedade
agencia String Código da Cooperativa do beneficiário Obrigatório
posto String Código do Posto do beneficiário Obrigatório
cedente String Código do Convênio de Cobrança do beneficiário Obrigatório
nossoNumero String Nosso Número Opcional
codigoPagador String Código Pagador Opcional
tipoPessoa Domínios:


1
2

Tipo de pessoa do pagador, podendo ser:


1 - PESSOA FISICA
2 - PESSOA JURIDICA

Obrigatório
cpfCnpj String CPF e/ou CNPJ do pagador Obrigatório
nome String Nome do pagador Obrigatório
endereco String Endereço do pagador Opcional. Será obrigatório se o código do pagador não for informado.
cidade String Cidade do pagador Opcional. Será obrigatório se o código do pagador não for informado.
uf String Estado do pagador Opcional. Será obrigatório se o código do pagador não for informado.
cep String CEP do pagador Obrigatório
telefone String Telefone mais DDD do pagador Opcional. Será obrigatório se o código do pagador não for informado.
email String Endereço de E mail do pagador. Opcional. Será obrigatório se o código do pagador não for informado.
especieDocumento Domínios:


A
B
C
D
E
G
H
I
J
K
O

Espécie de documento do título, Obrigatório


Podendo ser:
A - DUPLICATA MERCANTIL (DM)
B - DUPLICATA RURAL (DR)
C - NOTA PROMISSOR IA (NP)
D - NOTA PROMISSOR IA RURAL (NR)
E - NOTA DE SEGURO (NS)
G - RECIBO (RC)
H - LETRA DE CAMBIO (LC)
I - NOTA DE DEBITO (ND)
J - DUPLICATA DE SERVICO (DS)
K - OUTROS (OS)
O - BOLETO OFERTA (OFE)

codigoSacador Avalista String Código do sacador avalista. Se não existir, enviar ‘000' Obrigatório
seuNumero String Número de controle interno do beneficiário que referência o pagador. Obrigatório
dataVencimento Data Data de vencimento do boleto Obrigatório
valor Decimal Valor do boleto Obrigatório
tipoDesconto Domínios:


A
B

Tipo de desconto, podendo ser:


A - VALOR
B - PERCENTUAL

Obrigatório
valorDesconto 1 Decimal Valor de desconto 1 Opcional. Será obrigatório se o dataDesconto1 for informado.
dataDesconto1 Data Data limite para a concessão de desconto 1 Opcional. Será obrigatório se o valorDesconto1 for informado.
valorDesconto 2 Decimal Valor de desconto 2 Opcional. Será obrigatório se o dataDesconto2 for informado.
dataDesconto2 Data Data limite para a concessão de desconto 2 Opcional. Será obrigatório se o valorDesconto2 for informado.
valorDesconto 3 Decimal Valor de desconto 3 Opcional. Será obrigatório se o dataDesconto3 for informado.
dataDesconto3 String Data limite para a concessão de desconto 3 Opcional. Será obrigatório se o valorDesconto3 for informado.
tipoJuros Domínios:


A
B

Tipo de Juros, podendo ser:


A - VALOR
B - PERCENTUAL

Obrigatório
juros Decimal Valor de juros a cobrar por dia Opcional
multas Decimal Valor de multas a cobrar Opcional
descontoAntecipado Decimal Valor de desconto antecipado a cobrar Opcional. Deve ser menor que o valor.
Informativo String Texto do Informativo Obrigatório
mensagem String Texto da linha da mensagem. Obrigatório
codigoMensagem String Código da mensagem Opcional

Caso de Sucesso

Endpoint https://erpnet.online/api/eboleto/emitir
Método POST
Body
(JSON)		 
{
  "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
}
O código do banco utilizado é o 748, pois apenas o Sicredi é aceito até o momento.
Retorno
(DATA)		 
{
    "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
}

É retornado o boleto emitido em caso de sucesso. Propriedade Success = true.

Caso seja retornado Success = false verifique a mensagem de erro em Message

Caso de falha

Endpoint https://erpnet.online/api/eboleto/emitir
Método POST
Body
(JSON)		 
{
  "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
}
O código do banco utilizado é o 748, pois apenas o Sicredi é aceito até o momento.
Retorno
(DATA)		 
{
    "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
}

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.

Realizando a consulta de vários boletos emitidos

Caso de Sucesso

Endpoint https://erpnet.online/api/eboleto/consultar?Agencia=NÚMERO DA AGÊNCIA&Cedente=CÓDIGO DO CEDENTE&Posto=NÚMERO DO POSTO&NossoNumero=NÚMERO DO BOLETO NO BANCO&CodigoBanco=CÓDIGO DO BANCO
Método GET
QUERYSTRING 
Todos os parâmetros são opcionais, caso seja informado no ERP.Net.
Caso contrário, são obrigatórios serem informados os parâmetros Agencia, Cedente, Posto e CodigoBanco.
  • Agência: Informar o número de sua agência para pesquisa de boletos;
  • Cedente: Informar o código do Cedente vinculado ao boleto;
  • Posto: Informar o código do posto de seu banco;
  • NossoNumero: Se informado, realiza a pesquisa apenas do boleto em questão;
  • CodigoBanco: Se configurado no ERP.Net, não é necessário passar este parâmetro.
Retorno
(DATA)		 
{
  "Data": [
    {
      "DataEmissao": "2018-03-23T00:00:00",
      "DataLiquidacao": null,
      "DataVencimento": "2016-08-26T00:00:00",
      "NomePagador": "TESTE",
      "NossoNumero": "181000013",
      "Parametro": null,
      "SeuNumero": "1234567891",
      "Situacao": "BAIXADO POR SOLICITACAO",
      "Valor": 10.5,
      "ValorLiquidado": 0,
      "Codigo": null,
      "Mensagem": null,
      "Success": true
    },
    {
      "DataEmissao": "2018-03-23T00:00:00",
      "DataLiquidacao": null,
      "DataVencimento": "2016-08-26T00:00:00",
      "NomePagador": "TESTE",
      "NossoNumero": "181000021",
      "Parametro": null,
      "SeuNumero": "1234567891",
      "Situacao": "BAIXADO POR SOLICITACAO",
      "Valor": 10.5,
      "ValorLiquidado": 0,
      "Codigo": null,
      "Mensagem": null,
      "Success": true
    },
    {
      "DataEmissao": "2018-05-15T00:00:00",
      "DataLiquidacao": null,
      "DataVencimento": "0001-01-01T00:00:00",
      "NomePagador": "TESTE",
      "NossoNumero": "181000242",
      "Parametro": null,
      "SeuNumero": "1234567891",
      "Situacao": "EM CARTEIRA",
      "Valor": 10,
      "ValorLiquidado": 0,
      "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
}

Caso de Falha

Para simular a falha, iremos omitir o parâmetro Agencia.

Endpoint https://erpnet.online/api/eboleto/consultar?Agencia=NÚMERO DA AGÊNCIA&Cedente=CÓDIGO DO CEDENTE&Posto=NÚMERO DO POSTO&NossoNumero=NÚMERO DO BOLETO NO BANCO&CodigoBanco=CÓDIGO DO BANCO
Método GET
QUERYSTRING 
Todos os parâmetros são opcionais, caso seja informado no ERP.Net.
Caso contrário, são obrigatórios serem informados os parâmetros Agencia, Cedente, Posto e CodigoBanco.
  • Agência: Informar o número de sua agência para pesquisa de boletos;
  • Cedente: Informar o código do Cedente vinculado ao boleto;
  • Posto: Informar o código do posto de seu banco;
  • NossoNumero: Se informado, realiza a pesquisa apenas do boleto em questão;
  • CodigoBanco: Se configurado no ERP.Net, não é necessário passar este parâmetro.
Retorno
(DATA)		 
{
    "Data": [
        {
            "DataEmissao": null,
            "DataLiquidacao": null,
            "DataVencimento": null,
            "NomePagador": null,
            "NossoNumero": null,
            "Parametro": "agencia",
            "SeuNumero": null,
            "Situacao": null,
            "Valor": null,
            "ValorLiquidado": null,
            "Codigo": "E0010",
            "Mensagem": "Campo obrigatorio em branco. - Parâmetro: agencia",
            "Success": false
        }
    ],
    "Message": "Campo obrigatorio em branco. - Parâmetro: agencia",
    "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
}


Realizando a consulta de um boleto emitido

Caso de Sucesso

Pegue um NossoNumero válido para utilizar neste teste, caso contrário será retornado uma falha, como no exemplo do teste com falha.

Endpoint https://erpnet.online/api/eboleto/consultar?Agencia=NÚMERO DA AGÊNCIA&Cedente=CÓDIGO DO CEDENTE&Posto=NÚMERO DO POSTO&NossoNumero=NÚMERO DO BOLETO NO BANCO&CodigoBanco=CÓDIGO DO BANCO
Método GET
QUERYSTRING 
Com exceção do parâmetro NossoNumero os demais parâmetros são opcionais, caso sejam informados no ERP.Net.
Caso contrário, são obrigatórios serem informados os parâmetros Agencia, Cedente, Posto e CodigoBanco.
  • Agência: Informar o número de sua agência para pesquisa de boletos;
  • Cedente: Informar o código do Cedente vinculado ao boleto;
  • Posto: Informar o código do posto de seu banco;
  • CodigoBanco: Se configurado no ERP.Net, não é necessário passar este parâmetro.
Parâmetro Obrigatório
  • NossoNumero: Realiza a pesquisa apenas do boleto em questão;
Retorno
(DATA)		 
{
    "Data": [
        {
            "DataEmissao": "2018-05-15T00:00:00Z",
            "DataLiquidacao": null,
            "DataVencimento": "0001-01-01T00:00:00Z",
            "NomePagador": "TESTE",
            "NossoNumero": "181000242",
            "Parametro": "",
            "SeuNumero": "1234567891",
            "Situacao": "BAIXADO POR SOLICITACAO",
            "Valor": 10,
            "ValorLiquidado": 0,
            "Codigo": "",
            "Mensagem": "",
            "Success": true
        }
    ],
    "Message": "",
    "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
}

Caso de Falha

Para simular a falha, iremos passar um NossoNumero incorreto.

Endpoint https://erpnet.online/api/eboleto/consultar?Agencia=NÚMERO DA AGÊNCIA&Cedente=CÓDIGO DO CEDENTE&Posto=NÚMERO DO POSTO&NossoNumero=NÚMERO INCORRETO DO BOLETO NO BANCO&CodigoBanco=CÓDIGO DO BANCO
Método GET
QUERYSTRING 
Todos os parâmetros são opcionais, caso seja informado no ERP.Net.
Caso contrário, são obrigatórios serem informados os parâmetros Agencia, Cedente, Posto e CodigoBanco.
  • Agência: Informar o número de sua agência para pesquisa de boletos;
  • Cedente: Informar o código do Cedente vinculado ao boleto;
  • Posto: Informar o código do posto de seu banco;
  • NossoNumero: Se informado, realiza a pesquisa apenas do boleto em questão;
  • CodigoBanco: Se configurado no ERP.Net, não é necessário passar este parâmetro.
Retorno
(DATA)		 
{
    "Data": [
        {
            "DataEmissao": null,
            "DataLiquidacao": null,
            "DataVencimento": null,
            "NomePagador": "",
            "NossoNumero": "",
            "Parametro": "",
            "SeuNumero": "",
            "Situacao": "",
            "Valor": null,
            "ValorLiquidado": null,
            "Codigo": "E0024",
            "Mensagem": "Nao foram encontrados resultados para os filtros de consulta informados. - Parâmetro: ",
            "Success": false
        }
    ],
    "Message": "Nao foram encontrados resultados para os filtros de consulta informados. - Parâmetro: ",
    "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
}
Disponível em "http://wiki.unimake.com.br/index.php?title=Manuais:ERP.Net/API/EBoleto&oldid=556"