Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Purchase Orders → Get A List Of Goods Received Notes For A Specific Purchase Order

AI-generated

Overview

This node operation retrieves a list of Goods Received Notes (GRNs) associated with a specific Purchase Order within an account. It is useful in scenarios where users need to track the receipt of goods against purchase orders, verify deliveries, or reconcile inventory and accounting records. For example, a procurement manager might use this node to fetch all GRNs for a given purchase order to confirm which items have been received and their quantities.

Properties

Name Meaning
Account Id Identifier of the account from which to retrieve the purchase order's goods received notes.
Purchase Order Id Identifier of the specific purchase order for which to list the goods received notes.

Output

The output will contain a JSON array of goods received notes related to the specified purchase order. Each item in the array typically includes details such as the GRN identifier, date of receipt, quantities received, and possibly other metadata relevant to the goods receipt process.

If the node supports binary data output (not explicitly shown in the provided code), it would represent attachments or documents related to the goods received notes, but no such indication is present here.

Dependencies

  • Requires an API key credential or similar authentication token configured in n8n to access the external service.
  • The node interacts with an external API endpoint defined by the base URL set in credentials.
  • The bundled source references an OpenAPI-based client library for making requests, so proper configuration of the API endpoint and credentials is necessary.

Troubleshooting

  • Missing or invalid Account Id or Purchase Order Id: Ensure these required fields are correctly filled; otherwise, the API call will fail or return no data.
  • Authentication errors: Verify that the API key or authentication token is valid and has sufficient permissions to access purchase order data.
  • Network or API errors: Check connectivity and API availability. If the external service is down or unreachable, the node will not return results.
  • Empty results: Confirm that the purchase order exists and has associated goods received notes; otherwise, the output will be empty.

Links and References

  • Refer to the external API documentation for detailed information on Goods Received Notes and Purchase Orders endpoints.
  • n8n documentation on how to configure API credentials and use HTTP request nodes may help in setting up this node properly.

Discussion