← Voltar

## Guias de Integração

Documentação detalhada para cada tipo de documento fiscal eletrônico

📄

## NF-e

Nota Fiscal Eletrônica

Modelo 55 - Para operações entre empresas (B2B). Documento principal para transações comerciais.

#### 🔌 Endpoints Disponíveis

POST /api/nfe/emitir.php
POST /api/nfe/cancelar.php
POST /api/nfe/carta_correcao.php
∞
ITENS
A1
CERTIFICADO
XML
+ PDF
🛒

## NFC-e

Nota Fiscal de Consumidor

Modelo 65 - Para vendas ao consumidor final (B2C). Ideal para PDV e varejo.

#### 🔌 Endpoints Disponíveis

POST /api/nfce/emitir.php
POST /api/nfce/cancelar.php
POST /api/nfce/consultar.php
QR
CODE
CSC
OBRIGATÓRIO
PDF
DANFCE
🚚

## MDF-e

Manifesto Eletrônico

Modelo 58 - Para transporte de cargas. Controle completo de manifestos de transporte.

#### 🔌 Endpoints Disponíveis

POST /api/mdfe/emitir.php
POST /api/mdfe/encerrar.php
POST /api/mdfe/cancelar.php
POST /api/mdfe/incluir_condutor.php
✓ 4
AUTORIZADOS
100%
FUNCIONAL
REAL
SEFAZ

## ⚡ O que Você Vai Aprender

🔧

#### Configuração Inicial

Certificado digital, CSC e configurações básicas

📡

#### Fazer Requisições

Como fazer chamadas HTTP para os endpoints

📋

#### Estrutura JSON

Campos obrigatórios e opcionais detalhados

✅

#### Validações

Regras de validação e erros comuns

🔍

#### Exemplos Práticos

JSONs completos prontos para usar

🛠️

#### Troubleshooting

Solução de problemas comuns da SEFAZ

## 🚀 Início Rápido - Primeiro Passo

### 1️⃣ Configurar Certificado Digital

Coloque seu certificado A1 (.pfx) na pasta:

    pontti_nfe/certificados/empresas/{CNPJ}/{CNPJ}.pfx

Exemplo: `pontti_nfe/certificados/empresas/21497109000156/21497109000156.pfx`

### 2️⃣ Configurar Senha do Certificado

Edite o arquivo `config_certificado.php`:

PHP Config

    <?php
    return [
        'senha_certificado' => 'SUA_SENHA_AQUI'
    ];

### 3️⃣ Fazer Primeira Requisição

Use Postman ou qualquer cliente HTTP:

cURL Example

    curl -X POST http://localhost/pontti_nfe/api/nfce/emitir.php \
      -H "Content-Type: application/json" \
      -d @exemplos_json/nfce_emissao_completa.json

## 👇 Escolha o Tipo de Documento Fiscal

Clique em um dos cards acima para ver o guia de integração específico