VitePOS Bridge icon

VitePOS Bridge

Use VitePOS automation bridge and analytics APIs

Purchase → Get Purchase

AI-generated

Summary

Fetches a single purchase order from a VitePOS Bridge WordPress site by its ID, using a GET request to /wp-json/vtab/v1/purchases/{id}.

Inputs

  • Purchase ID (required) — ID of the purchase order to retrieve. It is inserted into the request path as-is. No other parameters (filters, query options, body) are sent for this operation.

Output shape

One JSON item per input item. It holds the bridge API's response fields (typically the purchase record, including line items when the API returns them), plus a leading response string summarizing the result, e.g. "Purchase 123 loaded with 4 items."

The summary also reminds you to use each item's quantity/ordered_quantity for PO line quantities, because batch received_qty is batch stock, not the purchased quantity. If the API response already has a response key, the original payload is nested under raw instead. If the API returns status/success false, response carries its message. With Continue On Fail enabled, a failed item returns {error: message} instead of stopping the workflow. Requires the VitePOS Bridge API credential (site URL).

Examples

Example 1: Look up a purchase order by ID to check its line items and quantities.

Resource: Purchase; Operation: Get Purchase; Purchase ID: 123

Example 2: Load purchase details for each ID coming from a previous node.

Resource: Purchase; Operation: Get Purchase; Purchase ID: {{ $json.purchase_id }} (expression, runs once per input item)

Links

Discussion