Processo Emissão NFC-e

Informações Gerais

Esta página descreve o fluxo técnico completo para emissão de NFC‑e no Emissor Fiscal.

Ela contempla os processos de emissão, consulta, cancelamento e inutilização.

Informações importantes:

Todas as tags contempladas no json de emissão estão disponíveis aqui: Tags
Os endpoints foram estruturados para refletir, sempre que possível, as tags definidas no Manual de Orientação do Contribuinte (MOC).

Jornada de Emissão:

Campos Emissor Fiscal x Campos MOC
Emissão NFC-e
Consulta NFC-e
Cancela NFC-e
Inutiliza NFC-e
Consulta Última Nota NFC-e
Evento de Conciliação Financeira - ECONF

Ambientes

Client 2.0: http://localhost:8089
- Autenticação: V1
Client em Nuvem:
- HML: https://api-client-hml.fiscalpartners.com.br/
- PRD: https://api-client.fiscalpartners.com.br/
- Autenticação: V3

Campos Emissor Fiscal x Campos MOC

No processo de emissão, os campos dos endpoints foram estruturados para refletir, sempre que possível, as tags definidas no Manual de Orientação do Contribuinte (MOC). No entanto, algumas nomenclaturas diferem das utilizadas no documento oficial, independente da interface de integração.

Por isso, apresentamos abaixo a correspondência entre os nomes adotados na API e as respectivas tags do MOC.

Tags exclusivas do Emissor Fiscal

Campo Emissor Fiscal	Campo MOC
TIPOIDCONS	dest
IDCONS	CPF, CNPJ ou idEstrangeiro
ItemNFCeList	det
NVEXMLList	NVE
itemICMSST	ICMSST
obsItem	obsItem (NT NT2021.004v1.20)
dadosFat	cobr
dupList	cobr
PagNFCeList	pag
obsContList	infAdic
obsFiscoList	infAdic
procRefList	infAdic (NT 2021.004)

Emissão NFC-e

Esta API é responsável pela emissão do documento fiscal NFC-e de forma online (tpemis = 1) ou contingência offline (tpemis = 9).

O tratamento para iniciar a emissão em contingência ocorre de forma automática a partir da falha na emissão do documento anterior, ou seja, quando um documento recebe o retorno M0020 ao ser emitido, o Client altera automaticamente o tpemis para 9.

Comportamento em contingência

Neste cenário, os clientes tem comportamentos distintos, conforme segue:

No Client 2.0: O cancelamento por substituição é executado de forma automática pelo componente quando ocorre o retorno M0020. O componente realiza o agendamento de cancelamento por substituição do primeiro documento se identificar nova tentativa de emissão com a mesma venda em contingência offline. Se não identificada nova tentativa de emissão, o documento que recebeu retorno M0020 será inutilizado ou cancelado de forma online (automaticamente).

No Client em Nuvem: A automação deve alimentar os parâmetros nNFSubstituida: Número da nota que será substituída pela nota atual e serieSubstituida: Série da nota que será substituída pela nota atual. Desta forma, a segunda nota será emitida em contingência referenciando a nota que será cancelada por substituição- a primeira nota emitida que recebeu M0020.

⚠️ Importante:

O Client em Nuvem não realizará o cancelamento por substituição caso o PDV não sinalizar qual documento deverá ser substituído no momento da emissão do documento em contingência offline.

Detalhamento da API de Emissão de NFC-e

Interfaces suportadas:

Endpoint Client 2.0: /NFCe/Autoriza
Endpoint Client em Nuvem: /nfcehubsender/Sale/Send
Método: POST
Header:
- Authorization: Token de autorização
- Content-Type: application/json

Dados dos parâmetros de envio:

Campo	Descrição	Conteúdo / Observação	Obrigatório
devolveXML*	Indica se o XML deve ou não ser retornado na requisição	true / false	Sim
tipoEmissao	Indica se o documento a ser gerado é NFC-e ou CF-e	0 - NFC-e	Sim
tpDANFE	Tipo de Danfe a ser retornado	1 = Retrato (Padrão) 3 = Resumido 5 = Simplificado 6 = Simplificado SC 7 = Etiqueta	Sim
tpImp	Tipo da Impressão. Deve ser informado de acordo com o tpDANFE indicado	1 = tpDanfe 1 (Retrato) 2 = tpDanfe 8 (Paisagem) 3 = tpDanfe 5 (Simplificado) Se não informado, Emissor Fiscal atribuirá valor 1	Não

