Âncoras - Integração Básica via Arquivo

O primeiro passo consiste no envio do Manual do Arquivo, acompanhado de um arquivo de exemplo (nos formatos CSV ou CNAB), para que nosso time técnico possa configurar o template das notas.
Além disso, é necessário definir o diretório a ser utilizado para a troca de arquivos, que pode ser um SFTP/FTP do cliente ou, se necessário, podemos fornecer um diretório para a comunicação.

Juntamente com o manual e o diretório, é necessário definir se mais de um CNPJ utilizará o mesmo SFTP/FTP para realizar os fluxos de remessa e retorno.
Para que isso seja possível, precisamos estabelecer os prefixos de cada empresa, que correspondem aos primeiros caracteres do nome do arquivo.
Por exemplo:

Nome do Arquivo: ABC2764529167451
Neste caso, o prefixo é 'ABC'.

Outro ponto que precisa ser definido é se, no arquivo de retorno, serão enviados tanto os títulos recusados quanto os aprovados, já que o padrão é enviar somente os antecipados com sucesso.
Caso ambos sejam enviados, precisamos definir o que cada status (recusado/aprovado) representará.

Fluxo de Integração

1. O sacado seleciona os títulos que serão enviados para a plataforma.
2. Um arquivo é gerado no template enviado previamente.
3. O arquivo é disponibilizado no SFTP ou FTP na pasta /in.
4. A plataforma consome o arquivo e, caso esteja no formato esperado, os títulos são enfileirados e processados.
5. Os títulos sem duplicidade são disponibilizados na plataforma.

Upload de Notas

Os dados mínimos necessários para o upload dos títulos são:

• invoiceNumber: Número da fatura
• paymentDate: Data de pagamento
• paymentValue: Valor do pagamento
• supplierGovernmentId: CPF/CNPJ do fornecedor
• invoiceKey: Chave da nota de 44 caracteres

Validações Realizadas

• Notas com valor de pagamento inferior a R$ 5,00 não são processadas.
• A duplicidade é verificada por meio da chave composta: invoiceNumber, paymentDate, e supplierGovernmentId.
• Caso o campo installment (Parcela) seja informado, ele também será utilizado para validar duplicidades.

Retorno de Notas

Quando uma ou mais negociações são realizadas na plataforma, o sistema envia o retorno dessas operações para o SFTP/FTP, de acordo com o horário previamente acordado, com os status de título aprovado ou recusado.

Caso ocorram operações após o horário estabelecido, não será possível consolidar todas as transações em um único arquivo.
Nesse caso, um arquivo será gerado para cada operação realizada após o horário acordado.

Fluxo de Integração (Retorno)

1. A operação é realizada na plataforma.
2. No horário previamente acordado, a plataforma disponibiliza, na pasta /out do SFTP ou FTP, um arquivo no template combinado, contendo todos os dados das operações realizadas no dia.
3. Este arquivo é consumido pelo cliente.
4. As informações de pagamento e os dados do título são atualizados no ERP.