Investidores - Integração Básica via Arquivo

Etapas Iniciais

O processo de integração começa com o envio do Manual do Arquivo, acompanhado de um arquivo de exemplo (nos formatos CSV ou CNAB), permitindo que nosso time técnico configure corretamente o template a ser utilizado.

Além disso, é necessário definir o diretório de troca de arquivos, que pode ser um SFTP/FTP fornecido pelo cliente ou, se preferir, um diretório disponibilizado por nós.

Caso mais de um CNPJ utilize o mesmo diretório, será preciso definir prefixos específicos para cada empresa, que servirão para identificar os arquivos corretamente com base em seus nomes.

Exemplo de nome de arquivo: XYZ2764529167451
Neste caso, o prefixo é XYZ.

Fluxo de Compra pelo Investidor

O Investidor informa as taxas de antecipação para os Sacados, por meio de integração via API ou upload de arquivo na plataforma.
Quando o Cedente realiza uma operação de antecipação, a plataforma gera e disponibiliza, via SFTP/FTP, um arquivo de remessa com todas as informações necessárias para que o Investidor possa analisar e decidir sobre a compra, conforme o template previamente acordado.
O Investidor analisa o arquivo e retorna, via SFTP/FTP, um arquivo de retorno, informando a decisão de compra:
- Pode aprovar todos os títulos;
- Pode recusar total ou parcialmente.
O Cedente assina eletronicamente a operação.
O Investidor realiza a assinatura final, concluindo a operação de compra.

No passo 3, cada título deve conter um status de aprovação ou recusa, definido conforme convenção acordada (código ou palavra).

Envio do Arquivo de Remessa

Assim que a compra é efetivada, a plataforma gera um arquivo de remessa contendo todas as informações da operação, conforme o template previamente compartilhado.

Esse arquivo é disponibilizado na pasta /in, onde poderá ser acessado pelo Investidor (ou instituição financeira) para análise e validação.

Envio do Arquivo de Retorno

Após as validações internas, o Investidor deve enviar um arquivo de retorno, com o status de cada item (aprovado ou recusado).

Esse arquivo deve ser depositado na pasta /out, de onde será automaticamente consumido pela plataforma. A partir daí:

Os status dos títulos são atualizados na plataforma;
O fluxo segue para a geração e assinatura dos Termos de Cessão.