SAP B1 Service Layer 3 - CRM

Overview

This node interacts with the SAP Business One Service Layer 3 CRM API to perform various operations on CRM resources, including Quotations. Specifically, the "Cancel" operation for the Quotation resource sends a request to cancel an existing quotation identified by its key (DocEntry). This is useful in business scenarios where a sales quotation needs to be invalidated or withdrawn before it is finalized or converted into an order.

Practical examples:

• Automatically canceling quotations that are no longer valid due to changes in customer requirements.
• Integrating with other systems to update quotation status based on external triggers.
• Managing quotation lifecycle within automated workflows to maintain accurate sales pipeline data.

Properties

Output

The node outputs JSON data representing the response from the SAP B1 Service Layer API after attempting to cancel the quotation. The structure typically includes details about the cancellation result or error information if the operation failed.

If the operation succeeds, the output JSON will contain confirmation or updated quotation data as returned by the API.

If the operation fails, the output JSON will include an error field with the error message describing what went wrong.

No binary data output is produced by this node.

Dependencies

• Requires connection credentials to the 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 performs a login request to obtain session cookies used for subsequent API calls.
• The node uses HTTP requests to interact with the SAP B1 Service Layer endpoints.
• Proper permissions in SAP B1 are necessary to perform cancellation operations on quotations.

Troubleshooting

• Authentication errors: If login fails, verify the correctness of the username, password, company database, and base URL.
• Invalid DocEntry: Ensure the DocEntry value corresponds to an existing quotation; otherwise, the API may return a not found or similar error.
• Permission issues: Lack of sufficient rights in SAP B1 can cause authorization errors when attempting to cancel a quotation.
• Network or SSL issues: The node disables strict SSL verification (rejectUnauthorized: false), but network connectivity problems or incorrect URLs can still cause failures.
• Error messages: The node returns error messages from the API in the output JSON under the error key. Use these messages to diagnose issues such as invalid input, resource not found, or server errors.

Links and References

• SAP Business One Service Layer API Documentation
• SAP Business One Quotation Object Reference