Gebruikers aanmaken

Voor het aanmaken van een gebruiker in Pynter kan gebruik gemaakt worden van de CreatePerson endpoint. Deze endpoint ziet er als volgt uit:

POST /service/apiservice.asmx HTTP/1.1
Host: tools4ever.acc.pynter.nl
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <CreatePerson xmlns="/service/ApiService.asmx">
      <username>string</username>
      <password>string</password>
      <personCreate></personCreate>
    </CreatePerson>
  </soap12:Body>
</soap12:Envelope>

De endpoint verwacht een personCreate object geserialiseerd als XML. Dit object ziet er als volgt uit:

<personCreate>
    <!-- Externe identificatie voor de persoon. Kan gebruikt worden om de persoon op te wijzigen of op te halen. Moet uniek zijn. -->
    <ExternalIdentifier>string</ExternalIdentifier>

    <!-- De voornaam. -->
    <FirstName>string</FirstName>

    <!-- OPTIONEEL: Het tussenvoegsel. -->
    <Insertion>string</Insertion>

    <!-- De achternaam exclusief tussenvoegsel. -->
    <FamilyName>string</FamilyName>

    <!-- Een zakelijk e-mailadres voor de persoon. -->
    <Email>string</Email>

        <!-- Het autorisatieniveau van de persoon. -->
        [public AccountLevel AccountLevel { get; set; }](https://docs.pynter.nl/books/authenticatie-en-authorisatie/page/authorisatie)

    <!-- Of deze persoon een manager is of niet. -->
    <IsManager>boolean</IsManager>

    <!-- De naam van de functie. -->
    <FunctionName>string</FunctionName>

    <!-- De naam van de divisie / locatie van de persoon. -->
    <DivisionName>string</DivisionName>

    <!-- De kostenplaats voor de persoon. -->
    <CostCentre>string</CostCentre>

    <!-- OPTIONEEL: De telefoonnummer. -->
    <PhoneNumber>string</PhoneNumber>

    <!-- OPTIONEEL: Wanneer het contract ingaat. -->
    <ContractStartTime>datetime</ContractStartTime>

    <!-- OPTIONEEL: Wanneer het contract afloopt. -->
    <ContractEndTime>datetime</ContractEndTime>
</personCreate>

Bij het succesvol aanroepen krijg je het volgende resultaat terug:

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <CreatePersonResponse xmlns="/service/ApiService.asmx">
      <CreatePersonResult>
        <Success>boolean</Success>
        <Contents>int<Contents>
        <Error>string</Error>
      </CreatePersonResult>
    </CreatePersonResponse>
  </soap12:Body>
</soap12:Envelope>

In de Contents van de response bevind zich het interne Pynter ID van de persoon die later gebruikt kan worden voor het wijzigen van de persoon.