DevolveXML: Na configuração do Client 2.0, caso seja informado o caminho do XML e indicado não neste campo, o XML será armazenado no diretório indicado.

Exemplo de payload de Envio

O retorno da API poderá ser o documento autorizado ou a rejeição do documento. Segue o detalhamento dos parâmetros retornados:

chNFe: Chave da nota fiscal
cStat: Status vinculado ao documento. Os possíveis status serão detalhados em tópico específico.
xMotivo: Descrição do status do documento
danfe: DANFE em PNG. Deverá decodificar de Base64
nNF: Número do documento fiscal
xUrlDanfe: URL de consulta do documento fiscal na Sefaz

Exemplo de Payload de Retorno

{
    "chNFe": "431111103111110001196500300000001111111111111",
    "danfe": (Retorno em Base64),
    "dhRetorno": "2024-11-21T09:44:58-03:00",
    "nNF": 78,
    "nProt": "143240001111143",
    "xmlCompactado": (Retorno em Base64),
    "xMotivo": "Autorizado o uso da NF-e",
    "xUrlDanfe": "https://www.sefaz.rs.gov.br/NFCE/NFCE-COM.aspx?p=4[...]"
}

Detalhamento campo cStat

Neste campo poderão haver retornos de status da SEFAZ e do Emissor Fiscal, conforme segue:

Retornos da SEFAZ

Autorização:
- 100 – Autorizado
Rejeições:
- Consultar todos os códigos de rejeição vinculados a emissão de documento no manual de orientação ao contribuinte (MOC – Anexo I) disponível no item “4.4.2. Tabela de Códigos de Rejeição”.

Retornos do Emissor Fiscal

Consultar retornos utilizando a API ListaCodigoStatusSefaz documentada em: APIs Auxiliares

Possíveis retornos HTTP

200 - Sucesso
400 – BadRequest
- Caso tenha algum problema nas informações enviadas, causando falha no Emissor Fiscal ou rejeição pela Sefaz
401 - Unauthorized
404 – NotFound
429 - TooManyRequests
500 - InternalServerError
503 - Service Unavailable

Consulta NFC-e

Endpoint Client 2.0: /NFCe/Consulta
Endpoint Client em Nuvem: /nfcehubservices/Sale/Search
Método: GET
Header:
- Authorization: Token de autorização
- Content-Type: application/jsoN
Parâmetros:
- nNF: Número do documento
- Série: Série do documento
- Cnpj = CNPJ do Emissor
- GeraDanfe = true|false. Define retorno da DANFE
- versão:
- tpAmb: Tipo do ambiente
- TpDanfe = = Tipo de DANFE
  - Retrato= 1 (Padrão)
  - Resumido = 3
  - Simplificado = 5
  - Simplificado SC = 6
  - Etiqueta = 7
  - Paisagem = 8
- DevolveXML: true/false. (Define retorno do XML)

Exemplo Payload Envio:

{
   "nNF": 212,
   "serie": 709,
   "CNPJ": "54517628001593",
   "DevolveXml": "true",
   "GeraDanfe": "true",
   "versao": "4.00",
   "tpAmb": "2",
   "tpDanfe": "2",
   "GeraDanfeHTML": "false"
}

Exemplo Payload Retorno:

