Serviços

Criar Serviço

Cadastra um serviço no catálogo da empresa para emissão simplificada de NFS-e Nacional (DPS / ADN).

Formas de Utilização do Serviço na NFER:
1.
Catálogo Centralizado (`POST /v1/services`): Cadastre previamente seus serviços com código interno, descrição, cTribNac (LC 116), regras de retenção e alíquotas da Reforma Tributária (IBS/CBS). Na emissão da NFS-e (POST /v1/nfse), basta informar serviceId.
2.
Emissão Inline Direta (`POST /v1/nfse`): Caso seu ERP prefira não manter um catálogo prévio na NFER, os dados do serviço podem ser enviados diretamente dentro do payload da DPS da NFS-e na hora de emitir.
3.
Reforma Tributária (IBS/CBS): O serviço suporta nativamente a configuração do IVA Dual (enableIbsCbs: true, cclassTrib, cNbs, cIndOp, alíquotas estadual/federal). Para prestadores do Simples Nacional ou emissão tradicional sem destaque do IVA, envie enableIbsCbs: false.
POST
https://api.nfer.me
/v1/services

Authorizations

X-API-Key
string
header
required

Chave de API emitida no painel NFER enviada no header da requisição.

Content-Type
string
header
required

application/json

Body

application/json
codigo
string
required

Código interno ou SKU do serviço no seu sistema.

Exemplo:SRV-SAAS-PRO
descricao
string
required

Descrição ou denominação do serviço prestado (até 255 caracteres).

Exemplo:Licenciamento de Software por Assinatura (SaaS) - Plano Pro
codigoTributacaoMunicipio
string
required

Código de Tributação Nacional (cTribNac da LC 116 com 6 dígitos, ex.: "010501") ou código municipal tributário.

Exemplo:010501
discriminacaoPadrao
string
opcional

Texto padrão sugerido para a discriminação dos serviços na DPS / DANFSE.

Exemplo:Assinatura mensal de plataforma em nuvem (SaaS) referente ao plano Pro. Período: vigência corrente.
valorUnitario
number
opcional

Valor unitário padrão do serviço.

Exemplo:149.90
unidade
string
opcional
default:UN

Unidade de medida do serviço (ex.: "UN", "MES", "HORA"). Padrão: "UN".

Exemplo:MES
cnae
string
opcional

Código CNAE fiscal correspondente à atividade (apenas números).

Exemplo:6203100
aliqIss
number
opcional

Alíquota de ISS em percentual (ex.: 2.0). Opcional (para optantes pelo Simples Nacional é calculada pelo PGDAS ou enviada na nota).

Exemplo:2.0
issRetido
boolean
opcional
default:false

Indica se o ISS é retido na fonte pelo tomador do serviço.

Exemplo:false
enableIbsCbs
boolean
opcional
default:true

Habilita o cálculo e destaque do IVA Dual da Reforma Tributária (IBS e CBS). Default: true.

Exemplo:true
cNbs
string
opcional

Código da Nomenclatura Brasileira de Serviços (NBS) com até 9 dígitos.

Exemplo:101011100
cIndOp
string
opcional
default:100301

Indicador de Operação da Reforma Tributária (ex.: "100301").

Exemplo:100301
cst
string
opcional
default:000

CST de IBS/CBS da Reforma Tributária (ex.: "000").

Exemplo:000
cclassTrib
string
opcional

Código de Classificação Tributária (cClassTrib) da Reforma Tributária (ex.: "000001").

Exemplo:000001
aliqIbsUf
number
opcional
default:0.0010

Alíquota estadual de IBS (ex.: 0.0010 para 0,10%).

Exemplo:0.0010
aliqIbsMun
number
opcional
default:0.0000

Alíquota municipal de IBS (ex.: 0.0000).

Exemplo:0.0000
aliqCbs
number
opcional
default:0.0090

Alíquota federal de CBS (ex.: 0.0090 para 0,90%).

Exemplo:0.0090
aliqPis
number
opcional

