meteo/Sentri-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Compare commits

base: meteo:3bfccab663723bfcbe8166a0d08ef7b8ba381ca5
Branches Tags
meteo:main
..
compare: meteo:main
Branches Tags
meteo:main

3 Commits
3bfccab663 ... main

Author SHA1 Message Date
Meteo
6d68dceacb v1.3.1 release 2026-07-15 20:55:54 +02:00
Marco Mooij | DigiState
e4596c151d minor changes after travel reimbursement tests 2026-07-09 11:21:44 +02:00
Marco Mooij | DigiState
295b86a3c3 travel reimbursement documentation updated 2026-07-09 10:33:45 +02:00
8 changed files with 81 additions and 72 deletions
Expand all files Collapse all files

2
API/v1/office/travel-reimburse/GET Travel reimbursement.md
View File

@@ -9,6 +9,8 @@ This will get travel reimbursement entries from the database.
#### Permissions required
`office-travel-reimburse` RO
>[!note]
>You can only get the travel reimbursements of your user.
#### Body parameters
| Parameter | Type | Required | Description |
| ---------------------- | ------ | -------- | ------------------------- |

28
API/v1/office/travel-reimburse/POST Travel reimbursement.md
View File

@@ -9,27 +9,31 @@ This API call adds a entry for the travel reimbursement
#### Permissions required
`office-travel-reimburse` RW
>[!note]
>You can only post the travel reimbursements on your user.
#### Body parameters
| Parameter | Type | Required | Description |
| -------------------- | ------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| user_uuid | uuid | yes | Unique id of the user to add the reimbursement to |
| departure_postcode | string | yes | Postcode of the departure point |
| destination_postcode | string | yes | Postcode of the destination point |
| travel_date | date | yes | The date of the travel (YYYY-MM-DD) |
| travel_distance | integer | yes | The travel distance |
| travel_description | string | no | Description of the travel |
| company_uuid | uuid | yes, if customers module enabled | *Only when the Customers modules is enabled* The company uuid that the travel is linked to. Set the home/work travel company in system settings |
| company_name | string | yes, if customers module disabled | *Only when the Customers module is disabled* The that the travel is linked to. Set the home/work travel company in system settings |
| Parameter | Type | Required | Description |
| ----------------------------------- | ------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| departure_postcode | string | yes | Postcode of the departure point |
| destination_postcode | string | yes | Postcode of the destination point |
| travel_date | date | yes | The date of the travel (YYYY-MM-DD) |
| travel_distance | integer | yes | The travel distance |
| travel_description | string | no | Description of the travel |
| office_travelreimburse_company_uuid | uuid | yes, if customers module enabled | *Only when the Customers modules is enabled* The company uuid that the travel is linked to. Set the home/work travel company in system settings |
| office_travelreimburse_company_name | string | yes, if customers module disabled | *Only when the Customers module is disabled* The that the travel is linked to. Set the home/work travel company in system settings |
| homework | int | 1 or 0 | Set to 1 if the travel entry is home-work travel. |
### Example Body (json)
```json
{
"user_uuid": "5219edbb-512d-11f1-8bac-bc2411125ba4",
"departure_postcode": "3448BT",
"destination_postcode": "3433AA",
"travel_date": "2026-06-21",
"travel_distance": "56",
"travel_description": "Example description",
"company_uuid": "0f6a9c83-809b-4d54-8b16-a8197ac64ab4"
"office_travelreimburse_company_uuid": "0f6a9c83-809b-4d54-8b16-a8197ac64ab4",
"homework": 1
}
```

27
API/v1/office/travel-reimburse/PUT Travel reimbursement.md
View File

