# Simplifisca API

> API de nota fiscal para SaaS. Emita NF-e (modelo 55, venda de produtos) e NFS-e (Padrão Nacional, serviços) com uma chamada REST ou pelo servidor MCP. Emissão assíncrona, webhooks assinados com HMAC, multi-CNPJ, homologação ilimitada.

Base URL: https://app.simplifisca.com.br/api/v1 · Autenticação: `Authorization: Bearer sf_live_...` · Formato: JSON (campos em camelCase).

## Documentação

- [Documentação completa para LLMs](https://app.simplifisca.com.br/llms-full.txt): tudo em um só arquivo Markdown — leia este primeiro
- [Guia de início rápido](https://app.simplifisca.com.br/docs/): autenticação, emitentes, NF-e, NFS-e, webhooks, erros
- [Referência OpenAPI 3.1](https://app.simplifisca.com.br/api/v1/openapi.json): schema completo de todos os endpoints
- [Referência navegável](https://app.simplifisca.com.br/docs/referencia/)

## MCP

- [Servidor MCP](https://app.simplifisca.com.br/mcp): Streamable HTTP, mesmo header de autenticação. Ferramentas: conta, listar_emitentes, cadastrar_emitente, enviar_certificado, listar_catalogo, salvar_produto, salvar_servico, emitir_nfe, emitir_nfse, consultar_documento, listar_documentos, cancelar_documento, exemplo_payload

## Endpoints principais

- `POST /api/v1/emitentes` e `PUT /api/v1/emitentes/{id}/certificado`: cadastrar empresa emitente e certificado A1
- `PUT /api/v1/produtos/{codigo}` · `PUT /api/v1/servicos/{codigo}`: catálogo fiscal (tributação configurada uma vez; a nota só leva o código)
- `POST /api/v1/nfe` · `POST /api/v1/nfse`: emitir (202, status "processando")
- `GET /api/v1/{nfe|nfse}/{id}`: status, chave de acesso, protocolo; `/xml` e `/pdf` para arquivos
- `POST /api/v1/{nfe|nfse}/{id}/cancelamento`: cancelar
- `POST /api/v1/webhooks`: receber eventos nfe.autorizada, nfe.rejeitada, nfse.autorizada...

## Opcional

- [Preços](https://app.simplifisca.com.br/#precos): Start R$ 49,90/mês (100 notas); Pro R$ 149,90/mês (1000 notas); Scale R$ 449,90/mês (5000 notas). Homologação não conta no plano.