Inicio rápido

Comprueba tu clave

curl https://api.nembol.com/rest/v1/store \
  -H "Authorization: Bearer $NEMBOL_API_KEY"

La respuesta te indica la tienda, su currency base (todos los precios de los productos están en esta moneda) y los scopes de tu clave.

Consulta tus cuentas de canal conectadas

curl https://api.nembol.com/rest/v1/channel_accounts \
  -H "Authorization: Bearer $NEMBOL_API_KEY"

{
  "data": [
    {
      "id": "chac_66a1f09b2",
      "object": "channel_account",
      "channel": "shopify",
      "label": "Shopify",
      "shop_name": "acme-vintage",
      "status": "connected"
    }
  ]
}

Guarda el id. Identifica exactamente esta cuenta, aunque tengas varias cuentas en el mismo canal.

Crea un producto

curl -X POST https://api.nembol.com/rest/v1/products \
  -H "Authorization: Bearer $NEMBOL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-001" \
  -d '{
    "title": "Vintage denim jacket",
    "description": "Classic 90s denim jacket, size M.",
    "price": "49.90",
    "quantity": 3,
    "sku": "VDJ-M-001",
    "images": [{ "url": "https://example.com/jacket.jpg" }]
  }'

Recibes 201 con el producto completo al instante, porque la escritura local es síncrona. Ya existe en Nembol, pero todavía no está en ningún canal.

Publícalo en un canal

Un anuncio (listing) es un producto en una cuenta de canal. Crea uno:

curl -X POST https://api.nembol.com/rest/v1/listings \
  -H "Authorization: Bearer $NEMBOL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-002" \
  -d '{
    "product_id": "prod_64a91c3f2",
    "channel_account_id": "chac_66a1f09b2"
  }'

La respuesta es 202. La publicación pasa por los workers de canal de Nembol:

{
  "id": "list_9ac2e",
  "object": "listing",
  "product_id": "prod_64a91c3f2",
  "channel_account_id": "chac_66a1f09b2",
  "channel": "shopify",
  "status": "ongoing"
}

Si envías de nuevo el mismo par (product_id, channel_account_id), recibes este mismo anuncio, sin duplicados.

Míralo publicarse

Consulta el anuncio periódicamente (o, mejor, suscríbete al webhook listing.status_changed):

curl https://api.nembol.com/rest/v1/listings/list_9ac2e \
  -H "Authorization: Bearer $NEMBOL_API_KEY"

{
  "id": "list_9ac2e",
  "status": "listed",
  "id_on_channel": "8571…",
  "url_on_channel": "https://acme-vintage.myshopify.com/products/vintage-denim-jacket"
}

status pasa de ongoing a listed. Si el canal lo rechaza, obtienes status: "error" con el motivo en issues[]. Listo. Tu producto está publicado.