Pular para o conteúdo
Docs

Conversor e importação de XML

Atualizado em

Nesta página

As ferramentas de XML ajudam a trazer o histórico para a Emitra e a trabalhar com arquivos do Padrão Nacional, mesmo os que não foram emitidos por aqui.

Ferramentas no painel#

Ferramenta O que faz Permissão
Conversor em lote XML de NFS-e → ZIP de PDFs (DANFSe), XLSX consolidado ou JSON tools:convert
Validador de DPS Confere um XML de DPS contra o XSD vigente e as regras do nosso domínio tools:convert
Importar NFS-e emitidas fora Traz XMLs de notas do Padrão Nacional emitidas por outro sistema tools:import
Importar tomadores e itens Cadastro em massa por CSV ou XLSX tools:import
Conversor ABRASF → nacional Mapeia códigos de serviço municipais para cTribNac/NBS tools:import

tools:convert está com owner, admin, emissor e contador. tools:import está com owner, admin e emissor.

Conversor de XML em lote#

  1. Envie vários XMLs ou um ZIP.
  2. A Emitra confere se cada arquivo é uma NFS-e do Padrão Nacional. Arquivos que não forem entram no relatório com o motivo.
  3. Escolha a saída: ZIP com os PDFs (DANFSe), uma planilha XLSX com uma linha por nota ou JSON.
  4. O resultado fica disponível por 24 horas.

Importar NFS-e emitidas fora#

Use para ter num só lugar as notas que você emitiu antes, pelo emissor nacional ou por outro sistema.

  1. Envie os XMLs (um a um ou em ZIP).
  2. A Emitra confere se o CNPJ do prestador é o da empresa ativa. Arquivos de outro CNPJ são recusados.
  3. Notas repetidas são reconhecidas pela chave de acesso e não entram duas vezes.
  4. As notas aparecem com o status importada, numa lista própria, e entram nos relatórios e no dashboard com o filtro "incluir importadas".

Notas importadas nunca são reenviadas à Sefin e não podem ser canceladas nem substituídas pela Emitra. Para isso, use o sistema em que foram emitidas.

Quando a importação termina, o evento nfse.imported é enviado aos webhooks inscritos.

Importar tomadores e itens#

  1. Baixe o modelo de planilha (CSV ou XLSX).
  2. Preencha e envie.
  3. Cada linha passa pelas mesmas validações do cadastro manual (documento com dígito verificador, código de serviço com 6 dígitos, NBS com 9 dígitos).
  4. Revise a prévia e confirme.
  5. O relatório final mostra, por linha, se o registro foi criado, atualizado ou teve erro. Tomadores são atualizados pelo documento e itens pelo código.

Validador de DPS#

Envie um XML de DPS (até 1 MB). A Emitra valida contra o XSD da versão vigente do leiaute e aplica as regras de negócio que não estão no XSD. O resultado lista cada erro com a linha, o caminho XPath e a mensagem em português.

Conversor ABRASF → nacional#

Para quem vem de um emissor municipal no padrão ABRASF:

  1. Envie um CSV com código municipal, descrição e alíquota, ou um XML de RPS ABRASF (os itens distintos são extraídos).
  2. Para cada item, a Emitra sugere o cTribNac e o NBS mais prováveis, com o motivo e o grau de confiança.
  3. Revise em massa: aceite, troque ou ignore cada sugestão.
  4. Aplique. Os itens de serviço são criados ou atualizados e o mapeamento fica salvo para as próximas importações.

Com o assistente de IA habilitado, a sugestão combina busca na lista oficial com a escolha do modelo entre os candidatos encontrados, e conta nos usos de IA do plano. Sem IA, a sugestão é só por busca de texto e a confiança aparece como "baixa". Em qualquer caso, quem decide é você ou o seu contador.

Limites e segurança de upload#

Todo XML recebido passa pelas mesmas proteções:

Limite Valor
Tamanho por arquivo 5 MB
Por envio 50 MB ou 500 arquivos
ZIP descompactado até 200 MB no total, com razão de compressão de até 100×
  • O parse de XML não resolve entidades externas nem acessa a rede.
  • ZIPs com caminhos absolutos ou .. têm esses arquivos ignorados.
  • O tipo do arquivo é conferido pelo conteúdo, não pela extensão.

Ferramentas públicas, sem login#

Algumas ferramentas têm uma versão gratuita em /ferramentas, sem cadastro:

Página O que faz
/ferramentas/xml-para-pdf Converte 1 XML de NFS-e (até 1 MB) em PDF
/ferramentas/validar-dps Valida 1 XML de DPS
/ferramentas/codigo-de-servico Busca o código de serviço nacional na lista oficial

Nas ferramentas públicas, o processamento acontece em memória, na própria requisição. Nada é gravado: nem o arquivo, nem o conteúdo, nem o IP. Guardamos só um contador agregado de uso por ferramenta e por dia. Há limite de uso por IP (padrão de 10 por hora por ferramenta).

Próximos passos#

Esta página foi útil?