API pública · v1
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/v1- Formato
- JSON
- Autenticación
- Bearer · API key
- Alcance de la key
- Una tienda
- Paginación
- page · limit (máx. 200)
Autenticació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_TU_API_KEYListar pedidos
GET/api/v1/orders
Devuelve 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
| Nombre y tipo | Descripción |
|---|---|
| date_fromstring | Fecha de inicio en formato YYYY-MM-DD (inclusive). |
| date_tostring | Fecha de fin en formato YYYY-MM-DD (inclusive). |
| statusstring | Filtra por estado: pending · processing · completed · cancelled |
| pageinteger | Número de página. Por defecto: 1. |
| limitinteger | Pedidos por página. Por defecto 50, máximo 200. |
Campo de coordenadas
Los campos customer_latitude y customer_longitude se rellenan cuando:
- El checkout usa el mapa interactivo y el cliente selecciona o arrastra un marcador.
- El cliente usa «Mi ubicación» (geolocalización).
- Se realiza un geocoding automático basado en la dirección ingresada manualmente.
Si el cliente ingresa solo la dirección sin interactuar con el mapa, estos campos quedan null.
curl "https://wapidelo.com/api/v1/orders?date_from=2026-06-01&date_to=2026-06-10" \
-H "Authorization: Bearer wapi_TU_API_KEY"const res = await fetch(
'https://wapidelo.com/api/v1/orders?date_from=2026-06-01&date_to=2026-06-10',
{ headers: { Authorization: 'Bearer wapi_TU_API_KEY' } }
)
const { data, meta } = await res.json()import requests
r = requests.get(
'https://wapidelo.com/api/v1/orders',
params={'date_from': '2026-06-01', 'date_to': '2026-06-10'},
headers={'Authorization': 'Bearer wapi_TU_API_KEY'},
)
data = r.json(){
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"order_number": "001",
"status": "completed",
"payment_status": "paid",
"delivery_method": "delivery",
"payment_method": "paguelofacil",
"cash_amount": null,
"payment_metadata": {
"paguelofacil": {
"oper": "LK-3JISTMUTUCGF",
"estado": "Aprobada"
}
},
"customer_name": "María García",
"customer_phone": "+50760000000",
"customer_email": "maria@ejemplo.com",
"customer_address": "Calle 50, Ciudad de Panamá",
"customer_latitude": 8.9824,
"customer_longitude": -79.5199,
"address_detail": "Apto 5B, edificio rojo",
"address_reference": "Cerca del parque",
"delivery_zone": "Casco Viejo",
"subtotal": 38.50,
"total": 42.50,
"currency": "USD",
"custom_fields": null,
"notes": null,
"scheduled_date": "2026-06-10",
"scheduled_time_slot": "9:00 AM - 12:00 PM",
"source": "storefront",
"internal_reference": null,
"invoice_number": null,
"shipday_order_id": null,
"created_at": "2026-06-10T14:30:00Z",
"created_at_local": "2026-06-10T09:30:00",
"created_date_local": "2026-06-10",
"created_time_local": "09:30:00",
"updated_at": "2026-06-10T15:00:00Z",
"store_timezone": "America/Panama",
"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": []
}
]
}
],
"meta": { "page": 1, "limit": 50, "total": 124 }
}Obtener pedido
GET/api/v1/orders/:id
Devuelve 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
| Nombre y tipo | Descripción |
|---|---|
| idstring (UUID)requerido | ID único del pedido. |
Response
Mismo schema que cada objeto dentro de data[] del endpoint de lista.
curl "https://wapidelo.com/api/v1/orders/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer wapi_TU_API_KEY"const res = await fetch(
'https://wapidelo.com/api/v1/orders/550e8400-e29b-41d4-a716-446655440000',
{ headers: { Authorization: 'Bearer wapi_TU_API_KEY' } }
)
const order = await res.json()import requests
r = requests.get(
'https://wapidelo.com/api/v1/orders/550e8400-e29b-41d4-a716-446655440000',
headers={'Authorization': 'Bearer wapi_TU_API_KEY'},
)
order = r.json()Errores
Todos los errores devuelven JSON con el campo error.
| Código | Descripción |
|---|---|
| 400 | Parámetros inválidos o faltantes. |
| 401 | API key ausente, inválida, revocada o expirada. |
| 404 | Recurso no encontrado o sin acceso desde este API key. |
| 429 | Demasiadas solicitudes. Espera los segundos que indica Retry-After. |
| 500 | Error interno. Intenta de nuevo en unos segundos. |
{ "error": "Invalid or revoked API key" }Límites de uso
Puedes hacer hasta 60 solicitudes por minuto desde una misma dirección IP. Si superas ese límite, la API responde con el código 429 y la cabecera Retry-After, que indica cuántos segundos esperar antes de volver a intentar.
Esa respuesta incluye también X-RateLimit-Limit y X-RateLimit-Remaining.
HTTP/1.1 429 Too Many Requests
Retry-After: 42
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
{ "error": "Demasiados intentos. Espera unos minutos e intenta de nuevo." }¿No encontraste lo que buscabas?
Nuestro equipo te responde por WhatsApp, normalmente en minutos.