Pular para o conteúdo principal
Todos os sistemas operacionaisNovidadesv1
Entrar

Arquivos (SFTP ou S3)

Envie dados de pagamento recorrentes para a Athia através de um feed de arquivos SFTP ou Amazon S3 validado.

Nesta página

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.
1
Exporte o histórico de tentativas

Inclua cada tentativa de pagamento e seu resultado, em vez de uma linha por pedido.

2
Entregue via SFTP ou S3

Use o esquema e a localização segura de ambos para o preenchimento histórico e arquivos agendados.

3
A Athia valida o feed

Schema, completude, identificadores, timestamps e consistência do resultado são verificados antes da ativação.

4
Corrija e envie novamente

Resolva as lacunas relatadas, envie os dados afetados e repita a validação até que o feed passe.

5
Execute o agendamento recorrente

Mantenha o feed atual automaticamente após a carga histórica única; não são esperadas atualizações manuais contínuas.

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.