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 Return resource and the Cancel operation, it allows users to cancel an existing purchase return document by its unique identifier (DocEntry). This is useful in scenarios where a purchase return was created erroneously or needs to be invalidated.
Practical examples include:
- Automatically cancelling a purchase return when a related business process is reversed.
- Integrating cancellation workflows into larger automation pipelines that handle purchase returns.
- Managing purchase returns programmatically without manual intervention in SAP Business One.
Properties
| Name | Meaning |
|---|---|
| DocEntry | The unique numeric identifier of the purchase return document to cancel (required). |
Output
The node outputs JSON data representing the response from the SAP Service Layer API after attempting to cancel the specified purchase return. The structure typically includes details about the cancelled document or error information if the cancellation failed.
Example output JSON structure:
{
"DocEntry": 123,
"Message": "Document canceled successfully",
// ... other SAP response fields
}
If an error occurs, the output JSON will contain an error field with the error message.
The node does not output binary data.
Dependencies
- Requires connection to an SAP Business One Service Layer instance.
- Needs credentials including:
- Base URL of the SAP Service Layer API.
- Username and password for authentication.
- Company database name.
- The node performs a login request to obtain session cookies used for subsequent API calls.
- No additional external dependencies beyond the SAP Service Layer API.
Troubleshooting
- Authentication errors: If login fails, verify the SAP Service Layer URL, username, password, and company database are correct.
- Invalid DocEntry: If the provided
DocEntrydoes not exist or is incorrect, the API will return an error. Ensure the document ID is valid. - Permission issues: The user must have sufficient permissions in SAP Business One to cancel purchase returns.
- Network/SSL issues: The node disables SSL verification (
rejectUnauthorized: false) but network connectivity and firewall settings must allow access to the SAP Service Layer. - Error messages: Errors returned by the SAP API are passed through in the output's
errorfield. Review these messages for specific causes.
Links and References
- SAP Business One Service Layer Documentation
- SAP Service Layer API Reference
- OData Query Options (used for
$selectand$filterparameters)