Skip to main content
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

  • No sube diseños. Los productos se crean antes, en el editor de Gudink. La API pide productos que ya existen en tu cuenta.
  • 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 pedir acceso

El acceso es por invitación mientras la API está en su primera etapa.
  1. Tené tu cuenta de Gudink creada, con el email verificado y los datos de facturación completos.
  2. Escribinos a hola@gudink.com contando qué web o plataforma querés conectar.
  3. Cuando habilitamos tu cuenta te aparece la sección Integraciones > API en tu panel.
Para integrar sin generar pedidos reales está el entorno de pruebas. Es una cuenta aparte, con su propio panel, sus propios productos y su propia clave: registrate ahí y pedinos que habilitemos la API también en esa cuenta.

​
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.