Alíquota de retenção ou tributação de PIS (%).

Exemplo:0.65
aliqCofins
number
opcional

Alíquota de retenção ou tributação de COFINS (%).

Exemplo:3.0
aliqInss
number
opcional

Alíquota de retenção de INSS na fonte (%).

Exemplo:11.0
aliqIr
number
opcional

Alíquota de retenção de Imposto de Renda na fonte (%).

Exemplo:1.5
aliqCsll
number
opcional

Alíquota de retenção de CSLL na fonte (%).

Exemplo:1.0
fiscalProfileId
string<uuid>
opcional

ID de Perfil Fiscal vinculado para resolução automática de regras tributárias.

status
"ativo" | "rascunho"
opcional
default:ativo

Status inicial do serviço no catálogo. Padrão: "ativo".

Exemplo:ativo

Response

application/json

Serviço cadastrado com sucesso no catálogo.

id
string<uuid>

Identificador único do recurso.

Exemplo:550e8400-e29b-41d4-a716-446655440000
company_id
string<uuid>

Identificador único da empresa emissora.

Exemplo:9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d
codigo
string

Exemplo retornado: "SRV-SAAS-PRO"

Exemplo:SRV-SAAS-PRO
descricao
string
Exemplo:Licenciamento de Software por Assinatura (SaaS) - Plano Pro
codigo_tributacao_municipio
string

Exemplo retornado: "010501"

Exemplo:010501
valor_unitario
number
Exemplo:149.9
unidade
string

Exemplo retornado: "MES"

Exemplo:MES
aliq_iss
integer
Exemplo:2
iss_retido
boolean
Exemplo:false
enable_ibs_cbs
boolean
Exemplo:true
c_nbs
string

Exemplo retornado: "101011100"

Exemplo:101011100
c_ind_op
string

Exemplo retornado: "100301"

Exemplo:100301
cst
string

Exemplo retornado: "000"

Exemplo:000
cclass_trib
string

Exemplo retornado: "000001"

Exemplo:000001
aliq_cbs
number
Exemplo:0.009
aliq_ibs_uf
number
Exemplo:0.001
aliq_ibs_mun
integer
Exemplo:0
status
string

Status atual do processamento da nota.

Exemplo:ativo
created_at
string<date-time>

Data e hora de criação do registro.

Exemplo:2026-10-13T02:00:00.000Z
curl --request POST \
  --url https://api.nfer.me/v1/services \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "codigo": "SRV-SAAS-PRO",
  "descricao": "Licenciamento de Software por Assinatura (SaaS) - Plano Pro",
  "codigoTributacaoMunicipio": "010501",
  "discriminacaoPadrao": "Assinatura mensal de plataforma em nuvem (SaaS) referente ao plano Pro. Período: vigência corrente.",
  "valorUnitario": 149.9,
  "unidade": "MES",
  "cnae": "6203100",
  "aliqIss": 2,
  "issRetido": false,
  "enableIbsCbs": true,
  "cNbs": "101011100",
  "cIndOp": "100301",
  "cst": "000",
  "cclassTrib": "000001",
  "aliqCbs": 0.009,
  "aliqIbsUf": 0.001,
  "aliqIbsMun": 0,
  "status": "ativo"
}'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "company_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "codigo": "SRV-SAAS-PRO",
  "descricao": "Licenciamento de Software por Assinatura (SaaS) - Plano Pro",
  "codigo_tributacao_municipio": "010501",
  "valor_unitario": 149.9,
  "unidade": "MES",
  "aliq_iss": 2,
  "iss_retido": false,
  "enable_ibs_cbs": true,
  "c_nbs": "101011100",
  "c_ind_op": "100301",
  "cst": "000",
  "cclass_trib": "000001",
  "aliq_cbs": 0.009,
  "aliq_ibs_uf": 0.001,
  "aliq_ibs_mun": 0,
  "status": "ativo",
  "created_at": "2026-10-13T02:00:00.000Z"
}