-
Notifications
You must be signed in to change notification settings - Fork 156
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
chore: add public stock cap use-case #1269
base: main
Are you sure you want to change the base?
Conversation
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
Co-authored-by: Iga Karbowiak <40886528+IKarbowiak@users.noreply.github.com>
We can define warehouse as public or private. Public warehouse allows you to query the stock information publicly in the API. Private warehouse requires permission. | ||
#### Public vs. private warehouses | ||
|
||
We can define warehouse as public or private. Public warehouse allows you to query the stock information publicly in the API. Private warehouse requires permission. The [`quantityAvailable`](api-reference/products/objects/product-variant.mdx#productvariantquantityavailableint--) field on `ProductVariant` type is the sum of the available quantity in all public and private warehouses. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Permissions part is a bit unclear for me:
- when my client has permissions, does it impact variant.quantityAvailable?
- or did you mean variant.stocks field?
|
||
We can define warehouse as public or private. Public warehouse allows you to query the stock information publicly in the API. Private warehouse requires permission. The [`quantityAvailable`](api-reference/products/objects/product-variant.mdx#productvariantquantityavailableint--) field on `ProductVariant` type is the sum of the available quantity in all public and private warehouses. | ||
|
||
Storefronts can display product availability at specific locations with public stock. To protect business-sensitive details, you can cap public stock at the maximum orderable quantity per checkout: [`quantityLimitPerCustomer`](api-reference/products/inputs/product-variant-input.mdx#productvariantinputquantitylimitpercustomerint--). Therefore, if a warehouse holds 999 pieces and the max orderable quantity is 50, the API will return 50 as the available stock. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Theres the link for product input, but this setting can be changed globally in SiteSettings (and adjusted in linked variant input).
@peelar I just added link guide to readme https://github.com/saleor/saleor-docs/pull/1276/files |
I know Warehouses could be probably use their separate page in the docs, but I wanted to at least capture that information for now