Uploads de dados de custo

A aceitação é apenas metade de uma decisão de pagamento; a outra metade é o que custa a aprovação. Os dados de custo chegam à Athia como um upload de CSV, em vez de uma conexão de API, porque as taxas contratadas, os preços por método e as tabelas de taxas são termos comerciais mantidos em contratos e planilhas – a maioria dos provedores não expõe nenhuma API para eles. Um arquivo é a única fonte completa.

Com os dados de custo carregados, Athia pode passar de "qual provedor aprova mais" para "qual provedor aprova mais por unidade de custo", definir o preço de uma alteração de roteamento antes de você fazê-la e separar um aumento de taxa com o qual você concordou daquele que você não concordou.

As duas conexões de custo#

Mantenha-os separados, mesmo quando um único fornecedor cuida de ambos. As taxas de cartão se decompõem de maneira diferente das taxas que não são de cartão, e o modelo de custo da Athia as trata como objetos diferentes.

Antes de começar#

Não há pré-requisitos de console do provedor nem credenciais para esse conector — é um upload de arquivo, não uma conexão de API. O que você precisa antes de abrir o assistente:

• O modelo Athia CSV. Baixe-o na etapa 2 do assistente ("Precisa de ajuda com o formato? Baixe nosso modelo CSV para ver a estrutura esperada.") e preencha-o. O modelo define as colunas que Athia espera, na ordem em que as espera. É a definição de formato oficial – um arquivo montado a partir da memória ou de uma exportação de provedor geralmente falhará na validação.
• A própria tabela de preços, conforme acordado: suas taxas contratadas, preços por método e tabela de taxas para o período coberto pelo arquivo.
• As regiões de atuação o acordo se aplica.

Campos de configuração#

Configuração#

O assistente tem três etapas: Configuração → Carregar arquivo → Validar.

1. Acessar Configurações → Conexões e escolha + Adicionar conexão.
2. Abaixo Dados de custos, selecione Taxas de pagamento com cartão ou Taxas de pagamento sem cartão.
3. Etapa 1, Configurar conector: insira um Nome da conexão e marque um ou mais Regiões operacionais. Ambos são obrigatórios.
4. Etapa 2, Carregar arquivo CSV: baixe o modelo se ainda não o fez e solte seu arquivo na zona de lançamento ou use Navegar pelos arquivos.
5. Escolha Validar dados.

A validação verifica o arquivo em relação à estrutura esperada antes de qualquer coisa ser ingerida, de modo que um arquivo malformado é rejeitado no upload, em vez de aparecer mais tarde como números de custo errados em uma resposta. Se a validação falhar, corrija o arquivo e faça upload novamente — nada parcial será retido.

Cadência de sincronização#

Os dados de custo são um instantâneo de um acordo comercial, por isso ficam obsoletos no momento em que seus preços mudam. Carregue um novo arquivo sempre que você:

• renegociar taxas,
• adicione um provedor ou método de pagamento,
• entrar em um novo mercado ou
• receber uma tabela de taxas revisada.

Trate-o como um item de revisão trimestral, mesmo que nada óbvio tenha mudado – as alterações nas taxas de repasse e do esquema chegam sem conversa.

Limites e coisas para saber#

• Somente .csv arquivos são suportados. Sem pastas de trabalho do Excel, sem arquivos compactados.
• O modelo é a especificação do formato. As colunas obrigatórias são definidas pelo modelo para download, em vez de documentadas no produto. O tamanho do arquivo, a contagem de linhas e os limites de colunas não são publicados.
• Upload é tudo ou nada. Um arquivo que falha na validação é totalmente rejeitado; não há ingestão parcial.
• O comportamento de substituição não está indicado no produto. Se um novo upload substitui as taxas anteriores ou é mantido junto com elas, não é definido no assistente. Nomeie cada upload do contrato e o período que ele cobre e confirme com sua equipe da Athia qual tabela de preços está em vigor antes de confiar em um valor de custo que abranja uma alteração de preço.
• Uma tabela de preços não é uma fatura. Diz a Athia o que você deveria ser cobrado, não o que você eram cobrado. Os registros reais de liquidação e taxas vêm dos conectores do provedor, e a granularidade das taxas varia: Checkout.com e Adyen oferecem os detalhes de taxas mais ricos, enquanto Stripe relata taxas combinadas, sem intercâmbio granular. Carregar as taxas contratadas e os registros reais de taxas do seu provedor é o que torna possível a análise de variação de taxas. Veja Conectores Athia para o catálogo de conectores do provedor.

Solução de problemas#