SAP Service Layer (Purchases)Install

Overview

This node interacts with the SAP Service Layer specifically for managing Purchase Tax Invoices. It allows users to perform various operations such as retrieving a purchase tax invoice by its key, optionally selecting specific fields to return. This is useful in scenarios where you need to fetch detailed or partial information about a particular purchase tax invoice from SAP Business One.

Common use cases:

• Fetching a specific purchase tax invoice by its unique identifier (DocEntry) to review or process it further.
• Retrieving only selected fields of a purchase tax invoice to optimize data transfer and processing.
• Integrating SAP purchase tax invoice data into workflows for reporting, auditing, or automation purposes.

Practical example:

• You want to get the total amount and vendor code of a purchase tax invoice with DocEntry 12345. Using this node’s "Get by Key (Select)" operation, you specify DocEntry as 12345 and Select as "DocTotal,CardCode". The node returns only those fields, reducing unnecessary data retrieval.

Properties

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output item contains:

• json: The JSON response from the SAP Service Layer API representing the purchase tax invoice data retrieved.
  • If the Select property was used, only the specified fields will be present.
  • If no Select was specified, the full purchase tax invoice object is returned.
• pairedItem: Metadata linking the output to the input item index.

Binary data:
This node does not output binary data; it only returns JSON-formatted data from the SAP Service Layer.

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 authenticates by sending a login request to SAP Service Layer and manages session cookies for subsequent requests.
• No additional external dependencies beyond the SAP Service Layer API and valid credentials.

Troubleshooting

Common issues

• Authentication failure: Incorrect username, password, or company DB will cause login errors.
• Invalid DocEntry: Specifying a non-existent or incorrect DocEntry will result in an error or empty response.
• Malformed Select string: Improperly formatted select fields may cause the API to reject the request.
• Network or SSL issues: If the SAP Service Layer endpoint is unreachable or has invalid SSL certificates, requests may fail.

Error messages and resolutions

• Login failed / Unauthorized: Verify credentials and company DB are correct.
• 404 Not Found: Check that the DocEntry exists in SAP for the Purchase Tax Invoice resource.
• 400 Bad Request: Review the syntax of the Select parameter and ensure it matches valid SAP entity fields.
• Request timeout or network error: Confirm network connectivity and SAP Service Layer availability.

Links and References

• SAP Business One Service Layer Documentation
• OData Query Options ($select)
• SAP Service Layer Authentication