POST PlanCare2Api/Timesheets

Saves a new timesheet instance.

Requires 'Start' permission for function RegistrationOverview {2C05CECA-9B4D-4159-86C6-B39F4E167D86}

Request Information

URI Parameters

None.

Body Parameters

The instance of timesheet to save.

Name	Description	Type	Additional information
Identifier	The Identifier of the timeregistration. Remarks: When using PlanCare2 identification: for new instance the Identifier should be 0 and Type should be PlanCare2Id. When using External identification: the Identifier should always be your own identifier and Type should be ExternalId.	Identity	Required
Employee	References to the employee.	Identity	Required
ProductId	References to the Product.	integer	Conditional Required: Use either this property or the Product property
Product	References to the Product.	ProductIdentity	Conditional Required: Use either this property or the ProductId property
Start	The start date and time.	date	Required
End	The end date and time.	date	Required
EmploymentId	References to the employement of the employee.	integer	Required
WorkTypeId	References to an optional WorkType.	integer	None
Description	The description of the timeregistration.	string	None
ClientAbsent	Determines whether the client is absent.	boolean	None
ClientSigned	Determines whether the client has signed.	boolean	None
CostTypeId	The id of the costType.	integer	None
TravelMethodId	The id of the travelMethod.	integer	None
Cost	Amount of the cost.	decimal number	None
TravelDistance	The travel distances in km.	integer	None
TravelDuration	The travel duration in minutes.	integer	None
Location	The address.	Location	None
Client	References to the client.	Identity	Conditional Required: Required for all client timesheets
ContractId	References to the Contract.	integer	Conditional Required: Required for all client timesheets
LocationId	Refers to the Location.	integer	Conditional Required: Only required for GRZ timesheets
Acts	The list of acts for timesheet. The list can be empty but must be initialized.	Collection of ProductAct	Conditional Required: Only required for GRZ timesheets
OrganizationEntityId	Refers to the organization entity id.	Identity	None

Request Formats

application/json, text/json

Sample:

{
  "Identifier": {
    "$id": "2",
    "Identifier": "sample string 1",
    "Type": 0
  },
  "Employee": {
    "$ref": "2"
  },
  "ProductId": 1,
  "Product": {
    "$id": "3",
    "Identifier": "sample string 1",
    "Type": 0
  },
  "Start": "2026-05-26T23:13:00.3545565+02:00",
  "End": "2026-05-26T23:13:00.3545565+02:00",
  "EmploymentId": 4,
  "WorkTypeId": 1,
  "Description": "sample string 5",
  "ClientAbsent": true,
  "ClientSigned": true,
  "CostTypeId": 1,
  "TravelMethodId": 1,
  "Cost": 1.0,
  "TravelDistance": 1,
  "TravelDuration": 1,
  "Location": {
    "$id": "4",
    "ZipCode": "sample string 1",
    "HouseNumber": 1,
    "HouseNumberAddition": "sample string 2"
  },
  "Client": {
    "$ref": "2"
  },
  "ContractId": 8,
  "LocationId": 9,
  "Acts": [
    {
      "$id": "5",
      "ProductId": 1,
      "ActId": 2,
      "ActName": "sample string 3",
      "ActDescription": "sample string 4"
    },
    {
      "$ref": "5"
    }
  ],
  "OrganizationEntityId": {
    "$ref": "2"
  }
}

application/xml, text/xml

Sample:

<TimesheetComplete xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.TimeSheet">
  <Acts xmlns:d2p1="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface">
    <d2p1:ProductAct>
      <d2p1:ActDescription>sample string 4</d2p1:ActDescription>
      <d2p1:ActId>2</d2p1:ActId>
      <d2p1:ActName>sample string 3</d2p1:ActName>
      <d2p1:ProductId>1</d2p1:ProductId>
    </d2p1:ProductAct>
    <d2p1:ProductAct>
      <d2p1:ActDescription>sample string 4</d2p1:ActDescription>
      <d2p1:ActId>2</d2p1:ActId>
      <d2p1:ActName>sample string 3</d2p1:ActName>
      <d2p1:ProductId>1</d2p1:ProductId>
    </d2p1:ProductAct>
  </Acts>
  <Client xmlns:d2p1="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Common.Infrastructure">
    <d2p1:Identifier>sample string 1</d2p1:Identifier>
    <d2p1:Type>ExternalId</d2p1:Type>
  </Client>
  <ClientAbsent>true</ClientAbsent>
  <ClientSigned>true</ClientSigned>
  <ContractId>8</ContractId>
  <Cost>1</Cost>
  <CostTypeId>1</CostTypeId>
  <Description>sample string 5</Description>
  <Employee xmlns:d2p1="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Common.Infrastructure">
    <d2p1:Identifier>sample string 1</d2p1:Identifier>
    <d2p1:Type>ExternalId</d2p1:Type>
  </Employee>
  <EmploymentId>4</EmploymentId>
  <End>2026-05-26T23:13:00.3545565+02:00</End>
  <Identifier xmlns:d2p1="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Common.Infrastructure">
    <d2p1:Identifier>sample string 1</d2p1:Identifier>
    <d2p1:Type>ExternalId</d2p1:Type>
  </Identifier>
  <Location xmlns:d2p1="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.RealizedWorktime">
    <d2p1:HouseNumber>1</d2p1:HouseNumber>
    <d2p1:HouseNumberAddition>sample string 2</d2p1:HouseNumberAddition>
    <d2p1:ZipCode>sample string 1</d2p1:ZipCode>
  </Location>
  <LocationId>9</LocationId>
  <OrganizationEntityId xmlns:d2p1="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Common.Infrastructure">
    <d2p1:Identifier>sample string 1</d2p1:Identifier>
    <d2p1:Type>ExternalId</d2p1:Type>
  </OrganizationEntityId>
  <Product>
    <Identifier>sample string 1</Identifier>
    <Type>ExternalId</Type>
  </Product>
  <ProductId>1</ProductId>
  <Start>2026-05-26T23:13:00.3545565+02:00</Start>
  <TravelDistance>1</TravelDistance>
  <TravelDuration>1</TravelDuration>
  <TravelMethodId>1</TravelMethodId>
  <WorkTypeId>1</WorkTypeId>
</TimesheetComplete>

Response Information

Resource Description

Returns the HttpResponseMessage which contains the saved timesheet instance.

HttpResponseMessage

Name	Type	Additional information
Version	Version	None
Content	HttpContent	None
StatusCode	HttpStatusCode	None
ReasonPhrase	string	None
Headers	Collection of Object	None
RequestMessage	HttpRequestMessage	None
IsSuccessStatusCode	boolean	None