@@ -9,28 +9,33 @@ This PUT modifies an existing reimbursement item.
#### Permissions required
`office-travel-reimburse` RW
>[!note]
>You can only update the travel reimbursements on your user.
#### Body parameters
| Parameter | Type | Required | Description |
| -------------------- | ------- | -------- | -------------------------------------------------------------- |
| reimburse_uuid | uuid | yes | Unique id of the reimburse to edit |
| departure_postcode | string | yes | Postcode of the departure point |
| destination_postcode | string | yes | Postcode of the destination point |
| travel_date | date | yes | The date of the travel (YYYY-MM-DD) |
| travel_distance | integer | yes | The travel distance |
| travel_description | string | no | Description of the travel |
| company_uuid | uuid | no | The company uuid if the travel is linked to a certain company. |
| Parameter | Type | Required | Description |
| ----------------------------------- | ------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| reimburse_uuid | uuid | yes | Unique id of the reimburse to edit |
| departure_postcode | string | yes | Postcode of the departure point |
| destination_postcode | string | yes | Postcode of the destination point |
| travel_date | date | yes | The date of the travel (YYYY-MM-DD) |
| travel_distance | integer | yes | The travel distance |
| travel_description | string | no | Description of the travel |
| office_travelreimburse_company_uuid | uuid | yes, if customers module enabled | *Only when the Customers modules is enabled* The company uuid that the travel is linked to. Set the home/work travel company in system settings |
| office_travelreimburse_company_name | string | yes, if customers module disabled | *Only when the Customers module is disabled* The that the travel is linked to. Set the home/work travel company in system settings |
| homework | int | 1 or 0 | Set to 1 if the travel entry is home-work travel. |
### Example Body (json)
```json
{
"reimburse_uuid": "1c0b5323-6d79-11f1-8c62-bc2411125ba4",
"user_uuid": "5219edbb-512d-11f1-8bac-bc2411125ba4",
"departure_postcode": "3448BT",
"destination_postcode": "3433AA",
"travel_date": "2026-06-21",
"travel_distance": "56",
"travel_description": "Example description",
"company_uuid": "0f6a9c83-809b-4d54-8b16-a8197ac64ab4"
"office_travelreimburse_company_uuid": "0f6a9c83-809b-4d54-8b16-a8197ac64ab4",
"homework": 1
}
```

5
API/v1/office/travel-reimburse/configure/PUT Global travel reimbursements settings.md
View File

@@ -16,8 +16,6 @@ This PUT call configures the global Sentri settings for the Travel reimbursement
| office_travelreimburse_cents_homework_excl | int | yes | The cents per km for home/work travel with taxes excluded. |
| office_travelreimburse_cents_business_incl | int | yes | The cents per km for business travel with taxes included. |
| office_travelreimburse_cents_business_excl | int | yes | The cents per km for business travel with taxes excluded. |
| office_travelreimburse_howework_company_uuid | uuid | yes, if customers module enabled | *Only when the Customers modules is enabled* The company uuid that the travel is linked to. Set the home/work travel company in system settings |
| office_travelreimburse_howework_company_name | string | yes, if customers module disabled | *Only when the Customers module is disabled* The that the travel is linked to. Set the home/work travel company in system settings |
### Example Body (json)
```json
@@ -26,8 +24,7 @@ This PUT call configures the global Sentri settings for the Travel reimbursement
"office_travelreimburse_cents_homework_incl": 23,
"office_travelreimburse_cents_homework_excl": 23,
"office_travelreimburse_cents_business_incl": 23,
"office_travelreimburse_cents_business_excl": 23,
office_travelreimburse_howework_company_uuid: "0f6a9c83-809b-4d54-8b16-a8197ac64ab4"
"office_travelreimburse_cents_business_excl": 23
}
```

45
API/v1/sources/inserve/GET Sync cloud distributor.md
View File

@@ -1,45 +0,0 @@
# GET Sync cloud distributor
This API call synchronizes active companies in Sentri with the corresponding cloud distributor companies in Inserve. These cloud distributor companies are required to associate Sentri server licenses with companies in Inserve.
#### Location
```
/api/v1/sources/inserve/sync-cloud-distributor/
```
#### Permissions required
`servers` RW
#### Body parameters
None.
### Example Body (json)
None.
### Example Request
```php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://sentri.nl/api/v1/sources/inserve/sync-cloud-distributor/',
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <API your Bearer Token>",
"Accept: application/json",
"Content-Type: application/json"
]
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
```
### Example Response
```json
"Sync is done successfully"
```
#### Known errors or issues.
None are known at the time
If you do encounter issues and get an http code in return, check the response codes on this page.

