Perfis Fiscais

Simular Regra Fiscal (Preview)

Simula a resolução fiscal em tempo real para um destino e tipo de cliente específicos, retornando o CFOP e tributos que o NFER aplicará.

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

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
fiscalProfileId
string<uuid>
required

ID do perfil fiscal a testar.

Exemplo:b1b0b5c1-3d7a-4c2e-9d8f-1a2b3c4d5e6f
ufDestinatario
string
required

Sigla da UF de destino (2 letras ou "EX").

Exemplo:RJ
tipoPessoa
string
required

Tipo do comprador: "F" (Pessoa Física) ou "J" (Pessoa Jurídica).

Exemplo:F
temIE
boolean
opcional
default:false

Se o cliente possui Inscrição Estadual ativa.

Exemplo:false
isSaida
boolean
opcional
default:true

True para saída/venda, false para entrada/compra.

Response

application/json

Regra fiscal resolvida com sucesso.

success
boolean
opcional
Exemplo:true
direcao
string
opcional

Exemplo retornado: "saida_inter"

Exemplo:saida_inter
rule
object
opcional
Simular Regra Fiscal (Preview)
curl --request POST \
  --url https://api.nfer.me/v1/fiscal-profiles/preview \
  --header 'X-API-Key: <sua_chave_api>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fiscalProfileId": "b1b0b5c1-3d7a-4c2e-9d8f-1a2b3c4d5e6f",
  "ufDestinatario": "RJ",
  "tipoPessoa": "F",
  "temIE": false,
  "isSaida": "true"
}'
{
  "success": true,
  "direcao": "saida_inter",
  "rule": {
    "cfop": "6102",
    "csosn": "102",
    "cst_icms": null,
    "aliq_icms": 0,
    "cst_pis": "07",
    "aliq_pis": 0,
    "cst_cofins": "07",
    "aliq_cofins": 0,
    "tem_st": false
  }
}