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 billable items.

To implement this integration:

1. Perform an initial data load by calling Query Billable Items 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 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.

3. Query BillableItems by tag to display them in the appropriate category sections using Query Billable Items 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 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 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 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.