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.
Estado 401 significa que falta un encabezado o que el token ha sido revocado. Estado 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 los estudios sustituyen a los sources archivo con el cart_item_key del diseño guardado; 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."
]
}
}
Fabrixa permite 30 solicitudes por aplicación y minuto; si se supera ese límite, se devuelve una respuesta 429 «Too Many Requests». Las cabeceras «X-RateLimit-Limit» y «X-RateLimit-Remaining» se incluyen en cada respuesta, de modo que una integración pueda realizar un seguimiento de su cuota restante antes de alcanzar el límite.
Fabrixa admite archivos de diseño en formato PDF, TIFF, JPG o PNG en color RGB, de hasta 50 MB y 15 000 píxeles por cara, a los que se puede acceder a través de HTTPS sin necesidad de autenticación. Los archivos PDF de varias páginas se tratan como una página por capa, y Fabrixa recupera el archivo por sí mismo para generar los archivos de impresión correctos cuando se procesa el trabajo.
En WooCommerce, ve a «Ajustes», luego a «Avanzado», después a «REST API» y añade una clave con permisos de lectura y escritura. Pega la clave «ck_» resultante, el secreto «cs_» y el dominio de su tienda en Fabrixa, guarda los cambios y los pedidos se sincronizarán automáticamente; las reglas de importación se pueden modificar más adelante en la configuración del canal.
Antes de realizar un primer pedido, necesita un token de acceso a la aplicación y una clave de aplicación de un canal de ventas, un endpoint público de webhook HTTPS que verifique la firma HMAC-SHA256 en cada payload, y material gráfico accesible a través de HTTPS sin necesidad de autenticación. Los tres se emiten o configuran desde el panel de control de Fabrixa, y las credenciales se generan al instante al crear el canal de ventas.
Un código 403 indica que el token de acceso de la aplicación y la clave de la aplicación son válidos, pero carecen de permiso para el recurso solicitado. Esto difiere de un código 401, que significa que falta un encabezado obligatorio o que el token ha sido revocado; ambos casos pueden comprobarse mediante una solicitud GET /ping antes de continuar con el desarrollo.
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.
Puedes conectarte a través de nuestro REST API y un feed de productos, y Fabrixa Studio, nuestro editor de diseño, se puede integrar en su propia plataforma para que aparezca como una función propia.
Lee la respuesta →Actualmente se encuentra en fase de desarrollo; nuestro equipo está trabajando en el envío automatizado de pedidos, la sincronización de productos, precios y existencias, y el seguimiento automático de las devoluciones.
Lee la respuesta →Recursos para desarrolladores: Documentación de API https://www.fabrixa.com/developers/api-documentation · Guía de integración https://www.fabrixa.com/developers/integration-guide/ · Webhooks https://api.fabrixa.com/docs/integration#webhooks
Lee la respuesta →Las 8 respuestas sobre «Integraciones» y «API» → Consulta a nuestro equipo de atención al cliente →
