Emissão

O serviço de emissão de NF-e é responsável por realizar a validação dos dados da NF-e 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.

O retorno deste serviço contém o status de recebimento da NF-e pela API e o código nsNRec para consulta de status de processamento.

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: 

• Id (atributo da tag infNFe)
• cNF
• cDV
• dhCont
• xJust

URL

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

Dados de entrada

Os dados da NF-e para o método de emissão podem ser enviados em JSON, XML ou TXT.

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 NF-e 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 NF-e. 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 NF-e no formato XML:

Envio de dados em formato TXT

Para envio dos dados em TXT o Content-Type da requisição deverá ser definido como text/plain;charset=utf-8 e o X-AUTH-TOKEN deverá ser enviado no cabeçalho HTTP.

No envio em formato TXT o corpo da requisição deverá conter o conteúdo do TXT com as informações da NF-e. Esse conteúdo deverá ser gerado a partir do layout do TXT de emissão do integrador local da NS Tecnologia.

Clicando no arquivo abaixo é possível fazer o download de um exemplo completo de NF-e no formato TXT (layout NS Tecnologia):

Exemplo de requisição

Requisição de emissão de NF-e em JSON

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

Requisição de emissão de NF-e em TXT

curl -X POST \
    -H "X-AUTH-TOKEN: SEU_TOKEN" \
    -H "Content-Type: text/plain" \
    -d 'NOTA FISCAL|1| \
        A|3.10||' \
    https://nfe.ns.eti.br/nfe/issue

Requisição de emissão de NF-e em XML

curl -X POST \
    -H "X-AUTH-TOKEN: SEU_TOKEN" \
    -H "Content-Type: application/xml" \
    -d '<NFe xmlns="http://www.portalfiscal.inf.br/nfe">
        <infNFe versao="3.10" >
           <ide>
              <cUF>43</cUF>
              <cNF>00009483</cNF>
              <natOp>VENDA DE MERCADORIA</natOp>
          ...
        </NFe>' \
    https://nfe.ns.eti.br/nfe/issue

Dados retornados

Exemplos de retorno

Retorno com sucesso

{
  "status": 200,
  "motivo": "NF-e enviada para Sefaz",
  "nsNRec": "1438"
}

Retorno com erro de dados

{
  "status": -2,
  "motivo": "NFe invalido de acordo com a validacao contra schema",
  "erros": [
    "cvc-pattern-valid: Value '9618000' is not facet-valid with respect to pattern '[0-9]{8}' for type '#AnonType_CEPTEndereco'.",
    "O campo 'CEP' foi preenchido incorretamente com o valor '9618000'. Este campo deve ser preenchido com numeros e conter exatamente 8 caracteres."
  ]
}

Códigos de retorno