v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB
NFCe

Emitir

Cria uma NFC-e e a envia para processamento. O envio é síncrono: a nota é autorizada ou rejeitada na mesma requisição. A resposta contém o mesmo formato da operação de consulta. A numeração (número e série) pode ser definida automaticamente pela API. Para controlar manualmente, informe os campos numero e serie no corpo. Opcionalmente use o parâmetro forma_emissao=offline para emissão manual em contingência.

post/nfce

Query parameters

refstring required
Example:12345

Referência única da NFC-e no seu sistema

completa0 | 1

Se 1, retorna dados completos da requisição e protocolo em caso de autorização

forma_emissaostring
Example:offline

Use "offline" para emissão manual em contingência (informar numero, serie e codigo_unico no corpo)

Request body

cnpj_emitentestring required

CNPJ da empresa emitente

data_emissaostring date-time required

Data e hora de emissão com timezone (ISO). Diferença máxima 5 min do horário atual.

indicador_inscricao_estadual_destinatariostring

1 – Contribuinte ICMS; 2 – Isento; 9 – Não contribuinte

modalidade_fretestring required

0 – Emitente; 1 – Destinatário; 2 – Terceiros; 9 – Sem frete

local_destinostring required

1 – Interna; 2 – Interestadual; 3 – Exterior

presenca_compradorstring required

1 – Presencial; 4 – Entrega a domicílio

natureza_operacaostring required

Natureza da operação. Omitido será "VENDA AO CONSUMIDOR"

informacoes_adicionais_contribuintestring

Informações adicionais

nome_destinatariostring
cnpj_destinatariostring
cpf_destinatariostring
numerostring

Número da nota (opcional; API pode definir)

seriestring

Série da nota (opcional)

codigo_unicostring

Código único (tag cNF) para emissão em contingência offline

Example request

{
  "cnpj_emitente": "12345678000123",
  "data_emissao": "2015-11-19T13:54:31-02:00",
  "indicador_inscricao_estadual_destinatario": "9",
  "modalidade_frete": "9",
  "local_destino": "1",
  "presenca_comprador": "1",
  "natureza_operacao": "VENDA AO CONSUMIDOR",
  "items": [
    {
      "numero_item": "1",
      "codigo_ncm": "62044200",
      "codigo_produto": "251887",
      "quantidade_comercial": 1,
      "quantidade_tributavel": 1,
      "cfop": "5102",
      "valor_unitario_comercial": 79,
      "valor_unitario_tributavel": 79,
      "valor_bruto": 79,
      "unidade_comercial": "un",
      "unidade_tributavel": "un",
      "icms_origem": "0",
      "icms_situacao_tributaria": "102"
    }
  ],
  "formas_pagamento": [
    {
      "forma_pagamento": "03",
      "valor_pagamento": 79,
      "nome_credenciadora": "Cielo",
      "bandeira_operadora": "02",
      "numero_autorizacao": "R07242"
    }
  ]
}

Response

Recurso criado com sucesso

cnpj_emitentestring
refstring
status'autorizado' | 'erro_autorizacao'

autorizado ou erro_autorizacao (emissão síncrona)

status_sefazstring
mensagem_sefazstring
chave_nfestring
numerostring
seriestring
caminho_xml_nota_fiscalstring
caminho_danfestring

Formato .html (DANFCe)

qrcode_urlstring

URL do QR Code para consulta pelo consumidor

url_consulta_nfstring
contingencia_offlineboolean

Presente quando a nota foi emitida em contingência offline

contingencia_offline_efetivadaboolean

Se a contingência já foi efetivada na SEFAZ