Saltar al contenido
Facturador

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.