Melhoria no Boleto WS Sicoob

[ARConsultoria]

Boa tarde.

Iniciei o desenvolvimento pra utilização do boleto online sicoob e durante o registro ocorreu tudo ok, o problema foi na hora de consultar os títulos registrados e principalmente os pagos.

Vi que atualmente o sicoob só tem a opção tpConsultaDetalhe, que necessita que seja passado os dados do boleto(nosso número ou linha digitável) para que seja verificado se o mesmo foi pago. O que se torna inviável na realidade de alguns dos meus clientes que podem ter milhares de títulos em aberto.

Analisei a API do sicoob e entrei em contato com o suporte do banco e vi que existe um endpoint que retorna a movimentação de um período X a Y, não é a melhor forma, mas é o que tem.

Sendo assim, solicito que seja adicionada a opção tpConsulta ao banco sicoob consumindo esses dados.

Abaixo tentarei ser o mais claro possível pra ajudar na implementação, em caso de dúvidas estou à disposição.

Link da documentação: https://developers.sicoob.com.br/portal/apis

1) Obter o access token na mesma URL de autenticação que já é utilizada pra emissão dos boletos. O diferencial é ter que adicionar esses 3 scopes(sugiro até editar o tópico principal dos boletos por WS adicionando estes):

- cobranca_boletos_solicitacao_movimentacao_incluir
- cobranca_boletos_solicitacao_movimentacao_consultar
- cobranca_boletos_solicitacao_movimentacao_download

2) POST em /boletos/solicitacoes/movimentacao passando o período e o tipo da movimentação

- Será retornado o "codigoSolicitacao"

3) GET em /boletos/solicitacoes/movimentacao passando o "codigoSolicitacao"

- Será retornado um array de idArquivos a depender da quantidade de registros do período

4) GET em /boletos/movimentacao-download passando o "codigoSolicitacao" e um "idArquivo" por vez

- Será retornado um BASE64 de um arquivo .ZIP, dentro desse arquivo .ZIP haverá um arquivo .json onde de fato serão apresentados os boletos do período e que deverá alimentar a "ListaConsultaRetornoWeb" do ACBrBoleto.

Abaixo um exemplo do conteúdo desse arquivo .json
 

[
   {
      "siglaMovimento":"LIQUI",
      "dataInicioMovimento":"2023-05-24T00:00:00-03:00",
      "dataFimMovimento":"2023-05-25T00:00:00-03:00",
      "numeroCliente":36307,
      "numeroContrato":36307,
      "modalidade":1,
      "numeroTitulo":39548,
      "seuNumero":"NFE 24274-1/1",
      "dataVencimentoTitulo":"2023-06-15T00:00:00-03:00",
      "valorTitulo":145.9300,
      "codigoBarras":"75691938200000145931517701003630700039548001",
      "dataMovimentoEntrada":"",
      "dataEmissaoDocumento":"",
      "dataLimitePagamento":"",
      "numeroContaCorrente":60151,
      "valorTarifaMovimento":2.0000,
      "dataMovimentoProrrogacao":"",
      "dataVencimentoAnterior":"",
      "valorAbatimento":0.0000,
      "dataMovimentoLiquidacao":"2023-05-24T00:00:00-03:00",
      "dataLiquidacao":"2023-05-24T00:00:00-03:00",
      "dataPrevisaoCredito":"2023-05-24T00:00:00-03:00",
      "numeroBancoRecebedor":1,
      "numeroAgenciaRecebedora":2256,
      "idTipoOpFinanceira":58,
      "valorDesconto":0.0000,
      "valorMora":0.0000,
      "valorLiquido":145.9300
   },
   {
      "siglaMovimento":"LIQUI",
      "dataInicioMovimento":"2023-05-24T00:00:00-03:00",
      "dataFimMovimento":"2023-05-25T00:00:00-03:00",
      "numeroCliente":36307,
      "numeroContrato":36307,
      "modalidade":1,
      "numeroTitulo":39451,
      "seuNumero":"NFE 24229-1/1",
      "dataVencimentoTitulo":"2023-05-23T00:00:00-03:00",
      "valorTitulo":68.7700,
      "codigoBarras":"75696935900000068771517701003630700039451001",
      "dataMovimentoEntrada":"",
      "dataEmissaoDocumento":"",
      "dataLimitePagamento":"",
      "numeroContaCorrente":60151,
      "valorTarifaMovimento":2.0000,
      "dataMovimentoProrrogacao":"",
      "dataVencimentoAnterior":"",
      "valorAbatimento":0.0000,
      "dataMovimentoLiquidacao":"2023-05-24T00:00:00-03:00",
      "dataLiquidacao":"2023-05-24T00:00:00-03:00",
      "dataPrevisaoCredito":"2023-05-24T00:00:00-03:00",
      "numeroBancoRecebedor":1,
      "numeroAgenciaRecebedora":2256,
      "idTipoOpFinanceira":58,
      "valorDesconto":0.0000,
      "valorMora":0.1100,
      "valorLiquido":68.8800
   }
]

 

Espero que tenha sido claro. Caso haja algo em inconformidade me avisem que corrigirei. Obrigado pela atenção.

[Daniel InfoCotidiano]

Tópico movido para a área do SAC, para que o SLA de respostas seja considerado

[Juliomar Marchetti]

Boa já modifiquei no tópico

https://www.projetoacbr.com.br/forum/topic/57991-acbrboleto-via-webservice/?do=findComment&comment=465974&_rid=19

