SAP Service Layer (Purchases)Install

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 Create Cancellation operation, it allows users to create a cancellation document for an existing purchase delivery note identified by its unique DocEntry.

This functionality is useful when you need to reverse or cancel a previously issued purchase delivery note due to errors, changes in order, or other business reasons. For example, if a delivery note was created incorrectly or the goods were not delivered as expected, this operation helps generate the corresponding cancellation document to keep records accurate.

Properties

Output

The node outputs the JSON response returned by the SAP Service Layer API after attempting to create the cancellation document. This typically includes details about the newly created cancellation document or error information if the operation failed.

The output structure is:

{
  "json": {
    // Response data from SAP Service Layer for the cancellation creation
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

No binary data output is produced by this node.

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 request to obtain session cookies used for subsequent API calls.
• The SAP Service Layer must be accessible from the environment where n8n runs.
• Proper permissions in SAP Business One are required to create cancellation documents.

Troubleshooting

• Authentication Errors: If login fails, verify that the SAP Service Layer URL, username, password, and company database are correct and that the SAP Service Layer service is running.
• Invalid DocEntry: Providing a non-existent or incorrect DocEntry will cause the API call to fail. Ensure the DocEntry corresponds to an existing purchase delivery note.
• Permission Denied: Lack of sufficient permissions in SAP Business One may result in authorization errors.
• Network Issues: Connection problems to the SAP Service Layer endpoint can cause timeouts or failures.
• Error Messages: The node returns error messages from the SAP API in the output JSON under the error key. Review these messages to identify issues such as invalid parameters or server errors.

Links and References

• SAP Business One Service Layer Documentation
• SAP Service Layer API Reference
• n8n Documentation on HTTP Request Node (for understanding underlying HTTP requests)

This summary focuses exclusively on the Purchase Delivery Note resource and the Create Cancellation operation as requested.