SAT Lima

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.

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.

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

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.

Esta consulta pode demorar mais que uma solicitação típica. É um trabalho assíncrono. Por padrão, a solicitação espera de forma síncrona e retorna { data }, ou você pode fazer polling / usar um callback_url.

Referência completa

Esquemas, campos de resposta e um playground interativo.

Primeiros passos

Países

Estado de conta

Resposta

Referência completa

​Estado de conta

​Resposta

Referência completa

Estado de conta

Resposta