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 Return resource and the Reopen operation, it allows users to reopen a previously closed or canceled purchase return document by its unique identifier (DocEntry). This is useful when a purchase return needs to be reactivated for further processing or correction after being finalized.

Common scenarios:

• Reopening a purchase return that was mistakenly closed or canceled.
• Adjusting details on a purchase return after reopening it.
• Automating workflows where purchase returns need to be reopened based on external triggers or conditions.

Practical example:
You have a purchase return document with DocEntry 123 that was closed prematurely. Using this node, you can send a request to reopen that document so your team can update or process it further.

Properties

Output

The node outputs an array of JSON objects corresponding to each input item processed. For the Reopen operation on a Purchase Return, the output JSON contains the response from the SAP Service Layer API indicating the result of the reopen action.

Typical output structure:

{
  "json": {
    // Response data from SAP Service Layer about the reopened purchase return,
    // e.g., status confirmation, updated document info, or error details.
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

If the operation fails, 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 endpoint.
• Needs credentials including:
  • Base URL of the SAP Service Layer.
  • Username and password for authentication.
  • Company database name.
• The node performs login to obtain session cookies before making API requests.
• No additional environment variables are required beyond the configured credentials.

Troubleshooting

• Authentication errors: If login fails, verify the SAP Service Layer URL, username, password, and company database are correct.
• Invalid DocEntry: Ensure the DocEntry number corresponds to an existing purchase return document.
• Permission issues: The user must have sufficient permissions in SAP Business One to reopen purchase returns.
• Network/SSL errors: The node disables SSL verification (rejectUnauthorized: false) but network issues or firewall restrictions may still block access.
• Error messages: The node returns error messages from the SAP API in the output JSON under the error key. Review these messages for clues on failure reasons.

Links and References

• SAP Business One Service Layer Documentation
• SAP Service Layer API Reference
• OData Query Options (used for $select and $filter parameters in other operations)

If you need details on other operations or resources, feel free to ask!