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.
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).
Passo a passo
- 1
Acesse Intermediação > Entrega e clique em Importar (ou diretamente em intermediação/entrega/import).
- 2
Selecione o arquivo (formatos aceitos: TXT, CSV, XLS, XLSX, XML, PDF).
- 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
Confirme. O processamento é assíncrono (fila Hangfire) e pode levar alguns minutos.
- 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.
