Urenboeking toevoegen/wijzigen

<< Click to Display Table of Contents >>

Navigation:  API aanroepen >

Urenboeking toevoegen/wijzigen

Aanroep

Naam: UpdateBooking

 

Aanroep structuur

<?xml version="1.0" encoding="utf-8"?>

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<S:Body>

  <ns2:UpdateBooking xmlns:ns2="api.timewriter.nl">

    <securityToken></securityToken>

    <booking>

      <id></id>

      <start></start>

      <duration></duration>

      <approvalLevel></approvalLevel>

      <leaveState></leaveState>

      <invoiced></invoiced>

      <id_IT_MED></id_IT_MED>

      <id_GR_MED></id_GR_MED>

      <id_IT_TAA></id_IT_TAA>

      <id_IT_AT1></id_IT_AT1>

      <id_IT_AT2></id_IT_AT2>

      <id_IT_AT3></id_IT_AT3>

      <id_IT_AT4></id_IT_AT4>

      <id_IT_AT5></id_IT_AT5>

      <userFieldList>

        <userField>

          <key></key>

          <value></value>

        </userField>

         ...

      </userFieldList>

    </booking>

    <roundTimes></roundTimes>

  </ns2:UpdateBooking>

</S:Body>

</S:Envelope>

 

Verklaring

Tag/veldnaam

Type

Opmerkingen/beperkingen

Omschrijving

securityToken

string

verplicht

securityToken verkregen bij login

roundTimes

boolean

verplicht

indien true, tijdsduur afronden op de in TimeWriter ingestelde minimale tijdseenheid

tijdsduur afronden

booking

Booking

verplicht

zie Booking

 

Voorbeelden

hmtoggle_arrow1Urenboeking toevoegen

 

Hieronder volgt een voorbeeld van toevoegen van een urenboeking met de volgende eigenschappen:

•start datum en tijd is 23 december 2017 14:15.

•de duur is 60 minuten

•er zijn 2 gebruikersvelden ingevuld (1 tekst en 1 numeriek).

 

<?xml version="1.0" encoding="utf-8"?>

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<S:Body>

  <ns2:UpdateBooking xmlns:ns2="api.timewriter.nl">

    <securityToken></securityToken>

    <booking>

      <id></id> <!-- id heeft geen waarde: nieuwe urenboeking aanmaken -->

      <start>2017-12-23T14:15:00.000</start>

      <duration>60</duration>

      <id_IT_MED>50</id_IT_MED>

      <id_IT_AT1>123</id_IT_AT1>

      <id_IT_AT2>456</id_IT_AT2>

      <id_IT_AT3>789</id_IT_AT3>

      <userFieldList>

        <userField>

          <key>UF005char</key>

          <value>Omschrijving werkzaamheden</value>

        </userField>

        <userField>

          <key>UF006num</key>

          <value>30.75</value>

        </userField>          

      </userFieldList>

    </booking>

    <roundTimes></roundTimes>

  </ns2:UpdateBooking>

</S:Body>

</S:Envelope>

 
hmtoggle_arrow1Urenboeking wijzigen

 

Hieronder volgt een voorbeeld van het wijzigen van een urenboeking:

 

<?xml version="1.0" encoding="utf-8"?>

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<S:Body>

  <ns2:UpdateBooking xmlns:ns2="api.timewriter.nl">

    <securityToken></securityToken>

    <booking>

      <id>456789</id> <!-- id heeft een waarde: bestaande urenboeking wijzigen -->

      <start>2017-12-23T14:15:00.000</start>

      <duration>120</duration>

      <id_IT_MED>50</id_IT_MED>

      <id_IT_AT1>123</id_IT_AT1>

      <id_IT_AT2>456</id_IT_AT2>

      <id_IT_AT3>789</id_IT_AT3>

    </booking>

    <roundTimes></roundTimes>

  </ns2:UpdateBooking>

</S:Body>

</S:Envelope>

 

 

Antwoord

Naam: UpdateBookingResponse

 

Antwoord structuur

<?xml version="1.0" encoding="utf-8"?>

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

<SOAP-ENV:Header/>

<S:Body>

  <ns2:UpdateBookingResponse xmlns:ns2="api.timewriter.nl">

    <result>

      <error></error>

      <errorMessage></errorMessage>

      <booking>

        <id></id>

        <start></start>

        <duration></duration>

        <approvalLevel></approvalLevel>

        <leaveState></leaveState>

        <invoiced></invoiced>

        <id_IT_MED></id_IT_MED>

        <id_GR_MED></id_GR_MED>

        <id_IT_TAA></id_IT_TAA>

        <id_IT_AT1></id_IT_AT1>

        <id_IT_AT2></id_IT_AT2>

        <id_IT_AT3></id_IT_AT3>

        <id_IT_AT4></id_IT_AT4>

        <id_IT_AT5></id_IT_AT5>

        <name_IT_MED></name_IT_MED>

        <name_GR_MED></name_GR_MED>

        <name_IT_AT1></name_IT_AT1>

        <name_IT_AT2></name_IT_AT2>

        <name_IT_AT3></name_IT_AT3>

        <name_IT_AT4></name_IT_AT5>

        <name_IT_AT5></name_IT_AT5>

        <userFieldList>

          <userField>

            <key></key>

            <value></value>

          </userField>

           ...

        </userFieldList>

      </booking>

    </result>

  </ns2:UpdateBookingResponse>

</S:Body>

</S:Envelope>

 

Verklaring

Tag/veldnaam

Type

result

RequestResult

Tag/veldnaam

Type

Omschrijving

error

boolean

false indien geen fouten, true indien er fouten zijn opgetreden

errorMessage

string

foutboodschap, alleen gevuld indien error = true

booking

Booking

zie Booking