{
    "ID": "",
    "chNFe": "35190754517628000111111090000001111111111119",
    "dhRetorno": "2025-07-01T10:36:45-03:00",
    "nProt": "13519000xxxxxx95",
    "cStat": "100",
    "xMotivo": "Autorizado o uso da NF-e",
    "xUrlDanfe": null,
    "Danfe": "AvCBSCi9Db250ZW50cyA2GvPocAzVtZRFCf/fzsQvk+H0R2mC7pQL1b36=",
    "XmlCompactado": "H4sIAAAAAAMJb2H6P22t0XwH0e2JP6BH1/Jlp9h8Z3APEcBoAAA==",
    "DanfeHTML": null,
    "mensagemSEFAZ": null,
    "UltimoDocumento": null,
    "CCCC": null,
    "cod": null,
    "numeroSessao": null,
    "xURLDanfeAutorizacao": null,
    "Arquivo_Danfe": null,
    "Arquivo_XML": null,
    "DataAlteracao": "2025-06-28T16:54:28.267",
    "Central_Contingencia": null,
    "IndicaPDVAutorizacao": "A",
    "IndicaPDVCancInut": "A",
    "IndicaPDVConsulta": "A",
    "URL_Consulta": null,
    "Consultou_Todos_Servidores": false,
    "tpEvento": null,
    "MensagemSolucao": null,
    "DesvioConsumoIndevido": false,
    "XmlEventoCompactado": null,
    "chaveNFeEnviada": null,
    "idNota": 0,
    "ExigeIdentificacaoDestinatarioContingencia": null,
    "cMsg": null,
    "xMsg": null,
    "RetornoIntegradorList": []
}

Cancela NFC-e

Endpoint Client 2.0: /NFCe/Cancela
Endpoint Client em Nuvem: /nfcehubservices/Sale/Cancel
Método: POST
Header:
- Authorization: Token de autorização
- Content-Type: application/jsos
Parâmetros:
- chNFe: Chave do documento que será cancelado
- dhEvento: Data do cancelamento
- xJust: Justificativa do cancelamento
- tpEvento: Código do evento de cancelamento
- versão:
- tpAmb: Tipo do ambiente.

Requisição de cancelamento online:

Exemplo Requisição de Cancelamento Online:

{
    "chNFe": "26211112411111000111111110000000011060301100",
    "dhEvento": "2025-12-05T17:10:28-03:00",
    "xJust": "CancelamentodeNFC-e",
    "tpEvento": 110111,
    "versao": "1.00",
    "tpAmb": 2,
    "DevolveXml": true
}

Requisição de cancelamento por substituição:

ChNFe: Chave da nota a ser cancelada
ChNFeRef: Chave da nota substituta da NFC-e a ser cancelada.

Exemplo Requisição de cancelamento por substituição:

{
    "chNFe": "431111103540310001111100300000071111131111178",
    "dhEvento": "{{DataHoraAtual}}",
    "xJust": "CancelamentodeNFC-e teste documentação",
    "tpEvento": 110112,
    "versao": "1.00",
    "tpAmb": 2,
    "chNFeRef": "43211110114011000119650030000001111111119505",
    "GeraDanfe": true,
    "DevolveXml": true
}

Exemplo Payload Retorno:

{
"ID": "",
    "chNFe": "2625121111116000111111110000000011011112300",
    "dhRetorno": "2025-07-16T11:22:32-03:00",
    "nProt": "143190001111166",
    "cStat": "135",
    "xMotivo": "Evento registrado e vinculado a NF-e",
    "xUrlDanfe": null,
    "Danfe": null,
    "XmlCompactado": "H4sIAAAAAAAE[...]yJwcAAA=",
    "DanfeHTML": null,
    "mensagemSEFAZ": null,
    "UltimoDocumento": null,
    "CCCC": null,
    "cod": null,
    "numeroSessao": null,
    "xURLDanfeAutorizacao": null,
    "Arquivo_Danfe": null,
    "Arquivo_XML": null,
    "DataAlteracao": "2025-07-11T14:37:42.297",
    "Central_Contingencia": false,
    "IndicaPDVAutorizacao": "A",
    "IndicaPDVCancInut": "A",
    "IndicaPDVConsulta": "A",
    "URL_Consulta": null,
    "Consultou_Todos_Servidores": false,
    "tpEvento": null,
    "MensagemSolucao": null,
    "DesvioConsumoIndevido": false,
    "XmlEventoCompactado": null,
    "chaveNFeEnviada": null,
    "idNota": 0,
    "ExigeIdentificacaoDestinatarioContingencia": false,
    "cMsg": null,
    "xMsg": null,
    "RetornoIntegradorList": []
}

Inutiliza NFC-e

