Perfis Fiscais

Criar Perfil Fiscal

Cadastra um novo perfil fiscal. O NFER gera automaticamente a matriz de regras fiscais (CFOP, ICMS/CSOSN, PIS, COFINS) com base no CRT e UF da sua empresa.

POST
https://api.nfer.me
/v1/fiscal-profiles

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
nome
string
required

Nome identificador do perfil (ex: "Revenda Geral", "Indústria E-commerce").

Exemplo:Revenda Interestadual
segmento
string
required

Segmento operacional: "revenda", "industrializacao", "servico", "uso_consumo" ou "ativo_imobilizado".

Exemplo:revenda
paraConsumidorFinal
boolean
opcional
default:true

Se true, configura as regras internas para consumidor final.

descricao
string
opcional

Observações internas sobre o perfil.

Exemplo:Regras de revenda para produtos adquiridos de terceiros

Response

application/json

Perfil fiscal criado com regras geradas automaticamente.

id
string<uuid>
opcional

Identificador único do recurso.

Exemplo:b1b0b5c1-3d7a-4c2e-9d8f-1a2b3c4d5e6f
nome
string
opcional

Exemplo retornado: "Revenda Interestadual"

Exemplo:Revenda Interestadual
segmento
string
opcional

Exemplo retornado: "revenda"

Exemplo:revenda
para_consumidor_final
boolean
opcional
Exemplo:true
active
boolean
opcional
Exemplo:true
Criar Perfil Fiscal
curl --request POST \
  --url https://api.nfer.me/v1/fiscal-profiles \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "nome": "Revenda Interestadual",
  "segmento": "revenda",
  "paraConsumidorFinal": "true",
  "descricao": "Regras de revenda para produtos adquiridos de terceiros"
}'
{
  "id": "b1b0b5c1-3d7a-4c2e-9d8f-1a2b3c4d5e6f",
  "nome": "Revenda Interestadual",
  "segmento": "revenda",
  "para_consumidor_final": true,
  "active": true
}