Inventory Events

Inventory Events are the mechanism through which stock levels are updated in Carriyo. Instead of directly setting inventory quantities, you submit events that describe changes to your inventory.

Event Types

Inventory events support different operations:

• SET : Sets the absolute quantity values (on_hand, unavailable)
• ADJUST : Adjusts quantities by adding or subtracting from current values

Bulk Import

The Inventory Events API supports bulk import, allowing you to submit multiple inventory events in a single request. This is useful for:

• Syncing inventory from your ERP or WMS systems
• Processing inventory adjustments in batch
• Initial inventory setup

Each bulk import request generates a unique request_id that can be used to track the status of all events in the batch.

Event Tracking

You can retrieve the status and results of inventory events using either:

• Request ID : Get all events from a specific bulk import
• Product ID : Get all events for a specific product

This allows you to verify that inventory updates were processed correctly and troubleshoot any failures.