> ## Documentation Index
> Fetch the complete documentation index at: https://ayuda.gudink.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API de Gudink: conectá tu web o tu tienda a medida

> Con la API de Gudink tu propia web crea los pedidos sola: vos vendés y cobrás en tu sitio, Gudink produce y envía. Qué hace, para quién es y cómo pedir acceso.

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](/integracion-tn/conectar-tienda-nube-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](/api/pedidos#retiro-en-sucursal).

## Qué podés hacer

| Con la API podés | Página |
| - | - |
| Listar tus productos y sus variantes, con precio y disponibilidad | [Productos y envío](/api/productos-y-envio) |
| Cotizar el envío de un carrito, a domicilio o con retiro en sucursal | [Productos y envío](/api/productos-y-envio) |
| Crear, consultar y cancelar pedidos | [Pedidos](/api/pedidos) |
| Recibir un aviso cuando un pedido cambia de estado | [Avisos (webhooks)](/api/avisos) |
| Probar todo sin producir, enviar ni cobrar nada | [Entorno de pruebas](/api/entorno-de-pruebas) |

## 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](mailto: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](/api/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](/api/conectar-con-un-agente): 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](/api/inicio-rapido). Si estás armando un conector para una plataforma (WooCommerce, una tienda propia, un ERP), mirá también [Conectar una plataforma de e-commerce](/api/conectar-una-plataforma).

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](/api/pedidos#no-duplicar-pedidos).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.