API Reference
La API de Wapidelo permite a sistemas externos — plataformas de proveedores, ERPs o scripts personalizados — consultar los pedidos de tu tienda en tiempo real. Todas las respuestas son JSON.
https://wapidelo.com/api/v1Autenticación
Incluye tu API key en el header Authorization de cada petición. Las keys se generan desde Dashboard → Integraciones → API Pública.
Authorization: Bearer wapi_a3f8c2e1b4d09f7eTrata tu API key como una contraseña. No la expongas en código del lado del cliente ni en repositorios públicos. Cada key está vinculada a una tienda específica.
Listar pedidos
GETDevuelve una lista paginada de pedidos de la tienda asociada al API key, ordenados del más reciente al más antiguo. Cada pedido incluye sus líneas de detalle.
Query parameters
date_fromFecha de inicio en formato YYYY-MM-DD (inclusive).
date_toFecha de fin en formato YYYY-MM-DD (inclusive).
statusFiltra por estado: pendingprocessingcompletedcancelled
pageNúmero de página. Por defecto: 1.
limitPedidos por página. Por defecto 50, máximo 200.
Request
curl "https://wapidelo.com/api/v1/orders?date_from=2026-06-01&date_to=2026-06-10" \
-H "Authorization: Bearer wapi_a3f8c2e1b4d09f7e"Response
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"order_number": "001",
"status": "completed",
"payment_status": "paid",
"delivery_method": "delivery",
"customer_name": "María García",
"customer_phone": "+50760000000",
"customer_email": "maria@ejemplo.com",
"customer_address": "Calle 50, Ciudad de Panamá",
"subtotal": 38.50,
"total": 42.50,
"currency": "USD",
"notes": null,
"scheduled_date": "2026-06-10",
"scheduled_time_slot": "9:00 AM - 12:00 PM",
"created_at": "2026-06-10T14:30:00Z",
"updated_at": "2026-06-10T15:00:00Z",
"items": [
{
"id": "item-uuid",
"product_name": "Kale orgánico",
"sku": "V101",
"unit_label": "lb",
"quantity": 3,
"unit_price": 2.50,
"subtotal": 7.50,
"variant_label": null,
"selected_options": null
}
]
}
],
"meta": { "page": 1, "limit": 50, "total": 124 }
}Obtener pedido
GETDevuelve el detalle completo de un pedido específico. Retorna 404 si el ID no existe o no pertenece a la tienda del API key.
Path parameters
idreqID único del pedido.
Request
curl "https://wapidelo.com/api/v1/orders/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer wapi_a3f8c2e1b4d09f7e"Response
Mismo schema que cada objeto dentro de data[] del endpoint de lista.
Errores
Todos los errores devuelven JSON con el campo error.
{ "error": "Invalid or revoked API key" }| Código | Descripción |
|---|---|
401 | API key ausente, inválida, revocada o expirada. |
400 | Parámetros inválidos o faltantes. |
404 | Recurso no encontrado o sin acceso desde este API key. |
500 | Error interno. Intenta de nuevo en unos segundos. |
¿Problemas o preguntas? hola@wapidelo.com