Organização & Conta

Cadastros

Clientes, produtos, transportadoras e perfis fiscais.

A NFER oferece uma infraestrutura completa de cadastros fiscais reutilizáveis para clientes (destinatários), catálogo de produtos, transportadoras e perfis tributários. Você pode cadastrar e gerenciar essas entidades previamente via API/Painel ou criá-las automaticamente de forma inline no momento da emissão da nota fiscal.

Upsert Automático

Envie clientes ou itens direto no payload da NF-e; o NFER cria ou atualiza sem duplicidades.

Resolução IBGE Nativa

Basta informar o CEP ou Cidade + UF; o código oficial IBGE do município é resolvido automaticamente.

Perfis Tributários

Regras fiscais pré-configuradas de CFOP, CSOSN, CST, PIS e COFINS aplicadas por segmento.

Clientes (Destinatários)

Gerencie pessoas físicas (CPF) e jurídicas (CNPJ) para emissão de NF-e e NFC-e. Os campos email e telefone são 100% opcionais para a autorização na SEFAZ. O campo cMun (código IBGE do município) é preenchido automaticamente caso você envie o CEP ou o par Cidade/UF.

Campo de Status (Sem Breaking Change)

Os cadastros de clientes possuem o campo opcional status ("ativo" | "rascunho"). O campo é 100% retrocompatível: se for omitido, assume o padrão "ativo".

Modo Inline: Na emissão da nota (POST /v1/nfe), você pode enviar o objeto destinatario ou customer diretamente no payload. Se o cliente não existir, ele será registrado; se já existir, seus dados serão atualizados.

Utilize os endpoints dedicados caso prefira pré-sincronizar sua base de contatos com a API.

{

"nome": "Cliente Exemplo LTDA",

"cpfCnpj": "00000000000191",

"tipoPessoa": "J",

"status": "ativo",

"ie": "123456789",

"email": "financeiro@clienteexemplo.com.br",

"telefone": "11999998888",

"endereco": {

"logradouro": "Avenida Paulista",

"numero": "1000",

"bairro": "Bela Vista",

"xMun": "São Paulo",

"UF": "SP",

"CEP": "01310100"

}

Operação	Método e Rota	Referência Técnica
Listar Clientes (Filtro por Status)	GET /v1/customers	Ver Listagem →
Cadastrar Novo Cliente	POST /v1/customers	Ver Parâmetros →
Consultar Cliente por ID	GET /v1/customers/:id	Ver Detalhes →
Atualizar Cadastro do Cliente	PUT /v1/customers/:id	Ver Atualização →

Catálogo de Produtos

Mantenha seu catálogo de itens cadastrado com NCM, CFOP padrão, alíquotas e pesos. Na emissão de notas com frete, o peso unitário é somado automaticamente no cálculo do volume da carga.

Regras Tributárias:

Simples Nacional (CRT 1 ou 2): Utilize o código csosn (ex: 102 tributada sem permissão de crédito, 500 ICMS cobrado anteriormente por ST).
Regime Normal (CRT 3 — Lucro Real / Presumido): Utilize o código cst (ex: 00 tributada integralmente, 20 com redução de base, 40 isenta, 60 cobrado por ST).
Substituição Tributária (CEST): Se o produto for sujeito ao regime de ST, informe o cest com 7 dígitos (ex: 2805700).
Reforma Tributária (IBS/CBS): Configure cClassTrib (6 dígitos, ex: 200034), cstIbscbs (3 dígitos, ex: 200) e reducaoIbscbs (% de redução). Opcional — se omitido, o Perfil Fiscal resolve automaticamente. Vigência a partir de 03/08/2026 exclusivamente para Regime Normal (CRT 3); emitentes do Simples Nacional estão blindados e dispensados nesta fase.
Overrides Manuais: Suporte opcional a cstPis, aliqPis, cstCofins, aliqCofins, cstIpi, aliqIpi, aliqIcms e reducaoBcIcms.
Pesos: Informe pesoLiquido e pesoBruto em quilogramas (kg) por unidade.

{

"sku": "SKU-9821",

"nome": "Monitor Gamer 27 165Hz IPS",

"ncm": "85285200",

"cest": "2103100",

"unidade": "UN",

"valor_unitario": 1299.00,

"origem": 0,

"tipoItem": "00",

"status": "ativo",

"csosn": "102",

"cClassTrib": "000001",

"cstIbscbs": "000",

"reducaoIbscbs": 0.00,

"pesoLiquido": 4.500,

"pesoBruto": 5.200

}

Operação	Método e Rota	Referência Técnica
Listar Catálogo de Produtos	GET /v1/products	Ver Listagem →
Cadastrar Produto ou SKU	POST /v1/products	Ver Parâmetros →
Consultar Produto por ID	GET /v1/products/:id	Ver Detalhes →
Atualizar Dados Fiscais do Item	PUT /v1/products/:id	Ver Atualização →

Transportadoras & Frete

Cadastre transportadoras para preenchimento automático do bloco de frete da NF-e (Grupo X da SEFAZ).

Modalidades de Frete (modFrete):

0 — Por conta do emitente (CIF)
1 — Por conta do destinatário (FOB)
2 — Por conta de terceiros
3 — Transporte próprio por conta do remetente
4 — Transporte próprio por conta do destinatário
9 — Sem ocorrência de transporte

{

"razaoSocial": "Expresso Logística e Transportes LTDA",

"cnpjCpf": "11222333000188",

"ie": "149876543110",

"endereco": "Rodovia Anhanguera, KM 18",

"municipio": "Osasco",

"uf": "SP"

}

Operação	Método e Rota	Referência Técnica
Listar Transportadoras	GET /v1/carriers	Ver Listagem →
Cadastrar Transportadora	POST /v1/carriers	Ver Parâmetros →
Remover Transportadora	DELETE /v1/carriers/:id	Ver Exclusão →

Perfis Fiscais Tributários

Os Perfis Fiscais agrupam regras tributárias complexas por operação ou segmento (ex: revenda, indústria, consumidor final, bonificação). Ao emitir a nota, basta vincular o fiscalProfileId ao item para que o NFER calcule e preencha automaticamente as tags de ICMS, PIS e COFINS.

Você pode utilizar os perfis pré-configurados do NFER executando o endpoint de seed defaults ou criar perfis personalizados para regras fiscais da sua empresa.

{

"nome": "Revenda de Mercadorias",

"segmento": "revenda",

"paraConsumidorFinal": false,

"descricao": "Operações de venda de mercadorias adquiridas para revenda"

}

Operação	Método e Rota	Referência Técnica
Listar Perfis Tributários	GET /v1/fiscal-profiles	Ver Perfis Ativos →
Criar Perfil Tributário	POST /v1/fiscal-profiles	Ver Parâmetros →
Consultar Regras do Perfil	GET /v1/fiscal-profiles/:id	Ver Regras de Impostos →
Simular Cálculo de Item	POST /v1/fiscal-profiles/preview	Ver Simulador →