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

# Órdenes de captura SAT Lima

> Verifique se uma placa tem uma ordem de captura vigente em Lima.

Indica se um veículo (por placa) tem uma ordem de captura vigente na
província de Lima, emitida pelo SAT de Lima (Servicio de Administración
Tributaria de Lima) por dívida tributária ou papeletas pendentes. Uma única
consulta, por placa.

## Ordens de captura

`POST /pe/sat-lima/capturas/v1`

| Campo   | Tipo   | Notas                                                                                            |
| ------- | ------ | ------------------------------------------------------------------------------------------------ |
| `plate` | string | **Obrigatório.** A placa do veículo a consultar, de 4 a 10 caracteres (letras, dígitos, hífens). |

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

## Resposta

| Campo               | Notas                                                                                                                 |
| ------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `found`             | `true` quando a fonte retornou um resultado para a placa.                                                             |
| `plate`             | A placa consultada (sem espaços, em maiúsculas).                                                                      |
| `has_capture_order` | `true` quando a placa tem pelo menos uma ordem de captura vigente.                                                    |
| `message`           | A linha de resultado da fonte (presente quando a placa não tem ordem).                                                |
| `report_date`       | Data do relatório (`yyyy-mm-dd` quando interpretável).                                                                |
| `orders[]`          | As ordens de captura quando existem, cada uma com as colunas que a fonte reporta. Vazio quando a placa não tem ordem. |

```json theme={"dark"}
{
  "data": {
    "found": true,
    "plate": "ABC123",
    "has_capture_order": false,
    "message": "El vehículo de placa ABC123 no tiene orden de captura en la provincia de Lima.",
    "report_date": "2026-06-22",
    "orders": []
  }
}
```

<Note>
  Uma ordem de captura significa que o veículo pode ser retido pela dívida
  ou pelas papeletas pendentes. A cobertura se limita à província de Lima: um
  resultado `false` descarta uma ordem de captura apenas em Lima, não no resto
  do Peru.
</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 ou 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>