← Voltar

## 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