Skip to main content

Emissão de NF-e

Método: POST

Endpoint: https://api.emitix.com.br/nfe/emitir

Descrição Geral

Esta rota permite a emissão de uma Nota Fiscal Eletrônica (NF-e) diretamente para a SEFAZ, enviando todas as informações fiscais e tributárias necessárias para a criação do documento fiscal válido.

O sistema processa o XML da NF-e, realiza a assinatura digital utilizando o certificado do emitente, e envia para a SEFAZ o pedido de autorização. A resposta indica se a nota foi autorizada, rejeitada ou se houve alguma pendência.

Função da Rota

A rota tem como função principal:

  • Receber os dados da NF-e no formato estruturado conforme o layout exigido pela SEFAZ;
  • Realizar a assinatura digital do XML usando o certificado enviado;
  • Enviar a NF-e para autorização na SEFAZ;
  • Retornar o protocolo e a situação da NF-e após o processamento.

Situações de Uso

Use esta rota quando:

  • For necessário emitir uma nova NF-e para uma venda ou prestação de serviço;
  • Precisar garantir que a NF-e seja assinada digitalmente e enviada para a SEFAZ com segurança;
  • Integrar sistemas de faturamento e ERP com a SEFAZ para emissão automática de notas fiscais.

Campos da Requisição (Payload)

CampoTipoObrigatórioDescrição
nfearrayLista com os objetos NF-e a serem emitidos (normalmente apenas 1 por requisição).
nfe[].ideobjectIdentificação da NF-e, contendo informações como UF, natureza da operação, série, etc.
nfe[].emitobjectDados do emitente da NF-e (CNPJ, nome, endereço, inscrição estadual, CRT).
nfe[].destobjectDados do destinatário da NF-e (CNPJ, nome, endereço, inscrição estadual, etc).
nfe[].detarrayLista de detalhes dos produtos/serviços da NF-e, incluindo tributação.
nfe[].totalobjectValores totais da NF-e (produtos, impostos, valor da nota, etc).
nfe[].transpobjectInformações sobre transporte e modalidade de frete.
nfe[].pagobjectDados de pagamento da NF-e.
indSincstringIndicador de envio síncrono (1) ou assíncrono (0).
certificatestringCertificado digital em Base64 para assinatura da NF-e.
pass_certificatestringSenha do certificado digital.

Observação: Para mais detalhes dos campos internos e as possibilidades de emissão, consulte o layout da NF-e disponibilizado na nossa documentação do Swagger: https://api.emitix.com.br/api.


Exemplo de Payload

{
"nfe": [
{
"ide": {
"cUF": "35",
"natOp": "Venda de mercadoria",
"mod": "55",
"serie": "4",
"dhEmi": "2025-11-03T08:00:00-03:00",
"tpNF": "1",
"idDest": "1",
"cMunFG": "3550308",
"tpImp": "1",
"tpEmis": "1",
"tpAmb": "2",
"finNFe": "1",
"indFinal": "1",
"indPres": "1",
"procEmi": "0",
"verProc": "1.0"
},
"emit": {
"CNPJ": "74363615000119",
"xNome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
"enderEmit": {
"xLgr": "Rua Exemplo",
"nro": "100",
"xBairro": "Centro",
"cMun": "3550308",
"xMun": "São Paulo",
"UF": "SP",
"CEP": "01000000",
"cPais": "1058",
"xPais": "Brasil",
"fone": "1130000000"
},
"IE": "391036600111",
"CRT": "1"
},
"dest": {
"CNPJ": "74363615000119",
"xNome": "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL",
"enderDest": {
"xLgr": "Rua do Cliente",
"nro": "200",
"xBairro": "Bairro Cliente",
"cMun": "3550308",
"xMun": "São Paulo",
"UF": "SP",
"CEP": "01000001",
"cPais": "1058",
"xPais": "Brasil",
"fone": "11999999999"
},
"IE": "391036600111",
"indIEDest": "1"
},
"det": [
{
"prod": {
"cProd": "008",
"cEAN": "SEM GTIN",
"xProd": "Monitor Gamer Mancer 165Hz",
"NCM": "84716053",
"CFOP": "5102",
"uCom": "UN",
"qCom": "1.0000",
"vUnCom": "1500.00",
"vProd": "1500.00",
"cEANTrib": "SEM GTIN",
"uTrib": "UN",
"qTrib": "1.0000",
"vUnTrib": "1500.00",
"indTot": "1"
},
"imposto": {
"ICMS": {
"ICMSSN102": {
"orig": "0",
"CSOSN": "102"
}
},
"PIS": {
"PISAliq": {
"CST": "01",
"vBC": "1500.00",
"pPIS": "0.65",
"vPIS": "9.75"
}
},
"COFINS": {
"COFINSAliq": {
"CST": "01",
"vBC": "1500.00",
"pCOFINS": "3.00",
"vCOFINS": "45.00"
}
}
}
}
],
"total": {
"ICMSTot": {
"vBC": "0.00",
"vICMS": "0.00",
"vICMSDeson": "0.00",
"vFCP": "0.00",
"vBCST": "0.00",
"vST": "0.00",
"vFCPST": "0.00",
"vFCPSTRet": "0.00",
"vProd": "1500.00",
"vFrete": "0.00",
"vSeg": "0.00",
"vDesc": "0.00",
"vII": "0.00",
"vIPI": "0.00",
"vIPIDevol": "0.00",
"vPIS": "9.75",
"vCOFINS": "45.00",
"vOutro": "0.00",
"vNF": "1500.00"
}
},
"transp": {
"modFrete": "0"
},
"pag": {
"detPag": [
{
"indPag": "0",
"tPag": "01",
"vPag": "1500.00"
}
]
}
}
],
"indSinc": "1",
"certificate": "HASH_DO_CERTIFICADO",
"pass_certificate": "SENHA_DO_CERTIFICADO"
}

Exemplo de Requisição Completa

curl -X POST https://api.emitix.com.br/nfe/emitir \
-H "Content-Type: application/json" \
-H "Authorization: Bearer SEU_TOKEN_AQUI" \
-H "api-key: SUA_API_KEY_AQUI" \
-d '{Payload}'

Exemplo de Resposta

[
{
"message": "NFe emitida com sucesso",
"statusCode": 201,
"isContingency": false,
"success": true,
"chaveAcesso": "352511743636...",
"DANFE": "https://storage.googleapis.com/emitix-9ec66.firebasestorage.app/NFE%2F_CHAVE_DE_ACESSO.pdf",
"sefazResponse": {
"tpAmb": "2",
"verAplic": "SP_NFE_PL009_V4",
"chNFe": "352511743636...",
"dhRecbto": "2025-11-03T10:39:45-03:00",
"nProt": "135250008202365",
"digVal": "29t75jX4hLw5Fl1xI9txQkWt1u0=",
"cStat": "100",
"xMotivo": "Autorizado o uso da NF-e"
},
"xml": [
"<NFe xmlns=\"http://www.portalfiscal.inf.br/nfe\">...</NFe>"
]
}
]