> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Sample Flows

## Article: Sample Flows

## Article Link: https://dev.wix.com/docs/api-reference/business-management/get-paid/billable-items/sample-flows.md

## Article Content:

# Sample Use Cases and Flows

This article shares some possible use cases you can support,
as well as a sample flow that could support each use case.
This can be a helpful jumping off point as you plan your implementation.

## Export billable items to an external accounting system or inventory management system

Keep an external accounting system synchronized with Wix saved items.

To implement this integration:

1. Perform an initial data load by calling [Query Billable Items](https://dev.wix.com/docs/rest/business-management/get-paid/billable-items/query-billable-items.md) with pagination to retrieve all existing items.

2. Map and upload the billable items to the external system:
   - `name` → Product/Service name
   - `description` → Product/Service description
   - `price` → Base price
   - `taxGroupId` → Tax category (if supported)

3. Store the current timestamp for future synchronization.

4. Set up a scheduled job to periodically check for new or updated items by calling [Query Billable Items](https://dev.wix.com/docs/rest/business-management/get-paid/billable-items/query-billable-items.md) with a filter for items created or updated since the last sync.

5. Allow site administrators to configure the synchronization frequency through your app settings.

## Create a custom pricing page with categorized services

Create a structured pricing page that organizes services into categories using tags.

To implement this feature:

1. Create tags for your service categories using the Tags API (For example, "consulting", "training", or "support").

2. Create billable items for each service with appropriate category tags by calling [Create Billable Item](https://dev.wix.com/docs/rest/business-management/get-paid/billable-items/create-billable-item.md).

3. Query BillableItems by tag to display them in the appropriate category sections using [Query Billable Items](https://dev.wix.com/docs/rest/business-management/get-paid/billable-items/query-billable-items.md) with a filter for specific tags.

4. Display the items on your custom pricing page, organized by category and sorted by price.

5. When prices change, call [Update Billable Item](https://dev.wix.com/docs/rest/business-management/get-paid/billable-items/update-billable-item.md) to update the pricing information.

## Bulk update pricing with seasonal discounts

Apply seasonal discounts to multiple services at once using bulk update functionality.

To implement this feature:

1. Query all billable items that should receive the discount by calling [Query Billable Items](https://dev.wix.com/docs/rest/business-management/get-paid/billable-items/query-billable-items.md) with a filter for items tagged as "seasonal-eligible".

2. Calculate the discounted price for each item (e.g., 20% off).

3. Call [Bulk Update Billable Items](https://dev.wix.com/docs/rest/business-management/get-paid/billable-items/bulk-update-billable-items.md) to update all prices at once, including the item ID, current revision, and new price for each item.

4. Handle potential errors in the response by checking the `bulkActionMetadata` for success and failure counts, and implement appropriate error handling for specific error codes.

5. When the seasonal discount ends, repeat the process to restore original prices.