Saltar al contenido
Plataforma para desarrolladores

Impulsa tu negocio con nuestra API.

Conecta tu plataforma directamente con nuestra infraestructura de fabricación y fulfillment. Las claves de API vienen con el plan Pro en app.tullunprint.com, sin tener que solicitarlas.

Inicia sesión para acceder a la API Habla con nosotros

Cómo funciona el acceso

Inicia sesión en tu cuenta de vendedor y abre la página de la API. Crea una clave para cada sistema que se comunique con nosotros y añade la URL a la que debemos llamar cuando cambie un pedido. La referencia completa (URL base, cada endpoint, una petición de ejemplo) está en esa misma página.

  • Catálogo de productos con tus precios
  • Tus diseños guardados
  • Hacer pedidos
  • Estado de los pedidos
  • Seguimiento
  • Webhooks en cada cambio
  • Una clave por sistema
  • Fulfillment automatizado
app.tullunprint.com/merchant/api Dentro de tu cuenta
1
Iniciar sesiónLas claves de API vienen con el plan Pro. Sin registro aparte para desarrolladores.
2
Crear una claveUna clave por sistema que se comunica con nosotros: revocar una nunca rompe otra.
3
Añadir un webhookLlamamos a tu URL cuando un pedido cambia de estado, con las mismas palabras que la página de Pedidos.
Qué cubre la API
  • GET  /catalogTodo lo que imprimimos, con tus precios
  • GET  /designsTus diseños guardados y sus tokens
  • GET  /ordersTus pedidos, los más recientes primero
  • GET  /orders/{id}Un pedido: estado, artículos, seguimiento
  • POST /ordersHacer un pedido a partir de un diseño guardado
  • POST /webhooksEnterarte de los cambios en los pedidos
  • GET  /webhooksLas URL que has registrado
  • DELETE /webhooks/{id}Detener una
JSON de entrada y salida · los precios siempre salen de tu catálogo, nunca de la petición · los diseños se crean en el diseñador y se usan mediante token
Qué puedes crear

Todo lo que hace el panel, mediante scripts.

Leer el catálogo

Cada funda que imprimimos y cada dispositivo compatible, con tu descuento ya aplicado.

Usar tus diseños

Los diseños se crean una vez en el diseñador y se referencian por token: no hay que subir diseños en la petición.

Hacer y seguir pedidos

Envía un pedido con un destinatario y luego consulta su estado, artículos y seguimiento a medida que avanza.

Te avisamos, sin consultas

Los webhooks se disparan con cada cambio de pedido para que tu sistema esté al día sin preguntar.

Conviene saber

Algunas cosas en las que la API es estricta.

Las claves se muestran una vez

Una clave nueva se muestra una sola vez; solo guardamos una huella. Revócala y emite otra desde la misma página.

Los precios salen de tu catálogo

Una petición nunca fija un precio. Pagas lo que dice tu catálogo en el momento del pedido.

Las mismas palabras en todas partes

Los estados de pedido en la API, los webhooks y la página de Pedidos usan el mismo vocabulario («Being made», «On its way») para que no haya nada que reinterpretar.

Un evento, sin complicaciones

Cada cambio de estado envía order.updated a tu URL https con el pedido, su estado, el número de seguimiento cuando lo hay y la hora.

Margen para trabajar

Hasta 120 peticiones por minuto y clave, y 30 pedidos nuevos por minuto. Las claves siguen funcionando si cambias de plan; las nuevas necesitan Pro.

Construye sobre nuestra infraestructura de producción.

Inicia sesión en tu cuenta de vendedor, crea una clave y empieza a integrar hoy mismo.

Inicia sesión para acceder a la API Ver integraciones