Módulo Fiscal White-Label

Produtos

Catálogo de produtos do contribuinte -- identificação e preço padrão, nunca tributação embutida (tributação é cadastrada separadamente em Tributação, por NCM+CFOP+UF, e resolvida automaticamente na hora de emitir). Pré-requisito: o contribuinte precisa ter o produto MODULO_FISCAL_WHITELABEL contratado (403 caso contrário).

Cadastrar / atualizar um produto POST

POST https://areacliente.centralfiscal.com.br/v1/contribuintes/{contribuinte_id}/produtos

Upsert por (contribuinte, código) -- reenviar o mesmo código atualiza os dados.

Campo	Obrigatório	Observação
`codigo`	Sim	Código do produto no seu catálogo (chave do upsert).
`descricao`	Sim
`ncm`	Sim	8 dígitos.
`unidade`	Não	Padrão `UN`.
`valor_unitario_padrao`	Não	Usado na emissão quando o item não informar um valor próprio.
`cfop_padrao`	Não	Usado na emissão quando o item não informar um CFOP próprio -- também resolve a tributação (NCM+este CFOP) em Tributação.
`ean`, `ean_tributavel`	Não	GTIN comercial/tributável -- vai no item da NF-e quando preenchido.
`cest`	Não	Obrigatório pela SEFAZ quando o NCM está sujeito a Substituição Tributária.
`codigo_ex_tipi`	Não	Exceção da TIPI, 2-3 dígitos.
`codigo_beneficio_fiscal`	Não	cBenef (Convênio ICMS 42/16).
`codigo_origem`	Não	Código do produto no sistema do fornecedor/origem -- só informativo.
`informacoes_adicionais`	Não	Vai no item como `infAdProd`, impresso no DANFE.
`custo_aquisicao`, `preco_venda_sugerido`	Não	Só informativo -- nunca enviado ao motor fiscal, nunca movimenta financeiro/estoque.

curl -X POST https://areacliente.centralfiscal.com.br/v1/contribuintes/{contribuinte_id}/produtos \
  -H "Authorization: Bearer cf_live_51JqK..." \
  -H "Content-Type: application/json" \
  -d '{
    "codigo": "SKU-001",
    "descricao": "Parafuso sextavado M8",
    "ncm": "73181500",
    "unidade": "UN",
    "valor_unitario_padrao": 1.25,
    "cfop_padrao": "5102"
  }'

Resposta

{
  "ambiente": "PRODUCTION",
  "produto": {
    "tenant_produto_id": "a1b2c3d4-...",
    "taxpayer_id": "3d390cff-...",
    "codigo": "SKU-001",
    "descricao": "PARAFUSO SEXTAVADO M8",
    "ncm": "73181500",
    "unidade": "UN",
    "valor_unitario_padrao": 1.25,
    "cfop_padrao": "5102",
    "ean": null,
    "cest": null,
    "ativo": true,
    "created_at": "2026-11-03T10:00:00-03:00",
    "updated_at": "2026-11-03T10:00:00-03:00"
  }
}

Listar

Endpoint	Retorna
GET `/v1/contribuintes/{id}/produtos`	Todos os produtos do catálogo, incluindo `fiscal_pronto` (bool -- se já existe tributação cadastrada pro NCM+CFOP desse produto).

✅

Cadastrar o produto não cadastra a tributação dele. Um item só fica fiscal_pronto: true depois de existir um perfil em Tributação pro mesmo NCM+CFOP (+ UF de destino, quando aplicável).