Catalog API

curl "https://api.scoperly.com/connect/v1/supplier/catalog/products" \
  -H "Authorization: Bearer $TOKEN"

# Response:
# {
#   "items": [
#     {
#       "externalId": "SKU-001",
#       "name": "Organic Green Tea 500g",
#       "categoryName": "Food, Beverages & Tobacco",
#       "unitOfMeasure": "pcs",
#       "minOrderQty": 5,
#       "availableQty": 500,
#       "brandName": "Georgian Highlands",
#       "barcode": "4601234567890",
#       "description": "Premium loose leaf green tea.",
#       "images": "[\"https://storage.googleapis.com/.../products/1/42/ab12...cd.jpg\"]",
#       "status": "ACTIVE",
#       "createdAt": "2025-01-15T10:30:00Z"
#     }
#   ],
#   "nextCursor": "42",
#   "hasMore": true
# }
# Note: "images" is a JSON-encoded string containing an array of image URLs —
# parse it before use. No prices in catalog responses (see the pricing note above).

curl -X POST https://api.scoperly.com/connect/v1/supplier/catalog/products \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "externalId": "SKU-001",
    "name": "Organic Green Tea 500g",
    "description": "Premium loose leaf green tea from Georgian highlands.",
    "categorySlug": "food-dairy",
    "unitOfMeasure": "pcs",
    "availableQty": 500,
    "minOrderQty": 5,
    "leadTimeDays": 1,
    "brand": "Georgian Highlands",
    "barcode": "4601234567890",
    "attributes": { "shelfLifeDays": 365, "origin": "GE" },
    "isActive": true
  }'

# Response: 200 OK
# (same shape as list item, sanitized — no internal tenant / storefront / category IDs)

curl "https://api.scoperly.com/connect/v1/supplier/catalog/products/search?q=green+tea&status=ACTIVE&limit=10" \
  -H "Authorization: Bearer $TOKEN"

curl -X PUT https://api.scoperly.com/connect/v1/supplier/catalog/products/SKU-001/stock \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ "availableQty": 250 }'

# Response: 200 OK
# (sanitized ProductResponse with the updated availableQty)

[
  { "externalId": "SKU-001", "name": "Green Tea 500g", "availableQty": 500 },
  { "externalId": "SKU-002", "name": "Black Tea 500g", "availableQty": 120 }
]

{
  "succeeded": 2,
  "failed": 0,
  "results": [
    { "externalId": "SKU-001", "status": "ACTIVE" },
    { "externalId": "SKU-002", "status": "ACTIVE" }
  ],
  "errors": []
}

{
  "items": [
    { "externalId": "SKU-001", "availableQty": 250 },
    { "externalId": "SKU-002", "availableQty": 100 }
  ]
}

{
  "succeeded": 1,
  "errors": [
    {
      "externalId": "SKU-002",
      "status": "failed",
      "errorCode": "NOT_FOUND",
      "error": "Product not found: SKU-002"
    }
  ]
}

{
  "mediaId": "products/.../<sha256>-<uuid>.jpg",
  "uploadUrl": "https://storage.googleapis.com/...",
  "expiresAt": "2025-01-15T10:45:00Z"
}

{
  "externalId": "SKU-001",
  "images": ["https://storage.googleapis.com/.../products/1/42/ab12...cd.jpg"]
}

# 1. Presign
SHA=$(sha256sum photo.jpg | cut -d' ' -f1)
SIZE=$(stat -c%s photo.jpg)
curl -X POST https://api.scoperly.com/connect/v1/supplier/catalog/products/SKU-001/images/presign \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "{ \"contentType\": \"image/jpeg\", \"sha256\": \"$SHA\", \"byteSize\": $SIZE }"
# → { "mediaId": "...", "uploadUrl": "https://storage...", "expiresAt": "..." }

# 2. Upload the bytes (NO Authorization header)
curl -X PUT "$UPLOAD_URL" \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg

# 3. Commit
curl -X POST https://api.scoperly.com/connect/v1/supplier/catalog/products/SKU-001/images/commit \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d "{ \"mediaId\": \"$MEDIA_ID\", \"sha256\": \"$SHA\" }"
# → { "externalId": "SKU-001", "images": ["https://storage..."] }

# 1. Start session
curl -X POST https://api.scoperly.com/connect/v1/supplier/catalog/sync/start \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "integrationType": "SMART_SALE",
        "direction": "INBOUND",
        "totalItems": 1240
      }'
# → 201 Created
# { "sessionId": "5a1e...-...-...-...-...", "status": "RUNNING" }

# 2. Batch upsert products (up to 100 items per call)
curl -X POST https://api.scoperly.com/connect/v1/supplier/catalog/products/batch \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '[ { "externalId": "SKU-1", "name": "...", "availableQty": 100 }, ... ]'

# 3. End session
curl -X POST https://api.scoperly.com/connect/v1/supplier/catalog/sync/5a1e.../end \
  -H "Authorization: Bearer $TOKEN"
# { "sessionId": "5a1e...", "status": "COMPLETED", "processedItems": 1237, "failedItems": 3 }