# Emitfy API

> API REST para emissão fiscal no Brasil (NFS-e, NF-e, NFC-e, CT-e), catálogo (clientes, produtos, vendas) e webhooks. Modelo Conta × Assinatura: keys/webhooks na assinatura (/v1/webhooks); emissão em /v1/companies/:companyId. Auth: X-Api-Key / X-Api-Secret. Base: https://api.emitfy.com

Base URL: https://api.emitfy.com
Docs humanas: https://api.emitfy.com/docs
Contexto completo: https://api.emitfy.com/llms-full.txt
OpenAPI: https://api.emitfy.com/openapi.yaml

## Começar

- [Introdução](https://api.emitfy.com/docs): Visão geral Conta × Assinatura e dois fluxos (atalho vs catálogo)
- [Autenticação](https://api.emitfy.com/docs/authentication): Headers X-Api-Key, X-Api-Secret; empresa no path
- [Empresas](https://api.emitfy.com/docs/companies): CRUD /v1/companies (CNPJs da assinatura) e certificado A1
- [Sandbox](https://api.emitfy.com/docs/sandbox): Homologação
- [Para IAs](https://api.emitfy.com/docs/for-ai): llms.txt, Markdown por página, OpenAPI
- [SDKs](https://api.emitfy.com/docs/sdks): Oficiais — PHP `emitfy/sdk`, Node `@emitfy/sdk`, .NET `Emitfy`, Python `emitfy`, Java `com.emitfy:emitfy`

## Emissão

- [NFS-e](https://api.emitfy.com/docs/reference/nfse): POST /v1/companies/:companyId/nfse
- [NF-e](https://api.emitfy.com/docs/reference/nfe): POST /v1/companies/:companyId/nfe
- [NFC-e](https://api.emitfy.com/docs/reference/nfce): Cupom fiscal (requer ativação)
- [CT-e](https://api.emitfy.com/docs/reference/cte): Conhecimento de transporte (requer ativação)

## Catálogo

- [Clientes](https://api.emitfy.com/docs/reference/customers): CRUD /v1/companies/:companyId/customers
- [Produtos](https://api.emitfy.com/docs/reference/products): CRUD /v1/companies/:companyId/products
- [Vendas](https://api.emitfy.com/docs/reference/sales): POST /v1/companies/:companyId/sales

## Destinatário

- [Notas recebidas](https://api.emitfy.com/docs/reference/received-nfes): DistDFe e manifestação

## Integração

- [Webhooks](https://api.emitfy.com/docs/webhooks): CRUD /v1/webhooks (assinatura); payload com companyId + taxId
- [Idempotência](https://api.emitfy.com/docs/idempotency): Idempotency-Key / externalId
- [Erros](https://api.emitfy.com/docs/errors): Envelope success + error.code/message (validação 422)
- [OpenAPI](https://api.emitfy.com/openapi.yaml): OpenAPI 3.1 (company-scoped)
- [SDKs](https://api.emitfy.com/docs/sdks): PHP / Node / .NET / Python / Java (Ruby/Go sob demanda)

## Optional

- [Marketing overview](https://emitfy.com/llms.txt): Posicionamento do produto (não é contrato de API)