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)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
nfe | array | ✅ | Lista com os objetos NF-e a serem emitidos (normalmente apenas 1 por requisição). |
nfe[].ide | object | ✅ | Identificação da NF-e, contendo informações como UF, natureza da operação, série, etc. |
nfe[].emit | object | ✅ | Dados do emitente da NF-e (CNPJ, nome, endereço, inscrição estadual, CRT). |
nfe[].dest | object | ✅ | Dados do destinatário da NF-e (CNPJ, nome, endereço, inscrição estadual, etc). |
nfe[].det | array | ✅ | Lista de detalhes dos produtos/serviços da NF-e, incluindo tributação. |
nfe[].total | object | ✅ | Valores totais da NF-e (produtos, impostos, valor da nota, etc). |
nfe[].transp | object | ✅ | Informações sobre transporte e modalidade de frete. |
nfe[].pag | object | ✅ | Dados de pagamento da NF-e. |
indSinc | string | ✅ | Indicador de envio síncrono (1) ou assíncrono (0). |
certificate | string | ✅ | Certificado digital em Base64 para assinatura da NF-e. |
pass_certificate | string | ✅ | Senha 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>"
]
}
]