# Estoque NFe — estoquenfe.com.br
> Sistema web para entrada automática de notas fiscais eletrônicas de fornecedores e controle de estoque com custo médio ponderado.

Estoque NFe é um produto da Óptago (optago.com.br). Captura NFe de entrada direto da SEFAZ via certificado A1 ou por upload manual de XML/ZIP, processa cada nota atualizando quantidade e custo médio ponderado de cada produto, e registra tudo num ledger imutável de movimentações.

## O produto

- Busca automática de NFe na SEFAZ (Distribuição de DFe) com certificado A1
- Upload manual de XML individual ou lotes em ZIP
- Manifestação do destinatário automática (imediata ou no 8º dia)
- DANFE em PDF gerado localmente a partir do XML
- Custo médio ponderado (CMP) recalculado a cada entrada, em DECIMAL
- Ledger append-only de movimentações: histórico imutável
- Mapeamento de código de produto por fornecedor (evita redigitar na 2ª nota)
- Multi-empresa: cada CNPJ com estoque, fornecedores e certificado isolados
- Controle de acesso por papel (gestor / operador) por empresa

## Segurança

- Certificado A1 e senha armazenados criptografados
- Defesa contra XXE em duas camadas no parser de XML
- CSRF, CSP com nonce, validação de destinatário (CNPJ da nota ≡ empresa logada)
- Sem cookies de rastreamento; sem frameworks JavaScript de terceiros

## Público-alvo

Empresas brasileiras (CNPJ) que recebem notas fiscais de fornecedores e precisam de controle de estoque com custo médio correto, sem depender de ERP genérico para essa operação específica.

## Painel

O sistema roda em: https://estoquenfe.optago.app.br

## API e MCP (para desenvolvedores e agentes de IA)

O Estoque NFe expõe uma API REST e um servidor MCP (Model Context Protocol) para os documentos fiscais capturados da SEFAZ: listar documentos, baixar o XML autorizado, gerar o DANFE em PDF e registrar a manifestação do destinatário. Autenticação por Bearer JWT do SSO Óptago; escopo por CNPJ de empresa (o token só acessa empresas às quais o usuário pertence). Rate limit de 120 requisições/minuto por usuário.

- Documentação da API REST: https://estoquenfe.com.br/api-docs
- Documentação do servidor MCP: https://estoquenfe.com.br/mcp-docs
- Base da API REST: https://estoquenfe.optago.app.br/api/v1
- Endpoint do MCP: https://estoquenfe.optago.app.br/api/v1/mcp

Rotas REST (por CNPJ): GET /{cnpj}/nfe (listar), GET /{cnpj}/nfe/{chave}/xml, GET /{cnpj}/nfe/{chave}/pdf, POST /{cnpj}/nfe/{chave}/manifestar. Ferramentas MCP: listar_documentos, obter_xml, obter_pdf, manifestar.

## Contato

- WhatsApp: https://wa.me/+5541999284779
- Site da empresa: https://optago.com.br
- Instagram: https://www.instagram.com/optagobr