✓ Acesso Público • Disponível sem Autenticação

Documentação Técnica da API NexoFisc

Referência oficial de integração para emissão síncrona de documentos fiscais eletrônicos. Todas as requisições autenticam via cabeçalho HTTP Authorization: Bearer emk_... e utilizam JSON UTF-8.

1. Autenticação

Envie sua chave no header: Authorization: Bearer emk_.... Cada requisição é validada em microssegundos.

2. Idempotência Absoluta

Informe o idExterno do seu sistema. Reenviar uma nota após oscilação de rede nunca duplica a emissão.

3. Homologação → Produção

Teste gratuitamente com a cota inicial em homologação. Assim que autorizada e paga, emite em produção!

Exemplos Oficiais de Payloads por Modelo Fiscal

POST /v1/documentos JSON UTF-8 • Content-Type: application/json

    

Regras para os Itens da Nota e Catálogo do ERP

Campo Tipo Obrigatório Descrição e Regras
cProd String(60) Sim Código identificador SKU interno do produto.
cEan String(14) Sim Código de barras padrão GTIN-8, 12, 13 ou 14. Se não houver, envie o literal "SEM GTIN".
xProd String(120) Sim* Descrição clara do item comercializado (*opcional se dados_compartilhados estiver ativo).
ncm String(8) Sim* 8 dígitos numéricos válidos da Nomenclatura Comum do Mercosul (*preenchido automaticamente via catálogo ERP).
cfop String(4) Sim* Ex.: 5102 (venda estadual), 6102 (interestadual), 5353 (transporte).
uCom / qCom String / Decimal Sim Unidade comercial (ex.: UN, KG, CX) e quantidade com até 4 casas decimais.
vUnCom Decimal Sim Valor unitário comercial do item. O valor total (vProd) é apurado pelo motor da NexoFisc.

Regras de Tributação e Reforma Tributária (IBS / CBS)

Tributo Campos do Objeto Regras Fiscais Aceitas
ICMS (Regime Normal) tributacao.icms: orig, cst, pIcms CSTs: 00 (Tributada integralmente), 20 (Com redução), 40/41 (Isenta), 60 (Cobrado anteriormente por ST).
ICMS (Simples Nacional) tributacao.icms: orig, csosn CSOSNs: 102 (Tributada sem crédito), 101 (Com crédito de ICMS), 500 (Cobrado por ST).
PIS e COFINS tributacao.pisCofins: cstPis, pPis, cstCofins, pCofins CST 01 (Tributável básica), 04/06 (Monofásica/Alíquota zero), 49/99 (Outras). Alíquotas em percentual.
IBS / CBS (Reforma 2026) tributacao.ibsCbs: cst, cClassTrib, pIbsUf, pIbsMun, pCbs CST 000, Classificação Tributária de 6 dígitos e exclusão automática do ICMS da base (excluirIcmsDaBasePisCofins: true).
ISSQN (Serviços) valores: aliquotaIss, issRetido Alíquota de 2% a 5% conforme município. Flag issRetido: true quando retido pelo tomador.

Modalidade de Frete (modFrete)

CódigoModalidade
9Sem Ocorrência de Transporte (Padrão PDV/Serviços)
0Por conta do Emitente (CIF)
1Por conta do Destinatário (FOB)
2Por conta de Terceiros

Meios de Pagamento (pagamentos.tPag)

CódigoMeioExemplo
01Dinheiro{ "tPag": "01", "vPag": 1.00 }
17PIX{ "tPag": "17", "vPag": 100.00 }
03Crédito{ "tPag": "03", "vPag": 250.00 }
04Débito{ "tPag": "04", "vPag": 85.50 }