Importar XML, PDF, CSV ou Excel (entregas)

O Hap tem uma tela de importação que recebe arquivos (XML, PDF, CSV, XLS, XLSX, TXT) e cria/atualiza entregas (e movimentos relacionados) automaticamente. Útil para fechar grandes volumes de entrega vindos de planilhas do cliente ou XMLs de NF-e.

IntermediaçãoAtualizado em 17/09/2026

Quando usar

Use quando precisar bater de uma vez muitas entregas que estão em uma planilha do cliente, ou conferir entregas a partir de XMLs de NF-e recebidas.

Antes de começar

  • Arquivo de entrada (XML, PDF, CSV, XLS, XLSX, TXT).
  • Pedidos correspondentes já criados (a importação usa o Nº do pedido para casar).
Importar entregas - tela onde se sobe arquivo XML/PDF/CSV/Excel e mapeiam colunas

Passo a passo

  1. 1

    Acesse Intermediação > Entrega e clique em Importar (ou diretamente em intermediação/entrega/import).

  2. 2

    Selecione o arquivo (formatos aceitos: TXT, CSV, XLS, XLSX, XML, PDF).

  3. 3

    Mapeie as colunas do arquivo para os campos esperados: Número do Pedido, Código do Produto, Quantidade, Número da Nota Fiscal, Data de Emissão, Valor Unitário, Valor Total, Unidade.

  4. 4

    Confirme. O processamento é assíncrono (fila Hangfire) e pode levar alguns minutos.

  5. 5

    Acompanhe o job: status SUCEDIDO indica que as entregas foram criadas/atualizadas. Erros aparecem no log do job.

Problemas comuns

  • Formato não aceito: use TXT, CSV, XLS, XLSX, XML ou PDF.
  • Pedido não encontrado: a importação casa pelo Nº do pedido. Confirme se o número informado no arquivo corresponde a um pedido existente.
  • Demora muito: o processamento é assíncrono. Aguarde alguns minutos e cheque o status do job em segundo plano.

Artigos relacionados

IntermediaçãoImportar baixas de entregaGere as baixas de entrega de um pedido de intermediação a partir de um arquivo (TXT, CSV, Excel, XML da NF-e ou PDF da DANFE), sem lançar uma a uma. O sistema lê o arquivo, casa cada linha com o item/entrega do pedido e gera a baixa com parcelas e comissão.IntermediaçãoIntermediação: o que é e como funcionaA Intermediação é o módulo do Hap para quem aproxima um fornecedor de um cliente e ganha comissão pelo negócio, sem necessariamente comprar e revender a mercadoria. O pedido de intermediação registra o fornecedor (quem origina/entrega a mercadoria), o cliente (quem recebe), o negociador responsável e a comissão combinada e, a partir daí, controla entregas, baixas, fixação de preço e o cálculo das comissões.IntermediaçãoGlossário e papéis na IntermediaçãoTermos e papéis usados nos pedidos de intermediação: Fornecedor (origem da mercadoria), Cliente (destino), Negociador (fecha o negócio e recebe comissão), Intermediador (terceiro), Cliente de Remessa (recebe em operação triangular), Importador/Exportador (em importações), Fixação (pedido com preço a definir depois) e Rapel (desconto/bonificação por item).IntermediaçãoCadastrar e editar uma Operação de intermediaçãoA Operação é o molde do pedido de intermediação: define se o pedido é de venda ou de compra, quem paga a comissão por padrão, a observação padrão, as casas decimais e, o mais importante, quais ações o pedido vai executar (impostos, importação, rapel, período de entrega, valor a fixar e outras). Tudo o que aparece ou some no pedido depende da Operação escolhida.