Pedidos de la tienda virtual
GET /api/orders
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Pedidos recibidos por la tienda virtual (e-commerce), más recientes primero, 20 por página. No confundir con los pedidos internos de la sección Pedidos.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: listado paginado por página {data[], links: {first, last, prev, next}, meta: {current_page, last_page, per_page, total, ...}}. Usa el query param page para avanzar.
Estados (status_order_id): 1 pago sin verificar, 2 pago verificado, 3 despachado, 4 confirmado por el cliente (la empresa puede tener estados adicionales).
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
page |
query | no | 1 |
Número de página. |
Respuestas
200 — Pedidos
{
"data": [
{
"id": 12,
"external_id": "f1e2d3c4-b5a6-4789-9abc-def012345678",
"number_document": null,
"order_id": "PED-000012",
"order_code": "A7K2Q9",
"customer": "PEDRO QUISPE MAMANI",
"customer_email": "pedro.quispe@correo.pe",
"customer_telefono": "987654321",
"customer_direccion": "JR. HUALLAGA 321, LIMA",
"customer_document_number": "45678912",
"customer_document_type": "DNI",
"is_guest": false,
"items": [
{
"id": 31,
"description": "GASEOSA COCA COLA 500ML",
"cantidad": 6,
"sale_unit_price": 2.5
}
],
"total": 15.0,
"total_discount": 0,
"discount_coupont": null,
"reference_payment": "YAPE-984512",
"document_external_id": null,
"created_at": "2026-11-07 11:30:00",
"status_order_id": 1,
"payment_status_order_id": 1,
"shipping_status_order_id": null,
"tracking_code": null,
"purchase": null,
"document_type_id": null,
"has_sale_note": false,
"sale_note_number_full": null,
"sale_note_id": null
}
],
"links": {
"first": "https://empresa.dominio/api/orders?page=1",
"last": "https://empresa.dominio/api/orders?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"path": "https://empresa.dominio/api/orders",
"per_page": 20,
"to": 1,
"total": 1
}
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.