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 Get by Key operation, it retrieves a single purchase delivery note identified by its unique key (DocEntry). This is useful when you need to fetch detailed information about a specific purchase delivery note, such as for auditing, reporting, or further processing in an automation workflow.

Practical example:
You have an automated process that triggers when a new purchase delivery note is created in SAP. Using this node with the "Get by Key" operation, you can retrieve the full details of that delivery note by its DocEntry number to validate data or send notifications.

Properties

Output

The node outputs JSON data representing the purchase delivery note retrieved from SAP Service Layer. The structure corresponds directly to the SAP entity for Purchase Delivery Notes, including all fields and nested objects returned by the API.

• The output JSON contains all available properties of the specified purchase delivery note.
• If an error occurs (e.g., invalid DocEntry), the output JSON will contain an error field with the error message.
• No binary data is produced by this operation.

Example output snippet (simplified):

{
  "DocEntry": 123,
  "CardCode": "C0001",
  "DocDate": "2024-01-15",
  "DocTotal": 1500.00,
  "DocumentLines": [
    {
      "ItemCode": "A100",
      "Quantity": 10,
      "Price": 150
    }
  ],
  ...
}

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 n8n environment where this node runs.

Troubleshooting

• Common issues:

  • Invalid or missing DocEntry: The node will return an error if the specified document key does not exist.
  • Authentication failures: Incorrect credentials or inaccessible SAP Service Layer URL will cause login errors.
  • Network or SSL issues: The node disables strict SSL verification (rejectUnauthorized: false), but network connectivity problems may still occur.

• Error messages:

  • "Invalid credentials" or similar during login: Verify username, password, and company DB are correct.
  • "Document not found" or HTTP 404: Check that the DocEntry value exists in SAP.
  • Other HTTP errors: Review SAP Service Layer logs and ensure the API endpoint is reachable.

Links and References

• SAP Business One Service Layer Documentation
• OData Protocol Overview (used by SAP Service Layer)
• n8n Documentation on Creating Custom Nodes