API de Cobranças

Faça a gestão completa de sua carteira de cobranças utilizando a nossa API de Cobranças.

Com a API de cobranças Grafeno, você poderá criar suas cobranças e fazer a gestão de sua carteira, sendo possível consultar, atualizar, dar baixa, protestar e excluir cobranças de forma dinâmica através de nossa API. Além da gestão completa de sua carteira de cobranças, nossa API tem suporte para o envio de webhooks, o que permite que o seu sistema receba em tempo real as atualizações de status de suas cobranças.

🚧

Integração de Cobranças - Vórtx

Atualmente a Grafeno utiliza dois agentes bancarizadores: BMP (274) e Vórtx (310).

Estruturalmente não existem diferenças na integração via API Grafeno entre os dois bancarizadores, ou seja, a API de cobranças Grafeno deve funcionar para a criação de cobranças independente do bancarizador da conta (274 ou 310).

O que muda são algumas regras de negócios entre a Grafeno - BMP e Grafeno - Vórtx, seguem as regras que se aplicam para a integração Grafeno - Vórtx:

1 - Nosso Número: O cálculo do dígito do NN é o mesmo utilizado no layout BMP (274), a única diferença é na seleção do dígito. A Vórtx não utiliza o dígito P, logo, por via de regra, se o resto da divisão for menor do que 2, o dígito será 0 (ZERO).

Se o resto da divisão for 0 (zero), ou se o resultado da subtração for 10 ou 11, o dígito de auto conferência será 0 (zero). Exemplo: Se a soma fosse 77, e 77÷11 tivesse resto 0, então o dígito verificador seria 0.

2 - Regras de negócios relacionadas às cobranças do banco Vórtx (310):

  • Não é possível alterar ou incluir uma definição de abatimento em cobranças já registradas;
  • Não é possível alterar a data de vencimento de uma cobrança que tenha regra de desconto definida;
  • Não é possível alterar o campo de multa de cobranças Vórtx registradas;
  • Não é possível alterar o campo de juros de cobranças Vórtx registradas;
  • Só existe um tipo de registro de boletos na Vórtx, neste caso é o registro online (imediato);
  • É possível alterar o dado "seu número" via API para cobranças Vórtx;
  • É possível alterar a data de vencimento de uma cobrança caso a mesma não tenha nenhuma regra de desconto definida.

3 - Código de barras / linha digitável: Diferente do banco BMP (274), na Vórtx (310), o número da conta na linha digitável do boleto bancário é informado com o dígito da conta.

4 - Carteira: A carteira Vórtx (310) é a 21, o banco é 310VORTX e a agência é a 0001.

5 - Modalidades de cobranças: Atualmente via Vórtx, só é possível gerar cobranças na modalide "Boleto Simples". As modalidades "PIX Cobrança" e "Boleto Híbrido" ainda não estão disponíveis.

👍

Acesse a referência técnica da API de Cobranças: Charges API.