Skip to content

EME4 – Integração Externa – Integração NFe – Importar NFe com Prévia (Compra) ​

Confiança da documentação: Média

Visão Geral ​

Importa arquivos XML de NFe gerando prévias para conferência antes da efetivação da nota fiscal de entrada. Utilize esta tela para carregar o XML, revisar inconsistências e confirmar a geração da NFe de compra.

Caminho no Sistema ​

Menu: Integração Externa > Integração NFe > Importar NFe com Prévia (Compra)

Ações disponíveis ​

  • Publicar Método Agendado
    Onde usar: Tela principal
    Descrição: Publica o método para execução agendada.

  • Excluir NFe Gerada
    Onde usar: Tela principal
    Descrição: Exclui a NFe gerada a partir da prévia.

  • Excluir Prévias Selecionadas
    Onde usar: Tela principal
    Descrição: Exclui as prévias selecionadas na grade.

  • Adicionar Lote / Projeto
    Onde usar: Aba "Itens NFe"
    Descrição: Adiciona lote ou projeto ao registro selecionado.

  • Importar Prévia Notas Fiscais
    Onde usar: Aba "Cabeçalho"
    Descrição: Importa o arquivo XML gerando a prévia das notas fiscais.

  • Interpretar Prévias
    Onde usar: Aba "Cabeçalho"
    Descrição: Interpreta as prévias importadas, identificando inconsistências.

  • Importar Notas Fiscais
    Onde usar: Aba "Cabeçalho"
    Descrição: Efetiva a importação das notas fiscais a partir das prévias.

Estrutura da Tela ​

Cabeçalho ​

Agrupa os parâmetros iniciais para leitura e importação do arquivo XML.

Campos ​

CampoObrigatórioDescrição
Arquivo com PathNãoSelecione o arquivo XML da NFe a ser importado. — Opções: FILE
Tipo DoctoNãoInforme o tipo de documento a ser gerado a partir do XML.
Data EntradaNãoInforme a data de entrada a ser considerada na importação.
Cód. utilizado na importação dos itensNãoSelecione se a importação dos itens utilizará o Código Produto ou o Código NCM. — Opções: Código Produto / Código NCM
Unidade do XML não encontrada - Imp Unid. PadrãoNãoDefina se deve assumir a unidade padrão quando a unidade do XML não for encontrada.

Botões disponíveis:

  • Importar Prévia Notas Fiscais
    Onde usar: Aba "Cabeçalho"
    Descrição: Importa o arquivo XML gerando a prévia das notas fiscais.

  • Interpretar Prévias
    Onde usar: Aba "Cabeçalho"
    Descrição: Interpreta as prévias importadas, identificando inconsistências.

  • Importar Notas Fiscais
    Onde usar: Aba "Cabeçalho"
    Descrição: Efetiva a importação das notas fiscais a partir das prévias.

Aba: Informações NFe ​

Agrupa dados de identificação e situação cadastral da informação da NFe.

Sub-aba: Itens NFe ​

Lista os itens da NFe lidos do XML com indicação de ocorrências e inconsistências.

A tela possui duas áreas: formulário de edição e lista de registros vinculados.

Campos ​
CampoObrigatórioDescrição
Oco. Prévia XML NFeSimIndica a ocorrência registrada para o item na prévia do XML.
InconsistenteNãoIndica se o registro está marcado como inconsistente.
NúmeroNãoNúmero do item/duplicata/volume conforme o XML.
VencimentoNãoData de vencimento conforme o XML.
ValorNãoValor conforme o XML.

Ações disponíveis:

  • Adicionar Lote / Projeto
    Onde usar: Aba "Itens NFe"
    Descrição: Adiciona lote ou projeto ao registro selecionado.

Sub-aba: Duplicatas ​

Lista as duplicatas/parcelas extraídas do XML da NFe.

A tela possui duas áreas: formulário de edição e lista de registros vinculados.

Campos ​
CampoObrigatórioDescrição
Oco. Prévia XML NFeSimIndica a ocorrência registrada para o item na prévia do XML.
InconsistenteNãoIndica se o registro está marcado como inconsistente.
NúmeroNãoNúmero do item/duplicata/volume conforme o XML.
VencimentoNãoData de vencimento conforme o XML.
ValorNãoValor conforme o XML.

