Overview

This node integrates with the SAP Service Layer to manage various purchase-related entities, including Purchase Invoices. Specifically, for the Purchase Invoice resource and the Get by Key operation, it retrieves a single purchase invoice identified by its unique key (DocEntry). This is useful when you need to fetch detailed information about a specific purchase invoice from SAP Business One.

Common scenarios:

• Fetching details of a particular purchase invoice for review or processing.
• Integrating SAP purchase invoice data into other systems or workflows.
• Automating validation or reporting based on specific invoices.

Practical example:
You want to retrieve the purchase invoice with DocEntry 12345 to check its status and total amount before proceeding with payment or further processing in your workflow.

Properties

Output

The node outputs the JSON response returned by the SAP Service Layer API for the requested purchase invoice. This JSON contains all available fields and nested objects related to the purchase invoice, such as vendor details, line items, totals, dates, and statuses.

If an error occurs during the request, 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 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 POST request to /Login endpoint and uses session cookies for subsequent requests.
• No additional external dependencies beyond the SAP Service Layer API.

Troubleshooting

• Authentication errors: If login fails, verify that the base URL, username, password, and company database are correct and that the SAP Service Layer is accessible.
• Invalid DocEntry: If the specified DocEntry does not exist, the API may return an error or empty result. Confirm the key is valid.
• Network issues: Ensure the SAP Service Layer server is reachable from n8n and that SSL certificates are trusted or properly configured (the node disables strict SSL verification).
• Permission issues: The user must have sufficient permissions in SAP to read purchase invoices.
• Error messages: Errors are returned in the output JSON under the error key. Common messages include connection timeouts, unauthorized access, or invalid parameters.

Links and References

• SAP Business One Service Layer Documentation
• OData Query Options (for $select and $filter usage)

Summary

This node's Purchase Invoice - Get by Key operation allows retrieving detailed information about a specific purchase invoice from SAP Business One via the Service Layer API using its unique document entry number. It requires proper SAP credentials and handles session management internally. The output is the full JSON representation of the purchase invoice or an error message if retrieval fails.