Saltar al contenido principal
La API se prueba con tu cuenta de siempre, en https://app.gudink.com/api/v1. No hay una cuenta ni un entorno aparte: probás con tu clave gk_live_, tus productos y tu destino de avisos, que son los mismos que después vas a usar para vender. Hay dos formas, y conviene empezar por la primera:
  • Pedidos en borrador (/order-drafts): Gudink valida el pedido y te devuelve el costo, pero no crea ningún pedido. No reserva stock, no te llega ningún mail y no aparece en tu panel. Es la forma de probar tu integración sin dejar rastro.
  • Pedidos sin pagar: un pedido real que no pagás. Sirve para probar lo que pasa después de crearlo (consultarlo, cancelarlo, los avisos).

Probar con pedidos en borrador

Mandás el mismo cuerpo que a POST /orders, pero a POST /order-drafts:
Responde 201 con status: "draft", el desglose de costos (totals) y su vencimiento. Se validan las mismas cosas que en un pedido real: productos, variantes, datos de facturación y la cotización del envío. Si algo está mal, el error es el mismo que te devolvería POST /orders. Lo que podés hacer con un borrador:
  • Verlo: GET /order-drafts/{id}, o todos con GET /order-drafts.
  • Borrarlo: DELETE /order-drafts/{id}.
  • Confirmarlo: POST /order-drafts/{id}/confirm lo convierte en un pedido real, igual que si lo hubieras creado con POST /orders: vuelve a chequear stock y precio en ese momento y responde el pedido, con draft_id y price_changed (true si el total cambió desde el borrador). Si la cotización del envío venció, mandá una nueva en el cuerpo: { "shipping": { "quote_id": "..." } }. Confirmar dos veces el mismo borrador devuelve el mismo pedido, sin duplicarlo.
Podés tener hasta 100 borradores vivos a la vez.

Probar con pedidos sin pagar

Lo que lo hace seguro es el pago. Un pedido creado por API nace sin pagar (pending_payment) y Gudink no lo produce ni te lo cobra hasta que lo pagás vos desde tu panel. Si no lo pagás, no pasa nada: lo cancelás o vence solo.

Lo que necesitás

  1. Tu cuenta de Gudink, con el email verificado y los datos de facturación completos.
  2. Al menos un producto diseñado en tu cuenta.
  3. Una clave, que creás vos en Integraciones > API. Ver Claves y autenticación.
  4. Si vas a usar avisos, un destino dado de alta en Integraciones > API > Avisos.
Todos los ejemplos de esta documentación usan dos variables de entorno, para que la clave nunca quede escrita en el código:

Qué pasa con un pedido de prueba

No pagues desde payment.pay_url un pedido de prueba. Pagarlo lo convierte en un pedido real: se produce, se envía a la dirección que mandaste y se te cobra.

Cancelá cada pedido de prueba

  • Cancelalo cuando termines con POST /orders/{id}/cancel. Responde 200 con status: "cancelled" y cancel_reason: "cancelled_by_seller", y sus unidades vuelven a estar disponibles en el momento.
  • Si te olvidás, vence solo a las 72 horas de creado, con cancel_reason: "unpaid_expired". Mientras tanto retiene stock, y tus próximas pruebas pueden responder 409 out_of_stock aunque la variante diga available: true.
  • Cuentan para el tope de pedidos sin pagar. Podés tener hasta 20 pedidos por API sin pagar a la vez, y hasta 50 unidades entre todos. Pasado eso, el siguiente responde 409 too_many_unpaid_orders hasta que canceles o pagues alguno. Ver Límites.
  • Usá un prefijo de external_id que se distinga a simple vista, por ejemplo prueba-k7p2-0001, así los reconocés en tu panel.
No hay una forma garantizada de provocar un out_of_stock. Tu código tiene que manejarlo igual: probalo, por ejemplo, con un doble de la API en tus tests.

Probar product_archived

No se puede archivar un producto por la API. Para probar el rechazo:
  1. En tu panel, diseñá un producto de prueba y archivalo.
  2. Mandá un pedido con su product_id. Responde 409 product_archived. Ese chequeo va antes que el de la cotización, así que sirve cualquier quote_id.
Desde ese momento ese producto ya no sale en GET /products, GET /products/{id} responde 404 y cotizarlo también responde 404 not_found.

Probar los avisos

  • “Mandar prueba”, en Integraciones > API > Avisos, te envía un aviso webhook.test firmado con el secreto de tu destino. Ver el aviso de prueba.
  • Crear un pedido manda order.created, y cancelarlo manda order.cancelled. Los dos salen igual que con un pedido real.
  • La firma y cada type de aviso los podés probar sin red, firmando vos los avisos: ver Probar tu destino sin publicarlo.
  • Si tu servidor corre en tu máquina, necesitás cualquier túnel https con un nombre de host público: Gudink no puede mandar avisos a localhost, a una IP ni a un puerto que no sea 443. Cuando termines, borrá ese destino.

Ver los estados que vienen después del pago

Pagado, en producción, despachado y entregado sólo se ven con un pedido pagado. Para verlos de verdad, pagá un pedido real: por ejemplo, una muestra para vos, con tu dirección como destino. Así recibís order.paid, order.in_production, order.shipped (con el número de seguimiento real) y order.delivered, y de paso ves el producto terminado. Hasta ese momento, probá esos avisos firmándolos vos con el vector de prueba: tu código no distingue un aviso firmado por vos de uno de Gudink.

Recorrido de prueba de punta a punta

Corré estos pasos, en orden. Si salen bien, tu integración está lista para vender. Si tu tienda ofrece retiro en sucursal, hacé también un pedido con la opción pickup: va con pickup_point_id y sin shipping_address (ver Retiro en sucursal). Cancelalo igual al terminar. Los pasos 5 a 7, con curl:

Antes de empezar a vender

  1. Cancelá los pedidos de prueba que hayan quedado sin pagar: ocupan lugar en el tope de 20 y retienen stock.
  2. Borrá el destino de avisos del túnel, si usaste uno, y dejá dado de alta el de tu servidor.
  3. Si hiciste las pruebas con una clave que ya no vas a usar, revocala.
  4. Repasá el checklist antes de pasar a producción.