← Voltar
Produção

Documentação NFC-e

API para emissão de Nota Fiscal de Consumidor Eletrônica

POST http://localhost/pontti_nfe/api/nfce/emitir.php

📋 Descrição

Emite uma NFC-e e envia para autorização na SEFAZ.

📥 Request Body

JSON Example 
{
    "empresa": {
        "nome": "PRINT JET DIGITAL",
        "nome_fantasia": "Print Jet",
        "cnpj": "21497109000156",
        "inscricao_estadual": "093218028",
        "regime_tributario": 1,
        "estado": "PE",
        "cidade": "Recife",
        "endereco": "Rua Frei Cassimiro",
        "numero": "644",
        "bairro": "Santo Amaro",
        "cep": "50100260",
        "email": "atendimento@printjetdigital.com.br",
        "telefone": "(81) 99999-9999"
    },
    "nfce": {
        "numero": "1",
        "serie": "001",
        "ambiente": 2,
        "csc": "1A8F6141-B4E9-4F46-BE82-1AA462EDA8B5",
        "csc_id": "000002"
    },
    "cliente": {
        "cpf": "05138670409",
        "nome": "João da Silva",
        "email": "joao@email.com",
        "telefone": "(81) 98888-7777"
    },
    "itens": [
        {
            "codigo": "PROD001",
            "descricao": "Produto Exemplo",
            "ncm": "49111090",
            "cfop": "5102",
            "unidade": "UN",
            "quantidade": 1,
            "valor_unitario": 5.00,
            "valor_total": 5.00
        }
    ],
    "pagamentos": [
        {
            "forma_pagamento": "01",
            "valor": 5.00
        }
    ],
    "desconto": 0,
    "informacoes_complementares": "Venda realizada no PDV 01",
    "responsavel_tecnico": {
        "cnpj": "12345678000190",
        "contato": "TI",
        "email": "ti@empresa.com.br",
        "telefone": "11999999999"
    }
}

📤 Response (Sucesso)

JSON Response 
{
    "success": true,
    "numero": "1",
    "serie": "001",
    "chave_acesso": "26251021497109000156650010000000011182804582",
    "protocolo": "226250936821623",
    "cStat": "100",
    "xml_path": "/pontti_nfe/arquivos/.../nfce/xml/...",
    "pdf_path": "/pontti_nfe/arquivos/.../nfce/pdf/...",
    "data_emissao": "2025-10-21 16:09:31",
    "valor_total": 5.00,
    "message": "NFC-e emitida com sucesso"
}

🔑 Parâmetros Principais

Campo Tipo Obrigatório Descrição
csc string SIM Código de Segurança do Contribuinte
csc_id string SIM Identificador do CSC
ambiente int SIM 1=Produção, 2=Homologação
cliente object OPCIONAL Dados do consumidor (pode ser omitido)
responsavel_tecnico object SIM Dados do responsável técnico
POST http://localhost/pontti_nfe/api/nfce/cancelar.php

📋 Descrição

Cancela uma NFC-e autorizada (prazo: até 24 horas).

📥 Request Body

JSON Example 
{
    "chave_acesso": "26251021497109000156650010000000011182804582",
    "protocolo": "226250936821623",
    "justificativa": "Erro no preenchimento dos dados da NFC-e"
}

⚠️ Observações Importantes

⏰

Data/Hora Automática

O sistema define automaticamente a data/hora atual para evitar erro 704

🔢

CSC Obrigatório

O CSC e CSC_ID devem estar ativos no portal da SEFAZ

📱

QR Code

Gerado automaticamente para consulta pelo consumidor

💰

Pagamentos

Suporta múltiplas formas de pagamento e troco

👤

Cliente Opcional

Para vendas sem identificação do consumidor, omitir o campo "cliente"

🖨️

DANFCE

PDF gerado automaticamente com QR Code incluído

💳 Formas de Pagamento

Código Descrição
01 Dinheiro
02 Cheque
03 Cartão de Crédito
04 Cartão de Débito
05 Crédito Loja
10 Vale Alimentação
11 Vale Refeição
12 Vale Presente
13 Vale Combustível
15 Boleto Bancário
90 Sem Pagamento
99 Outros