Actions88
- Purchase Credit Note Actions
- Purchase Invoice Actions
- Purchase Delivery Note Actions
- Purchase Down Payment Actions
- Purchase Order Actions
- Purchase Quotation Actions
- Purchase Request Actions
- Purchase Return Actions
- Purchase Tax Invoice Actions
Overview
This node integrates with the SAP Service Layer to manage various purchase-related documents in SAP Business One. Specifically, for the Purchase Delivery Note resource and the Cancel operation, it allows users to cancel an existing purchase delivery note by its unique identifier (DocEntry). This is useful in scenarios where a previously created delivery note needs to be invalidated or reversed due to errors, changes in order fulfillment, or other business reasons.
Practical examples include:
- Automatically cancelling a purchase delivery note when a supplier shipment is returned.
- Integrating cancellation workflows into larger automation processes that handle purchase document lifecycle management.
- Ensuring data consistency by programmatically cancelling delivery notes that were created in error.
Properties
| Name | Meaning |
|---|---|
| DocEntry | The unique numeric identifier of the Purchase Delivery Note to cancel (required). |
Output
The node outputs a JSON object representing the response from the SAP Service Layer API after attempting to cancel the specified purchase delivery note. This typically includes confirmation of the cancellation or details about the updated document status.
If an error occurs during the cancellation request, the output JSON will contain an error field with the error message.
No binary data output is produced by this operation.
Dependencies
- Requires connection to an SAP Business One Service Layer instance.
- Needs credentials including base URL, username, password, and company database name to authenticate against the SAP Service Layer.
- The node performs a login request to obtain session cookies used for subsequent API calls.
- The SAP Service Layer API must support the POST
/PurchaseDeliveryNotes({DocEntry})/Cancelendpoint.
Troubleshooting
- Authentication failures: If login credentials are incorrect or the SAP Service Layer is unreachable, the node will fail at the login step. Verify credentials and network connectivity.
- Invalid DocEntry: Providing a non-existent or incorrect
DocEntrywill result in an error from the SAP API indicating the document was not found. - Permission issues: The user account used for authentication must have sufficient permissions to cancel purchase delivery notes.
- API endpoint errors: If the SAP Service Layer version does not support the cancel operation on purchase delivery notes, the request will fail.
- SSL certificate issues: The node disables strict SSL verification (
rejectUnauthorized: false), but if your environment requires strict SSL, adjust accordingly.
Error messages returned by the node will be included in the output JSON under the error key, providing clues for resolution.
Links and References
- SAP Business One Service Layer Documentation
- SAP Service Layer API Reference - Purchase Delivery Notes (example link; verify with your SAP version)