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 purchase-related documents in SAP Business One. Specifically, for the Purchase Down Payment resource and the Cancel operation, it allows users to cancel an existing purchase down payment document by its unique identifier (DocEntry). This is useful in scenarios where a previously created down payment needs to be invalidated or reversed due to changes in business requirements or errors.
Practical examples:
- Canceling a down payment that was mistakenly created.
- Reversing a down payment when a purchase order is no longer valid.
- Automating cancellation workflows triggered by external events or systems.
Properties
| Name | Meaning |
|---|---|
| DocEntry | The unique numeric identifier of the Purchase Down Payment document to be canceled. |
Output
The node outputs a JSON object representing the response from the SAP Service Layer API after attempting to cancel the specified purchase down payment. This typically includes status information about the cancellation request, such as success confirmation or error details.
If an error occurs during the request, the output JSON will contain an error field with the error message describing what went wrong.
No binary data output is involved in this operation.
Dependencies
- Requires connection credentials to the SAP Service Layer API, including:
- Base URL of the SAP Service Layer endpoint.
- Username and password for authentication.
- Company database name.
- The node performs a login POST request to obtain session cookies used for subsequent API calls.
- The SAP Service Layer must be accessible from the n8n environment.
- Proper permissions are required on the SAP side to perform cancellation operations on purchase down payments.
Troubleshooting
- Authentication failures: If login fails, verify the SAP Service Layer URL, username, password, and company database name are correct and that the SAP server is reachable.
- Invalid DocEntry: If the provided
DocEntrydoes not exist or is incorrect, the API will return an error. Double-check the document number. - Permission issues: Ensure the user account has rights to cancel purchase down payments.
- Network or SSL errors: The node disables strict SSL verification (
rejectUnauthorized: false), but network connectivity issues or firewall restrictions can still cause failures. - Error messages: The node returns error messages from the SAP API in the output JSON under the
errorkey. Use these messages to diagnose issues.
Links and References
- SAP Business One Service Layer Documentation
- SAP Service Layer API Reference (example link; check your SAP version)
- OData Protocol (used by SAP Service Layer)
Note: This summary focuses exclusively on the Purchase Down Payment resource and the Cancel operation as requested.