¶
¶ Sicoob API V2 - Boleto híbrido
A integração da API bancária do banco Sicoob na versão 2 dispõe de uma nova tecnologia, onde é possível gerar um boleto híbrido, e o cliente tem a opção de pagar pelo código de barras ou via QR-Code Pix.
¶ Registro dos boletos:
Para as carteiras de cobrança do tipo API e Gateway, a comunicação do boleto ocorre ao requisitar a impressão/PDF pela interface do IXC, onde o comando de comunicação/impressão é solicitado ao banco, também realizando o registro desse boleto no sistema bancário.
O registro dos boletos pela carteira de API pode ser feito de três formas:
- Gerando o PDF/Imprimindo o boleto no financeiro do cliente.
- Realizando a comunicação em massa com o gateway.
- Ou pela rotina de envio de faturas via e-mail automático.
O envio de faturas via e-mail automático não é recomendado, pois se a fatura não puder ser gerada por qualquer inconsistência nos dados cadastrais do cliente ou por algum problema com a fatura em sí, isto irá travar a tarefa de envio de e-mails, e não irá realizar a comunicação do boleto.
A forma de registro de boletos mais recomendada é a comunicação em massa com o gateway. Pois facilita na demanda de registro de grandes quantidades de boletos.
A comunicação em massa seria como o envio das remessas ao banco em uma carteira tradicional/manual.
Você pode fazer essa comunicação em intervalos de tempo, como algumas formas de exemplo:
-Diária
-Semanal
-Mensal
ou como desejar.
¶ Prazo de baixa de pagamento:
¶ Pagando por Pix:
Diferente do método de pagamento de Pix avulso (Webhook), as carteiras de Gateway e API bancária tem seu prazo de baixa no mesmo dia do pagamento, porém elas são reconhecidas no sistema somente quando rodar a tarefa de consulta de baixas de pagamento em seu servidor.
¶ Pagando pelo código de barras:
Se o pagamento for efetuado pelo código de barras tradicional, o tempo de baixa no sistema é o mesmo de um boleto simples (até 2 dias úteis), e irá baixar no sistema assim que rodar sua tarefa de consulta de baixas de pagamento.
¶ Disponibilidade do código Pix:
O Pix fica disponível na impressão do boleto, na Central do assinante, Opa! Suíte, e pelo sistema IXC utilizando o botão de “Copiar código PIX” na aba financeiro do cadastro do cliente.
É possível escolher se irá utilizar o PIX no boleto ou não.
Caso tenha sua carteira Sicoob API na versão V1, você pode entrar em contato com o Suporte de Carteira de Cobrança e solicitar a atualização da sua carteira.
Não é necessário homologar uma nova carteira, apenas gerar um novo client_id no Site Developer do Sicoob.
Observações: No Cadastro do Cliente, o Sicoob só permite que os campos: Nome, Endereço (Rua), e nas Instruções dos boletos contenham no máximo 40 caracteres, caso exceda este limite, o boleto não será comunicado.
Para mais informações, consulte o Manual da Sicoob API V2 - Cobrança Híbrida.
¶ Como realizar a integração
Primeiramente, contate o Suporte de Carteira de Cobrança da IXC Soft. Para realizar a integração de sua cartera de API Sicoob V2 no IXC Soft, você irá precisar de alguns dados, sendo eles:
- Numero da Agência com dígito verificador.
- Numero da Conta com dígito verificador.
- Número do Convênio, Código beneficiário ou Cedente (pode constar com um destes nomes depedendo do Banco).
- Client_ID.
As informações de 1 à 3 você pode solicitar ao seu Gerente de Contas do Banco, exceto pela última informação, que você como titular da conta bancária precisa gerar:
4. Client_ID.
Retornar à Sicoob API
Retorne ao menu Carteira de Cobrança