> ## 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

> Consulta la deuda pendiente con el SAT de Lima por DNI, RUC, placa, papeleta o código.

Resuelve la deuda pendiente con el SAT de Lima (Servicio de Administración
Tributaria de Lima) de una persona, empresa o vehículo: tributos (impuesto
vehicular, predial, arbitrios, alcabala), papeletas, multas administrativas y
compromisos de pago. Una sola consulta, seleccionada por `document_type`.

## Estado de cuenta

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

| Campo             | Tipo   | Notas                                                                                                                                                                                                 |
| ----------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `document_type`   | string | Uno de `dni`, `ruc`, `placa`, `papeleta` (documento de papeleta / multa administrativa), `cod_administrado` (código de administrado), `compromiso` (código de compromiso de pago). Por defecto `dni`. |
| `document_number` | string | **Requerido.** El 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" }'
```

## Respuesta

| Campo                 | Notas                                                                                                        |
| --------------------- | ------------------------------------------------------------------------------------------------------------ |
| `found`               | `true` cuando se resolvió una cuenta (incluso sin deuda); `false` solo ante un resultado genuinamente vacío. |
| `query`               | El valor consultado (sin espacios, en mayúsculas).                                                           |
| `document_type`       | La dimensión de búsqueda utilizada.                                                                          |
| `clear`               | `true` cuando no hay nada pendiente.                                                                         |
| `summary.total`       | Suma de los montos pendientes, en PEN (null cuando no hay deuda).                                            |
| `summary.items_count` | Cantidad de ítems pendientes.                                                                                |
| `debts[]`             | Los ítems pendientes (ver abajo).                                                                            |

Cada ítem en `debts[]`:

| Campo                                       | Notas                                                                                            |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| `group`                                     | Etiqueta del grupo de deuda (p. ej. `Papeletas`, `Impuesto vehicular`, `Arbitrios municipales`). |
| `group_code`, `concept_code`                | Códigos de grupo / concepto de origen.                                                           |
| `reference`                                 | Referencia o identificador del documento del ítem.                                               |
| `document`                                  | Campo de documento de origen.                                                                    |
| `plate`                                     | Placa, para ítems vinculados a un vehículo.                                                      |
| `amount`                                    | Monto pendiente, en PEN.                                                                         |
| `amount_with_discount`                      | Monto con descuento cuando se ofrece.                                                            |
| `status`                                    | Estado del ítem.                                                                                 |
| `year`, `installment`                       | Año tributario y cuota, para ítems tributarios.                                                  |
| `due_date`                                  | Fecha de vencimiento (`yyyy-mm-dd` cuando es interpretable).                                     |
| `infraction_date`                           | Fecha de infracción (`yyyy-mm-dd` cuando es interpretable), para papeletas y multas.             |
| `violation_code`, `violation`, `regulation` | Código de falta, descripción y reglamento, para papeletas y multas.                              |

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

<Note>
  `dni` y `ruc` resuelven primero al titular registrado antes de listar la deuda,
  por lo que pueden tardar un poco más que una consulta por placa o código.
</Note>

<Note>
  Esta consulta puede tardar más que una solicitud típica. Es un
  [trabajo asíncrono](/es/async-jobs). Por defecto la solicitud espera en línea y devuelve
  `{ data }`, o puedes hacer polling / usar un `callback_url`.
</Note>

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, campos de respuesta y un playground interactivo.
</Card>