About the Billable Items API

The billable items feature allows Wix users to manage custom billable products and services that can be added to invoices that are sent to customers for payment.

The Billable Items API enables you to create, update, and organize billable items to streamline a site's billing process and integrate with Wix's business management platform.

This functionality enables you to quickly add custom items to invoices and send them out for payment, without the need to install any apps made by Wix.

With the Billable Items API, you can:

• Create and manage billable items for products or services with detailed information.
• Organize items with tags for better categorization and filtering.
• Set pricing and tax information for accurate billing using tax groups.
• Add images to visually represent items using the Wix Media Manager.
• Query and filter items based on various criteria including price, name, and tags.
• Perform bulk operations to efficiently update multiple items at once.
• Receive real-time notifications when items are created, updated, or deleted, by listening for events.

About billable items

A billable item represents a billable product or service that can be added to an invoice. Billable items include details like:

• Name and description.
• Price information.
• Tax group associations.
• Visual representation (images).
• Custom metadata through extended fields.
• Organizational tags.

Before you begin

• Tax group IDs reference the Wix eCommerce tax groups and must be valid existing tax groups.
• Image uploads must be handled through the Wix Media Manager before referencing them in billable items.

Use cases

• Export billable items to an external accounting system or inventory management system
• Create a custom pricing page with categorized services
• Bulk update pricing with seasonal discounts

Terminology

• Billable item: A billable product or service that can be added to invoices, containing details like name, description, price, and tax information.
• Tax group: A reference to tax rules that determine how taxes are categorized. See the Tax Groups API for more information.