Arquivos (SFTP ou S3)

Você exporta arquivos e os entrega de acordo com uma programação para SFTP ou S3. Athia fornece o destino, a especificação do formato e a validação.

• Quem é o dono do seu lado: sua equipe de dados. Eles exportam dos sistemas de registro e agendam a entrega.
• O que Athia oferece a você: o destino e credenciais SFTP ou S3, a especificação do campo (consulte Dicionário de dados Athia) e um relatório de validação sobre cada entrega listando linhas rejeitadas, campos obrigatórios ausentes e incompatibilidades de tipo, verificados em relação ao mapeamento acordado para sua conta, em vez de nomes de colunas fixas, para que você possa corrigir a exportação antes da próxima execução.
• Cadência: diariamente é típico para a alimentação recorrente. Combine-o com a frequência com que seus sistemas de origem fecham.
• Formatos: Apache Parquet é o preferido. Gzip CSV, JSON Lines ou acesso direto à tabela e visualização também funcionam.
• Granularidade do arquivo: um arquivo por fonte por mês, cerca de um gigabyte por arquivo, dividido se for maior.
• Um esforço único: a exportação histórica é feita uma vez. Depois que a conexão ativa for executada, nenhuma atualização manual contínua será necessária.

O preenchimento e o feed recorrente usam o mesmo caminho e a mesma especificação.

Entregando por SFTP#

SFTP é a escolha certa para histórico em massa e para feeds que não precisam chegar em segundos.

Obtendo acesso

Peça à sua equipe Athia para abrir uma conta SFTP. Você troca chaves públicas e elas retornam o host, o nome de usuário e os diretórios de upload e recebimento da sua conta. Não há senha.

Nomeando seus arquivos

Comece cada nome de arquivo com o tipo de dados que ele contém. Athia roteia nesse prefixo, portanto, um arquivo com nome incorreto é um arquivo com roteamento incorreto.

• transactions_2026-05-18_01.parquet
• costs_2026-05-18_01.parquet
• subscriptions_2026-05-18_01.parquet

Tudo após o prefixo pode ser usado por você: um carimbo de data/hora, um sistema de origem, um número de peça.

Fazendo upload e lendo o recibo

1. Conecte-se com o host e o nome de usuário que você recebeu.
2. Solte seus arquivos no diretório de upload.
3. Leia o recibo no diretório de recibos no mesmo servidor.

Athia escreve um recibo para cada arquivo que processa, nomeando linhas rejeitadas, campos obrigatórios ausentes e incompatibilidades de tipo. Corrija a exportação em vez do arquivo, ou a próxima execução agendada repetirá o problema.