Introdução
A API de Pagamentos DDA oferece duas formas de trabalhar com os arquivos de boletos: o Fluxo Manual e o Fluxo Automático via VAN. Este guia vai ajudá-lo a entender como cada um funciona e qual o melhor caminho para seguir na sua integração.
Fluxo Manual
No fluxo manual, você é responsável por baixar os arquivos DDA diretamente do internet banking do seu banco e enviá-los para a API processar.
Como funciona:
Passo 1: Coletar o arquivo DDA no banco
Acesse o internet banking da sua instituição financeira e faça o download do arquivo DDA disponibilizado pelo banco.
Passo 2: Fazer o upload do arquivo DDA na API
Utilize a rota de upload para enviar o arquivo baixado para a API processar. Neste momento, a API irá gerar um uniqueId que identifica este arquivo.
Consulte a documentação da rota de Upload de Arquivo DDA
Passo 3: Consultar o uniqueId gerado para visualizar os pagamentos
Com o uniqueId do arquivo em mãos, você pode consultar todos os pagamentos (boletos) que estão dentro daquele arquivo específico.
Consulte a documentação da rota de Consulta de Pagamentos do Arquivo
Passo 4: Consultar uniqueId dos pagamentos para obter informações completas
Cada pagamento também possui seu próprio uniqueId. Para visualizar todas as informações detalhadas de um boleto específico, utilize este identificador na rota de consulta individual.
Consulte a documentação da rota de Consulta de Pagamento Individual
Fluxo Automático via VAN
No fluxo automático, a API se conecta diretamente com o banco através da VAN (Value Added Network), eliminando a necessidade de baixar e fazer upload de arquivos manualmente. Tudo acontece de forma automatizada.
Como funciona:
Passo 1: Realizar a consulta dos últimos arquivos DDA conciliados
Ao invés de fazer upload, você simplesmente consulta quais arquivos DDA foram automaticamente conciliados pela VAN. A API retorna uma lista com os uniqueId dos arquivos disponíveis.
Consulte a documentação da rota de Consulta de Arquivos via VAN
Passo 2: Consultar o uniqueId gerado para visualizar os pagamentos
Assim como no fluxo manual, utilize o uniqueId do arquivo para consultar todos os pagamentos contidos nele.
Consulte a documentação da rota de Consulta de Pagamentos do Arquivo
Passo 3: Consultar uniqueId dos pagamentos para obter informações completas
Para visualizar todas as informações detalhadas de um boleto específico, utilize o uniqueId do pagamento na rota de consulta individual.
Consulte a documentação da rota de Consulta de Pagamento Individual
Como solicitar a Transmissão Automática (VAN)
Se você deseja trabalhar com o fluxo automático, é necessário solicitar a ativação da Transmissão Automática junto ao seu banco e à Tecnospeed. O processo completo está documentado em:
Como solicitar a Transmissão Automática junto ao banco
Qual fluxo devo escolher?
Fluxo Manual é indicado quando:
- Você está começando a integração e quer testar rapidamente
- Sua empresa processa um volume baixo de boletos
- Você não tem urgência em automatizar completamente o processo
Fluxo Automático via VAN é indicado quando:
- Você processa um volume alto de boletos diariamente
- Deseja eliminar processos manuais e ter maior agilidade
- Busca automatização completa do processo de conciliação
Dúvidas frequentes
Posso começar com o fluxo manual e depois migrar para o automático?
Sim! Muitos clientes começam testando com o fluxo manual e depois solicitam a ativação da VAN para automatizar o processo.
Preciso alterar minha integração ao migrar do manual para o automático?
Apenas a primeira etapa muda (consulta via VAN ao invés de upload). As rotas de consulta de pagamentos permanecem as mesmas nos dois fluxos.
Quanto tempo leva para ativar a Transmissão Automática?
O prazo varia de acordo com cada banco, mas geralmente leva de 5 a 15 dias úteis após a entrega correta da documentação.
Comentários
0 comentário
Por favor, entre para comentar.