- Recipes
- SOAP to Personio employees
Connect SOAP and Personio employees in our serverless environment
Use this template to Fetch data from a SOAP service using them to create employees using Personio API.
Share
Fetch data from a SOAP service
Used integrations:
- JavaScript
- Python
class SoapSourceFetch {
async init() {
// TODO: Create your soap credential
// More info at https://yepcode.io/docs/integrations/soap/#credential-configuration
this.soapClient = yepcode.integration.soap("your-soap-credential-name");
}
async fetch(publish, done) {
// TODO: Change MyFunctionNameAsync by your function name
// Example: fetchData --> fetchDataAsync
// Official docs: https://github.com/vpulim/node-soap#clientmethodasyncargs-options---call-method-on-the-soap-service
const response = await this.soapClient.MyFunctionNameAsync({
argumentName: "value",
});
// response is a javascript array containing, in the following order, result, rawResponse, soapheader, and rawRequest
// result can be a simple javascript object, or a javascript object containing an array
// rawResponse is the raw xml response string
// soapHeader is the response soap header as a javascript object
// rawRequest is the raw xml request string
// In this case, we assume that our function returns an array
for (const item of response[0]) {
publish(item);
}
done();
}
async close() {}
}
class SoapSourceFetch:
def setup(self):
## TODO: Create your soap credential
## More info at https://yepcode.io/docs/integrations/soap/#credential-configuration
self.soap_client = yepcode.integration.soap("your-soap-credential-name")
def generator(self):
## TODO: Change MyFunctionName by your function name
response = self.soap_client.service.MyFunctionName(
## Arguments needed by your function: arg1, arg2,..., argN
'argument'
)
## The response type will be determinated by the called function
## Can be a object, an array or even a basic data type
## In this case, we assume that our function returns an array
for item in response:
yield item
def close(self):
pass
Do you need help solving this integration with YepCode?
Let's talkCreate employees using Personio API
Used integrations:
- JavaScript
- Python
class HttpTargetPersonioCreateEmployee {
async init() {
// TODO: Create your http credential with personio information:
// More info at https://yepcode.io/docs/integrations/http/#credential-configuration
// baseUrl: https://api.personio.de/v1
this.httpClient = yepcode.integration.http(
"your-http-personio-credential-name"
);
// TODO: You need to define two env vars (https://yepcode.io/docs/processes/team-variables)
const {
data: {
bearerToken
},
} = await this.httpClient.post("/auth", {
client_id: yepcode.env.PERSONIO_CLIENT_ID,
client_secret: yepcode.env.PERSONIO_CLIENT_SECRET,
});
this.bearerToken = bearerToken;
}
async consume(item) {
// TODO: Customize your request checking the API documentation:
// https://developer.personio.de/reference/post_company-employees
const response = await this.httpClient.post(
"/company/employees", {
// TODO: map your fields from item
employee: {
email: item.email,
first_name: item.first_name,
last_name: item.last_name,
gender: "male",
position: "developer",
subcompany: "ACME",
department: "IT",
office: "Madrid",
hire_date: "2020-01-31",
weekly_working_hours: 40,
custom_attributes: {
"dynamic_ {{ field uid }} ": "German",
},
},
}, {
headers: {
Authorization: `Bearer ${this.bearerToken}`,
},
}
);
// A new token is recieved in each request (https://developer.personio.de/reference/auth-1)
this.bearerToken = response.headers.authorization;
}
async close() {}
}
class HttpTargetPersonioCreateEmployee:
def setup(self):
# TODO: Create your http credential with personio information:
# More info at https://yepcode.io/docs/integrations/http/#credential-configuration
# baseUrl: https://api.personio.de/v1
self.session = yepcode.integration.http("your-http-personio-credential-name")
# TODO: You need to define two env vars (https://yepcode.io/docs/processes/team-variables)
response = self.session.post(
"/auth",
json={
"client_id": yepcode.env.PERSONIO_CLIENT_ID,
"client_secret": yepcode.env.PERSONIO_CLIENT_SECRET,
},
)
response.raise_for_status()
self.token = response.json()["bearerToken"]
def consume(self, generator, done):
for item in generator:
self.process(item)
done()
def process(self, item):
# TODO: map your fields from item
employee = {
"email": item["email"],
"first_name": item["first_name"],
"last_name": item["last_name"],
"gender": "female",
"position": "developer",
"subcompany": "yepcode",
"department": "IT",
"office": "Berlin",
"hire_date": "2021-01-01",
"weekly_working_hours": 40,
"custom_attributes": {
"custom": "value",
},
}
# TODO: Customize your request checking the API documentation:
# https://developer.personio.de/reference/post_company-employees
response = self.session.post(
"/company/employees",
json=employee,
headers={"Authorization": f"Bearer {self.token}"},
)
response.raise_for_status()
# A new token is recieved in each request (https://developer.personio.de/reference/auth-1)
self.token = response.headers["authorization"]
def close(self):
pass
FAQs
YepCode is a SaaS platform that enables the creation, execution and monitoring of integrations and automations using source code in a serverless environment.
We like to call it the Zapier for developers, since we bring all the agility and benefits of NoCode tools (avoid server provisioning, environment configuration, deployments,...), but with all the power of being able to use a programming language like JavaScript or Python.
These recipes are an excellent starting point for creating your own YepCode processes and solving complex integration and automation problems.
You only have to complete the sign up form and your account will be created with our FREE plan (no credit card required).
YepCode has been created with a clear enterprise focus, offering a multi-tenant environment, team management capabilities, high security and auditing standards, Identity Provider (IdP) integrations, and on-premise options. It serves as the Swiss army knife for engineering teams, especially those requiring the extraction or transmission of information to external systems. It excels in scenarios demanding flexibility and adaptability to change within the process.
Sure! You only need to configure YepCode servers to establish a connection with that service. Check our docs page to get more information.