Conciliação de Pré-Fatura Mercado Livre: como o Atlas TMS extrai, faz o de-para e fecha seu financeiro

Transportadoras que operam Last Mile do Mercado Livre recebem, a cada quinzena, uma planilha de pré-fatura com centenas de linhas — valores, pedágios, ordens de coleta e rotas. Conferir isso manualmente contra o TMS é lento, arriscado e caro. O módulo de Conciliação de Pré-Fatura do Atlas TMS automatiza a leitura do arquivo, o de-para com as viagens já registradas no sistema e o cálculo de divergências em relação à tabela de frete e ao CT-e emitido, para você aprovar e faturar com segurança.

O problema que o módulo resolve

Na prática, a operação MeLi gera três “verdades” que precisam bater:

1. A pré-fatura do cliente — arquivo CSV ou Excel enviado pelo Mercado Livre com o valor cobrado por viagem/rota;
2. A viagem no Atlas TMS — ordem de coleta (O.C.), placa, origem/destino, datas e parceiro;
3. O valor esperado internamente — tabela de frete contratada + valor do CT-e, quando já emitido.

Sem conciliação automatizada, o financeiro depende de filtros no Excel, busca manual de O.C. e comparação “de olho”. O Atlas TMS unifica isso em um fluxo: upload → parse inteligente → matching → painel de divergências → SLA → aprovação → contas a receber.

De onde vem o arquivo e o que o sistema extrai

O módulo aceita os formatos que o Mercado Livre costuma enviar: CSV (delimitador detectado automaticamente: ponto-e-vírgula, vírgula ou tab) e XLSX (primeira aba da planilha). Não é necessário padronizar o cabeçalho manualmente: o parser reconhece dezenas de variações de nome de coluna.

Colunas reconhecidas automaticamente (de-para de cabeçalho)

O serviço de leitura normaliza cada linha para um modelo interno único. Exemplos de aliases aceitos:

Valores monetários em formato brasileiro (1.234,56) ou internacional são convertidos; datas em DD/MM/AAAA ou ISO viram YYYY-MM-DD; placas são limpas e padronizadas em maiúsculas; ordens de coleta sem prefixo recebem normalização OC + dígitos (ex.: 12345 → OC12345). Cada linha original fica guardada em raw_data para auditoria.

Fluxo completo: da planilha ao faturamento

Como funciona o de-para (matching) linha a linha

Para cada linha importada, o motor de conciliação tenta encontrar uma viagem no Atlas TMS, nesta ordem de prioridade:

1. Ordem de coleta (O.C.) — prioridade máxima

Compara o número da planilha com trips.order_number, testando variantes: valor exato, sem prefixo OC, e renormalização. É o método mais confiável quando a operação registra a mesma O.C. que o Mercado Livre fatura.

2. Placa + janela de data

Se a O.C. não encontrar viagem, busca veículo pela placa (com tolerância ILIKE) e, se houver data de serviço na linha, restringe a viagem entre 7 dias antes e 7 dias depois — útil quando a planilha traz placa e data mas a O.C. veio diferente ou vazia.

3. Origem e destino (cidade)

Último recurso: match por origin_city e destination_city (busca parcial). Indicado para rotas fixas Last Mile quando placa/O.C. falham.

Em todos os casos, a busca respeita o tenant e, quando você informa o parceiro na importação, filtra viagens daquele cliente — evitando cruzar dados de outro contrato.

Cálculo de divergência: pré-fatura × tabela × CT-e

Depois de vincular a viagem, o sistema calcula o valor esperado consultando a tabela de frete do parceiro (origem, destino, UF, tipo de veículo, tipo de negócio e conjunto de frete quando configurados). Em paralelo, lê o valor de prestação do CT-e vinculado à viagem, se existir.

• Baseline = tabela de frete (frete + pedágio da tabela), ou CT-e se a tabela não retornar valor;
• Valor da linha = frete da planilha + pedágio da planilha;
• Divergência = diferença entre o cobrado pelo MeLi e o baseline;
• Tolerância de R$ 0,02 — abaixo disso a linha fica OK; acima, Divergência com nota explicativa (tabela e CT-e quando disponíveis).

Exemplos reais de cenários que o painel destaca:

• MeLi cobrou mais paradas do que o TMS registrou — divergência de valor ou volume;
• Pedágio na operação não refletido na pré-fatura do cliente — linha com pedágio zero na planilha mas custo na viagem;
• CT-e emitido com valor diferente da tabela contratada — alerta antes de aceitar o lote.

O botão Reconciliar reprocessa todas as linhas após você corrigir viagens, tabelas ou vínculos manuais — sem precisar reenviar o arquivo.

SLA e valor líquido a faturar

Para linhas com viagem encontrada, o módulo pode acionar o motor de SLA de faturamento: regras por parceiro (atraso na chegada, prazos de entrega, etc.) geram multas e descontos automáticos vinculados à pré-fatura. O painel exibe:

• Bruto (arquivo) — soma do que o Mercado Livre está cobrando;
• Multas SLA e Descontos SLA;
• Líquido a faturar — o que efetivamente vira contas a receber após aprovação.

Assim, a conciliação não é só “bateu ou não bateu”: é quanto você deve aceitar receber com base em contrato e desempenho operacional.

Integração com a operação Mercado Livre no Atlas

O módulo de conciliação não trabalha isolado. Ele se apoia no ecossistema Atlas para MeLi:

• Extração de viagens e XMLs via API oficial (OAuth) — chaves de NF-e, destinatários e pré-preenchimento de CT-e;
• Viagens Last Mile registradas com mesma O.C. que aparece na pré-fatura;
• RPA / painel operacional para acompanhar rotas, paradas e indicadores antes do fechamento financeiro.

Quanto mais disciplinada a operação no TMS (O.C. correta, placa, datas), maior a taxa de match automático na primeira importação — tipicamente acima de 90% em bases maduras.

Vínculo manual e auditoria

Linhas Sem viagem podem ser associadas manualmente à viagem correta no painel, sem editar a planilha original. Toda importação gera registro em auditoria (quem subiu, quantas linhas, arquivo armazenado em storage/financial/pre_invoices/). O JSON bruto de cada linha permite provar o que o Mercado Livre enviou em caso de contestação.

Status da pré-fatura

Benefícios para transportadoras e para quem vende o Atlas

Permissões e onde acessar

O módulo fica em Financeiro → Pré-faturas de clientes. Permissões típicas: financial_view, financial_receivables ou financial_manage. Upload, reconciliar, SLA e faturamento respeitam o isolamento por tenant (cada transportadora vê apenas seus dados).

Resumo técnico (para o time comercial)

Quer ver o módulo na sua operação Meli?

Fale com a equipe Atlas TMS para demonstração com planilha real (ambiente de homologação) ou ativação no seu tenant.

Acessar o sistema Solicitar demonstração