Primeros pasos

1. Consigue una llave

El negocio crea la llave en su panel de papedir (Ajustes → Integraciones) y te la entrega. Se muestra una sola vez: guárdala como secreto, nunca en el código ni en el navegador.

export BASE=https://api.pedidos.transformit.com.co/api/v1/external
export LLAVE=pdk_live_ab12cd34_…

2. Verifícala

curl -s -X POST "$BASE/ping" -H "Authorization: Bearer $LLAVE"

{"ok":true,"tenant_id":"…","key_prefix":"pdk_live_ab12cd34","scopes":["stock:write","catalog:read","orders:read"],
 "integration":{"direction":"inbound","enabled":true}}

3. Lee el catálogo

curl -s "$BASE/catalog?limit=100" -H "Authorization: Bearer $LLAVE"

Cada producto trae sku y tracked (si papedir lleva su inventario). Sigue con cursor=<next_cursor> hasta que next_cursor sea null.

4. Cruza tus productos

Asigna a cada producto de papedir el id que tiene en tu sistema, buscándolo por SKU:

curl -s -X PATCH "$BASE/catalog/mapping" -H "Authorization: Bearer $LLAVE" \
  -H 'Content-Type: application/json' \
  -d '{"items":[{"sku":"PAN-01","external_id":"b3f1c2d4-0000-4000-8000-000000000001"}]}'

5. Envía la existencia

curl -s -X PUT "$BASE/stock" -H "Authorization: Bearer $LLAVE" \
  -H "Idempotency-Key: lote-$(date +%s)" -H 'Content-Type: application/json' \
  -d '{"items":[{"external_id":"b3f1c2d4-0000-4000-8000-000000000001","stock":12,"version":1}]}'

Cada ítem vuelve con su status (applied, stale, not_found…). Listo: la tienda del negocio ya muestra tu existencia.

Siguiente

• Recibe los pedidos: webhooks.
• Todo el flujo, reservas incluidas: guía de inventario externo.
• ¿Algo falló? Mira errores: cada respuesta trae request_id.