Endpoint Client 2.0: /NFCe/Inutiliza
Endpoint Client em Nuvem: /nfcehubsender/Sale/Invalidate
Método: POST
Header:
- Authorization: Token de autorização
- Content-Type: application/jsoN
Parâmetros:
- ano: ano corrente
- CNPJ: Cnpj do emissor
- nNFFin: Número Final dos documentos a serem inutilizados
- nNFIni: Número Inicial dos documentos a serem inutilizados
- serie: Série dos documentos
- xJust: Justificativa da inutilização.
- devolveXML: Deseja o retorno do XML

Exemplo Payload Envio:

{
    "ano": 2025,
    "CNPJ": "54111118001113",
    "nNFFin": 901,
    "nNFIni": 901,
    "serie": 365,
    "Versao": "4.00",
    "TpAmb": 2,
    "xJust": "QUEBRA NA SEQUENCIA DE NUMERACAO EM FUNCAO DE PROBLEMAS TECNICOS.",
    "devolveXML": true
}

Exemplo Payload Retorno:

{
    "ID": "",
    "chNFe": "",
    "dhRetorno": "2025-07-01T11:11:33-03:00",
    "nProt": "135190001111149",
    "cStat": "102",
    "xMotivo": "Inutilizacao de numero homologado",
    "xUrlDanfe": null,
    "Danfe": null,
    "XmlCompactado": "H4sIAAAAAAAEAMVY6a/iyK7/4CsAEgAA",
    "DanfeHTML": null,
    "mensagemSEFAZ": null,
    "UltimoDocumento": null,
    "CCCC": null,
    "cod": null,
    "numeroSessao": null,
    "xURLDanfeAutorizacao": null,
    "Arquivo_Danfe": null,
    "Arquivo_XML": null,
    "DataAlteracao": "2025-06-28T16:54:28.267",
    "Central_Contingencia": null,
    "IndicaPDVAutorizacao": "A",
    "IndicaPDVCancInut": "A",
    "IndicaPDVConsulta": "A",
    "URL_Consulta": null,
    "Consultou_Todos_Servidores": false,
    "tpEvento": null,
    "MensagemSolucao": null,
    "DesvioConsumoIndevido": false,
    "XmlEventoCompactado": null,
    "chaveNFeEnviada": null,
    "idNota": 0,
    "ExigeIdentificacaoDestinatarioContingencia": null,
    "cMsg": null,
    "xMsg": null,
    "RetornoIntegradorList": []
}

Consulta Última Nota NFC-e

Para que o emissor consiga identificar qual a numeração da última nota de NFC-e que transitou no Emissor Fiscal, ele pode utilizar esta API.

Endpoint Client 2.0: /NFCe/GetUltimaNota
Endpoint Client em Nuvem: /hubservices/NFCe/NoteNumber/GetLast?Cnpj={{SaleCnpj}}&Serie=2
Método: GET
Header:
- Authorization: Token de autorização
- Content-Type: application/jsoN
Parâmetros:
- Cnpj = CNPJ do Emissor
- Série: Série do documento

Exemplo Payload Envio:

Exemplo Payload Retorno:

Evento de Conciliação Financeira - ECONF

O Evento de Conciliação Financeira (ECONF – código 110750) foi instituído pela Nota Técnica 2024.002. Ele permite ao emitente registrar à SEFAZ, de forma facultativa, que o pagamento referente a uma NF-e (modelo 55) ou NFC-e (modelo 65) foi efetivado, mesmo em data diversa da emissão. Após autorizado, integra o histórico da nota e fortalece a rastreabilidade fiscal.

Quando se aplica

O ECONF é adequado quando:

O pagamento ocorre em data diferente da emissão (ex.: cartão, boleto, transferência);
A empresa precisa demonstrar conciliação financeira formal para fins fiscais ou contábeis;
Há necessidade de alinhamento com o Registro 1601 da EFD‑ICMS/IPI.

⚠️ Importante:

Evento facultativo, não altera tributos, valores ou dados da nota;
Não substitui manifestação, carta de correção, cancelamento ou outros eventos fiscais;
O evento de cancelamento (110751) permite excluir informações registradas no ECONF original.

Endpoint Client 2.0: /NFCe/ConciliacaoFinanceira
Endpoint Client em Nuvem: nfcehubsender/api/NFWebApi/ConciliacaoFinanceira
Método: POST
Header:
- Authorization: Token de autorização
- Content-Type: application/json

