Documentação para Desenvolvedores

Registro de Remessa

Recurso Descrição
GET /api/v1/bank_billet_remittances Listar Registros de Remessa
GET /api/v1/bank_billet_remittances/pending Listar Registros de Remessa pendentes
POST /api/v1/bank_billet_remittances/:id/occurrence/:code Criar pendências

Modelo de Dados

Parâmetro Obr. Tipo Tamanho Descrição
id N/A Integer   ID da carteira
our_code Sim String 6 Código de operação de registro no banco (Possíveis valores)
occurrence Não String 3 Ocorrência
remittance_id Sim Integer   ID da Remessa
bank_billet_id Sim Integer   ID do Boleto
bank_billet_account_id Sim Integer   ID da Carteira
processed_at Não Date   Quando foi processado
occurrence_detail Não String   Descrição do evento na Remessa

Dicionário de Dados

our_code

1001 Entrada de Título
1002 Pedido de Baixa
1009 Protestar
1010 Não Protestar
1011 Protesto para fins falimentares
1018 Sustar o protesto
1034 Pago diretamente ao beneficiário
1047 Não cobrar juros
1066 Solicitar negativação expressa
1067 Não negativar
1068 Excluir negativação expressa
1069 Cancelar negativação expressa

Listar Registros de Remessa

GET /api/v1/bank_billet_remittances

Parâmetro Obr. Tipo Descrição
page Não Number Número da Página
per_page Não Number Quantidade de registros por página (Maximo de 250)
code Não String Código de operação de registro no banco (Possíveis valores). Obrigatório os parâmetros expire_from, expire_to, bank_billet_account_id
bank_billet_account_id Não Number ID da Carteira. Obrigatório os parâmetros expire_from, expire_to, code
expire_from Não Date A partir de Data de vencimento. Obrigatório os parâmetros expire_to, code, bank_billet_account_id
expire_to Não Date Até Data de vencimento. Obrigatório os parâmetros expire_from, code, bank_billet_account_id

Exemplo de requisição válida

Requisição:
  curl -i \
  -u $BOLETOSIMPLES_TOKEN:x \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: MyApp (myapp@example.com)' \
  -X GET 'https://sandbox.boletosimples.com.br/api/v1/bank_billet_remittances?page=1&per_page=50'
Resposta:
Server: Cowboy
Connection: keep-alive
Strict-Transport-Security: max-age=2592000
Total: 1
Content-Type: application/json; charset=utf-8
...

[
  {
    "id":47,
    "our_code": "1001",
    "occurrence": "01",
    "remittance_id":null,
    "bank_billet_id":46,
    "bank_billet_account_id":2,
    "processed_at":null,
    "occurrence_detail": "Entrada de Título",
    "created_at": "2017-11-21",
    "bank_billet":{
      "id":46,
      "expire_at": "2017-12-26",
      "paid_at":null,
      "description": "teste",
      "status": "opened",
      ...
    }
  }
]

Listar Registros de Remessa pendentes

GET /api/v1/bank_billet_remittances/pending

Parâmetro Obr. Tipo Descrição
page Não Number Número da Página

Exemplo de requisição válida

Requisição:
  curl -i \
  -u $BOLETOSIMPLES_TOKEN:x \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: MyApp (myapp@example.com)' \
  -X GET 'https://sandbox.boletosimples.com.br/api/v1/bank_billet_remittances/pending?page=1'
Resposta:
Server: Cowboy
Connection: keep-alive
Strict-Transport-Security: max-age=2592000
Total: 1
Content-Type: application/json; charset=utf-8
...

[
  {
    "id":40,
    "our_code": "1001",
    "occurrence": "01",
    "remittance_id":null,
    "bank_billet_id":46,
    "bank_billet_account_id":2,
    "processed_at":null,
    "occurrence_detail": "Entrada de Título",
    "created_at": "2017-11-21",
    "bank_billet":{
      "id":46,
      "expire_at": "2017-12-26",
      "paid_at":null,
      "description": "teste",
      "status": "opened",
      ...
    }
  }
]

Criar pendências

POST /api/v1/bank_billet_remittances/:id/occurrence/:code

Parâmetro Obr. Tipo Descrição
id Sim Number ID do boleto
code Sim Number Código de operação de registro no banco (Possíveis valores)

Exemplo de requisição inválida

Requisição:
curl -i \
-u $BOLETOSIMPLES_TOKEN:x \
-H 'Content-Type: application/json' \
-H 'User-Agent: MyApp (myapp@example.com)' \
-X POST 'https://sandbox.boletosimples.com.br/api/v1/bank_billet_remittances/2/occurrence/9989x'
Resposta:
HTTP/1.1 422 Unprocessable Entity
Server: Cowboy
Connection: keep-alive
Strict-Transport-Security: max-age=2592000
Content-Type: application/json; charset=utf-8
...

{"errors": "Operação não disponível para este banco."}

Exemplo de requisição válida

Requisição:
curl -i \
-u $BOLETOSIMPLES_TOKEN:x \
-H 'Content-Type: application/json' \
-H 'User-Agent: MyApp (myapp@example.com)' \
-X POST 'https://sandbox.boletosimples.com.br/api/v1/bank_billet_remittances/2/occurrence/1034'
Resposta:
HTTP/1.1 201 Created
Server: Cowboy
Connection: keep-alive
Strict-Transport-Security: max-age=2592000
Content-Type: application/json; charset=utf-8
...

{ message: "Boleto 2 - Operação( Pago diretamente ao beneficiário ) colocado(a) na lista de envio para o banco." }