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

# SAT Lima

> Consulte a dívida pendente com o SAT de Lima por DNI, RUC, placa, papeleta ou código.

Resolve a dívida pendente com o SAT de Lima (Servicio de Administración
Tributaria de Lima) de uma pessoa, empresa ou veículo: tributos (impuesto
vehicular, predial, arbitrios, alcabala), papeletas, multas administrativas e
compromissos de pagamento. Uma única consulta, selecionada por `document_type`.

## Estado de conta

`POST /pe/sat-lima/account-status/v1`

| Campo             | Tipo   | Notas                                                                                                                                                                                                     |
| ----------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `document_type`   | string | Um de `dni`, `ruc`, `placa`, `papeleta` (documento de papeleta / multa administrativa), `cod_administrado` (código de administrado), `compromiso` (código de compromisso de pagamento). O padrão é `dni`. |
| `document_number` | string | **Obrigatório.** O valor a consultar, de 1 a 20 caracteres alfanuméricos.                                                                                                                                 |

```bash theme={"dark"}
curl https://api.croma.run/pe/sat-lima/account-status/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_type": "placa", "document_number": "ABC123" }'
```

## Resposta

| Campo                 | Notas                                                                                                               |
| --------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `found`               | `true` quando uma conta foi resolvida (mesmo sem dívida); `false` apenas diante de um resultado genuinamente vazio. |
| `query`               | O valor consultado (sem espaços, em maiúsculas).                                                                    |
| `document_type`       | A dimensão de busca utilizada.                                                                                      |
| `clear`               | `true` quando não há nada pendente.                                                                                 |
| `summary.total`       | Soma dos valores pendentes, em PEN (null quando não há dívida).                                                     |
| `summary.items_count` | Quantidade de itens pendentes.                                                                                      |
| `debts[]`             | Os itens pendentes (veja abaixo).                                                                                   |

Cada item em `debts[]`:

| Campo                                       | Notas                                                                                          |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `group`                                     | Rótulo do grupo de dívida (p. ex. `Papeletas`, `Impuesto vehicular`, `Arbitrios municipales`). |
| `group_code`, `concept_code`                | Códigos de grupo / conceito de origem.                                                         |
| `reference`                                 | Referência ou identificador do documento do item.                                              |
| `document`                                  | Campo de documento de origem.                                                                  |
| `plate`                                     | Placa, para itens vinculados a um veículo.                                                     |
| `amount`                                    | Valor pendente, em PEN.                                                                        |
| `amount_with_discount`                      | Valor com desconto quando oferecido.                                                           |
| `status`                                    | Estado do item.                                                                                |
| `year`, `installment`                       | Ano tributário e parcela, para itens tributários.                                              |
| `due_date`                                  | Data de vencimento (`yyyy-mm-dd` quando interpretável).                                        |
| `infraction_date`                           | Data da infração (`yyyy-mm-dd` quando interpretável), para papeletas e multas.                 |
| `violation_code`, `violation`, `regulation` | Código da falta, descrição e regulamento, para papeletas e multas.                             |

```json theme={"dark"}
{
  "data": {
    "found": true,
    "query": "ABC123",
    "document_type": "placa",
    "clear": true,
    "summary": { "total": null, "items_count": 0 },
    "debts": []
  }
}
```

<Note>
  `dni` e `ruc` resolvem primeiro o titular registrado antes de listar a dívida,
  por isso podem demorar um pouco mais que uma consulta por placa ou código.
</Note>

<Note>
  Esta consulta pode demorar mais que uma solicitação típica. É um
  [trabalho assíncrono](/pt/async-jobs). Por padrão, a solicitação espera de forma síncrona e retorna
  `{ data }`, ou você pode fazer polling / usar um `callback_url`.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, campos de resposta e um playground interativo.
</Card>