> ## Documentation Index
> Fetch the complete documentation index at: https://developers.techwolf.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

# Employee Skill Sync Integration with SAP BTP

This Deployment Guide provides instructions that will assist in the process of
deploying the SAP BTP - TechWolf Employee Skill Sync Integration, including
detail on the configuration and deployment of the integration in the customer's
SAP BTP tenant and SAP SuccessFactors tenant. The intended audience for this
document is the Integration Implementer.

## Integration

The Integration has been designed, developed, tested, documented, and deployed
by TechWolf with SAP's guidance and oversight. The integration facilitates the
flow of validated Employee skill data between SAP SuccessFactors and TechWolf,
using an Integration Flow deployed in the customer's SAP Integration Suite. It
is not intended to address every use case a customer may be interested in. The
customer benefits by receiving pre-built, pre-tested, documented,
partner-maintained integrations that minimize implementer's effort as compared
to custom integrations for the specific use case(s) addressed.

<Note>
  This is a **distinct integration** from the direct-API [SAP SuccessFactors
  Employee Skill Sync <Icon icon="link" iconType="solid" />
  ](/integrations/sap-skill-sync-integration/overview-employees). Customers
  choose one or the other depending on their deployment model: the SAP
  SuccessFactors Skill Sync calls SAP SuccessFactors APIs directly from
  TechWolf. The SAP BTP Skill Sync uses the SAP Integration Suite running in
  the customer's own SAP BTP tenant.
</Note>

## Functional Objective

TechWolf and SAP are partnering to enhance skill management within
organizations. TechWolf leverages data from various sources, including business
systems, to infer skills. These inferred skills are seamlessly integrated into
SAP SuccessFactors Employee Growth Portfolios, providing a comprehensive and
real-time view of Employees' skills. The integration also enables profile
synchronization between TechWolf and SAP, ensuring that both platforms' updates
are consistently reflected. Note that TechWolf **Employees** are linked to SAP
**Per Person** entities.

This can be further facilitated with the use of the
[TechWolf Skill Assistant <Icon icon="link" iconType="solid" />](/integrations/skill-assistant/overview),
where Employees can be notified of newly suggested Skills and validate them.
This integration does not depend on the Skill Assistant; any other Skill
validation approach can be used. The integration is agnostic to the Skill
validation.

Besides Skill presence or absence, the integration also synchronizes the
proficiency of the Employees' Skills. These proficiency levels can be set by the
Employee themselves in the TechWolf Skill Assistant.

Changes that are made to the Employee Skill Profile within TechWolf are
synchronized to SAP SuccessFactors instantaneously through the Integration Flow.
Changes made to Employee Growth Portfolios within SAP SuccessFactors are
reflected back to TechWolf through a file-based pull: SAP SuccessFactors pushes
Employee Growth Portfolio export files to the TechWolf SFTP server on a
customer-defined schedule in the SAP Integration Center, and TechWolf pulls from
the SFTP server on a separate schedule (daily by default).

**Key benefits:**

* TechWolf synchronizes Employee Skill Profiles across all relevant systems,
  harmonizing Skills across all systems.
* The accurate and up-to-date Skill data in SAP SuccessFactors can be used for
  downstream purposes within SAP.
* As TechWolf does not rely on manual assessments (only validation), we increase
  employee adoption to your talent marketplace with automated Skill Profiles.
* Customer-owned infrastructure: every call to SuccessFactors is performed in
  the customer's BTP tenant, giving the customer full visibility via BTP's
  Monitor Message Processing view and keeping SuccessFactors credentials inside
  the customer's BTP keystore.

<Note>
  Within SAP, Employees assigned to Job Roles automatically inherit all Skills
  of those Job Roles, on top of any other Skills they may have. To align the
  behavior, the Skill Assistant will also block the removal of these inherited
  Skills from the Employee's Skill Profile.
</Note>

## The Integration Flow

The Content Package contains the **Update Employee Growth Portfolio** iFlow,
deployed in the customer's SAP Integration Suite. TechWolf calls this iFlow to
push Employee Skill Profile changes to SuccessFactors in near-real time, using
the Talent Intelligence Hub REST API.

The iFlow authenticates to SuccessFactors using an OAuth 2 SAML Bearer Assertion
backed by a customer-managed X.509 certificate, and carries the TechWolf AIR key
in its request header so SuccessFactors can attribute traffic to the TechWolf
Skill Sync partner solution.

The reverse direction (SuccessFactors → TechWolf) is handled outside the iFlow
via a file-based pull. An Employee Growth Portfolio export schedule configured
in the SAP Integration Center pushes export files to the TechWolf SFTP server,
which TechWolf consumes on a separate schedule.

## Reference Material

Reference materials and documentation can be found at:

* TechWolf developer documentation:
  [https://developers.techwolf.ai/ <Icon icon="link" iconType="solid" />](https://developers.techwolf.ai/)
* TechWolf Skill Sync source IP addresses:
  [IP Addresses <Icon icon="link" iconType="solid" />](/integrations/reference/ip-addresses)
* SAP SuccessFactors Talent Intelligence Hub documentation:
  [Talent Intelligence Hub <Icon icon="link" iconType="solid" />](https://help.sap.com/docs/successfactors-platform/using-talent-intelligence-hub/talent-intelligence-hub)
* SAP Integration Suite / Cloud Integration documentation:
  [SAP Integration Suite <Icon icon="link" iconType="solid" />](https://help.sap.com/docs/integration-suite)
* Used SAP SuccessFactors Talent Intelligence Hub REST API endpoints:
  * `PATCH /rest/ecosystem/wholeself/v1/growthPortfolios`
    ([REST API to Import Growth Portfolio Data <Icon icon="link" iconType="solid" />](https://help.sap.com/docs/successfactors-platform/using-talent-intelligence-hub/rest-api-to-import-growth-portfolio-data))
* Used SAP SuccessFactors Integration Center Definitions:
  * See
    [Installation - Employees <Icon icon="link" iconType="solid" />](/integrations/sap-btp-skill-sync/installation-employees)
    for the integration definitions. These are based on the default
    integration definitions by SAP, cfr.
    [Importing and Exporting of Talent Intelligence Hub Entities <Icon icon="link" iconType="solid" />](https://help.sap.com/docs/successfactors-platform/using-talent-intelligence-hub/importing-and-exporting-of-talent-intelligence-hub-entities)

To deploy the integration, follow the
[Installation <Icon icon="link" iconType="solid" />](/integrations/sap-btp-skill-sync/installation-employees)
guide.