Skip to content

Listar ventas ​

http
GET /sales/orders

Requiere el scope sales.orders:read y las cabeceras de autenticación.

El scope permite consultar todas las ventas de la empresa, incluidas las del POS, back office y otras integraciones. El listado no se limita a las ventas creadas por la API key actual.

Paginación ​

ParámetroTipoDescripción
pageintegerPágina, desde 1.
per_pageintegerDe 1 a 100 resultados; por defecto 20.

Los resultados se ordenan por ID descendente. La respuesta contiene data, links y meta. Cada venta utiliza los campos públicos de la respuesta de creación; los ítems se incluyen al crear, no en el listado.

bash
curl 'https://api.simple.pe/sales/orders?per_page=20&page=1' \
  --header 'Accept: application/json' \
  --header "X-Api-Key: ${SIMPLE_API_KEY}" \
  --header "X-Api-Secret: ${SIMPLE_API_SECRET}"

Puede responder 401, 403, 422 o 429. Consulta errores.

Simple · API para integraciones de terceros