> ## Documentation Index
> Fetch the complete documentation index at: https://docs.engineapi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> engineAPI: Motor fiscal SaaS para Software Houses. Emita NF-e, NFC-e e NFS-e via API REST simples.

Motor fiscal **B2B2B** que permite Software Houses integrar emissão de documentos fiscais eletrônicos em suas plataformas via API REST, sem montar SOAP nem XML.

<CardGroup cols={2}>
  <Card title="Zero infraestrutura fiscal" icon="server">
    Zero SOAP, zero XML manual. Você envia JSON, nós cuidamos de tudo.
  </Card>

  <Card title="Multitenancy nativo" icon="building">
    Gerencie múltiplos CNPJs por parceiro com isolamento completo de dados.
  </Card>

  <Card title="Produção em minutos" icon="bolt">
    Da conta criada à primeira nota autorizada em menos de 10 minutos.
  </Card>

  <Card title="AI-Ready" icon="robot" href="/guides/ai-integration">
    Qualquer agente de IA (Claude, ChatGPT, Copilot) integra em minutos via llms.txt.
  </Card>

  <Card title="Cobertura Fiscal" icon="clipboard-check" href="/cobertura">
    O que emitimos hoje por documento, regime e cenário, com o erro exato onde não emitimos.
  </Card>
</CardGroup>

***

## Documentos Suportados

| Documento                                   | Modelo | Autorizado por       | Status                                  |
| ------------------------------------------- | ------ | -------------------- | --------------------------------------- |
| **NF-e** (Nota Fiscal Eletrônica)           | 55     | SEFAZ Estadual       | <Icon icon="circle-check" /> Disponível |
| **NFC-e** (Nota Fiscal ao Consumidor)       | 65     | SEFAZ Estadual       | <Icon icon="circle-check" /> Disponível |
| **CT-e** (Conhecimento de Transporte)       | 57     | SEFAZ Estadual       | <Icon icon="calendar" /> Roadmap        |
| **MDF-e** (Manifesto de Documentos Fiscais) | 58     | SEFAZ Estadual       | <Icon icon="calendar" /> Roadmap        |
| **NFS-e** (Nota Fiscal de Serviços)         | -      | Prefeitura Municipal | <Icon icon="circle-check" /> Disponível |
| **DFe** (Distribuição de Documentos)        | -      | SEFAZ Nacional       | <Icon icon="calendar" /> Roadmap        |

<Info>
  **Reforma Tributária:** desde 03/08/2026, por obrigação federal (Ato Conjunto
  RFB/CGIBS nº 4/2026), o IBS/CBS é obrigatório na regra geral de NF-e e NFC-e: a
  engineAPI já emite. A NFS-e tem prazo próprio (01/10/2026) e já aceita o bloco
  `ibsCbs` na DPS, ainda sem emissão exercitada contra a SEFIN. Datas
  por documento, alíquotas de teste e o mecanismo de alíquotas até 2033 estão em
  [Reforma Tributária: datas que importam](/guides/reforma-datas).
</Info>

***

## Modelo B2B2B

Como um Partner organiza seus Issuers e os documentos de cada um:

```mermaid theme={null}
graph TD
    A("engineAPI<br/>Plataforma Fiscal") --> B("Partner<br/>Software House / Integrador")
    B --> C1("Issuer A<br/>CNPJ: 11.222.333/0001-44")
    B --> C2("Issuer B<br/>CNPJ: 55.666.777/0001-88")
    C1 --> D1("NF-e")
    C1 --> D2("NFC-e / NFS-e")
    C2 --> D3("NF-e / NFS-e")

    classDef profundo fill:#0F2A5E,stroke:#0F2A5E,color:#fff
    classDef nucleo fill:#1E56B1,stroke:#0F2A5E,color:#fff
    classDef destaque fill:#2D7AF6,stroke:#0F2A5E,color:#fff
    class A profundo
    class B,C1,C2 nucleo
    class D1,D2,D3 destaque
```

O **Partner** é a Software House que integra a engineAPI em seu produto. Cada parceiro gerencia seus próprios **Issuers** (CNPJs emissores) de forma totalmente isolada.

***

## Autenticação

A engineAPI suporta dois métodos de autenticação:

<CardGroup cols={2}>
  <Card title="Bearer JWT" icon="lock" href="/authentication">
    Para sessões de usuário no Dashboard. Obtido via `POST /v1/auth/login`.
  </Card>

  <Card title="API Key" icon="key" href="/authentication">
    Para integrações de longa duração. Gerada no Dashboard e enviada via `x-api-key` (`ek_live_`/`ek_test_`).
  </Card>
</CardGroup>

***

## Fluxo de Emissão

<Steps>
  <Step title="Cadastrar empresa emissora">
    `POST /v1/companies` com CNPJ e dados cadastrais. Todo emissor nasce em homologação.
  </Step>

  <Step title="Fazer upload do certificado digital">
    `POST /v1/companies/{issuerId}/certificate` com o arquivo `.pfx` (campo `file`) e a senha.
  </Step>

  <Step title="Emitir o documento">
    `POST /v1/nfe` (ou `/v1/nfce`, `/v1/nfse`) com os dados da operação.
  </Step>

  <Step title="Receber a resposta">
    A API retorna `{ data: { id, status: "AUTHORIZED", accessKey, protocol, downloads, ... }, meta }`: ver [Primeira Emissão](/guides/first-emission).
  </Step>

  <Step title="Receber webhook (opcional)">
    Configure `PATCH /v1/webhooks/config` para receber eventos em tempo real na sua URL.
  </Step>
</Steps>

***

## Base URLs

| Ambiente      | URL                             |
| ------------- | ------------------------------- |
| **Produção**  | `https://api.engineapi.com.br`  |
| **Dashboard** | `https://app.engineapi.com.br`  |
| **Docs**      | `https://docs.engineapi.com.br` |

***

## Próximos passos

<CardGroup cols={2}>
  <Card title="Quickstart" icon="play" href="/quickstart">
    Da conta à primeira nota em menos de 10 minutos
  </Card>

  <Card title="Autenticação" icon="lock" href="/authentication">
    JWT e API Keys explicados
  </Card>

  <Card title="Primeira emissão" icon="file-invoice" href="/guides/first-emission">
    Guia completo com exemplos reais
  </Card>

  <Card title="SDKs" icon="cube" href="/sdks/typescript">
    TypeScript, Python e PHP
  </Card>
</CardGroup>