Sub-aba: Volumes ​

Lista os volumes informados no XML da NFe.

A tela possui duas áreas: formulário de edição e lista de registros vinculados.

Campos ​
CampoObrigatórioDescrição
Oco. Prévia XML NFeSimIndica a ocorrência registrada para o item na prévia do XML.
InconsistenteNãoIndica se o registro está marcado como inconsistente.
NúmeroNãoNúmero do item/duplicata/volume conforme o XML.
VencimentoNãoData de vencimento conforme o XML.
ValorNãoValor conforme o XML.

Sub-aba: Inconsistências ​

Reúne as inconsistências detectadas na prévia, indicando origem e situação de correção.

A tela possui duas áreas: formulário de edição e lista de registros vinculados.

Campos ​
CampoObrigatórioDescrição
TipoNãoTipo da inconsistência registrada. — Opções: Aviso / Erro
OrigemNãoOrigem da inconsistência registrada. — Opções: Geração Documento / Interpretação
DescriçãoNãoDescrição da inconsistência registrada.
CorrigidoNãoIndica se a inconsistência foi corrigida.
Partes Docto XML NFeNãoIdentifica as partes do documento XML relacionadas à inconsistência.

Aba: XML ​

Apresenta os dados extraídos do XML da NFe, incluindo emitente, destinatário, transportadora, totais e informações fiscais.

A tela é dividida em duas áreas: na parte superior, o formulário de edição; na parte inferior, a lista de registros vinculados.

Campos ​

