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 Close operation, it allows users to close a purchase down payment document by its unique identifier (DocEntry). Closing a purchase down payment typically means marking it as finalized or completed in the SAP system, preventing further modifications.
Common scenarios:
- Automating the workflow of purchase down payments by programmatically closing them once certain conditions are met.
- Integrating SAP purchase processes with other systems where closing a down payment triggers subsequent actions.
- Batch processing multiple purchase down payments to close them efficiently.
Practical example:
You have a list of purchase down payments that have been fully processed and you want to close them all automatically via an n8n workflow. This node can be used to send a close request for each down payment by specifying their DocEntry values.
Properties
| Name | Meaning |
|---|---|
| DocEntry | The unique identifier (number) of the purchase down payment document to be closed. |
Output
The node outputs the JSON response returned by the SAP Service Layer API after attempting to close the specified purchase down payment. The output structure corresponds directly to the SAP API's response and typically includes details about the updated document status or any error messages.
If the operation is successful, the JSON will confirm the closure of the purchase down payment. If there is an error, 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 Service Layer instance.
- Needs credentials including:
- Base URL of the SAP Service Layer.
- Username and password for authentication.
- Company database name.
- The node performs a login request to obtain session cookies which are then used for subsequent API calls.
- The SAP Service Layer API must support the POST method on the endpoint
/PurchaseDownPayments({DocEntry})/Close.
Troubleshooting
- Authentication errors: If login fails, check the provided username, password, company database, and base URL. Ensure the SAP Service Layer is accessible and credentials are valid.
- Invalid DocEntry: If the specified
DocEntrydoes not exist or is incorrect, the API will return an error. Verify theDocEntryvalue before running the node. - Permission issues: The user account must have sufficient permissions to close purchase down payments.
- Network or SSL issues: The node disables strict SSL verification (
rejectUnauthorized: false) but network connectivity problems or firewall restrictions may still cause failures. - API endpoint changes: If SAP updates their API endpoints or behavior, the node might fail. Confirm compatibility with your SAP Service Layer version.
Error messages from the SAP API are passed through in the output JSON under an error key, helping diagnose issues.
Links and References
- SAP Business One Service Layer Documentation
- SAP Service Layer API Reference
- OData Protocol Overview
If you need summaries for other operations or resources, please provide their names.