VitePOS Bridge icon

VitePOS Bridge

Use VitePOS automation bridge and analytics APIs

Purchase → List Purchases

AI-generated

Summary

Lists purchase orders from a VitePOS Bridge WordPress site via GET /wp-json/vtab/v1/purchases, with optional filters, sorting, and pagination.

Inputs

  • Purchase Filters — Collection of optional filters, each sent as a query parameter only if filled. Includes Date From/Date To (sent as YYYY-MM-DD, time dropped), Vendor ID, Warehouse/Outlet ID, Payment Status (Paid P, Unpaid U, Due D, Partial PP), Status (Active A, Draft D, Inactive I), Search, Product ID, Variation ID, Product SKU, and Product Search (matches purchase line product names).
  • Include Items — Part of Purchase Filters. Boolean sent as 1/0 to include purchase line items in each row.
  • Order / Order By — Part of Purchase Filters. Sort direction (asc/desc, default desc) and field (purchase_date, grand_total, id, vendor_id, warehouse_id; default purchase_date).
  • Page / Per Page — Part of Purchase Filters. Pagination, with defaults 1 and 50 shown in the UI. They are only sent if added to the collection.

Output shape

One output item per input item. It holds the bridge's JSON response (typically with rowdata and a records count) plus a response field with a short readable summary, e.g. "Purchase list returned N rows out of M."

When product filters match line items, the summary mentions up to 3 purchase orders with matched quantity. If the API response already has a response key, the original body is placed under raw. With Continue On Fail, errors return {error: message}. Pagination is manual via Page/Per Page.

Examples

Example 1: Get unpaid purchase orders from one vendor in the last month, with line items

Purchase Filters: Vendor ID=12, Payment Status=Unpaid, Date From=2026-09-01, Date To=2026-09-30, Include Items=true

Example 2: Find purchase orders containing a specific product by name

Purchase Filters: Product Search="Maxi 20kg", Include Items=true, Order By=Purchase Date, Order=Descending

Example 3: Page through the largest purchases

Purchase Filters: Order By=Grand Total, Order=Descending, Per Page=100, Page=1

Links

Discussion