Before getting into the API-specific part, it is important to understand some concepts in Skubana that will make your development easier. Skubana has a feature called Channel Allocation Rules. These rules control how much available inventory is displayed for each sales channel, whether it's a channel Skubana integrates with natively, or a channel we connect through a 3rd party app.
The rules can get pretty complex. For starters, Skubana allows sellers to display a certain % of available inventory, or an actual hard count (called Max Allocation) for each product and sales channel, which is the green area. Secondly, these rules can change once minimum inventory levels are reached, which is the red area. This is extremely important because reaching low/minimum inventory levels is a danger zone for most sellers, so Skubana acts as an overselling prevention system that reduces the risk of marketplace suspension.
Additionally, these channel allocation rules can exclude inventory from certain warehouses from ever being shown to a specific sales channel, or a product.
These warehouse inclusions/exclusions essentially allow you to Sync inventory with a specific warehouse.
These rules allow Skubana customers to have granular control over their inventory and ensure that they get accurate inventory numbers and never run the risk of overselling on a channel.
Despite the complexity of these rules, the good thing is that you never have to worry about them.
The [POST] /service/v1.1/inventory/acknowledge endpoint takes care of this for you.
Skubana does all the work of extracting the exact currently allocated quantity for each product listing, no matter what rules are set inside Skubana. This is the most accurate stock level there is, which is why it's imperative to use it.
Using this API call is extremely efficient, because it only returns inventory for products whose stock levels have actually changed since the last time you called that endpoint. That means you don't have to unnecessarily cycle and paginate through SKUs that haven't even changed, but rather just get the ones for which the inventory actually needs to be updated on your end.