OmieapiDocumentaçãoOperações
← Referência das operações

ImportarNFealtera dados

Importa o XML de uma Nota Fiscal Eletrônica.

Identificação

Operaçãoprodutos/nfe:ImportarNFe
Serviçonfe
MóduloProdutos
Endpoint/api/v1/produtos/nfe/

Parâmetros

CampoTipoDescrição
cAppId obrigatóriostringIdentificação do aplicativo que emitiu a NF-e. Preenchimento obrigatório. Exemplo: ID001 PS: Informe o código que identifica a instalação do aplicativo. Caso o cliente tenha 2 Emissores de NF-e, indique: "01" e "02" ou "10" e "20" e assim por diante.
cAppNome obrigatóriostringNome do Aplicativo que emitiu a NF-e. Preenchimento obrigatório. Exemplo: GeradorNF-e
cAppVersao obrigatóriostringVersão do Aplicativo que emitiu a NF-e. Preenchimento obrigatório. Exemplo: 1.02.01
cCategoriastringCódigo da Categoria. Preenchimento opcional.
cChaveNFe obrigatóriostringChave da NF-e a ser importada. Preenchimento obrigatório. Apenas números com 44 digitos.
cMd5NFe obrigatóriostringMD5 do arquivo XML importado. Preenchimento obrigatório. Aplique o MD5 sobre o XML antes de realizar o consumo.
cNumeroPedidoClientestringNúmero do "Seu Pedido"
cOperacao obrigatóriostringTipo de Operação da Nota Fiscal. Preenchimento obrigatório. Códigos Disponíveis: 11 - Venda de produtos 21 - Compra de produtos
cOrigemstringOrigem da Nota Fiscal. Preenchimento opcional. Códigos Disponíveis: API - Importado via API.
cXmlNFe obrigatóriostringXml da NF-e a ser importada. Preenchimento obrigatório. Antes de enviar, converta os seus seguintes caracteres: &amp; para &amp;amp; > para &amp;gt; < para &amp;lt; " para &amp;quot; " para &amp;apos; | para &amp;#124; Após essa conversão aplique o MD5 para enviar no campo "cMd5NFe".
codigo_local_estoqueintegerCódigo do local do estoque. Preenchimento opcional. Assumirá o local padrão de estoque caso não informado.
dDataPrevisao obrigatóriostringData de Previsão do título de contas a pagar/receber. Preenchimento Obrigatório. Formato: dd/mm/aaaa
itenslista de objectItens da Nota Fiscal. Preenchimento opcional.
itensXmllista de objectDados dos Itens da NF-e. Informe aqui a relação dos produtos contidos no XML com o respectivo produto no Omie ERP. Caso a tag "itens" seja preenchida esta tag não deve ser utilizada. Preenchimento opcional.
lNaoGerarTitulobooleanNão gerar título de contas a pagar ou receber para a NF-e. Preenchimento opcional. Pode ser: true - inibe a geração do título de Contas a Pagar ou Receber no financeiro. false - Gera o ítulo de Contas a Pagar ou Receber no financeiro. O padrão é true.
lNaoIncluirClientebooleanNão adicionar o cliente caso não encontre no Omie. Preenchimento opcional. Pode ser: true - inibe a inclusão do cliente. false - Inclui o cliente caso não encontre. O padrão é true.
lNaoIncluirProdutobooleanNão adicionar o produto caso não encontre no Omie. Preenchimento opcional. Pode ser: true - inibe a inclusão do produto. false - Inclui o produto caso não encontre. O padrão é true.
lNaoMovEstoquebooleanNão movimentar o estoque. Preenchimento opcional. Pode ser: true - inibe a movimentação do estoque. false - Gera o movimentação do estoque. O padrão é true. Prevalece a informa
lancamentoslista de objectLançamentos no Conta Corrente relacionados a Nota Fiscal. (Tarifas,taxas,entre outros). Preenchimento opcional.
nClienteintegerId do cliente. Preenchimento opcional.
nContaCorrenteintegerId da Conta Corrente. Preenchimento opcional.
nProjetointegerId do projeto. Preenchimento opcional.
nVendedorintegerId do Vendedor. Preenchimento opcional.
parcelaslista de objectInformações complementares das Parcelas da NF-e. Nessa tag é recebido informações para complemento das parcelas já existentes no XML da NF-e enviada. Preenchimento opcional.

Exemplo de chamada

{
  "cAppNome": "GeradorNFe",
  "cAppVersao": "1.01.02",
  "cAppId": "NFe01",
  "cChaveNFe": "",
  "cXmlNFe": "",
  "cMd5NFe": "",
  "cOperacao": "11",
  "cOrigem": "API",
  "nCliente": 0,
  "cCategoria": "1.01.02",
  "nContaCorrente": 0,
  "codigo_local_estoque": 0,
  "lNaoMovEstoque": true,
  "lNaoGerarTitulo": false,
  "lNaoIncluirCliente": false,
  "lNaoIncluirProduto": true
}
Esta operação altera dados de verdade, na hora. Não existe ambiente de ensaio neste endereço.
api.omie.com.br/mcp · Documentação · Operações