La solución de impresión bajo demanda Fabrixa API permite que cualquier plataforma o tienda online POD envíe un pedido y realice un seguimiento de su ciclo de vida a lo largo de order.created y order.updated webhooks, y deja que Fabrixa se encargue de imprimir, empaquetar y enviar el producto con marca blanca —desde una sola unidad, a cualquier punto de la UE—. Usted creas la experiencia de compra; nosotros nos encargamos de la producción textil bajo demanda que hay detrás. Sin pedido mínimo, sin gastos de configuración y sin la marca de Fabrixa en el paquete.
Esta entrada ofrece una descripción general, en un lenguaje sencillo, de la integración API (v2) para los desarrolladores que estén evaluando Fabrixa como capa de gestión de pedidos. Si prefiere echar un vistazo rápido a la referencia, el documento completo Documentación de la API y paso a paso guía de integración Estamos listos cuando usted lo esté.
Para qué sirve ea API
Fabrixa es un plataforma de estampado textil reactivo: un único panel de control para los canales de venta, los diseños, la producción y los envíos. La mayoría de los clientes se conectan a través de Shopify, WooCommerce o Fabrixa Studio. La integración API es la cuarta opción, diseñada para las plataformas POD y para los desarrolladores que ya disponen de su propio escaparate y desean tener control programático sobre la gestión de los pedidos.
Usted le pones en contacto con API para enviar los pedidos. Fabrixa se encarga de producirlos: impresión reactiva sobre algodón y lino en Portugal y España, e impresión por sublimación sobre poliéster en los Países Bajos. Los paquetes se envían bajo su marca, con su dirección de remitente y sin ninguna referencia a Fabrixa en ningún lugar del paquete. Sus clientes nunca sabrán que existimos a menos que usted se lo digas.
Para qué sirve ea API
- Ping — una comprobación rápida para verificar que sus credenciales y su conexión funcionan correctamente antes de enviar cualquier dato real.
- Productos — Consulta el catálogo en el que está trabajando: ropa, textiles para el hogar y tejidos por metro, con las bases y variantes disponibles para impresión.
- Pedidos — Crear un pedido y consultar su estado. Este es el núcleo de cualquier integración: se introducen las líneas de pedido, las fuentes, los datos del cliente y de envío; y se obtiene un pedido con seguimiento.
- Cumplimientos — Realiza un seguimiento de la producción y la expedición a medida que se fabrican y envían los artículos, para que su plataforma pueda mostrar un estado preciso a los vendedores.
- Estudio — adjunta un diseño personalizado en Fabrixa Studio (nuestro configurador de productos integrable y de marca blanca) a un pedido mediante su
cart_item_key, por lo que lo que diseña el comprador es exactamente lo que se imprime.
Autenticación y rate limits
La integración API (v2) se encuentra en la URL base https://api.fabrixa.com/v2/integration. Cada solicitud conlleva dos encabezados:
| Cabecera | Propósito |
|---|---|
Autorización: Portador |
Su token API: identifica y autoriza la solicitud. |
X-Application-Key: |
Su clave de aplicación: va emparejada con el token, por lo que ambas deben estar presentes. |
El límite de frecuencia es 30 solicitudes por minuto. Eso es más que suficiente para el tráfico generado por pedidos, pero significa que las operaciones masivas deben realizarse de forma escalonada, en lugar de ejecutarse en un bucle muy corto. Gestiona el límite con flexibilidad, retrocede cuando lo alcances y recurre a los webhooks (más abajo) en lugar de realizar consultas periódicas.
Webhooks: reacciona ante el estado, no lo compruebes constantemente
En lugar de preguntar una y otra vez “¿ya está listo?”, suscríbete a los webhooks y deja que Fabrixa le avise cuando haya algún cambio. La integración API emite dos eventos:
- order.created — Se activa cuando se acepta un pedido para su producción. Úsalo para confirmar la recepción al vendedor y marcar el pedido como en curso.
- order.updated — se activa a medida que el pedido avanza por las fases de producción y envío, incluido el seguimiento. Úsalo para mantener sincronizado el estado de su plataforma sin agotar su límite de solicitudes.
Entre dos eventos y un límite máximo de 30 por minuto, una integración que funcione correctamente apenas roza el límite: envía la orden y, a continuación, reacciona a la respuesta recibida.
El flujo de pedidos, de principio a fin
Elijas la ruta que elija, la forma es la misma:
- Conectar — una tienda (Shopify o WooCommerce) o API.
- Diseño — Personalízalo en Fabrixa Studio o envíenos un PDF listo para imprimir.
- Enviar el pedido — a través de la tabla API, con las líneas de producto, el cliente y la dirección de envío.
- Fabricamos y enviamos — Fabrixa se encarga de la impresión, el embalaje y el envío, en marca blanca.
Una breve nota sobre la calidad, ya que es la razón por la que los vendedores eligen el tinte reactivo: este forma un enlace covalente con la celulosa de la fibra de algodón y se fija de forma permanente mediante calor y vapor. El color pasa a formar parte de la fibra —sin capa superficial ni agrietamiento en los puntos de flexión—, por lo que al tacto parece algodón sin estampar y, por lo general, conserva el color durante más de 600 ciclos de lavado. A modo de ejemplo de plazo de entrega, la ropa fabricada en Portugal tarda aproximadamente entre 6 y 9 días laborables.
Por qué las plataformas se basan en Fabrixa
- MOQ 1 — desde una sola unidad hasta decenas de miles. Sin pedido mínimo, sin gastos de configuración y sin contratos.
- Marca blanca por defecto — la marca del cliente en cada paquete, no la nuestra.
- Cadena de suministro corta de la UE — la producción en Portugal, España y los Países Bajos, no el transporte de mercancías de larga distancia.
- Impresión realmente reactiva — Algodón orgánico con certificación GOTS como base predeterminada, además de las certificaciones OEKO-TEX Standard 100 y Made in Green.
Preguntas frecuentes
¿Tengo que utilizar Fabrixa Studio para poder usar ea API?
No. Studio es opcional. En su lugar, puede enviar un PDF listo para imprimir junto con el pedido. Studio solo se utiliza cuando quiere que los compradores personalicen un producto en su tienda online, y adjuntas ese diseño al pedido mediante cart_item_key.
¿Cómo puedo autenticar las solicitudes?
Envía dos encabezados en cada llamada: Autorización: Portador y X-Application-Key:. Ambos son obligatorios; si falta uno de ellos, se rechazará la solicitud.
¿Qué ocurre si alcanzo el límite de frecuencia?
Ea API tiene un límite de 30 solicitudes por minuto. Si lo superas, espera un rato y vuelve a intentarlo, en lugar de saturar el endpoint. Para los cambios de estado, utiliza el order.created y order.updated Los webhooks, en lugar del sondeo: le mantienen al día sin gastar solicitudes.
¿El servicio de logística es realmente de marca blanca?
Sí. Los paquetes se envían bajo su marca, con su dirección de remitente y, por defecto, sin ninguna referencia a la marca Fabrixa. Sus clientes finales nunca nos ven.
Empiece a desarrollar
La forma más rápida de entrar es la guía de integración, respaldada por la Documentación de la API. Si prefiere ver primero cómo encaja todo, el Descripción general de la plataforma pasa por los canales de Studio, producción y envío. Y si quiere probar si se adapta a su plataforma, hable con nuestro equipo — estaremos encantados de analizar su caso de uso.
