Desarrolladores
Productos personalizados con láser, a través de una API REST
Conecta tu propia tienda, un marketplace o un sistema interno con nuestro taller. Crea diseños, obtén presupuestos exactos, haz pedidos y síguelos con webhooks.
La API abrirá después de nuestro lanzamiento en Shopify. Solicita acceso anticipado y cuéntanos qué estás construyendo.
Qué puedes hacer
Todo lo que necesitas para vender productos personalizados
Consultar el catálogo
Plantillas, materiales, tamaños, tipografías y precios en tu moneda, con todos los textos en cinco idiomas.
Crear diseños
Sube las fotos de tus clientes, envía los valores de los campos y recibe un diseño con su imagen de vista previa. Nosotros comprobamos la resolución de las fotos.
Presupuestos exactos
Artículos, envío e IVA para cualquier destino, calculados con el mismo código que cobra el pedido.
Hacer y seguir pedidos
Una petición por pedido, pagada desde tu saldo prepago. Sigue su estado y cancélalo mientras todavía se pueda.
Webhooks en cada paso
Creado, en espera, en producción, enviado, entregado, y avisos de saldo bajo. Cada webhook va firmado con HMAC-SHA256.
Consultar tu saldo
Tu saldo y todo su historial, para que tus cuentas cuadren siempre con las nuestras.
Ejemplo
Una petición, un pedido
El pedido se paga desde tu saldo. La respuesta te da nuestro número de pedido y su estado, y a partir de ahí siguen los webhooks.
curl https://api.staging.gravilo.eu/v1/orders \
-H "Authorization: Bearer gvl_live_…" \
-H "Idempotency-Key: 7d0f9a52-order-1042" \
-H "Content-Type: application/json" \
-d '{
"external_id": "1042",
"customer_locale": "de",
"ship_to": {
"name": "Lena Schmidt",
"line1": "Lindenstraße 12",
"postal_code": "10969",
"city": "Berlin",
"country": "DE"
},
"items": [
{ "design_id": "0192a5c4-7b1e-7c3d-9f00-5d1e2a3b4c5d", "quantity": 2 }
]
}'HTTP/1.1 201 Created
{
"id": "0192a5c4-8f02-7a11-b3c0-1e9d4c7a2b60",
"number": "GV-001042",
"external_id": "1042",
"is_test": false,
"status": "received",
"hold_reason": null,
"billing_status": "charged",
"placed_at": "2026-10-08T09:41:00Z"
}Pensada para integrar
Predecible, comprobable y documentada
Modo de prueba
Las claves de prueba validan y calculan el precio de los pedidos sin cobrar ni fabricar nada.
Reintentos seguros
Envía un Idempotency-Key con cada POST. La misma petición nunca crea dos pedidos.
OpenAPI 3.1
Una especificación legible por máquinas y documentación de referencia, generadas a partir de los esquemas con los que valida la API.
Errores claros
Detalles del problema (RFC 9457) con códigos estables y el campo exacto que hay que corregir.
¿Listo para empezar?
Empieza con la app de Shopify o conecta tu propio sistema con la API.