SETU Timecard inkomende correctieberichten

 

Belangrijkste XML-structuur voor correcties

<TimeCard>

<Id>

<IdValue>unieke_id_van_origineel_bericht</IdValue>

</Id>

<ReportedTime status="corrected">

<TimeInterval actionCode="[add|change|void|unchanged]" type="[regular|additional|overtime]">

<!-- tijdsregistratiedetails -->

</TimeInterval>

 

<Allowance actionCode="[add|change|void|unchanged]" type="expense" billable="true">

<!-- vergoedingdetails -->

</Allowance>

</ReportedTime>

</TimeCard>

 

Belangrijkste vereisten voor correcties

Identificatie

De Timecard->Id->IdValue moet verwijzen naar een eerder verwerkt timecard bericht.

Het originele bericht moet nog aanwezig zijn in de SETU log (de pagina SETU import meldingen).

 

Statusattribuut

Het statusattribuut in ReportedTime moet op corrected staan.

 

ActionCode attributen

Dit is verplicht voor zowel TimeInterval als Allowance elementen.

De toegestane waarden zijn:

  • add - nieuwe regels
  • change - wijzigingen op bestaande regels
  • void - verwijderen van bestaande regels (gedeeltelijk of volledig)
  • unchanged - ongewijzigde regels

 

Validaties

  1. MSF controleert of het originele bericht bestaat en is verwerkt
  2. Het originele bericht moet nog in de SETU import meldingen staan (en mag dus niet opgeschoond zijn)
  3. Het aantal (uren) dat met actioncode Void wordt meegegeven, mag niet meer zijn dan het al aanwezige aantal

 

Overige opmerkingen

  • MSF gebruikt niet het ID op TimeInterval niveau om de correcties te verwerken. MSF doet dit gebaseerd op werksoort en dag. Het is dus alleen mogelijk om met een correctie het 'aantal' te veranderen via actioncode change. Als de verkeerde werksoort is doorgegeven, moet de oude regel met de foutieve werksoort als void worden doorgestuurd en de nieuwe werksoort in een nieuwe regel van type add.

Opmerking: In de SETU-documentatie wordt verwerking op basis van TimeInterval ID’s als werkwijze genoemd, maar MSF werkt daar dus niet mee.

 

  • Op de pagina SETU import meldingen zijn de velden ActionCode en Urenstaat correctiebericht beschikbaar.

Let op: ActionCode bevat 1 random waarde uit het bericht, want 1 bericht kan natuurlijk meerdere ActionCodes bevatten.

Voorbeeld: Klik op de afbeelding om te vergroten:

 

  • Eventuele opmerkingen in het correctiebericht (tussen <comment> en </comment>) worden in de urenregels in het veld Opmerking ingelezen.

 

Zie ook

Pagina SETU import meldingen