SAP B1 Service Layer 3 - CRM icon

SAP B1 Service Layer 3 - CRM

Interact with SAP B1 Service Layer 3 - CRM

Overview

This node interacts with the SAP Business One Service Layer 3 CRM API to perform operations on various CRM resources, including Orders. Specifically, for the "Order" resource and the "Get by Key" operation, it retrieves a single order record identified by a unique key (DocEntry). This is useful when you need to fetch detailed information about a specific order from SAP B1, such as its status, customer details, or line items.

Common scenarios include:

  • Retrieving an order's details to display in a dashboard.
  • Using order data to trigger further automation workflows.
  • Validating order existence before performing updates or cancellations.

Example: Fetching an order by its DocEntry to check its current status before deciding whether to close or cancel it.

Properties

Name Meaning
DocEntry / Key The unique identifier (key) of the order to retrieve. Required for "Get by Key" operation.

Output

The node outputs JSON data representing the order object retrieved from SAP B1. The structure corresponds to the SAP B1 Order entity, containing fields such as order details, customer info, dates, amounts, and statuses.

If the request fails, the output JSON contains an error field with the error message.

No binary data output is produced by this operation.

Dependencies

  • Requires connection credentials to SAP Business One Service Layer API, including:
    • Base URL of the SAP B1 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.
  • The node makes HTTP requests to the SAP B1 REST API endpoints.

Troubleshooting

  • Authentication errors: If login fails, verify that the base URL, username, password, and company DB are correct and that the SAP B1 Service Layer is accessible.
  • Invalid DocEntry: If the specified DocEntry does not exist, the API may return a 404 or error message. Ensure the key is valid and exists in SAP B1.
  • Network issues: Connection timeouts or SSL errors can occur if the SAP B1 server is unreachable or has invalid certificates. The node disables strict SSL verification (rejectUnauthorized: false) but network connectivity must be ensured.
  • Error messages: Errors returned from the API are passed through in the output under the error field. Review these messages for clues on misconfiguration or invalid parameters.

Links and References

Discussion