Emitir NFSe

POST /nfse/emitir

Emite uma Nota Fiscal de Serviço Eletrônica.

Autenticação

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

Parâmetros do Body

Campos Obrigatórios

Campo	Tipo	Descrição
issuerId	string	ID da empresa emissora
tomador	object	Dados do tomador do serviço
servico	object	Dados do serviço prestado

Campos Opcionais

Campo	Tipo	Descrição
rps	object	Dados do RPS (Recibo Provisório de Serviços)
naturezaOperacao	integer	1 Tributação no município, 2 Fora do município, 3 Isenção, 4 Imune
regimeTributacao	integer	1 ME/EPP Simples Nacional, 2 Estimativa, 3 Soc. Profissionais, 4 Cooperativa
optanteSimples	boolean	Optante pelo Simples Nacional
exigibilidadeISS	integer	1 Exigível, 2 Não incidência, 3 Isenção, 4 Exportação, 5 Imunidade
retencoes	object	Retenções tributárias
informacoesComplementares	string	Info adicional

---

Objeto tomador

Campo	Tipo	Obrigatório	Descrição
cnpjCpf	string	✅	CNPJ ou CPF do tomador
razaoSocial	string	✅	Razão social
endereco	object	✅	Endereço completo
email	string		E-mail
telefone	string		Telefone
inscricaoMunicipal	string		IM do tomador

Objeto endereco (do tomador)

Campo	Tipo	Obrigatório	Descrição
logradouro	string	✅	Rua/Avenida
numero	string	✅	Número
bairro	string	✅	Bairro
codigoMunicipio	string	✅	Código IBGE
uf	string	✅	UF
cep	string	✅	CEP
complemento	string		Complemento

---

Objeto servico

Campo	Tipo	Obrigatório	Descrição
codigoMunicipio	string	✅	Código IBGE do local de prestação
itemListaServico	string	✅	Item da Lista LC 116/2003 (ex: "1.01")
discriminacao	string	✅	Descrição detalhada do serviço
valorServicos	number	✅	Valor total dos serviços
codigoCnae	string		Código CNAE
aliquotaIss	number		Alíquota ISS (ex: 0.05 = 5%)
valorDeducoes	number		Deduções
descontoIncondicionado	number		Desconto incondicionado
descontoCondicionado	number		Desconto condicionado

---

Objeto rps

Campo	Tipo	Obrigatório	Descrição
numero	integer	✅	Número do RPS
serie	string		Série do RPS
tipo	integer		1 RPS, 2 Nota Fiscal Conjugada, 3 Cupom

---

Objeto retencoes

Campo	Tipo	Descrição
irrf	number	Valor IRRF retido
csll	number	Valor CSLL retido
cofins	number	Valor COFINS retido
pis	number	Valor PIS retido
inss	number	Valor INSS retido
outrasRetencoes	number	Outras retenções

---

Exemplo

curl -X POST https://api.engineapi.com.br/nfse/emitir \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "issuerId": "ISSUER_ID",
    "naturezaOperacao": 1,
    "optanteSimples": true,
    "tomador": {
      "cnpjCpf": "99888777000155",
      "razaoSocial": "Empresa Tomadora LTDA",
      "email": "contato@empresa.com",
      "endereco": {
        "logradouro": "Av Paulista",
        "numero": "1000",
        "bairro": "Bela Vista",
        "codigoMunicipio": "3550308",
        "uf": "SP",
        "cep": "01310100"
      }
    },
    "servico": {
      "codigoMunicipio": "3550308",
      "itemListaServico": "1.01",
      "codigoCnae": "6201501",
      "discriminacao": "Desenvolvimento de software conforme contrato 123/2026",
      "valorServicos": 10000.00,
      "aliquotaIss": 0.05
    }
  }'

Resposta (200)

{
  "success": true,
  "nfse": {
    "id": "uuid",
    "number": "202600001",
    "status": "AUTHORIZED",
    "valorServicos": 10000.0,
    "valorIss": 500.0
  }
}