Emissão por tipo de nota

Referência dos campos de cada emissão. NF-e e NFC-e partem de um pedido de venda; a NFS-e tem payload próprio. Tipos completos no OpenAPI.

Cadastros (produtos & clientes)

O cadastro de produtos e clientes é feito no painel do CertFiscal (menus Produtos e Clientes, dentro da sua conta — o mesmo lugar onde você cria as chaves de API). A API referencia esses cadastros por id:

Para catálogo fixo, recomendamos cadastrar os produtos no painel com os dados fiscais completos (NCM, CFOP, CSOSN): a emissão fica mais simples (só sku + quantidade no pedido) e evita rejeições da SEFAZ por dado fiscal ausente.

Valores & unidades

Pedido de venda POST /v1/sales-orders

Base de NF-e e NFC-e. Campos:

Item (items[])

curl -X POST https://api.certfiscal.com.br/v1/sales-orders \
  -H "Authorization: Bearer SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{
    "companyId": "comp_...",
    "items": [
      { "description": "Camiseta P", "unit": "UN", "quantity": 2, "unitPriceCents": 4990 }
    ]
  }'

NFC-e (modelo 65) POST /v1/nfce

Cupom fiscal eletrônico, emissão síncrona. Escopo nfce:write + header Idempotency-Key.

Pagamento (payments[])

curl -X POST https://api.certfiscal.com.br/v1/nfce \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Idempotency-Key: $(uuidgen)" -H "Content-Type: application/json" \
  -d '{
    "salesOrderId": "so_...",
    "payments": [{ "tipo": "17", "valor": 99.80 }]
  }'

NF-e (modelo 55) POST /v1/nfe

Prepara a NF-e do pedido e autoriza na SEFAZ. Escopo nfe:write + Idempotency-Key. O destinatário (customerId no pedido) é obrigatório.

curl -X POST https://api.certfiscal.com.br/v1/nfe \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Idempotency-Key: $(uuidgen)" -H "Content-Type: application/json" \
  -d '{ "salesOrderId": "so_..." }'

NFS-e POST /v1/nfse

Nota de serviço, com payload próprio (não usa pedido de venda). Escopo nfse:write + Idempotency-Key.

Serviço (items[])

curl -X POST https://api.certfiscal.com.br/v1/nfse \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Idempotency-Key: $(uuidgen)" -H "Content-Type: application/json" \
  -d '{
    "companyId": "comp_...",
    "tomadorType": "PJ",
    "tomadorDoc": "12345678000190",
    "tomadorName": "Cliente Ltda",
    "items": [{ "description": "Consultoria em TI - 10h", "unitPriceCents": 500000, "issRate": 2.0 }]
  }'

Cancelamento POST /v1/nfe/{id}/cancelamento

Cancela NF-e/NFC-e autorizada. Escopo nfe:write.

curl -X POST https://api.certfiscal.com.br/v1/nfe/inv_.../cancelamento \
  -H "Authorization: Bearer SUA_CHAVE" -H "Content-Type: application/json" \
  -d '{ "justification": "Cancelamento por desistencia do cliente" }'

Empresas & consulta

Descubra o companyId das suas empresas e consulte o estado atual de qualquer documento (status, chave de acesso, número, protocolo, mensagem da SEFAZ e quais arquivos já existem). Útil para reconciliação e para acompanhar uma NFC-e emitida em contingência.

curl https://api.certfiscal.com.br/v1/companies -H "Authorization: Bearer SUA_CHAVE"
curl https://api.certfiscal.com.br/v1/nfe/ID_DA_NOTA -H "Authorization: Bearer SUA_CHAVE"

XML & DANFE