Emissão

Emissão de NFC-e

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

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

URL

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

Dados de entrada

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 NFC-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 NFC-e no formato TXT (layout NS Tecnologia):

Exemplo TXT

Exemplo de requisição

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

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

Dados retornados

Campo	Descrição	Pai	Tipo	Ocorrência	Observação
status	Código de status do processamento		N	1-1
motivo	Descrição literal do status de processamento		A	1-1

nfeProc	Objeto com dados de processamento da NFC-e		O	0-1	Somente em status = 100 ou -100
cStat	Status de processamento pela Sefaz	nfeProc	N	1-1
xMotivo	Descrição literal do processamento pela Sefaz	nfeProc	A	1-1
nProt	Número do protocolo de autorização	nfeProc	N	0-1	Somente em cStat = 100
digVal	Digest Value	nfeProc	A	0-1	Somente em cStat = 100
chNFe	Chave da NFC-e	nfeProc	N	0-1	Somente em cStat = 100
serie	Série da NFC-e	nfeProc	N	0-1	Somente em cStat = 100
numero	Número da NFC-e	nfeProc	N	0-1	Somente em cStat = 100
dhRecbto	Data e hora de recebimento pela Sefaz	nfeProc	D	0-1	Somente em cStat = 100 Padrão Sefaz AAAA-MM-DDTHH:MM:SS + UTC Ex.: 2016-06-13T15:04:10-02:00
xml	XML de distribuição da NFC-e	nfeProc	A	0-1	Somente em cStat = 100

Exemplos de retorno

Retorno com sucesso

{
    "status": 100,
    "motivo": "NFC-e autorizada com sucesso",
    "nfeProc": {
        "nProt": "143170001690341",
        "digVal": "IyD4IOIeSOxIR1ZXHYc7vSqQqH0=",
        "cStat": 100,
        "xMotivo": "Autorizado o uso da NF-e",
        "chNFe": "NFe43171007364617000135650010000064961000021614",
        "serie": "1",
        "numero": "6496",
        "dhRecbto": "2017-10-14T00:00:21-03:00"
    },
    "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\"?><nfeProc xmlns=\"http://www.portalfiscal.inf.br/nfe\" versao=\"3.10\"><NFe xmlns=\"http://www.portalfiscal.inf.br/nfe\"><infNFe versao=\"3.10\" Id=\"NFe43171007364617000135650010000064961000021614\"><ide>...</nfeProc>"
}

Retorno com erro de dados

{
    "status": -995,
    "motivo": "NFCe invalido de acordo com a validacao contra schema",
    "erros": [
        "NVE : cvc-pattern-valid: Value 'AB123' is not facet-valid with respect to pattern '[A-Z]{2}[0-9]{4}' for type '#AnonType_NVEproddetinfNFeTNFe'."
    ]
}

Códigos de retorno

Código	Descrição
100	NFC-e autorizada com sucesso
-100	NFC-e não autorizada Verifique o campo nfeProc.cstat e nfeProc.xMotivo para identificar o motivo
-1	Content-Type enviado inválido
-3	NFC-e não enviada no corpo da requisição
-4	Erro ao carregar os dados do NFCe O campo motivo terá maiores informações
-5	CSC não encontrado para o emitente e tipo de ambiente
-6	Versão do layout deve ser informada em NFe/infNFe/versao
-995	NFC-e inválida de acordo com a validação contra o XSD Verifique o campo erros para identificar os erros de validação
-996	Sem permissões para gerenciar documentos do CNPJ contribuinte
-997	Campos obrigatórios não informados O campo motivo terá maiores informações
-999	Erro interno ao processar a requisição O campo motivo terá maiores informações

NS NFCe