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

ImportarNFCealtera dados

Importa o XML de uma Nota Fiscal do Consumidor Eletrônica.

Identificação

Operaçãoprodutos/nfce:ImportarNFCe
Serviçonfce
MóduloProdutos
Endpoint/api/v1/produtos/nfce/

Como as pessoas pedem isso

importar nfce

Parâmetros

CampoTipoDescrição
cAcaoClientestringAção a ser executada com relação a tag idCliente. Preenchimento opcional. Pode ser: - CONSUMIDOR: assumirá que a venda foi realizada para um cliente consumidor padrão. Caso não exista um cliente consumidor cadastrado, o mesmo será criado automaticamente. - ERRO (padrão): Exigirá a definição de um idCliente válido. - INCLUIR: Com base nos dados do XML irá fazer a inclusão de um novo cliente.
cIncluirProdutostringIndica se na inclusão do cupom os produtos não existentes devem ser incluídos automaticamente. Possíveis valores: S - Sim N - Não (padrão)
cNaoGerarTitulostringIndica que a parcela não deve gerar um título no financeiro. Valores possíveis: S - Sim N - Não
cNaoMovEstoquestringIndica que os items do Cupom Fiscal não devem movimentar o estoque. Valores possíveis: S - Sim N - Não
chNFe obrigatóriostringChave de Acesso da Nota Fiscal Consumidor Eletrônico. Preenchimento obrigatório.
emiId obrigatóriostringIdentificação do computador onde o aplicativo emissor do cupom fiscal está instalado. É o código do PDV. Exemplos: "01", "20", "55". Preenchimento obrigatório.
emiNome obrigatóriostringNome do aplicativo emissor do cupom fiscal. Preenchimento obrigatório. O aplicativo deve ser previamente cadastrado. Para isso entre em contato com a nosso suporte.
emiVersao obrigatóriostringVersão do aplicativo emissor do cupom fiscal. Preenchimento obrigatório.
idClienteintegerCódigo do cliente. Preenchimento opcional. - Se no XML não houver informações do cliente assumirá que a venda foi realizada para um cliente consumidor padrão. Caso não exista um cliente consumidor cadastrado, o mesmo será criado automaticamente. - Se no XML houver informações do cliente, seus dados serão consultados no Omie com base no CPF/CNPJ, caso não seja encontrado a tag cAcaoCliente será avaliada. Possível valores para tag cAcaoCliente: - CONSUMIDOR: assumirá que a venda foi realizada para um cliente consumidor padrão. Caso não exista um cliente consumidor cadastrado, o mesmo será criado automaticamente. - ERRO (padrão): Exigirá a definição de um idCliente válido. - INCLUIR: Com base nos dados do XML irá fazer a inclusão de um novo cliente.
idLocalEstoqueintegerCódigo do Local do Estoque. Preenchimento opcional. Caso não informado assumirá o Local de Estoque padrão.
idProjetointegerCódigo do projeto. Preenchimento opcional. Quando não informado, será criado um projeto padrão para o emissor de cupom fiscal.
idVendedorintegerCódigo do vendedor. Preenchimento opcional. Quando não informado, será criado um vendedor padrão para o emissor de cupom fiscal.
nfceMd5 obrigatóriostringMD5 do arquivo XML enviado em "nfceXml". Preenchimento obrigatório.
nfceXml obrigatóriostringXML da NFC-e enviada. Preechimento 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 "nfceMd5". Observação: Para requisições SOAP usar CDATA como demonstra o exemplo abaixo: &lt;![CDATA[Conteúdo do campo convertido]]&gt;

Exemplo de chamada

{
  "emiNome": "SeuPDV",
  "emiVersao": "1.01.02",
  "emiId": "PDV01",
  "chNFe": "",
  "nfceXml": "",
  "nfceMd5": "",
  "cAcaoCliente": "INCLUIR",
  "idCliente": 0,
  "idVendedor": 0,
  "idProjeto": 0,
  "idLocalEstoque": 0,
  "cNaoMovEstoque": "N",
  "cNaoGerarTitulo": "N",
  "cIncluirProduto": "N"
}
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