Suppliers
List Suppliers
Returns a paginated list of suppliers.
Create Supplier
Create a new supplier. Automatically creates a default warehouse for the supplier and attaches default pricing tiers.
Bulk Delete
Delete multiple Shopify products from the local database (does not delete in Shopify).
Get Supplier
Get a single supplier with warehouses loaded.
Update Supplier
Update an existing supplier. All fields are optional. purchase_order_format is only allowed on PUT.
Delete Supplier
Delete a supplier. Returns 400 if the supplier is linked to purchase orders or other records.
Archive Supplier
Archive a single supplier.
Unarchive Supplier
Unarchive a previously archived supplier.
Bulk Archive
Archive multiple Shopify products by their IDs.
Bulk Unarchive
Bulk unarchive multiple stock takes.
List Supplier Products
Retrieve all products linked to a supplier. Supports search by supplier SKU, product SKU, or name (using Typesense with SQL fallback).
Get Supplier Products Stock
Get stock levels for specific products from a supplier's perspective.
Get Supplier Pricing Tiers
Get all pricing tiers attached to a supplier with DataTable support.
Attach Pricing Tier to Supplier
Attach an existing pricing tier to a supplier.
Delete Pricing Tier from Supplier
Delete a pricing tier from a supplier. Cannot delete default or linked pricing tiers.
Get Supplier Warehouses
Get all warehouses associated with a supplier, with DataTable support.
Create Supplier Warehouse
Create a new warehouse for a supplier. Automatically initializes supplier inventory for the new warehouse. If this is the supplier's first warehouse (or is_default is true), it becomes the default warehouse.
Get Warehouse Linked Orders
Get the count of open purchase orders linked to a warehouse. Used before deleting a warehouse to check for dependencies.
Preview Supplier Import
Preview a supplier import from a CSV file.
Import Suppliers
Import suppliers from a CSV file.
Preview Supplier Inventory Import
Preview supplier inventory import from a CSV file.
Import Supplier Inventory
Import inventory levels for a specific supplier from a CSV file.
Check Deletable
Check which nominal codes can be deleted. A code cannot be deleted if it is linked to sales order lines or used in nominal code mapping settings.
Create Supplier Product
Creates a new supplier product relationship (a product sold by a specific supplier).
Get Supplier Product
Returns full details for a supplier product including product, supplier, pricing tiers, and inventory levels per warehouse.
Update Supplier Product
Updates an existing supplier product.
Delete Supplier Product
Deletes a supplier product and its associated inventories.
Get Activity Log
Get FNSKU product mapping activity log for an integration instance.
Get Notes
Returns paginated notes for a supplier product, most recent first.
Add Note
Adds a note to a sales credit.
Delete Note
Deletes a note.
Update Pricing Tiers
Updates pricing tiers for a supplier product.
List Supplier Pricing Tiers
Returns all supplier pricing tiers.
Create Supplier Pricing Tier
Creates a new supplier pricing tier.
Bulk Delete Pricing Tiers
Bulk delete multiple pricing tiers by ID.
Get Supplier Pricing Tier
Returns a single supplier pricing tier by ID.
Update Supplier Pricing Tier
Updates an existing supplier pricing tier.
Delete Supplier Pricing Tier
Deletes a supplier pricing tier. Will fail if:
Archive Pricing Tier
Archive a product pricing tier. Fails if the tier is the default tier or has active dependent tiers.
Unarchive Pricing Tier
Unarchive a product pricing tier.
Bulk Archive Pricing Tiers
Bulk archive multiple pricing tiers. Default tiers and tiers with active dependents are skipped with warnings.
Bulk Unarchive Pricing Tiers
Bulk unarchive multiple pricing tiers.
Check Deletable
Check which nominal codes can be deleted. A code cannot be deleted if it is linked to sales order lines or used in nominal code mapping settings.
Check Archivable
Check which nominal codes can be archived. A code cannot be archived if it is currently used in the nominal code mapping settings.
Set as Default
Sets the specified pricing tier as the system default. Clears the is_default flag from the previously default tier.
Import Pricing Tiers (Preview)
Preview the result of importing supplier pricing tiers from a CSV/Excel file without committing.
Import Pricing Tiers
Import product pricing tiers from a CSV or Excel file.
List Supplier Inventories (DataTable)
Returns a paginated list of supplier inventory records using Spatie QueryBuilder.
List Supplier Inventories (Lookup)
Returns a paginated list of supplier inventories via Spatie QueryBuilder. Same filter/sort support as the DataTable index.
Get Supplier Inventory
Returns a single supplier inventory record with related product and warehouse data.
Update Supplier Inventory
Updates a supplier inventory record. Sets source to 'user'. Provide either quantity OR in_stock (not both).
Export Supplier Inventories
Exports all supplier inventory records for a specific supplier as a CSV or Excel file download. The supplier_id filter is automatically applied.
Archive Supplier Inventory
Archives a single supplier inventory record. Idempotent — returns a warning if already archived.
Unarchive Supplier Inventory
Unarchives a single supplier inventory record.
Bulk Archive Supplier Inventories
Bulk archives multiple supplier inventory records by ID array or current DataTable filters.
Bulk Unarchive Supplier Inventories
Bulk unarchives multiple supplier inventory records by ID array or current DataTable filters.
Check Archivable
Check which nominal codes can be archived. A code cannot be archived if it is currently used in the nominal code mapping settings.
Check Deletable
Check which nominal codes can be deleted. A code cannot be deleted if it is linked to sales order lines or used in nominal code mapping settings.
Download Import Template
Download the CSV import template for COGS bulk import. Headers: layer_id, cogs.
Validate Import
Validate mapped import data and return a preview. No data is created — safe to call repeatedly for client-side validation before executing the actual import.
Execute Import
Execute the product import — creates products from the validated data. Should be called after validate.