Saltar al contenido
API

Crear un flujo de personalización con la API Order

Si tus clientes diseñan su propia funda en tu app, la API Order te permite enviar el diseño final directo a producción y seguir el pedido hasta la entrega con webhooks.

Qué obtienes

El acceso a la API viene con el plan Pro. Creas una clave en la cuenta, y la URL base es https://app.tullunprint.com/api/v1. No hay registro aparte para desarrolladores.

El flujo

  • Lee el catálogo con GET /catalog para listar los tipos de funda y los dispositivos compatibles
  • Pon el diseño del cliente en un enlace https público; el pedido lo lleva como archivo del artículo
  • Crea el pedido con POST /orders: el tipo de funda, el dispositivo, el enlace del diseño y la dirección de envío
  • Registra un webhook con POST /webhooks y recibe los cambios de estado a medida que el pedido avanza por la producción y el envío
  • Consulta GET /orders/{id} en cualquier momento para ver el estado actual y el seguimiento

Requisitos del diseño

Envía archivos listos para imprimir: 300 dpi, sRGB, con sangrado. La API valida las dimensiones con la zona de impresión de la funda elegida, así que una interfaz de personalización debe exportar al tamaño de la plantilla de ese dispositivo.

Los estados que le importan a tu cliente

«Received», «Being made» y «On its way», con el número de seguimiento cuando lo haya. Trasládalos a tu propia página de pedido para que el cliente vea siempre las mismas palabras en el mismo orden.

Dónde encontrar los detalles

Los parámetros de los endpoints, los datos de ejemplo y las claves están en la página de la API de tu cuenta de vendedor. La página pública de la API en este sitio explica el modelo de un vistazo.

Todos los recursos

¿Listo para crear tu negocio POD?

Conecta tu tienda, crea tus productos y deja en nuestras manos la producción y el fulfillment.