Actions32
- Analytics Actions
- Batch Actions
- Customer Actions
- Order Actions
- Product Actions
- Purchase Actions
- Raw Request Actions
- System Actions
- Vendor Actions
- WhatsApp Actions
Purchase → List Purchases
AI-generatedSummary
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
responsekey, the original body is placed underraw. 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