CampoObrigatórioDescrição
DocumentoNãoIdentificação do documento conforme o XML.
Nro. NFNãoNúmero da nota fiscal conforme o XML.
ModeloNãoModelo do documento fiscal conforme o XML.
SérieNãoSérie do documento fiscal conforme o XML.
EmissãoNãoData de emissão do documento conforme o XML.
CPF/CNPJ EmitenteNãoCPF ou CNPJ do emitente conforme o XML.
Nome EmitenteNãoNome do emitente conforme o XML.
Fantasia EmitenteNãoNome fantasia do emitente conforme o XML.
CPF/CNPJ DestinatárioNãoCPF ou CNPJ do destinatário conforme o XML.
Nome DestinatárioNãoNome do destinatário conforme o XML.
CPF/CNPJ TransportadoraNãoCPF ou CNPJ da transportadora conforme o XML.
Nome TransportadoraNãoNome da transportadora conforme o XML.
Chave NFeNãoChave de acesso da NFe conforme o XML.
Chave NFe OrigemNãoChave de acesso da NFe de origem conforme o XML.
Bairro DestinatárioNãoBairro do destinatário conforme o XML.
Bairro EmitenteNãoBairro do emitente conforme o XML.
CEP DestinatárioNãoCEP do destinatário conforme o XML.
CEP EmitenteNãoCEP do emitente conforme o XML.
Complemento DestinatárioNãoComplemento do endereço do destinatário conforme o XML.
Complemento EmitenteNãoComplemento do endereço do emitente conforme o XML.
Fone DestinatárioNãoTelefone do destinatário conforme o XML.
Fone EmitenteNãoTelefone do emitente conforme o XML.
IE DestinatárioNãoInscrição estadual do destinatário conforme o XML.
IE EmitenteNãoInscrição estadual do emitente conforme o XML.
IM EmitenteNãoInscrição municipal do emitente conforme o XML.
Logradouro DestinatárioNãoLogradouro do destinatário conforme o XML.
Logradouro EmitenteNãoLogradouro do emitente conforme o XML.
Município DestinatárioNãoMunicípio do destinatário conforme o XML.
Município EmitenteNãoMunicípio do emitente conforme o XML.
Município IBGE DestinatárioNãoCódigo IBGE do município do destinatário conforme o XML.
Município IBGE EmitenteNãoCódigo IBGE do município do emitente conforme o XML.
Nro DestinatárioNãoNúmero do endereço do destinatário conforme o XML.
Nro. EmitenteNãoNúmero do endereço do emitente conforme o XML.
País EmitenteNãoPaís do emitente conforme o XML.
País DestinatárioNãoPaís do destinatário conforme o XML.
País IBGE DestinatárioNãoCódigo IBGE do país do destinatário conforme o XML.
País IBGE EmitenteNãoCódigo IBGE do país do emitente conforme o XML.
UF DestinatárioNãoUF do destinatário conforme o XML.
UF EmitenteNãoUF do emitente conforme o XML.
IE TransportadoraNãoInscrição estadual da transportadora conforme o XML.
Endereço TransportadoraNãoEndereço da transportadora conforme o XML.
Município TransportadoraNãoMunicípio da transportadora conforme o XML.
UF TransportadoraNãoUF da transportadora conforme o XML.
UF Veículo TransportadoraNãoUF do veículo da transportadora conforme o XML.
UF Reboque TransportadoraNãoUF do reboque da transportadora conforme o XML.
RNTC Reboque TransportadoraNãoRNTC do reboque da transportadora conforme o XML.
Placa Veículo TransportadoraNãoPlaca do veículo da transportadora conforme o XML.
Placa RNTC TransportadoraNãoPlaca RNTC da transportadora conforme o XML.
Placa Reboque TransportadoraNãoPlaca do reboque da transportadora conforme o XML.
Mod. FreteNãoModalidade de frete conforme o XML.
Protocolo Recebto NFeNãoProtocolo de recebimento da NFe conforme o XML.
CFOPNãoCFOP conforme o XML.
Data Entrada/SaídaNãoData de entrada/saída conforme o XML.
Ind. Forma PagtoNãoIndicador da forma de pagamento conforme o XML.
Inf. Ad. FiscoNãoInformações adicionais ao fisco conforme o XML.
Informações ComplementaresNãoInformações complementares conforme o XML.
Valor Tot. BC ICMSNãoValor total da base de cálculo do ICMS conforme o XML.
Valor Tot. BC STNãoValor total da base de cálculo do ICMS ST conforme o XML.
Valor Tot. Desc.NãoValor total de descontos conforme o XML.
Valor Total COFINSNãoValor total de COFINS conforme o XML.
Valor Total FreteNãoValor total do frete conforme o XML.
Valor Total ICMSNãoValor total do ICMS conforme o XML.
Valor Total IINãoValor total do II conforme o XML.
Valor Total IPINãoValor total do IPI conforme o XML.
Valor Total NFNãoValor total da nota fiscal conforme o XML.
Valor Total OutrasNãoValor total de outras despesas conforme o XML.
Valor Total PISNãoValor total de PIS conforme o XML.
Valor Total Produtos/ServiçosNãoValor total dos produtos/serviços conforme o XML.
Valor Total SeguroNãoValor total do seguro conforme o XML.
Valor Total STNãoValor total do ICMS ST conforme o XML.

Aba: Correção ​

Agrupa os campos disponíveis para correção de identificação, endereço e série antes da efetivação.

Os campos desta aba não puderam ser identificados automaticamente. Isso pode ocorrer devido a carregamento dinâmico ou regras condicionais do sistema.

Aba: Inf. NFe XML NFe ​

Agrupa as informações da NFe lidas do XML, incluindo ocorrências, dados do emitente, destinatário, transportadora e totais.

A tela é dividida em duas áreas: na parte superior, o formulário de edição; na parte inferior, a lista de registros vinculados.

Campos ​