Dados dos parâmetros de envio:

Tag	Descrição	Obrigatório
chNFe	Chave do documento fiscal a que o evento será vinculado	Sim
cAut	Identifica o número da autorização da transação da operação	Não
CNPJIF	CNPJ da instituição financeira, de pagamento, adquirente ou subadquirente.	Não
CNPJPag	Preencher informando o CNPJ do estabelecimento onde o pagamento foi processado/ transacionado/recebido quando a emissão do documento fiscal ocorrer em estabelecimento distinto.	Sim
CnpjReceb	Informar o CNPJ do estabelecimento beneficiário do pagamento	Sim
dPag	Data do Pagamento no formato AAAA-MM-DD. Em caso de pagamentos agendados, informar a data da efetivação.	Sim
indPag	0= Pagamento à Vista 1= Pagamento à Prazo	Não
tBand	Utilizar a Tabela de Códigos das Operadoras de cartão de crédito e/ou débito publicada no Portal Nacional da Nota Fiscal Eletrônica.	Não
tPag	Meio de Pagamento - Utilizar a Tabela de códigos dos meios de pagamentos publicada no Portal Nacional da Nota Fiscal Eletrônica	Sim
UFPag	UF do CNPJ do estabelecimento onde o pagamento foi processado/transacionado/recebido.	Sim
UfReceb	UF do CNPJ do estabelecimento beneficiário do pagamento.	Sim
vPag	Valor do Pagamento	Sim
xPag	Descrição do meio de pagamento. Preencher informando o meio de pagamento utilizado quando o código do meio de pagamento for informado como 99-outros.	Não

Exemplo de Payload de Envio

{
    "chNFe": "43251154517628001593650020002647981739959246",
    "detPagList": [
        {
            "cAut": "88899991111",
            "CNPJIF": "59438325000101",
            "CNPJPag": "54517628001593",
            "CnpjReceb": "59438325000101",
            "dPag": "2025-11-10",
            "indPag": 1,
            "tBand": 3,
            "tPag": 3,
            "UFPag": "RS",
            "UfReceb": "RS",
            "vPag": 67.2,
            "xPag": "Cartão"
        }
    ],
    "Protocolo": "c1f3f362-4bce-47a1-9445-bf19eabb054e"
}

Possíveis retornos HTTP

200 - Sucesso
400 – BadRequest
- Caso tenha algum problema nas informações enviadas, causando falha no Emissor Fiscal
401 - Unauthorized
404 – NotFound
429 - TooManyRequests
500 - InternalServerError
503 - Service Unavailable

Cancelamento Conciliação Financeira - ECONF

Endpoint Client 2.0: /NFCe/CancelaConciliacaoFinanceira
Endpoint Client em Nuvem: nfcehubsender/api/NFWebApi/CancelamentoConciliacaoFinanceira
Método: POST
Header:
- Authorization: Token de autorização
- Content-Type: application/json

Exemplo Payload Envio:

{
    "chNFe": "43251154517628001593650020002647981739959246",
    "Protocolo": "1578f1e3-4582-4865-acd9-3edba948b7df",
    "ProtocoloConciliacao": "c1f3f362-4bce-47a1-9445-bf19eabb054e"
}

Possíveis retornos HTTP

200 - Sucesso
400 – BadRequest
- Caso tenha algum problema nas informações enviadas, causando falha no Emissor Fiscal
401 - Unauthorized
404 – NotFound
429 - TooManyRequests
500 - InternalServerError
503 - Service Unavailable

Este conteúdo foi útil para você?

Ambientes​

Campos Emissor Fiscal x Campos MOC​

Emissão NFC-e​

Consulta NFC-e​

Cancela NFC-e​

Inutiliza NFC-e​

Consulta Última Nota NFC-e​

Evento de Conciliação Financeira - ECONF​

Cancelamento Conciliação Financeira - ECONF​

Ambientes

Campos Emissor Fiscal x Campos MOC

Emissão NFC-e

Consulta NFC-e

Cancela NFC-e

Inutiliza NFC-e

Consulta Última Nota NFC-e

Evento de Conciliação Financeira - ECONF

Cancelamento Conciliação Financeira - ECONF