# @yousolution/node-red-contrib-you-sap-service-layer

> Unofficial module SAP Service Layer for NODE-RED

Latest version **0.2.16** (published 2026-09-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install @yousolution/node-red-contrib-you-sap-service-layer
pnpm add @yousolution/node-red-contrib-you-sap-service-layer
yarn add @yousolution/node-red-contrib-you-sap-service-layer
bun add @yousolution/node-red-contrib-you-sap-service-layer
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.2.16 |
| Published | 2026-09-24 |
| First published | 2022-04-15 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 362 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 6 |
| Author | Andrea Trentin |
| Maintainers | alessio.pellizzaro, andrea.trentin |
| Keywords | node-red, SAP, service layer, API, ERP, integration, youSolution.Cloud |

## Links

- npm: https://www.npmjs.com/package/@yousolution/node-red-contrib-you-sap-service-layer
- Repository: https://github.com/yousolution-cloud/node-red-contrib-you-sap-service-layer
- Homepage: https://github.com/yousolution-cloud/node-red-contrib-you-sap-service-layer#readme
- Issues: https://github.com/yousolution-cloud/node-red-contrib-you-sap-service-layer/issues
- npm.io page: https://npm.io/package/@yousolution/node-red-contrib-you-sap-service-layer

## Dependencies (2)

- [axios](https://npm.io/package/axios.md) ^1.2.2
- [odata-query](https://npm.io/package/odata-query.md) ^7.0.4

## Recent versions

- 0.2.16 (latest) — 2026-09-24
- 0.2.15 — 2026-03-16
- 0.2.14 — 2025-12-24
- 0.2.13 — 2025-11-21
- 0.2.12 — 2025-08-05
- 0.2.11 — 2025-07-28
- 0.2.10 — 2025-03-20
- 0.2.9 — 2025-02-19
- 0.2.8 — 2025-01-23
- 0.2.7 — 2025-01-22
- 0.2.6 — 2025-01-22
- 0.2.5 — 2025-01-16
- 0.2.4 — 2024-11-07
- 0.2.3 — 2024-11-01
- 0.2.2 — 2024-10-23
- … 7 more at https://npm.io/package/@yousolution/node-red-contrib-you-sap-service-layer/versions

## README

<!-- [![NPM version][npm-version-image]][npm-url]
[![NPM downloads per month][npm-downloads-month-image]][npm-url]
[![NPM downloads total][npm-downloads-total-image]][npm-url]
[![MIT License][license-image]][license-url] -->

# Unofficial SAP Service layer nodes for Node-RED.

[![Platform](https://img.shields.io/badge/platform-Node--RED-red)](https://nodered.org)

This module provides a set of nodes for Node-RED to quickly create integration flows with SAP service layer.

# Installation

[![NPM](https://nodei.co/npm/node-red-contrib-you-sap-service-layer.png?downloads=true)](https://nodei.co/npm/node-red-contrib-you-sap-service-layer/)

You can install the nodes using node-red's "Manage palette" in the side bar.

Or run the following command in the root directory of your Node-RED installation

    npm install @yousolution/node-red-contrib-you-sap-service-layer --save

# Dependencies

The nodes are tested with `Node.js v12.22.6` and `Node-RED v2.0.6`.

- [axios](https://github.com/axios/axios)
- [odata-query](https://github.com/techniq/odata-query)

# Changelog

Changes can be followed [here](/CHANGELOG.md).

# Usage

## Basics

### Authenticate (node authenticateSap)

Use this node to authenticate with a valid SAP service layer API access\
The node requires the following credentials:

- host
- port
- company
- user
- password

You can see how to use it in the example flows in the _/examples_ directory.\
_For more details see official [SAP Service layer documentation](https://sap-samples.github.io/smb-summit-hackathon/b1sl.html)_

### Retrieve a list of entities (node listSap)

Use this node to retrieve a list of entities

1. Select the type of entity you want to retrieve as a list
2. If you want to add filter/options use oData params _optional_\
   Query options on entities:

| option   | description                                                                 |
| -------- | --------------------------------------------------------------------------- |
| $filter  | Restrict the set of business objects returned.                              |
| $orderby | Specify the order in which business objects are returned from the service.  |
| $select  | Restrict the service to return only the properties requested by the client. |
| $skip    | Specify that the result excludes the first n entities.                      |
| $top     | Specify that only the first n records should be returned.                   |

You can see how to use it in the example flows in the _/examples_ directory.\
_For more details see official [SAP Service layer documentation](https://sap-samples.github.io/smb-summit-hackathon/b1sl.html)_

### Get single entity (node getSap)

Use this node to get a single entity by providing the primary key

1. Select the type of entity you want to retrieve
2. Use _objectId_ as primary key of entity
3. Use _oData_ to filter the response fields _optional_\

Query options on single entity:

| option  | description                                                                 |
| ------- | --------------------------------------------------------------------------- |
| $select | Restrict the service to return only the properties requested by the client. |

You can see how to use it in the example flows in the _/examples_ directory.\
_For more details see official [SAP Service layer documentation](https://sap-samples.github.io/smb-summit-hackathon/b1sl.html)_

### Create a new entity (node createSap)

Use this node to create a new entity.

1. Select the type of entity you want to create
2. Use _msg.bodyPost_ to provide the entity's fields
3. Use _msg.createParams_ to provide object params

You can see how to use it in the example flows in the _/examples_ directory.\
_For more details see official [SAP Service layer documentation](https://sap-samples.github.io/smb-summit-hackathon/b1sl.html)_

### Update an object

Use this node to update an object.

1. Select the type of object you want to update
2. Use _objectId_ as primary key of object
3. Use _msg.updateParams_ to provide object params

You can see how to use it in the example flows in the _/examples_ directory.\
_For more details see official [SAP Service layer documentation](https://sap-samples.github.io/smb-summit-hackathon/b1sl.html)_

### Delete an Object

Use this node to delete an object.

1. Select the type of object you want to delete
2. Use _objectId_ as primary key of object

You can see how to use it in the example flows in the _/examples_ directory.\
_For more details see official [SAP Service layer documentation](https://sap-samples.github.io/smb-summit-hackathon/b1sl.html)_

### Count the number of objects per type

Use this node to count the number of objects per type.

1. Select the type of object you want to count

You can see how to use it in the example flows in the _/examples_ directory.\
_For more details see official [SAP Service layer documentation](https://sap-samples.github.io/smb-summit-hackathon/b1sl.html)_

---
_Source: https://npm.io/package/@yousolution/node-red-contrib-you-sap-service-layer · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