27
Modules/Office/Travel Reimbursement.md
View File

@@ -0,0 +1,27 @@
# Travel Reimbursement
The travel reimbursement feature allows users to enter information about the distance they have traveled, enabling the system to calculate and send an reimburse invoice of the associated travel costs to the user.
Users can open a calendar month and set their default travel information. By clicking on a day in the calendar, users can create a travel entry. These travel entries are then aggregated, and the total travel costs are calculated based on the cost settings configured by the administrator.
## Using Travel Reimbursement
Permissions required: `office-travel-reimburse` RW.
To use travel reimbursement, navigate to _Travel Reimbursement_ and configure your default travel information above the calendar. These defaults will be applied automatically when creating new travel entries. Click **Save** to store the defaults for future use.
To create a travel entry, click on the date for which you want to add a travel reimbursement. Multiple travel entries can be added to the same day. Click on an existing entry to edit its details, such as adding a description. From the same menu, you can also choose to delete the entry.
To send the invoice, click the **Mail travel reimbursement** button below the calendar. The invoice will be send to your email address.
## Configuring Travel Reimbursement
Permissions required: `admin-portalsettings` RW.
To configure the travel Travel Reimbursement settings go to *portal-management* > *Modules* > *configure Office* > *Travel Reimbursement*.
Here you can configure the following:
- Cents per/km home-work incl. VAT
- Cents per/km home-work excl. VAT
- Cents per/km business incl. VAT
- Cents per/km business excl. VAT

13
Release notes.md
View File

@@ -1,5 +1,17 @@
# Release notes
## v.1.3.1
`13-06-2026`
### Changes
- Name of the travel reimbursement PDF attachment changed.
- Changes in server license creation due to Inserve removing creation of cloud distributor companies.
### Fixes
- Error when deleting last travel entry.
- Error when posting server without server_state.
- Return url of portal-management forms went to /systemconfig/.
- List of travel entries in travel reimbursement PDF is not sorted on date.
- Calculation in total km not correct.
## v.1.3
`08-07-2026`
@@ -14,6 +26,7 @@
- [b31185c2e9](https://gitea.mooij.me/meteo/Sentri/commit/b31185c2e92945fa06ca223d6b0ac95b5cd1180d) Login without username/password now shows error on login page.
- [f94bafb25d](https://gitea.mooij.me/meteo/Sentri/commit/f94bafb25dd1ba17ba59b5114a9b0dff6d687f8c) Server overview wont hide last modify column.
- [fa3515625b](https://gitea.mooij.me/meteo/Sentri/commit/fa3515625b7ff5e80e3737c5feb5fbcd7a2b6cbe) No response toast anymore when saving something
## v.1.2.4
`21-06-2026`

6
index.md
View File

@@ -1,4 +1,5 @@
# Welcome to the Sentri docs!
>[!note]
>The making of the this documentation is still in progress.
# What is Sentri
@@ -18,7 +19,12 @@ The following CRM customer sources are currently available:
- [[Inserve|Inserve]]
## Module: Office
### Stompjes
This module currently provides a feature that lets you “stomp” a colleague. It can be used to keep track of things such as counting your mom jokes or other actions between team members. These events are counted and visualized through a simple graph.
### Travel reimbursement
Another feature is the travel reimbursement feature. This allows users to enter information about the distance they have traveled, enabling the system to calculate and send an reimburse invoice of the associated travel costs to the user.
## Module: Servers
The Servers module is designed to help you keep track of all servers you manage. It centralizes key information such as assigned resources, configured backups, used licenses, and more.