Skip to content

Employment agency

SETU-standard endpoints for staffing companies (employment agencies) integrating with Dyflexis. Implements the Dutch SETU XML standard for Human Resource, Assignment, and Time Card messages. All endpoints accept and return application/xml and require the setu token scope.

These endpoints are versioned and hosted under /api/setu/{version}/....

Operations
Webhooks

Submit a human resource

Request

Requires scope: setu.

The main element of the message, this container holds all elements needed to define a human resource (the person being staffed) in the SETU standard. SETU is the Dutch staffing industry's XML interchange standard.

Security
apiKey(Required scopes: setu)
Bodyapplication/xmlrequired
HumanResourceobject
curl -i -X POST \
  https://beta-developer.dyflexis.com/_mock/openapi/api/setu/1.4.1/humanResource \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/xml' \
  -d '<HumanResource>
    <HumanResourceId idOwner="StaffingCompany">
      <IdValue>179943169</IdValue>
    </HumanResourceId>
    <ResourceInformation>
      <PersonName>
        <FormattedName>John de Smith</FormattedName>
        <GivenName>John</GivenName>
        <PreferredGivenName>John</PreferredGivenName>
        <FamilyName primary="true" prefix="de">Smith</FamilyName>
      </PersonName>
      <EntityContactInfo>
        <ContactMethod>
          <Mobile>
            <FormattedNumber>06-12345678</FormattedNumber>
          </Mobile>
          <Telephone>
            <FormattedNumber>070 1234567</FormattedNumber>
          </Telephone>
          <InternetEmailAddress>john.doe@example.com</InternetEmailAddress>
        </ContactMethod>
      </EntityContactInfo>
      <PostalAddress>
        <PostalCode>2516 BE</PostalCode>
        <Municipality>The Hague</Municipality>
        <DeliveryAddress>
          <StreetName>Binckhorstlaan</StreetName>
          <BuildingNumber>36</BuildingNumber>
          <Unit>M449</Unit>
        </DeliveryAddress>
      </PostalAddress>
    </ResourceInformation>
    <HumanResourceAdditionalNL>
      <BirthDate>1991-03-18</BirthDate>
      <Sex>male</Sex>
      <CustomerReportingRequirements>
        <CostCenterName>The Hague Office</CostCenterName>
      </CustomerReportingRequirements>
    </HumanResourceAdditionalNL>
  </HumanResource>
  '

Responses

Human Resource created successfully

Response
No content