[Daniel InfoCotidiano]

@ARConsultoria
Foi criado uma TK-4012. Ela vai entrar no backlog para análise do time de boleto.

[tiautomacao]

Bom dia, também estou tentando , mas até agora sem sucesso, gerar este extrato dos boletos liquidados. De fato, nosso amigo colocou exatamente o que precisa ser feito. É feito em 3 etapas, quando fui tentar alterar a primeira etapa, para consegui o primeiro código não obtive êxito. 

Este é o scopo da primeira solitiação, fiz pelo postman e deu certinho.


 a

Ele retorna um código que é utilizado no segundo comando enviado:



Com este código recebido envia na terceira solicitação.







O resultado final é este, um link em formato base64 que ao ser convertido se torna um jason com os titulos

[tiautomacao]

Irei postar aqui as units que iniciei as alterações.

AcbrBoletoRet_Bancoob  - DefinirUrl 

If Boleto.Configuracoes.WebService.Operacao = tpConsulta then begin
     FPURL := FPURL + '/boletos/solicitacoes/movimentacao';
End;

Na mesa unit.
GerarDados
  tpConsulta:
      begin
        FMetodoHTTP := htPOST;
        RequisicaoMovimento;
      end;

Criei esta RequisicoesMovimento

procedure RequisicaoMovimento;
var
 Dtinicio : string;
begin
   FPDadosMsg := '{';
   FPDadosMsg := FPDadosMsg + '"numeroContrato": '+Boleto.Cedente.Convenio+',';
   FPDadosMsg := FPDadosMsg + '"tipoMovimento": 5,';
   FPDadosMsg := FPDadosMsg + '"dataInicial": "'+FormatDateBr(Boleto.Configuracoes.WebService.Filtro.dataMovimento.DataInicio,'YYYY-MM-DD')+ 'T00:00:00-03:00",';
   FPDadosMsg := FPDadosMsg + '"dataFinal": "'+FormatDateBr(Boleto.Configuracoes.WebService.Filtro.dataMovimento.DataFinal,'YYYY-MM-DD')+ 'T00:00:00-03:00"';
   FPDadosMsg := FPDadosMsg + '}';
end;

*Aqui eu já sai fora do padrão ACBR , mas deu certo desta forma, consegui chegar no primeiro codigo. Porém para pegar este retorno não consegiu.

[Juliomar Marchetti]

Em 06/06/2023 at 09:55, tiautomacao disse:

Irei postar aqui as units que iniciei as alterações.

AcbrBoletoRet_Bancoob  - DefinirUrl 

If Boleto.Configuracoes.WebService.Operacao = tpConsulta then begin
     FPURL := FPURL + '/boletos/solicitacoes/movimentacao';
End;

Na mesa unit.
GerarDados
  tpConsulta:
      begin
        FMetodoHTTP := htPOST;
        RequisicaoMovimento;
      end;

Criei esta RequisicoesMovimento

procedure RequisicaoMovimento;
var
 Dtinicio : string;
begin
   FPDadosMsg := '{';
   FPDadosMsg := FPDadosMsg + '"numeroContrato": '+Boleto.Cedente.Convenio+',';
   FPDadosMsg := FPDadosMsg + '"tipoMovimento": 5,';
   FPDadosMsg := FPDadosMsg + '"dataInicial": "'+FormatDateBr(Boleto.Configuracoes.WebService.Filtro.dataMovimento.DataInicio,'YYYY-MM-DD')+ 'T00:00:00-03:00",';
   FPDadosMsg := FPDadosMsg + '"dataFinal": "'+FormatDateBr(Boleto.Configuracoes.WebService.Filtro.dataMovimento.DataFinal,'YYYY-MM-DD')+ 'T00:00:00-03:00"';
   FPDadosMsg := FPDadosMsg + '}';
end;

*Aqui eu já sai fora do padrão ACBR , mas deu certo desta forma, consegui chegar no primeiro codigo. Porém para pegar este retorno não consegiu.

Estou tentando ajustar isso para o ACBr pois estou utilizando o mesmo em produção já! se tiver novidades posto aqui e aviso o commit

[Victor H. Gonzales - Panda]

podem enviar as credenciais por email?

[Daniel InfoCotidiano]

Bom dia @ARConsultoria e @tiautomacao !
Infelizmente em nossos testes algumas requisições demoraram 15 minutos para serem concluídas.
Enquanto isso recebíamos a reposta “Solicitação ainda em processamento”.

Nosso amigo @tiautomacao falou com o banco e recebemos a reposta:
 

"INFORMAÇÃO IMPORTANTE:
Conversei com nossa gerente financeira agora e ela disse assim:
1-Se no dia do Registro ela pedir o arquivo de boletos baixados, demora 20 minutos ou mais, (pelo site)
2-Se for em outros dias, que ela não registra nada, demorar entre 10 e 15 minutos para liberar o arquivo.
Então, a API demorar 15 minutos está super normal. Está dentro da normalidade viu."

Como o componente não pode ficar aguardando 15 minutos uma reposta, fica inviável implementar esta consulta.

Neste caso sugerimos tratar o retorno via arquivo CNAB.

[ARConsultoria]

Obrigado pelo retorno @Daniel InfoCotidiano.

[Alexandre de Paula]

Obrigado por reportar.

Fechando. Para novas dúvidas, criar um novo tópico.