Noviq NFE

Documentação

API REST simples para emissão de NF-e e gestão fiscal completa

Base URL
https://noviq-nfe-production.up.railway.app

Quick start

# Listar empresas cadastradas
curl https://noviq-nfe-production.up.railway.app/v1/fiscal/empresas \
  -H "X-API-Key: sk_live_SUA_CHAVE"

# Emitir NF-e (homologação)
curl -X POST https://noviq-nfe-production.up.railway.app/v1/nfe/emitir \
  -H "X-API-Key: sk_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "ambiente": 2,
    "serie": "1",
    "numero": 1,
    "natureza_operacao": "Venda de mercadoria",
    "cert_pfx_base64": "...",
    "cert_password": "senha",
    "emitente": { ... },
    "destinatario": { ... },
    "itens": [ ... ],
    "valor_total": 150.00
  }'

Autenticação

Header
X-API-Key: sk_live_...

Toda requisição deve incluir o header X-API-Key com sua chave de API.

NF-e

POST
/v1/nfe/emitir

Emite NF-e (modelo 55) no SEFAZ

POST
/v1/nfce/emitir

Emite NFC-e (modelo 65) no SEFAZ

POST
/v1/nfe/cancelar

Cancela NF-e autorizada

Cadastros (ERP)

GET
/v1/fiscal/empresas

Lista empresas cadastradas

POST
/v1/fiscal/empresas

Cria nova empresa

GET
/v1/fiscal/clientes

Lista clientes (suporta ?q=busca)

POST
/v1/fiscal/clientes

Cria novo cliente

GET
/v1/fiscal/fornecedores

Lista fornecedores

GET
/v1/fiscal/produtos

Lista produtos com NCM, CFOP, estoque

POST
/v1/fiscal/produtos

Cadastra produto

Movimentações

POST
/v1/fiscal/entradas

Lança nota fiscal de compra + atualiza estoque

POST
/v1/fiscal/saidas

Cria venda + atualiza estoque

GET
/v1/fiscal/estoque

Saldo atual de todos os produtos

GET
/v1/fiscal/estoque/{id}/movimentos

Kardex (histórico) de um produto

GET
/v1/fiscal/dashboard

KPIs do mês corrente

Consultas

GET
/v1/cnpj/{cnpj}

Consulta CNPJ na Receita Federal

GET
/v1/cep/{cep}

Consulta CEP nos Correios

Webhooks

POST
/v1/webhooks

Registra URL para receber eventos

GET
/v1/webhooks

Lista webhooks registrados

DELETE
/v1/webhooks/{id}

Remove webhook