API de sincronización

La API de sincronización permite actualizar precios y stock de tus productos en Amigable.do directamente desde tu sistema de inventario, ERP o tienda personalizada.

Generar tu API Key

1. Ve a tu Dashboard de Vendedor → tab “Integraciones”.
2. En la sección “API Key”, haz clic en “Generar clave”.
3. La clave se muestra una sola vez — cópiala y guárdala en un lugar seguro.

Precaución

Amigable.do no almacena tu API Key en texto plano. Si la pierdes, deberás generar una nueva (la anterior queda inválida automáticamente).

Endpoint

POST https://hicqxbewdplykbykakus.supabase.co/functions/v1/vendor-sync
Authorization: Bearer amig_sk_tukey
Content-Type: application/json

Modos de uso

Modo sync — actualizar precio y stock

Usa este modo cuando el producto ya existe en Amigable.do y solo quieres actualizar precio o stock por SKU.

{
  "mode": "sync",
  "products": [
    { "sku": "ABC123", "precio": 1500, "stock": 10 },
    { "sku": "DEF456", "precio": 800, "stock": 0 }
  ]
}

Modo upsert — crear o actualizar

Usa este modo para crear productos nuevos o actualizar productos existentes. Si el SKU no existe, se crea el producto.

{
  "mode": "upsert",
  "products": [
    {
      "sku": "ABC123",
      "titulo": "Camisa de algodón talla M",
      "precio": 1500,
      "stock": 10
    }
  ]
}

Respuesta

{
  "ok": true,
  "updated": 2,
  "created": 1,
  "skipped": 0
}

Campo	Descripción
updated	Productos actualizados correctamente
created	Productos creados (solo en modo upsert)
skipped	Productos ignorados (SKU no encontrado en modo sync)

Integración con Make o Zapier

Si usas Shopify o cualquier otra plataforma y quieres automatizar las actualizaciones:

1. En Shopify: crea un webhook para el evento products/update.
2. En Make o Zapier: conecta ese webhook con un HTTP POST a tu endpoint de Amigable.do.
3. Mapea los campos sku, precio y stock desde los datos del webhook de Shopify.

Solución de problemas

Error 401 — Unauthorized

Verifica que el header de autorización sea exactamente Authorization: Bearer amig_sk_tukey con tu clave real. No incluyas comillas ni espacios extra.

Todos los productos están en ‘skipped’

En modo sync, el SKU debe coincidir exactamente con el que tiene el producto en Amigable.do. Verifica los SKUs desde tu dashboard.

Error 429 — Too Many Requests

La API tiene un límite de velocidad entre requests. Agrega un delay de al menos 3 segundos entre lotes de productos.