# VNBR Fiscal API (apivns.vnsistemas.com.br)

> API RESTful de alta performance para emissão, consulta, cancelamento, inutilização e impressão de documentos fiscais eletrônicos (NF-e, NFC-e, MDF-e, CT-e, CT-e OS, NFS-e) integrada diretamente com a SEFAZ Brasil. Especialmente desenvolvida para Software Houses, ERPs, PDVs, e-commerces e desenvolvedores.

## Visão Geral e Recursos
- **Domínio Base**: `https://apivns.vnsistemas.com.br`
- **Endpoint Raiz da API**: `https://apivns.vnsistemas.com.br/api`
- **Documentação Detalhada para LLMs**: `https://apivns.vnsistemas.com.br/llms-full.txt`
- **Sitemap**: `https://apivns.vnsistemas.com.br/sitemap.xml`
- **Padrão de Comunicação**: JSON (UTF-8) para requisições e respostas.
- **Protocolo de Segurança**: HTTPS com TLS 1.2+ e criptografia de certificados digitais A1.
- **Arquitetura Multi-Tenant**: Uma única conta de Software House pode gerenciar e emitir notas para centenas de empresas clientes utilizando o cabeçalho `X-Empresa-CNPJ`.
- **Certificado Digital A1**: Armazenamento seguro em nuvem (.pfx/.p12 com senha criptografada). Não necessita instalação local de certificados na máquina do cliente final.

## Documentos Fiscais Suportados
1. **NF-e (Modelo 55)**: Nota Fiscal Eletrônica Mercantil para venda B2B/B2C, devoluções, transferências, exportação e importação.
2. **NFC-e (Modelo 65)**: Nota Fiscal de Consumidor Eletrônica para Varejo e PDVs com geração de QR Code SEFAZ e impressão térmica 80mm/58mm.
3. **MDF-e (Modelo 58)**: Manifesto Eletrônico de Documentos Fiscais para transporte interestadual e intermunicipal com encerramento obrigatório na SEFAZ.
4. **CT-e (Modelo 57)**: Conhecimento de Transporte Eletrônico de Cargas.
5. **CT-e OS (Modelo 67)**: Transporte rodoviário de passageiros e transporte de valores.
6. **NFS-e (Nacional e Prefeituras)**: Nota Fiscal de Serviços Eletrônica integrada ao novo Padrão Nacional (DPS).

## Autenticação
A API utiliza OAuth 2.0 (Bearer Token).

### Obter Token de Acesso:
```http
POST https://apivns.vnsistemas.com.br/oauth/token
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "client_id": "SEU_CLIENT_ID",
  "client_secret": "SEU_CLIENT_SECRET"
}
```

**Resposta de Sucesso (200 OK):**
```json
{
  "access_token": "a1b2c3d4e5...",
  "token_type": "Bearer",
  "expires_in": 2592000,
  "scope": "nfe nfce mdfe cte nfse"
}
```

### Headers Obrigatórios nas Chamadas de Emissão:
- `Authorization: Bearer <access_token>`
- `Content-Type: application/json`
- `X-Empresa-CNPJ: 12345678000190` *(obrigatório para contas Multi-Empresa/Software House)*

## Endpoints Principais da API REST

| Método | Rota | Descrição |
|---|---|---|
| `POST` | `/oauth/token` | Gera token de acesso Bearer via Client ID e Secret |
| `GET` | `/api/status` | Consulta disponibilidade dos servidores da SEFAZ autorizadora |
| `POST` | `/api/nfe` | Emite uma NF-e (Modelo 55) na SEFAZ |
| `GET` | `/api/nfe/{chave}` | Consulta o status de processamento da NF-e |
| `GET` | `/api/nfe/{chave}/xml` | Faz o download do XML assinado e autorizado |
| `GET` | `/api/nfe/{chave}/pdf` | Gera e faz o download do DANFE em PDF A4 |
| `POST` | `/api/nfe/{chave}/cancelamento` | Registra o evento de Cancelamento de NF-e na SEFAZ |
| `POST` | `/api/nfce` | Emite uma NFC-e (Modelo 65) na SEFAZ |
| `GET` | `/api/nfce/{chave}` | Consulta o status da NFC-e |
| `GET` | `/api/nfce/{chave}/xml` | Faz o download do XML da NFC-e autorizada |
| `GET` | `/api/nfce/{chave}/pdf` | Gera o DANFE da NFC-e em formato cupom térmico |
| `POST` | `/api/nfce/{chave}/cancelamento` | Cancela a NFC-e emitida |
| `POST` | `/api/mdfe` | Emite um MDF-e (Modelo 58) |
| `GET` | `/api/mdfe/{chave}/pdf` | Gera o DAMDFE em PDF |
| `POST` | `/api/mdfe/{chave}/encerramento`| Encerra o MDF-e no município de destino |
| `POST` | `/api/cte` | Emite um CT-e (Modelo 57) |
| `POST` | `/api/nfse` | Emite uma NFS-e no padrão nacional |

## Planos & Pacotes Oficiais (Sem Expiração de Créditos)
- **1.000 Documentos**: R$ 49,90 / mês ou recarga
- **3.000 Documentos**: R$ 99,90 / mês ou recarga
- **5.000 Documentos**: R$ 149,90 / mês ou recarga
- **10.000 Documentos**: R$ 199,90 / mês ou recarga
- **20.000 Documentos**: R$ 299,90 / mês ou recarga
- **50.000 Documentos**: R$ 499,90 / mês ou recarga
- **100.000 Documentos**: R$ 799,90 / mês ou recarga
- **200.000 Documentos**: R$ 1.299,90 / mês ou recarga

## Suporte & Contato Técnico
- **WhatsApp Oficial**: (22) 99762-2252
- **Website & Console**: https://apivns.vnsistemas.com.br
- **Empresa Mantenedora**: VNS Soluções em Tecnologia Ltda.