Emitir NFCe

POST /nfce/emitir

Emite uma Nota Fiscal de Consumidor Eletrônica (modelo 65).

Autenticação

Authorization: Bearer {token} ou x-api-key: {apiKey}

Parâmetros do Body

Campos Principais

Campo	Tipo	Obrigatório	Descrição
issuerId	string	✅	ID da empresa emissora
items	array	✅	Produtos vendidos
pagamentos	array	✅	Formas de pagamento
serie	number		Série (padrão: 1)
numero	number		Número (auto-increment)
destCPF	string		CPF do consumidor (opcional)
destNome	string		Nome do consumidor
troco	number		Valor do troco
informacoesComplementares	string		Info adicional

---

Objeto items[]

Campo	Tipo	Obrigatório	Descrição
codigo	string	✅	Código interno
descricao	string	✅	Descrição do produto
ncm	string	✅	NCM (8 dígitos)
cfop	string	✅	CFOP (ex: "5102" venda interna)
unidade	string	✅	Unidade ("UN", "KG", etc.)
quantidade	number	✅	Quantidade (mín: 0.0001)
valorUnitario	number	✅	Valor unitário (mín: R$ 0.01)
ean	string		EAN/GTIN (ou "SEM GTIN")
cest	string		CEST
valorTotal	number		Calculado automaticamente
desconto	number		Desconto no item
icms	object		ICMS do item
pis	object		PIS do item
cofins	object		COFINS do item

Objeto icms (do item)

Campo	Tipo	Descrição
origem	integer	0 Nacional, 1 Estrangeira
csosn	string	CSOSN (Simples Nacional): "102", "103", "300", "400", "500", "900"
cst	string	CST ICMS (Regime Normal): "00", "20", "40", "41", "60", "90"
aliquota	number	Alíquota ICMS (%)
baseCalculo	number	Base de cálculo
valor	number	Valor do ICMS

Objeto pis / cofins (do item)

Campo	Tipo	Descrição
cst	string	CST: "01", "02", "04", "06", "07", "08", "09", "49", "99"
baseCalculo	number	Base de cálculo
aliquota	number	Alíquota
valor	number	Valor

---

Objeto pagamentos[]

Campo	Tipo	Obrigatório	Descrição
forma	string	✅	"01" Dinheiro, "02" Cheque, "03" Cartão Crédito, "04" Cartão Débito, "15" Boleto, "17" PIX, "90" Sem pagamento
valor	number	✅	Valor do pagamento

---

Exemplo

curl -X POST https://api.engineapi.com.br/nfce/emitir \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "issuerId": "ISSUER_ID",
    "destCPF": "12345678909",
    "items": [{
      "codigo": "PROD001", "descricao": "Pão Francês",
      "ncm": "19059090", "cfop": "5102", "unidade": "KG",
      "quantidade": 0.5, "valorUnitario": 14.90,
      "icms": { "origem": 0, "csosn": "102" }
    }],
    "pagamentos": [{ "forma": "17", "valor": 7.45 }]
  }'

Resposta (200)

{
  "success": true,
  "invoice": {
    "id": "uuid",
    "accessKey": "35260211222333000144650010000000011000000019",
    "number": 1,
    "status": "AUTHORIZED",
    "qrcodeUrl": "https://nfce.sefaz.sp.gov.br/...",
    "qrcodeData": "data:image/png;base64,..."
  }
}