get
https://api3.clau.io/ext/v3/compras
Misma consulta que /ext/query/purchases. Montos en unidades monetarias (no centavos). Con productos=true devuelve un registro por linea de producto y agrega producto. Una fecha YYYY-MM-DD es el dia completo en la zona horaria del negocio.
Scope requerido: compras:read
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Misma consulta que /ext/query/purchases. Montos en unidades monetarias (no centavos). Con productos=true devuelve un registro por linea de producto y agrega producto. Una fecha YYYY-MM-DD es el dia completo en la zona horaria del negocio.
| Scope requerido | compras:read |
| Método | GET /ext/v3/compras |
Query
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
page_size | integer | no | Registros por pagina Default 100. |
page | integer | no | Numero de pagina Default 1. |
tienda | string | no | Identificador exacto de la tienda (compra_tienda_id) |
fecha_inicio | string | no | YYYY-MM-DD o ISO 8601, inclusiva |
fecha_fin | string | no | YYYY-MM-DD o ISO 8601, inclusiva |
orden | enum: asc | desc | no | Orden por compraId Default "asc". |
tipo_cliente | enum: todos | usuarios | no_usuario | no | usuarios = compras con cliente identificado Default "todos". |
productos | boolean | no | true = una fila por linea de producto Default false. |
Ejemplo
curl -X GET 'https://api3.clau.io/ext/v3/compras' \
-H 'apikey: ck_1_...'Respuesta 200
{
"codigoRespuesta": 0,
"msj": "Exito",
"data": {
"compras": [
{
"compraId": 88123,
"transaccionId": "POS-000123",
"codigoConfirmacion": "A1B2C3",
"fechaRegistro": "2026-08-15 12:30:00",
"tiendaId": "SUCURSAL-1",
"estadoId": 1,
"estado": "Procesada",
"montoTotal": 25.5,
"montoImpuestos": 1.78,
"montoSubtotal": 23.72,
"clienteTipo": "usuario",
"cliente": {
"clauId": "uid-7",
"numId": "8-888-888",
"email": "[email protected]",
"nombre": "Ana",
"apellido": "Perez",
"extId": "EXT-7"
},
"descuentos": {
"aplicados": true,
"cantidad": 1,
"monto": 2,
"cantidadBeneficios": 0,
"cantidadCupones": 1
},
"pagoConPuntos": {
"usado": false,
"puntos": 0,
"monto": 0
},
"giftcard": {
"usada": false,
"cantidad": 0,
"monto": 0
},
"formasPago": [
{
"pagoNombre": "Tarjeta",
"pagoValor": 25.5
}
]
}
],
"paginacion": {
"pagina": 1,
"tamanoPagina": 100,
"totalRegistros": 1,
"totalCompras": 1
}
},
"meta": {
"requestId": "5f1c…",
"appId": 1,
"scope": "compras:read"
}
}Errores: 401 key inválida (9501), 403 sin scope (9503, meta.requiredScope), 400 parámetros (details), 429 límite de tasa. Agregue ?help=true para la ayuda en texto plano.