Itaú VAN (SFTP)

O conector Itaú VAN permite a troca de arquivos com o Itaú via SFTP (SSH File Transfer Protocol): envio de remessas, listagem e download de retornos, por produto.

Configuração Inicial

Solicitação de Acesso

Os dados de conectividade (host, porta, usuário e senha) são fornecidos pelo time de Implantação Técnica do Itaú (E-mail: ImplantacaoTecnica@itau-unibanco.com.br). Verifique também se o seu ambiente possui regras de firewall para acessar o servidor do Itaú.

A autenticação do Itaú exige duplo fator: usuário + senha + chave SSH. Ao criar a conexão você escolhe:

• Gerar para mim — o Abstra gera um par de chaves e exibe a chave pública (formato OpenSSH) para você enviar à Implantação Técnica do Itaú registrar na sua conta.
• Já tenho minha chave — você fornece a sua própria chave privada SSH.

Configuração

Campo	Descrição
Host	Hostname ou IP do servidor SFTP do Itaú
Porta	Porta SFTP (padrão 22)
Usuário	Usuário SFTP fornecido pelo Itaú
Senha	Senha do usuário SFTP
Chave SSH	Gerar para mim ou Já tenho minha chave (chave privada PEM)
Ambiente padrão	PROD ou TESTE (usado quando a ação não informa ambiente)
Fingerprint do host (opcional)	SHA-256 da chave do servidor, para proteção contra MITM

Estrutura de pastas

O Itaú organiza os arquivos por direção, ambiente e produto:

• /REMESSA/{PROD|TESTE}/{PRODUTO}/ — arquivos enviados ao Itaú
• /RETORNO/{PROD|TESTE}/{PRODUTO}/ — arquivos recebidos do Itaú

Produtos suportados: 008 (Pagamentos), 001 (Cobrança), 025 (Conciliação Bancária).

Ações

• send (produto, ambiente?, projectFilePath) — envia um arquivo do projeto para /REMESSA/{ambiente}/{produto}/.
• list (produto, ambiente?, direction?) — lista uma pasta (padrão RETORNO).
• download (produto, ambiente?, fileName, direction?) — baixa um arquivo (padrão de RETORNO) para os arquivos do projeto e retorna o caminho local.

O ambiente (PROD/TESTE) vem por padrão da conexão e pode ser sobrescrito por ação.

Integração com ERP (SAP, NetSuite, Totvs)

Não há transferência direta SFTP↔ERP. Use um fluxo de 2 passos no código do seu projeto:

1. download → grava o arquivo nos arquivos do projeto e retorna o path.
2. Seu script lê esse arquivo e passa o conteúdo (base64) como parâmetro da ação de upload do conector ERP.

Imponha um limite de tamanho antes de carregar o arquivo em memória — arquivos CNAB/de conciliação podem ser grandes — e leia como bytes (não como texto UTF-8) para preservar o conteúdo.

Available Actions

For a complete list of all available actions and their parameters, see the Itaú VAN connector documentation.