Saltar al contenido principal
La API de Gudink conecta tu propia web, o una tienda hecha a medida, con la producción de Gudink. Cuando alguien te compra en tu sitio, tu servidor crea el pedido en Gudink solo, sin que cargues nada a mano. El estado y el número de seguimiento vuelven a tu sitio de la misma forma. Es para vos si vendés desde una web propia (hecha por vos, por un programador o por un agente de IA) o desde una plataforma con la que Gudink todavía no se integra, y querés dejar de cargar cada pedido a mano. Si vendés en Tiendanube no la necesitás: esa integración ya hace todo esto. Ver Conectar tu Tiendanube paso a paso.

Cómo funciona

  1. Tu comprador te paga a vos, en tu sitio. Con el medio de pago que vos elijas. Gudink no interviene en esa venta.
  2. Tu servidor crea el pedido en Gudink. Manda el producto, la variante, la cantidad y la entrega: a domicilio o retiro en una sucursal.
  3. Gudink te cobra a vos la producción y el envío. Pagás el pedido desde tu panel, como cualquier pedido tuyo.
  4. Gudink produce y despacha a tu comprador. El estado y el seguimiento vuelven por la API o por avisos automáticos (webhooks).
La entrega puede ser a domicilio o con retiro en una sucursal del operador logístico, la que elija tu comprador al pagar. Ver Retiro en sucursal.

Qué podés hacer

Qué no hace

  • Diseños: sólo remeras, y en prueba. En general los productos se crean antes, en el editor de Gudink, y la API pide productos que ya existen en tu cuenta. Para remeras básicas podés crear el producto por la API a partir de un PNG: es una función en prueba que se habilita por cuenta, ver Crear productos a partir de tu arte. Si cada venta lleva un diseño distinto (un nombre, una foto), recibí la venta por la API y, antes de pagar el pedido, cambiale el diseño desde tu panel con “Personalizar este pedido”. Ver Personalizar el diseño de un pedido.
  • No le cobra a tu comprador. El cobro es tuyo, en tu sitio.
  • No le escribe a tu comprador. Ni mails ni mensajes. La comunicación con tu cliente es tuya; Gudink te pasa el seguimiento para que se lo des.
  • No maneja pedidos de otros canales. Los pedidos de Tiendanube o los que cargás a mano no pasan por la API.
  • Hoy no incluye cupones.

Cómo empezar

La API es gratis y la activás vos, sin pedirle nada a nadie:
  1. Tené tu cuenta de Gudink creada, con el email verificado y los datos de facturación completos.
  2. Entrá a Integraciones > API en tu panel y creá tu clave. Ver Claves y autenticación.
  3. Probá con tu misma cuenta: un pedido creado por API no se produce ni se cobra hasta que lo pagás vos. Ver Probar sin pagar.

Si te lo conecta un agente de IA

Esta documentación está escrita para que un agente (Claude, ChatGPT, Cursor u otro) pueda hacer la conexión completa. Empezá por Conectar con un agente de IA: tiene las instrucciones listas para pegarle y la lista de lo que tenés que darle. Si la vas a programar vos, seguí con el Inicio rápido. Si estás armando un conector para una plataforma (WooCommerce, una tienda propia, un ERP), mirá también Conectar una plataforma de e-commerce. Dos cosas que conviene resolver desde el primer día:
  • Mandá una cabecera User-Agent propia en cada llamada, por ejemplo MiTienda/1.0 (+https://mitienda.com). Algunas librerías mandan una por defecto que la red rechaza con un 403 que no es JSON, aunque tu clave esté bien.
  • Armá el external_id de cada pedido con un prefijo propio de tu instalación más tu número de pedido (por ejemplo woo-k7p2-10432), no con el número de pedido solo. Ver No duplicar pedidos.