CampoObrigatórioDescrição
Oco. Prévia XML NFeSimIndica a ocorrência registrada para o item na prévia do XML.
InconsistenteNãoIndica se o registro está marcado como inconsistente.
DocumentoNãoIdentificação do documento conforme o XML.
Nro. NFNãoNúmero da nota fiscal conforme o XML.
ModeloNãoModelo do documento fiscal conforme o XML.
SérieNãoSérie do documento fiscal conforme o XML.
EmissãoNãoData de emissão do documento conforme o XML.
CPF/CNPJ EmitenteNãoCPF ou CNPJ do emitente conforme o XML.
Nome EmitenteNãoNome do emitente conforme o XML.
Fantasia EmitenteNãoNome fantasia do emitente conforme o XML.
CPF/CNPJ DestinatárioNãoCPF ou CNPJ do destinatário conforme o XML.
Nome DestinatárioNãoNome do destinatário conforme o XML.
CPF/CNPJ TransportadoraNãoCPF ou CNPJ da transportadora conforme o XML.
Nome TransportadoraNãoNome da transportadora conforme o XML.
Chave NFeNãoChave de acesso da NFe conforme o XML.
Chave NFe OrigemNãoChave de acesso da NFe de origem conforme o XML.
Bairro DestinatárioNãoBairro do destinatário conforme o XML.
Bairro EmitenteNãoBairro do emitente conforme o XML.
CEP DestinatárioNãoCEP do destinatário conforme o XML.
CEP EmitenteNãoCEP do emitente conforme o XML.
Complemento DestinatárioNãoComplemento do endereço do destinatário conforme o XML.
Complemento EmitenteNãoComplemento do endereço do emitente conforme o XML.
Fone DestinatárioNãoTelefone do destinatário conforme o XML.
Fone EmitenteNãoTelefone do emitente conforme o XML.
IE DestinatárioNãoInscrição estadual do destinatário conforme o XML.
IE EmitenteNãoInscrição estadual do emitente conforme o XML.
IM EmitenteNãoInscrição municipal do emitente conforme o XML.
Logradouro DestinatárioNãoLogradouro do destinatário conforme o XML.
Logradouro EmitenteNãoLogradouro do emitente conforme o XML.
Município DestinatárioNãoMunicípio do destinatário conforme o XML.
Município EmitenteNãoMunicípio do emitente conforme o XML.
Município IBGE DestinatárioNãoCódigo IBGE do município do destinatário conforme o XML.
Município IBGE EmitenteNãoCódigo IBGE do município do emitente conforme o XML.
Nro DestinatárioNãoNúmero do endereço do destinatário conforme o XML.
Nro. EmitenteNãoNúmero do endereço do emitente conforme o XML.
País EmitenteNãoPaís do emitente conforme o XML.
País DestinatárioNãoPaís do destinatário conforme o XML.
País IBGE DestinatárioNãoCódigo IBGE do país do destinatário conforme o XML.
País IBGE EmitenteNãoCódigo IBGE do país do emitente conforme o XML.
UF DestinatárioNãoUF do destinatário conforme o XML.
UF EmitenteNãoUF do emitente conforme o XML.
IE TransportadoraNãoInscrição estadual da transportadora conforme o XML.
Endereço TransportadoraNãoEndereço da transportadora conforme o XML.
Município TransportadoraNãoMunicípio da transportadora conforme o XML.
UF TransportadoraNãoUF da transportadora conforme o XML.
UF Veículo TransportadoraNãoUF do veículo da transportadora conforme o XML.
UF Reboque TransportadoraNãoUF do reboque da transportadora conforme o XML.
RNTC Reboque TransportadoraNãoRNTC do reboque da transportadora conforme o XML.
Placa Veículo TransportadoraNãoPlaca do veículo da transportadora conforme o XML.
Placa RNTC TransportadoraNãoPlaca RNTC da transportadora conforme o XML.
Placa Reboque TransportadoraNãoPlaca do reboque da transportadora conforme o XML.
Mod. FreteNãoModalidade de frete conforme o XML.
Protocolo Recebto NFeNãoProtocolo de recebimento da NFe conforme o XML.
CFOPNãoCFOP conforme o XML.
Data Entrada/SaídaNãoData de entrada/saída conforme o XML.
Ind. Forma PagtoNãoIndicador da forma de pagamento conforme o XML.
Inf. Ad. FiscoNãoInformações adicionais ao fisco conforme o XML.
Informações ComplementaresNãoInformações complementares conforme o XML.
Valor Tot. BC ICMSNãoValor total da base de cálculo do ICMS conforme o XML.
Valor Tot. BC STNãoValor total da base de cálculo do ICMS ST conforme o XML.
Valor Tot. Desc.NãoValor total de descontos conforme o XML.
Valor Total COFINSNãoValor total de COFINS conforme o XML.
Valor Total FreteNãoValor total do frete conforme o XML.
Valor Total ICMSNãoValor total do ICMS conforme o XML.
Valor Total IINãoValor total do II conforme o XML.
Valor Total IPINãoValor total do IPI conforme o XML.
Valor Total NFNãoValor total da nota fiscal conforme o XML.
Valor Total OutrasNãoValor total de outras despesas conforme o XML.
Valor Total PISNãoValor total de PIS conforme o XML.
Valor Total Produtos/ServiçosNãoValor total dos produtos/serviços conforme o XML.
Valor Total SeguroNãoValor total do seguro conforme o XML.
Valor Total STNãoValor total do ICMS ST conforme o XML.

