Quais campos mapear no CSV de uma plataforma de pagamentos

Um extrato de plataforma mostra data, nome e valor. O financeiro consegue somar as entradas, mas não identifica qual invoice foi paga, qual parte corresponde à tarifa e em que moeda o saldo foi disponibilizado. O mapa de campos deve informar quais dados precisam chegar ao ERP e onde obtê-los quando o CSV principal traz somente uma parte. Comece pelo tipo de movimento que a empresa precisa conciliar, depois teste uma amostra com entradas, taxas, saques e estornos.

Defina identidade, contexto e valores

Para identificar cada linha, preserve provedor, conta ou carteira, ID do evento, tipo e referência à operação principal. Inclua ID da cobrança ou do pagamento quando disponível. Separe ID da retirada, do lote e da linha de transação. Em valores, retenha moeda, bruto, taxa, líquido e saldo, conforme os campos disponíveis. Se existem duas moedas, guarde origem, destino e referência de conversão. Anote se cada coluna usa sinal positivo ou negativo e se valores são decimais ou unidades menores. Use a documentação do relatório para esclarecer cada campo.

Em datas, diferencie evento, disponibilidade e liquidação bancária. Preserve o fuso informado e marque colunas que trazem só data. Na importação, deixe referências como texto para preservar zeros iniciais e evitar interpretação como número. Guarde o nome do arquivo, período, data de extração e versão do mapeamento. Um CSV exportado do histórico filtrado pode conter menos linhas que o extrato completo. Registre os filtros antes de comparar saldos.

Configure a leitura e identifique dados complementares

O RFC 4180 descreve um formato comum de CSV, incluindo aspas e separação de campos. Na prática, confirme delimitador, codificação e cabeçalho do arquivo real. A documentação do conector Texto/CSV do Power Query explica opções de delimitador e detecção de tipos. Teste texto com vírgula, acento e quebra de linha. Separe o arquivo bruto da tabela tratada para poder refazer a importação quando a ferramenta classificar mal um valor.

A Wise documenta opções de extrato por conta e formatos. A Stripe descreve histórico categorizado no relatório de saldo. Se a fonte não tem referência de invoice, busque o relatório que liga pagamento e cobrança. Se o relatório agrega taxa de vários eventos, use a linha de detalhe disponível e mantenha saldo pendente quando a relação ainda precisa de comprovação. O mapeamento deve identificar qual arquivo complementa o campo e qual chave permite unir as fontes.

Exemplo de mapa para dois relatórios

Uma exportadora recebe um CSV com crédito USD 970, evento TR-018 e data de disponibilidade. Outro relatório liga TR-018 à invoice INV-26 e mostra bruto USD 1.000 e taxa USD 30. Um extrato bancário posterior registra USD 970 com referência da retirada PO-009. A tabela guarda três identificadores e liga cobrança, crédito e retirada. A data do extrato bancário fica em uma coluna diferente da data em que o saldo ficou disponível.

A rotina de importação rejeita uma linha sem moeda e informa o arquivo de origem. O financeiro obtém uma nova exportação e corrige a configuração de conta. Na mesma rodada, uma linha de tarifa sem referência direta continua em pendência até o provedor confirmar a origem. O fechamento mostra a diferença em separado, sem baixar outra invoice para equilibrar a soma.

Valide antes de liberar o arquivo para o ERP

Monte uma lista com colunas obrigatórias, opcionais e derivadas. Para cada uma, indique significado, fonte, tipo, moeda, exemplo e ação quando estiver vazia. Compare quantidade de linhas, valores por moeda e período com o relatório original. Faça uma amostra de pagamento parcial, taxa, conversão e estorno. Confira se o saldo inicial mais a movimentação explicada chega ao saldo final quando o relatório fornece essa visão.

Se a empresa usa um arquivo por moeda, registre a moeda do arquivo como atributo e confronte com a coluna de movimento quando ambas existirem. Se uma atualização muda o nome da coluna, a importação deve apontar o campo ausente e preservar o arquivo. Leve para a revisão contábil as linhas sem evidência e a base de corte, com responsável pela regularização.

No controle de qualidade, mantenha pelo menos uma amostra de referência por relatório. Quando o provedor publica um novo tipo de evento, atualize a descrição do campo e revise qual conta do ERP deve recebê-lo. Anote se a coluna de saldo representa a posição após a linha ou um total do período. Essa diferença muda o teste e evita somar saldos sequenciais como se fossem movimentos.

Perguntas frequentes

Que identificador é obrigatório?

Preserve o identificador de origem da linha ou evento e a conta ou carteira. Use também referências de cobrança, lote e retirada quando forem necessárias para ligar as etapas.

Posso calcular o bruto somando líquido e taxa?

Só quando as evidências indicam que os dois valores pertencem à mesma operação e moeda e que não houve outras deduções. Guarde a origem da regra.

Como lidar com relatório sem moeda?

Confirme a moeda no arquivo original, na conta ou na documentação do provedor. Rejeite ou encaminhe a linha para revisão quando a moeda continuar indefinida.

Fontes oficiais

• RFC Editor — formato CSV
• Microsoft — conector de Texto/CSV no Power Query
• Wise — como baixar extratos de saldo
• Stripe — relatório de saldo

Leituras relacionadas

• Como montar uma matriz de evidências para serviços recorrentes ao exterior
• Guias para exportadores de serviços

Como a Zen pode ajudar

A contabilidade para exportação de serviços da Zen ajuda a organizar documentos, conciliar recebimentos e analisar as regras da sua operação. Peça uma proposta personalizada para conversar sobre o seu caso.