✓ 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ódigo | Modalidade |
|---|---|
| 9 | Sem Ocorrência de Transporte (Padrão PDV/Serviços) |
| 0 | Por conta do Emitente (CIF) |
| 1 | Por conta do Destinatário (FOB) |
| 2 | Por conta de Terceiros |
Meios de Pagamento (pagamentos.tPag)
| Código | Meio | Exemplo |
|---|---|---|
| 01 | Dinheiro | { "tPag": "01", "vPag": 1.00 } |
| 17 | PIX | { "tPag": "17", "vPag": 100.00 } |
| 03 | Crédito | { "tPag": "03", "vPag": 250.00 } |
| 04 | Débito | { "tPag": "04", "vPag": 85.50 } |