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

# Quickstart

> Do zero à sua primeira integração com a API Corp ERP.

A API Corp ERP expõe dois recursos principais: **Clientes** e **Faturas**. O fluxo correto é sempre cadastrar o cliente antes de inserir faturas vinculadas a ele.

## Pré-requisitos

* Uma **API key** válida — solicite ao time Corp ERP
* Possuir uma **assinatura** ativa no **Corp ERP**

## Como funciona

<Steps>
  <Step title="Autentique suas requisições">
    Envie sua API key no header `x-api-key` ou `Authorization: Bearer` em todas as chamadas.
  </Step>

  <Step title="Cadastre o cliente">
    Use `POST /clients` para registrar o cliente com CPF/CNPJ e endereço. O código do município (IBGE) e os campos de endereço são preenchidos automaticamente via CEP.
  </Step>

  <Step title="Insira as faturas">
    Use `POST /invoices` para criar faturas vinculadas ao `codigo` do cliente. O cliente precisa existir — caso contrário a API retorna 404.
  </Step>

  <Step title="Consulte quando precisar">
    Use `GET /clients` e `GET /invoices` com filtros para buscar registros por código, documento, título ou período de vencimento.
  </Step>
</Steps>

## Comportamento de lote vs. objeto único

| Modo         | Resposta de sucesso                      | Resposta de erro                    |
| ------------ | ---------------------------------------- | ----------------------------------- |
| Objeto único | `201` com `{ data: {...} }`              | Status exato com `{ error: "..." }` |
| Array        | `200` ou `207` com `{ success, errors }` | `422` se nenhum item processado     |

## Próximos passos

<CardGroup cols={2}>
  <Card title="POST /clients" icon="user-plus" href="/api-reference/post-clientes">
    Referência completa para inserção de clientes.
  </Card>

  <Card title="POST /invoices" icon="file-invoice" href="/api-reference/post-faturas">
    Referência completa para inserção de faturas.
  </Card>
</CardGroup>

<Tip>
  Precisa de ajuda? Entre em contato em [contato@usight.com.br](mailto:contato@usight.com.br).
</Tip>