Compatibility

This function is only available for customers with activated time recording V3.


Allows you to create, edit and delete cost centers.

Description

POST timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&action=ACTION_TYPE&name=COSTCENTER_IDENT&name=COSTCENTER_NAME&valid_from=COSTCENTER_VALIDFROM_DATETIME&valid_to=COSTCENTER_VALIDTO_DATETIME&planned_duration=COSTCENTER_DURATION&defined_activities=COSTCENTER_ACTIVITIES&allow_other_activities=COSTCENTER_OTHER_ACTIVITIES_OPTION&defined_persons=COSTCENTER_PERSONS

Parameters


ParameterDescriptionTypeNoteMandatory
companyRTI company keystring
yes
importRTI import keystring

yes

actionPossible request modesstring

permissible modes are:

  • new: create a new cost center
  • update: edit an existing cost center
  • delete: delete a cost center


yes

identIdentifier of the cost centerstringUnique identifier of the cost center.
Only with this ID is it possible to edit or delete a cost center later.		yes
nameName of the cost centerstring
yes(1)
valid_fromStart of the cost center's validitystringYYYYmmddHHiissyes(1)
valid_toEnd of the cost center's validitystringYYYYmmddHHiissno
planned_durationPlanned duration of the cost centerintegerin minutesno
defined_activitiesDefined activities of the cost centerarray

An array of objects containing the identifier and an optional planning time in minutes per activity.
The identification of the activities must be unique and already stored in the system.
Example:

[
	{
		"ident": "A100",
		"duration": 2000
	},
	{
		"ident": "A200",
		"duration": null
	},
	{
		"ident": "A300"
	}
]
no
allow_other_activitiesThis option determines whether other activities are allowed for the booking in addition to the "defined_activities".integerPossible values: 0 or 1
default: 0		no
defined_personsDefined persons of the cost centerarray

An array of employee numbers (string).
If persons are specified for a cost center, it is only possible for these persons to create a time booking to this cost center.
The employee number is determined separately for each person via the personnel administration.

[ "M1000", "M1001", "M1002" ]
no

Hints:

(1) Mandatory field when creating a cost center

If fields are not transmitted when editing cost centers, they will not be changed.


Return

When creating and editing, "COSTCENTER_DATA_SAVED" is returned if successful.

When deleting a cost center, "COSTCENTER_DELETED" is returned if successful..

If entries are missing or incorrect, an "ERROR:description" is returned.

Examples

Create a new cost center with all possible fields
https://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&action=new&ident=B1234&name=Baustelle&valid_from=20210101000000&valid_to=20211231235959&planned_duration=10000&defined_activities=[{"ident":"A100","duration":5000},{"ident":"A200","duration":5000}]&allow_other_activities=0&defined_persons=["M1000","M1001"]
Edit the name of a cost center
https://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&ident=B1234&action=update&name=Büro
Delete a cost center
https://map.yellowfox.de/rti/timerecording/set_costcenter.php?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&ident=B1234&action=delete
  • No labels