Emissão

O serviço de emissão de NFCom é responsável por realizar a validação dos dados da NFCom enviados de acordo com os tipos de dados definidos pelos schemas XMLs da Sefaz e realizar o envio do documento para processamento no WebService do Portal da Secretaria da Fazenda.

Campos preenchidos automaticamente pela API

A lista abaixo apresenta os campos e atributos do layout de emissão que serão preenchidos automaticamente pela API caso não sejam enviados: 

URL

Produção: POST https://nfcom.ns.eti.br/nfcom/issue

Dados de entrada

Os dados da NFCom para o método de emissão podem ser enviados em JSON ou XML.

Envio de dados em formato JSON

Para envio dos dados em JSON do Content-Type da requisição deverá ser definido como application/json.

Clicando no arquivo abaixo é possível fazer o download de um exemplo completo de NFCom no formato JSON:

Envio de dados em formato XML

Para envio dos dados em XML o Content-Type da requisição deverá ser definido como application/xml e o X-AUTH-TOKEN deverá ser enviado no cabeçalho HTTP.

No envio em formato XML o corpo da requisição deverá conter o conteúdo do XML com as informações da NFCom. Esse conteúdo deverá ser gerado a partir do layout do Manual de Orientações do Contribuinte da Sefaz.

Clicando no arquivo abaixo é possível fazer o download de um exemplo completo de NFCom no formato XML:

Exemplo de requisição

Requisição de emissão de NFCom em JSON

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{
         "X-AUTH-TOKEN":"...",
         "NFCom":{...}
        }' \
https://nfcom.ns.eti.br/nfcom/issue

Requisição de emissão de NFCom em XML

curl -X POST \
    -H "X-AUTH-TOKEN: SEU_TOKEN" \
    -H "Content-Type: application/xml" \
    -d 'NFCom xmlns="http://www.portalfiscal.inf.br/nfcom">
	   <infNFCom versao="1.00" Id="NFCom43240107364617000135620000000000011000000016">
		<ide>
			<cUF>43</cUF>
			<tpAmb>2</tpAmb>
			<mod>62</mod>
          ...
        </NFCom>' \
    https://nfcom.ns.eti.br/nfcom/issue

Dados retornados

Exemplos de retorno

Retorno com sucesso

{
 "status": 200,
 "motivo": "NFCom enviada para Sefaz",
 "nsNRec": "1234"
}

Retorno com erro de dados

{
 "status": -2,
 "motivo": "NFCom invalida de acordo com a validacao contra schema",
 "erros": [
 "O campo 'CEP' foi preenchido incorretamente com o valor '9003000'. Este campo deve ser preenchido com nu
 ]
}

Códigos de retorno