Skip to main content
Finds SAP purchase orders whose Header Text (PurchaseOrderText) equals a given value — used in some freight/broker flows as a B/L or load-ticket reference. Display name “SAP Search Purchase Orders by Header Text”. Off by default. Returns the same full PO detail as read_sap_purchase_order (line items, supplier, pricing, delivery, references). Multiple matches are sorted by PO number descending so the newest is first.

​
Authentication and enablement

Requires a workspace SAP integration. base_url and authorization are injected. Enable the tool and bind the integration.

​
Inputs

  • header_text (required): exact Header Text value.
  • max_results (optional): 0 uses the server default.

​
Output

{header_text, total_found, orders[], completed_at}.

​
Limits and side effects

  • Read-only against SAP.
  • Match is on Header Text, not PO number.

​
Expected errors

  • Missing SAP credentials.
  • Empty header_text.
  • SAP API error.