Hay dos formas de enviar pedidos a Fabrixa: conectar la tienda que ya gestiona —Shopify o WooCommerce— sin necesidad de programar, o crear una directamente en la integración API. Esta guía explica ambas opciones: conecta un canal de ventas en cuestión de minutos o pasa de la autorización al envío en quince.
La mayoría de las tiendas nunca utilizan el modelo API. Si añade Fabrixa como canal de ventas, los pedidos de su tienda pasan directamente a producción: los productos se sincronizan, se actualiza el estado de los pedidos y no hay que escribir ni mantener código alguno. La ruta API que se describe más adelante está pensada para tiendas personalizadas y plataformas POD.
En su panel de control, abre Create channel y elige el tipo de integración. Cada canal mantiene sus propios productos, pedidos importados y reglas de importación: conecta tantos como utilices.
No hay que copiar ninguna clave. Autoriza Fabrixa desde su panel de administración de Shopify y la conexión estará activa.
Create channel, selecciona Shopify.Una tienda de WordPress se conecta mediante un par de claves REST de lectura/escritura, generadas en WooCommerce y que se introducen una sola vez en Fabrixa.
Settings → Advanced → REST API → Add key con Lectura/Escritura permisos.ck_ y el secreto cs_ y el dominio de su tienda en Fabrixa.¿Vendes productos personalizados? Fabrixa Studio —el editor de diseño de marca blanca— también está disponible en las tiendas de Shopify y WooCommerce, para que sus clientes puedan personalizar los productos bajo su marca. Ver Fabrixa Studio →
Las tiendas conectadas aparecen junto a su API y a los canales de sus socios en la vista «Canales»: productos sincronizados, pedidos recibidos, la última referencia importada y los ingresos por canal. Cambia el estado de un canal de «borrador» a «activo» cuando esté listo; no se produce ningún cambio en las fases posteriores.
¿Prefieres crear una tienda online personalizada o su propia plataforma POD? El resto de esta guía se centra en la ruta API: desde la autenticación hasta la gestión de pedidos en cuatro pasos.
Hay tres pasos que le llevan de cero a un pedido activo. Todos ellos se gestionan desde su panel de control de Fabrixa o a través de su ingeniero de soluciones.
Un token de acceso de la aplicación y una clave de la aplicación. Ambos son obligatorios en cada solicitud: el token en el encabezado «Authorization» y la clave en «X-Application-Key». Cree un canal de ventas en su panel de control para generarlos al instante, sin necesidad de realizar ninguna solicitud.
Un endpoint HTTPS accesible desde Internet que acepta solicitudes POST en formato JSON. En el entorno de desarrollo, «localhost» funciona a través de un túnel. Debes verificar la firma HMAC-SHA256 de cada payload antes de procesarla.
Su archivo de diseño —PDF, TIFF, JPG o PNG— accesible a través de HTTPS sin necesidad de autenticación. Color RGB, hasta 50 MB y 15 000 píxeles por lado. Los PDF de varias páginas deben tener una página por capa. Nosotros recuperamos el archivo y generamos los archivos de impresión correctos al procesar el trabajo.
Todas las solicitudes se envían a la URL base https://api.fabrixa.com/v2/integration con ambos encabezados configurados. GET /ping confirma que el token y la clave son válidos antes de hacer nada más.
A 401 significa que falta un encabezado o que el token ha sido revocado. Un 403 significa que las credenciales son válidas, pero carecen de permisos para acceder al recurso.
# Verify auth before anything else curl https://api.fabrixa.com/v2/integration/ping \ -H "Accept: application/json" \ -H "Authorization: Bearer APPLICATION_ACCESS_TOKEN" \ -H "X-Application-Key: APPLICATION_KEY" # 200 OK → credentials valid # 401 → missing header or revoked token # 403 → valid, but no access to the resource
El catálogo muestra las variantes de producto con sus códigos SKU y variant_id. Cada respuesta de la lista se incluye entre las etiquetas estándar links / meta / data sobre, así que numera las páginas con el next_page enlace. Almacenar en caché localmente: el catálogo no se genera para cada solicitud.
Los detalles completos del campo se encuentran en el Referencia de Swagger.
GET /v2/integration/products?page=1
{
"links": {
"self": ".../products?page=1",
"next_page": ".../products?page=2",
"prev_page": null
},
"meta": { "total": 248, "current_page": 1, "per_page": 10 },
"data": [
{ "id": 1306, "name": "Unisex AOP T-shirt", "SKU": "COF099191" }
]
}
Enviar rows (SKU + cantidad + un PDF de origen), customer y shipping_address. Establezca su propio number como referencia: si no lo indica, lo generaremos nosotros. Guarde el ID de pedido Fabrixa devuelto junto con su pedido.
Los pedidos de Studio sustituyen sources por un cart_item_key — todo lo demás es idéntico.
POST /v2/integration/orders
{
"number": "ORD-2026-0142",
"purchased_at": "2026-05-28 14:22:01",
"rows": [
{
"sku": "COF099191",
"quantity": 1,
"sources": [
{ "type": "file", "url": "https://cdn.you.com/art/9812.pdf" }
]
}
],
"customer": {
"first_name": "Maria", "last_name": "Silva",
"email": "maria@example.com", "phone": "+351912345678"
},
"shipping_address": {
"address": "Rua do Carmo 42", "city": "Lisboa",
"postal_code": "1200-094",
"country_code": "PT", "country": "Portugal"
}
}
Configure la URL de su webhook en el panel de control. Enviamos mediante POST order.created y order.updated a esa URL con el cuerpo completo del pedido, un encabezado x-webhook-signature (HMAC-SHA256) y un encabezado x-webhook-topic correspondiente. Verifique la firma, devuelva 200 rápido y procese de forma asíncrona.
Todos los eventos y los fragmentos de verificación se encuentran en la referencia de webhooks.
# Request headers content-type: application/json x-webhook-topic: order.updated x-webhook-signature: YmEwNjBhMGMy...AxMw== # Body (truncated) { "id": 23069, "number": "1250211835", "status": "imported", "fulfillment_status": "unfulfilled", "updated_at": "2026-05-28T07:43:52Z" }
Los errores se devuelven en formato JSON, nunca en HTML. El errors.messages array indica qué ha fallado; en caso de error 400, enumera los campos que no han superado la validación.
Error de validación, credenciales ausentes o revocadas, permisos insuficientes o recurso desconocido.
30 solicitudes por aplicación por minuto. X-RateLimit-Limit y X-RateLimit-Remaining aparecen en todas las respuestas.
Del lado del servidor. Vuelve a intentarlo con un mecanismo de retroceso; si el problema persiste, envíe el identificador de la solicitud a su ingeniero de soluciones.
{
"links": { "self": ".../v2/integration/orders" },
"meta": [],
"errors": {
"messages": [
"Application Key is not specified."
]
}
}
Para asistencia en materia de integración, problemas con credenciales o canales de venta, requisitos personalizados o planificación de la capacidad: diríjase al canal técnico de SE, no a la línea de ventas. Respuesta en el plazo de un día laborable.
