Developer docs

Changelog

Changes to the SnowBee Public API and developer documentation.

  • SKU inventory lookup now accepts either a SnowBee SKU ID or the SKU number in GET /skus/{skuId}/inventory. Resolution remains limited to the authenticated e-commerce store assortment and still returns 404 when the identifier is not available there.
  • B2C customer lookup by email is available at GET /customers/by_email/{email}. The email path segment should be URL-encoded; matching is case-insensitive and a missing customer returns 404.

  • GET /campaigns now includes THREE_FOR_TWO campaigns. These campaigns resolve SKUs from campaign scope and store assortment, and report each SKU's normal price as campaignPrice because the offer is basket-level rather than a per-SKU markdown.
  • E-commerce stores now receive CampaignUpdated events for 3-for-2 campaign membership changes, including when assortment changes make a SKU enter or leave a scoped campaign.

  • OpenAPI examples for e-commerce order line return tickets now show the actual returnTicketNumber format and the barcode URL segment as base64url of the scannable value.

  • Public e-commerce monetary response values are rounded to two decimals using HALF_UP while preserving internal precision. OpenAPI now documents the monetary string format.
  • Public e-commerce percentage response values, including VAT rates and discounts, are rounded consistently in output.