Actions19
- Customer Equipment Card Actions
- Knowledge Base Solution Actions
- Service Call Actions
- Service Contract Actions
Overview
This node interacts with the SAP Business One Service Layer (version 10) to manage various business resources, including Service Contracts. Specifically, the "Get by Key" operation for the Service Contract resource retrieves a single service contract record identified by its unique key (DocEntry). This is useful when you need to fetch detailed information about a specific service contract from SAP B1 for further processing or integration in your workflows.
Practical examples include:
- Retrieving a service contract's details to verify its status before performing updates.
- Fetching contract data to generate reports or trigger notifications.
- Integrating SAP B1 service contract data into other systems or dashboards.
Properties
| Name | Meaning |
|---|---|
| DocEntry | The unique numeric identifier (key) of the service contract to retrieve. Required input. |
Output
The node outputs JSON data representing the service contract object retrieved from SAP Business One. The structure corresponds directly to the SAP B1 Service Layer response for a service contract entity, containing all fields and nested objects related to that contract.
No binary data output is produced by this operation.
Example output snippet (simplified):
{
"DocEntry": 123,
"CustomerCode": "C0001",
"StartDate": "2023-01-01T00:00:00",
"EndDate": "2024-01-01T00:00:00",
"Status": "Open",
...
}
Dependencies
- Requires an API key credential for authenticating with the SAP Business One Service Layer.
- Needs the base URL of the SAP B1 Service Layer endpoint, username, password, and company database name configured in the credentials.
- The node performs a login request to obtain session cookies used for subsequent API calls.
- The node disables SSL certificate verification (
rejectUnauthorized: false), which may be relevant depending on your environment.
Troubleshooting
- Authentication errors: If login fails, check that the SAP B1 credentials (username, password, company DB) are correct and that the Service Layer endpoint is reachable.
- Invalid DocEntry: Providing a non-existent or incorrect
DocEntrywill result in an error from the SAP API indicating the record was not found. - Network issues: Ensure the SAP B1 Service Layer URL is accessible from the n8n instance and that no firewall blocks the connection.
- SSL warnings: Since SSL verification is disabled, ensure this is acceptable for your security policies; otherwise, configure proper certificates.
- Error messages returned in the output JSON under the
errorfield indicate issues during the request; review the message for specifics.