Items

Returns a paginated list of catalog items as { meta: { count, totalPages, page, limit, sortBy }, data: [...] }. salesPrice is in dollars.

Create a new product/service item in the catalog.

salesPrice: price in dollars; must not be 0; negative allowed only without taxes (discount lines).

categories: effectively required (send [] when none). Entries are { id: string | null, name }; id: null creates a new category.

type: any non-empty string (e.g. product, service).

Returns a bare JSON array of item id strings (no data envelope, no pagination). It carries no names or prices, so it is not suitable for dropdowns on its own; fetch GET /public/item/{id} for details.

Returns all item categories as a bare JSON array (no data envelope). Each entry includes clientId.

Retrieve a single item by ID.

Soft-deletes a catalog item (deletedAt is set). Note: salesPrice in this response is an integer amount in cents (1000 = $10.00), unlike the other item routes.

Partial update of a catalog item. categories and taxes must be present in the body (send [] to keep none). salesPrice is in dollars. The response currently reflects the item before the update; re-fetch GET /public/item/{id} for the stored state.

Delete multiple catalog items by id list. itemList holds item ids (at least one). Atomicity is undefined: on error some items may already be deleted — refresh the list afterwards.

Create a copy of an existing item. Returns { data: <item> }; salesPrice is an integer amount in cents (not converted).

Duplicate multiple items at once. itemList holds item ids (at least one). Atomicity is undefined: on error some items may already be duplicated — refresh the list afterwards. Returns only { success }; re-list items to see the copies.