# Docs

- [Documentação](/docs): Manual, API REST, SDKs, agentes de IA e self-hosting do nfse-digital.
- Manual de uso: Usar o painel
  - [Manual de uso](/docs/manual): Do primeiro acesso à nota no e-mail do cliente, tela por tela.
  - [Primeiro acesso](/docs/manual/first-access): Criar a conta, enviar o certificado A1 e configurar o emitente.
  - [Configurar o emitente](/docs/manual/issuer): Os dados da empresa que emite as notas.
  - [Tomadores](/docs/manual/customers): Os clientes para quem você emite.
  - [Modelos de serviço](/docs/manual/service-templates): O serviço prestado e como ele é tributado; importar notas antigas.
  - [Emitir uma nota](/docs/manual/emit): Emitir uma NFS-e pelo painel e entender o resultado.
  - [Acompanhar as notas](/docs/manual/invoices): Filtros, indicadores, detalhe da nota e DANFSe.
  - [Cancelar uma nota](/docs/manual/cancel): Cancelar uma nota autorizada na SEFIN.
  - [Enviar a nota por e-mail](/docs/manual/email): A nota chega ao tomador pelo seu Gmail, com o DANFSe e o XML.
  - [Agendamentos (nota mensal automática)](/docs/manual/schedules): Nota mensal automática, com aviso na véspera.
  - [Passar para produção](/docs/manual/production): Sair da homologação e emitir com valor fiscal.
  - [Integrações: agentes de IA](/docs/manual/ai-agents): Emitir conversando com Claude Code, Claude Desktop ou Codex.
  - [Integrações: API REST](/docs/manual/rest-api): Integrar o seu ERP pela API REST.
  - [Segurança da conta](/docs/manual/security): Passkeys, tokens, senha de app e exclusão da conta.
  - [Problemas comuns](/docs/manual/troubleshooting): Sintomas, causas e o que fazer.
- API REST: Integrar o seu sistema
  - [Visão geral](/docs/api): Emitir, listar, consultar e cancelar NFS-e a partir do seu ERP ou sistema de faturamento.
  - [Emitir nota](/docs/api/emit): POST /invoices — emite pela mesma regra do painel, com idempotência.
  - [Consultar e listar](/docs/api/query): Pela sua chave, pelo id ou numa lista filtrada.
  - [Cancelar nota](/docs/api/cancel): POST /invoices/{id}/cancel — registra o evento de cancelamento na SEFIN.
  - [DANFSe (PDF)](/docs/api/danfse): GET /invoices/{id}/danfse — o documento auxiliar da nota, com QR Code.
  - [Erros](/docs/api/errors): Todo erro é JSON, com o status HTTP que diz o que fazer.

  - **Testar a API**
  - Operações (playground)
    - [Emitente da conta](/docs/api/endpoints/getAccount)
    - [Listar tomadores](/docs/api/endpoints/listCustomers)
    - [Listar modelos de serviço](/docs/api/endpoints/listTemplates)
    - [Listar notas](/docs/api/endpoints/listInvoices)
    - [Emitir nota](/docs/api/endpoints/emitInvoice)
    - [Consultar nota pelo id](/docs/api/endpoints/getInvoice)
    - [Consultar nota pela idempotency_key](/docs/api/endpoints/getInvoiceByKey)
    - [Cancelar nota](/docs/api/endpoints/cancelInvoice)
    - [Baixar o DANFSe (PDF)](/docs/api/endpoints/getInvoiceDANFSe)

  - **Referência**
  - [Referência completa (Scalar)](/api-reference)
  - [openapi.json](/openapi.json)
- SDKs: Go, Python e TypeScript
  - [SDKs](/docs/sdks): Clientes Go, Python e TypeScript gerados do contrato da API.
  - [Go](/docs/sdks/go): Cliente com respostas tipadas por status, mais o atalho NewWithToken.
  - [Python](/docs/sdks/python): Funções síncronas e assíncronas por operação, com modelos tipados.
  - [TypeScript](/docs/sdks/typescript): Cliente fetch tipado, ESM, para Node ≥ 18 e navegador.
  - [Manter os SDKs](/docs/sdks/maintaining): Regerar, conferir e provar os três SDKs contra o binário real.
- Agentes de IA: MCP, skill e llms.txt
  - [Conectar um agente](/docs/agents): Emitir, consultar e cancelar conversando com Claude Code, Claude Desktop ou Codex, pelo servidor MCP.
  - [Ferramentas](/docs/agents/tools): O que o agente pode fazer pelo servidor MCP — o mesmo catálogo no stdio e no HTTP.
  - [Skill do agente](/docs/agents/skill): O SKILL.md que ensina o agente a emitir com segurança.
  - [llms.txt](/docs/agents/llms-txt): Os guias em texto para um agente integrar sozinho.
- Self-hosting: Instalar, configurar e publicar
  - [Início rápido](/docs/self-hosting): Rodar o nfse-digital na sua máquina em quatro comandos.
  - [Instalação](/docs/self-hosting/install): Pré-requisitos, onde o certificado A1 fica e como rodar.
  - [Configuração](/docs/self-hosting/configuration): Variáveis de ambiente e endpoints da SEFIN.
  - [Como o e-mail sai](/docs/self-hosting/email-delivery): Gmail por SMTP com senha de app, sem serviço de terceiro.
  - [Segurança](/docs/self-hosting/security): As defesas de cada camada.
  - [Deploy](/docs/self-hosting/deploy): Publicar a sua instância no Fly.io com banco no Turso.
  - [Testes](/docs/self-hosting/tests): Gate de cobertura e as verificações ponta a ponta.
  - [Como tudo foi construído](/docs/self-hosting/how-it-was-built): A stack de cada camada — binário Go, painel, API, MCP, e-mail, SDKs, este site e a infraestrutura — com as versões medidas e o porquê das escolhas.