Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Overview

This node operation deletes a specific item from a purchase order within an account. It is useful in scenarios where you need to remove an erroneous or no longer needed item from an existing purchase order, helping maintain accurate and up-to-date order records.

Practical examples include:

  • Removing a mistakenly added product from a purchase order before finalizing it.
  • Correcting purchase orders by deleting items that are out of stock or discontinued.
  • Automating cleanup of purchase orders by removing items based on certain conditions.

Properties

Name Meaning
Account Id Identifier of the account containing the purchase order.
Purchase Order Id Identifier of the purchase order from which an item will be deleted.
Purchase Order Item Id Identifier of the specific purchase order item to delete.

Output

The node outputs JSON data representing the result of the deletion operation. This typically includes confirmation of the deletion or details about the updated purchase order state after the item removal.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the external service managing purchase orders.
  • The node uses a base URL configured via credentials to connect to the purchase order management API.
  • The operation depends on the external service's REST API supporting deletion of purchase order items by their identifiers.

Troubleshooting

  • Common issues:

    • Invalid or missing identifiers (Account Id, Purchase Order Id, Purchase Order Item Id) will cause the operation to fail.
    • Authentication errors if the API key or credentials are not properly set.
    • Network or connectivity issues with the external API endpoint.
  • Error messages and resolutions:

    • "Unauthorized" or "Authentication failed": Verify that the API key credential is correctly configured and has necessary permissions.
    • "Purchase order item not found": Check that the provided Purchase Order Item Id exists within the specified Purchase Order Id.
    • "Invalid account or purchase order ID": Confirm that the Account Id and Purchase Order Id are correct and correspond to existing resources.
    • Timeout or network errors: Ensure stable internet connection and that the external API endpoint is reachable.

Links and References

  • Refer to the external purchase order management API documentation for detailed information on deleting purchase order items.
  • n8n documentation on creating and using API key credentials for authentication.

Discussion