SAT Lima

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.

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.

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

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.

Esta consulta puede tardar más que una solicitud típica. Es un trabajo asíncrono. Por defecto la solicitud espera en línea y devuelve { data }, o puedes hacer polling / usar un callback_url.

Referencia completa

Esquemas, campos de respuesta y un playground interactivo.

Primeros pasos

Colombia

Perú

Global

Estado de cuenta

Respuesta

Referencia completa

​Estado de cuenta

​Respuesta

Referencia completa

Estado de cuenta

Respuesta