Para IAs e agentes

A Emitfy publica contexto machine-readable para Cursor, ChatGPT, Claude e outros agentes — sem precisar parsear o HTML da documentação.

Início rápido

MCP remoto — guia MCP (https://mcp.emitfy.com/mcp) — prefira para a IA operar o CNPJ (setup + emissão) com OAuth, sem colar API key no client. Landing de produto: emitfy.com/mcp.
Página .md — cada doc humana tem um espelho Markdown (ex.: /webhooks.md). Use o botão Copiar página / Ver como Markdown no topo.
llms.txt / llms-full.txt — https://api.emitfy.com/llms.txt e https://api.emitfy.com/llms-full.txt — contrato REST para integrar sistemas (SDKs / HTTP).

Markdown por página

Nos botões do cabeçalho das docs você encontra:

Copiar página — coloca o Markdown (com frontmatter) na área de transferência.
Abrir no ChatGPT / Abrir no Claude — abre o chat pedindo para ler a URL .md.
Ver como Markdown — abre o espelho .md em texto puro.

O frontmatter inclui title, description, source_url e last_updated. Agentes devem citar o source_url ao responder.

Arquivos oficiais (host da API)

https://api.emitfy.com/llms.txt
https://api.emitfy.com/llms-full.txt
https://api.emitfy.com/openapi.yaml — trecho OpenAPI 3 da API REST (fonte enxuta; amplie conforme o contrato evolui).

O llms-full não lista cada campo fiscal avançado (alíquotas, CFOP, CSC, etc.); para isso o agente deve seguir o link da página humana correspondente.

Modelo Conta × Assinatura

Camada	O que é	Na API
Conta	Quem paga (plano, faturas, métodos de pagamento)	Billing no painel
Assinatura	Hub operacional 1:1 com a conta	Keys e webhooks em `/v1/webhooks`
Empresa	CNPJ (certificado, emissão, catálogo)	`/v1/companies/:companyId/...`

Chaves de API são da assinatura/conta. Webhooks também — um endpoint cobre todas as empresas; o payload traz companyId e taxId. Emissão e catálogo continuam com companyId no path.

Emissão por tipo de nota

Documento	Endpoint
NFS-e	`POST /v1/companies/{companyId}/nfse`
NF-e	`POST /v1/companies/{companyId}/nfe`
NFC-e (exclusivo de API)	`POST /v1/companies/{companyId}/nfce`
CT-e / CT-e OS (exclusivo de API)	`POST /v1/companies/{companyId}/cte` / `.../cte-os`

Não existe endpoint genérico de criação de nota: a emissão é sempre no endpoint do tipo. Consulta unificada em GET /v1/companies/{companyId}/invoices. Catálogo (.../customers, .../products) mantém cadastros reutilizáveis. A dashboard Emitfy exibe NF-e e NFS-e; NFC-e e CT-e são exclusivos de API.

Headers obrigatórios

Shell

X-Api-Key: <api-key>
X-Api-Secret: <api-secret>
Content-Type: application/json

Boas práticas para agentes

Preferir llms-full.txt para integrar; use llms.txt só para descoberta.
Ao usar uma página .md, cite o source_url do frontmatter.
Não invente CRUD de webhook por empresa — use /v1/webhooks.
OpenAPI é um trecho mínimo; confirme regras finas no llms-full ou na doc humana.
Preferir os SDKs oficiais (PHP, Node, .NET, Python, Java). Para HTTP cru: exemplos nos CodeTabs e OpenAPI.

Documentação humana: Introdução, Autenticação, Webhooks, SDKs, NF-e / notas.