Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Overview

This node operation allows users to create a new purchase order item within a specified purchase order. It is useful in scenarios where you need to programmatically add detailed line items to purchase orders, such as when automating procurement workflows or integrating with accounting systems.

For example, if your company uses an external system to manage purchase orders, this node can be used to add individual items specifying quantities, pricing, and expense categories directly from n8n workflows, streamlining the purchasing process.

Properties

Name Meaning
Account Id Identifier of the account associated with the purchase order item.
Purchase Order Id Identifier of the purchase order to which the item will be added.
Units Unit of measurement for the purchase order item. Options: Pieces, Hours.
Expense Category JSON object describing the expense category of the purchase order item.
Expense Custom Fields JSON array defining custom fields related to the expense for the purchase order item.
Amortization JSON object containing amortization information for the purchase order item.
Description User-friendly description of the purchase order item.
Purchased Quantity Number representing the quantity of the purchase order item.
Unit Price Number representing the price per unit of the purchase order item.

Output

The node outputs a JSON object representing the newly created purchase order item. This typically includes all details sent in the request along with any additional metadata or identifiers assigned by the backend service.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential or similar authentication token configured in n8n to authorize requests.
  • The node interacts with an external API endpoint (base URL configurable via credentials) that manages purchase orders.
  • Proper network connectivity and valid credentials are necessary for successful execution.

Troubleshooting

  • Missing Required Fields: Errors may occur if required properties like Account Id, Purchase Order Id, Description, Purchased Quantity, or Unit Price are not provided. Ensure all mandatory fields are filled.
  • Invalid JSON Format: Properties like Expense Category, Expense Custom Fields, and Amortization expect valid JSON strings. Malformed JSON will cause parsing errors.
  • Authentication Failures: If the API key or authentication token is invalid or missing, the node will fail to connect. Verify credentials configuration.
  • API Endpoint Issues: Network issues or incorrect base URL settings can prevent communication with the external service.
  • Data Validation Errors: Providing unsupported units or invalid numeric values might result in API rejections.

Links and References

  • No direct links available from the source code. For more information, consult the documentation of the external purchase order management API integrated with this node.

Discussion