Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Overview

This node operation "Open A Purchase Order" under the "Purchase Orders" resource is designed to retrieve or activate a specific purchase order by its identifier within an account. It is useful in scenarios where you need to programmatically access details of a purchase order that has been created but not yet opened or processed, such as for review, approval, or further processing in an automated workflow.

Practical examples include:

  • Automatically opening a purchase order when certain conditions are met in your procurement process.
  • Integrating with accounting or inventory systems to fetch and update purchase order statuses.
  • Triggering notifications or follow-up actions once a purchase order is opened.

Properties

Name Meaning
Account Id Identifier of the account to which the purchase order belongs. This is required to specify the context of the purchase order.
Purchase Order Id Identifier of the specific purchase order to open. This uniquely identifies the purchase order within the given account.

Output

The node outputs JSON data representing the opened purchase order's details. This typically includes all relevant information about the purchase order such as status, items, amounts, dates, and any metadata returned by the API. The exact structure depends on the external service's response schema for a purchase order.

No binary data output is indicated.

Dependencies

  • Requires an API key credential or similar authentication token configured in n8n to authorize requests to the external service managing purchase orders.
  • The node uses a base URL from credentials to connect to the external API.
  • The bundled code references an OpenAPI-based client library for interacting with the API, so the external service must support this API specification.

Troubleshooting

  • Missing or invalid Account Id or Purchase Order Id: Ensure these required fields are correctly set; otherwise, the API call will fail.
  • Authentication errors: Verify that the API key or authentication token is valid and has sufficient permissions.
  • Network or connectivity issues: Confirm that the base URL is reachable from the n8n environment.
  • Unexpected API responses: Check if the purchase order exists and is accessible with the provided identifiers.

Common error messages might include authorization failures, resource not found, or validation errors related to input parameters.

Links and References

  • Refer to the external service’s official API documentation for detailed information on purchase order operations.
  • Consult n8n documentation on how to configure API credentials and use custom nodes with OpenAPI specifications.

Discussion