Ações ​

  • Publicar Método Agendado
    Onde usar: Tela principal
    Descrição: Publica o método para execução agendada.

  • Excluir NFe Gerada
    Onde usar: Tela principal
    Descrição: Exclui a NFe gerada a partir da prévia.

  • Excluir Prévias Selecionadas
    Onde usar: Tela principal
    Descrição: Exclui as prévias selecionadas na grade.

Pré-requisitos ​

  • Para excluir, selecione ao menos uma prévia.
  • A exclusão somente é permitida para XML com status [Em Prévia].
  • O XML deve conter o padrão de documento da NFe.
  • A NFe deve possuir itens.
  • A NFe deve conter apenas uma natureza de operação.
  • A NFe deve possuir tipo de NFe (tpNF).
  • A NFe deve possuir finalidade de NFe (finNFe).
  • A NFe deve possuir série.

Regras do Sistema ​

Ao excluir um registro ​

  1. Exclusão permitida apenas para XML com status [Em Prévia] (campo: [Status])
  2. Selecione as prévias para exclusão!

Validações gerais ​

  1. Não foi encontrado o padrão documento da NFe.
  2. NFe não possui ítens
  3. Existe mais de uma natureza de operação na mesma NFe
  4. NFe não possui tipo de NFe (tpNF)
  5. NFe não possui finalidade de NFe (finNFe)
  6. NFe não possui série

Campos Calculados ​

Alguns campos são calculados automaticamente a partir de outros:

  • [Tem Diferimento CBS] — calculado a partir de: [Valor Diferido CBS]
  • [Alíquota IBS] — calculado a partir de: [Alíquota IBS UF], [Alíquota IBS Municipal]
  • [Valor IBS] — calculado a partir de: [Base IBS], [Alíquota IBS]
  • [IBS Alíquota Efetiva] — calculado a partir de: [Alíquota IBS UF Efetiva], [Alíquota IBS Municipal Efetiva]
  • [Valor IBS Municipal] — calculado a partir de: [Base IBS], [Alíquota IBS Municipal]
  • [Valor IBS UF] — calculado a partir de: [Base IBS], [Alíquota IBS UF]
  • [Tem Diferimento IBS] — calculado a partir de: [Valor Diferido IBS UF], [Valor Diferido IBS Municipal]
  • [Valor PIS] — calculado a partir de: [Base PIS], [Alíquota PIS]
  • [Valor COFINS] — calculado a partir de: [Base COFINS], [Alíquota COFINS]
  • [Unidade Produto] — calculado a partir de: [Unidade Produto]
  • [Valor IPI] — calculado a partir de: [Base IPI], [Alíquota IPI]
  • [Valor ICMS] — calculado a partir de: [Base ICMS], [Alíquota ICMS]

Como Usar ​

  1. Acesse pelo menu: Integração Externa > Integração NFe > Importar NFe com Prévia (Compra)
  2. Informe os filtros ou parâmetros do cabeçalho: [Arquivo com Path], [Tipo Docto], [Data Entrada], [Cód. utilizado na importação dos itens], [Unidade do XML não encontrada - Imp Unid. Padrão]
  3. Clique para carregar os dados e revise os resultados em: XML, Inf. NFe XML NFe
  4. Quando necessário, utilize Interpretar Prévias
  5. Quando necessário, utilize Importar Notas Fiscais
  6. Conclua a operação clicando em Importar Prévia Notas Fiscais