mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-27 07:00:29 +01:00
6901 lines
220 KiB
Plaintext
6901 lines
220 KiB
Plaintext
#%RAML 1.0
|
||
title: Xentral-API
|
||
description: Die API befindet sich in ihrer Xentral-Installation im Unterordner `/www/api/`.
|
||
version: v1, v2
|
||
baseUri: http://www.example.com/api/{version}/
|
||
mediaType: application/json
|
||
securedBy: [ Digest ]
|
||
securitySchemes:
|
||
Digest:
|
||
type: Digest Authentication
|
||
displayName: Digest Authentifizierung
|
||
description: |
|
||
Die API unterstützt nur die Digest Authentifizierung.
|
||
Grundsätzlich empfehlen wir aber die zusätzliche Absicherung mit HTTPS-Verschlüsselung.
|
||
describedBy:
|
||
responses:
|
||
401:
|
||
description: |
|
||
Fehler bei der Authentifizierung werden immer mit dem HTTP-Status `401 Unauthorized` ausgeliefert.
|
||
|
||
**Beispiel-Response beim Zugriff ohne Authentifizierung:**
|
||
```
|
||
{
|
||
"error": {
|
||
"code": 7411,
|
||
"http_code": 401,
|
||
"message": "Unauthorized. You need to login.",
|
||
"href": "http://www.example.com/api/docs.html#error-7411"
|
||
}
|
||
}
|
||
```
|
||
|
||
documentation:
|
||
- title: Authentifizierung
|
||
content: |
|
||
Die REST-API unterstützt momentan nur die Digest Authentifizierung, da nur diese Authentifizierungsmethode auch
|
||
ohne HTTPS ausreichend Sicherheit bietet. Wir empfehlen grundsätzlich aber die zusätzliche Absicherung mit
|
||
HTTPS-Verschlüsselung.
|
||
|
||
## API-Account anlegen
|
||
|
||
In Xentral unter *Administration > Einstellungen > API-Account*. Dort auf *Neu* klicken.
|
||
|
||
Wichtig sind folgende Felder:
|
||
* *Aktiv*: Hacken muss gesetzt sein, damit API-Account genutzt werden kann.
|
||
* *App Name / Benutzername* und *Initkey / Passwort*: Benutzername und Kennwort für Digest-Authentifizierung.
|
||
|
||
- title: Authorisierung
|
||
content: |
|
||
Der Zugriff eines API-Accounts kann über Berechtigungen granular eingeschränkt werden.
|
||
|
||
## Berechtigungen bearbeiten
|
||
|
||
In Xentral unter *Administration > Einstellungen > API-Account* muss der gewünschte API-Account mit einem Klick
|
||
auf den Stift bearbeitet werden. Dort ist eine Liste der vorhandenen Berechtigungen.
|
||
|
||
### Alte API-Accounts
|
||
|
||
Alle API-Accounts, die vor der Einführung der Berechtigungen existierten, haben automatisch alle
|
||
Berechtigungen erhalten.
|
||
|
||
- title: Requests
|
||
content: |
|
||
## Ressourcen
|
||
Grundsätzlich können alle API-Ressourcen nach folgendem Schema angesprochen werden.
|
||
|
||
**Beispiel mit der `Addressen` Ressource:**
|
||
|
||
| Method | Endpoint | Aktion |
|
||
| --------- | ------------------ | ------------------------------ |
|
||
| `GET` | `/v1/adressen` | Alle Adressen auflisten |
|
||
| `GET` | `/v1/adressen/10` | Einzelne Adresse abrufen |
|
||
| `PUT` | `/v1/adressen/10` | Vorhandene Adresse bearbeiten |
|
||
| `POST` | `/v1/adressen` | Neue Adresse anlegen |
|
||
| `DELETE` | `/v1/adressen/10` | Vorhandene Adresse löschen |
|
||
|
||
Bei vereinzelten Ressourcen kann es Abweichungen von diesem Schema geben.
|
||
|
||
## Content-Types
|
||
Die API erwartet Anfragen mit dem Content-Type `application/json` oder `application/xml`.
|
||
|
||
## Zeichensatz
|
||
Alle Anfragen mit Nutzdaten müssen mit `UTF-8` kodiert sein.
|
||
|
||
## Nutzdaten
|
||
Nutzdaten müssen im Request-Body mitgeschickt werden. Nutzdaten sind nur bei POST- und PUT-Request zulässig;
|
||
also nur Anfragen bei denen Ressourcen (z.B. Adressen) angelegt oder bearbeitet werden.
|
||
|
||
**Beispiel HTTP-Request:**
|
||
```
|
||
PUT /v1/adressen/7 HTTP/1.1
|
||
Host: api.example.com
|
||
Accept: application/json
|
||
Content-Type: application/json; charset=utf-8
|
||
Authorization: Digest XXXXXXXXXXX
|
||
|
||
{
|
||
"name": "Schrauben Meier",
|
||
"telefon": "0987654321"
|
||
}
|
||
```
|
||
|
||
### Aufbau Nutzdaten
|
||
|
||
#### JSON
|
||
JSON-Nutzdaten werden ohne einheitliches Root-Element erwartet. Die zu ändernden Feldnamen werden in der ersten
|
||
Ebene erwartet.
|
||
|
||
**Beispiel JSON:**
|
||
```json
|
||
{
|
||
"name": "Schrauben Meier GmbH",
|
||
"strasse": "Dorfstrasse 123",
|
||
"ort": "Musterdorf",
|
||
"plz": "12345",
|
||
"telefon": "0987654321",
|
||
}
|
||
```
|
||
|
||
#### XML
|
||
XML-Nutzdaten müssen von einem Root-Element umschlossen sein. Der Name des Root-Elements kann beliebig lauten.
|
||
Die zu ändernden Feldnamen werden in der zweiten Ebene erwartet.
|
||
|
||
**Beispiel XML:**
|
||
```xml
|
||
<data>
|
||
<name>Schrauben Meier GmbH</name>
|
||
<strasse>Dorfstrasse 123</strasse>
|
||
<ort>Musterdorf</ort>
|
||
<plz>12345</plz>
|
||
<telefon>0987654321</telefon>
|
||
</data>
|
||
```
|
||
|
||
- title: Responses
|
||
content: |
|
||
Die API liefert Antworten im `JSON`- oder `XML`-Format aus; abhängig vom `Accept`-Header der Anfrage.
|
||
|
||
Es wird die `JSON`-Ausgabe bevorzugt, wenn der `Accept`-Header fehlt oder ein nicht unterstütztes Format aufweist.
|
||
|
||
## Content-Types
|
||
Antworten werden mit dem Content-Type `application/json` oder `application/xml` ausgeliefert; abhängig
|
||
vom gesendeten Format.
|
||
|
||
## Zeichensatz
|
||
Alle Antworten sind `UTF-8` kodiert.
|
||
|
||
## Response-Body
|
||
### Erfolgreiche Anfrage
|
||
Der Response-Body einer erfolgreichen Anfrage beinhaltet immer ein `data`-Property als Root-Element.
|
||
|
||
#### Einzelne Ressource
|
||
**Beispiel mit einzelnem Ergebnis:**
|
||
```
|
||
{
|
||
"data": {
|
||
"id": 1,
|
||
"title": "Bernhardt Bieber"
|
||
}
|
||
}
|
||
```
|
||
|
||
#### Mehrere Ressourcen
|
||
Anworten mit mehreren Ressourcen beinhalten zusätzlich ein `pagination` Root-Element.
|
||
|
||
**Beispiel mit mehreren Ergebnissen:**
|
||
```
|
||
{
|
||
"data": [
|
||
{
|
||
"id": 1,
|
||
"title": "Phillipp Pabst"
|
||
},
|
||
{
|
||
"id": 2,
|
||
"name": "Peter Pfaff"
|
||
}
|
||
],
|
||
"pagination": {
|
||
"items_total": 50,
|
||
"items_current": 20,
|
||
"items_per_page": 20,
|
||
"page_current": 1,
|
||
"page_last": 3
|
||
}
|
||
}
|
||
```
|
||
Die Paginierung lässt sich über die GET-Parameter `page` und `items` steuern.
|
||
|
||
### Fehler
|
||
Auch Fehler besitzen ein einheitliches Schema mit `error`-Property als Root-Element:
|
||
```
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
```
|
||
|
||
Fehler-Responses beinhalten in der Regel ein `code` Property. Jeder Code steht für einen spezifischen Fehler.
|
||
Im Helpdesk (oder dieser Dokumentation) ist zu jedem Code eine genaue Beschreibung und idealerweise
|
||
Lösungsvorschläge zu finden.
|
||
|
||
- title: Filter/Sortierung/Paginierung
|
||
content: |
|
||
Suchfilter, Sortierung und Paginierung stehen bei allen Endpunkten zur Verfügung die eine Liste zurückliefern.
|
||
|
||
## Filter
|
||
|
||
### Einfache Filter
|
||
|
||
Beispiel: `/resource?ausverkauft=1&typ=produkt`
|
||
|
||
Welche Filter-Parameter zur Verfügung stehen erfahren Sie in der jeweiligen Endpunkt-Beschreibung.
|
||
|
||
### Komplexe Filter
|
||
|
||
Komplexe Filter sind grundsätzlich bei allen Endpunkt verfügbar die eine Liste zurückliefern; unabhängig
|
||
von den einfachen Filtern.
|
||
|
||
Beispiele:
|
||
- `/resource?filter[0][property]=mwst_satz&filter[0][expression]=gte&filter[0][value]=10`
|
||
- `/resource?filter[0][property]=beschreibung&filter[0][value]=%Schraube%`
|
||
- `/resource?filter[0][property]=land&filter[0][value]=DE&filter[0][operation]=OR&filter[1][property]=land&filter[1][value]=AT`
|
||
|
||
Parameter:
|
||
- `property`\
|
||
Feld in dem gesucht werden soll (Pflichtangabe).
|
||
|
||
- `value`\
|
||
Wert nach dem gesucht werden soll (Pflichtangabe).
|
||
|
||
- `expression`\
|
||
Vergleichsoperator\
|
||
Mögliche Werte:
|
||
- `eq` entspricht **=**
|
||
- `not` entspricht **!=**
|
||
- `gt` entspricht **>**
|
||
- `gte` entspricht **>=**
|
||
- `lt` entspricht **<**
|
||
- `lte` entspricht **<=**
|
||
- `like` entspricht **LIKE**
|
||
- `not_like` entspricht **NOT LIKE**
|
||
Default-Wert: `like`
|
||
|
||
- `operation`\
|
||
Verknüpfungsart bei der Anwendung mehrerer Filter.\
|
||
Mögliche Werte: `and`, `or`.\
|
||
Default-Wert: `and`
|
||
|
||
## Sortierung
|
||
|
||
Welche Felder für die Sortierung zur Verfügung stehen, erfahren Sie in der jeweiligen Endpunkt-Beschreibung.
|
||
|
||
Ein Minuszeichen vor dem Feldnamen kehrt die Sortierung um.
|
||
|
||
Beispiel: `/resource?sort=titel,-projekt`
|
||
|
||
## Paginierung
|
||
|
||
| Parameter | Beschreibung | Default | Wertebereich |
|
||
| ---------- | -------------------------------- | -------- | -------------- |
|
||
| `page` | Auswahl der Seite | `1` | `1` bis `1000` |
|
||
| `items` | Anzahl der Ergebnisse pro Seite | `20` | `1` bis `1000` |
|
||
|
||
Beispiel: `/resource?page=2&items=5`
|
||
|
||
- title: Fehler-Codes
|
||
content: |
|
||
|
||
TODO: Erklärungen hinzufügen
|
||
|
||
## Auth-Fehler
|
||
### <a name="error-7411"></a> #7411 - Unauthorized
|
||
Zugriff ohne Authentifizierung. Authorization-Header fehlt komplett.
|
||
|
||
### <a name="error-7412"></a> #7412 - Digest header incomplete
|
||
Digest-Header unvollständig; benötigte Teile fehlen.
|
||
|
||
### <a name="error-7413"></a> #7413 - Api account missing
|
||
Es ist kein API-Account angelegt oder aktiv.
|
||
|
||
### <a name="error-7414"></a> #7414 - Api account invalid
|
||
Der verwendete API-Account ist nicht gültig. Eventuell wurde der Account auf inaktiv gestellt.
|
||
|
||
### <a name="error-7415"></a> #7415 - Digest validation failed
|
||
Die Prüfung der Digest-Authentifizierung ist fehlgeschlagen.
|
||
|
||
### <a name="error-7416"></a> #7416 - Digest nonce invalid
|
||
Server-Nonce ist auf Server nicht vorhanden. Mögliche Ursachen:
|
||
- Der Client hat einen beliebigen Nonce-Key mitgeschickt der dem Server nicht bekannt ist.
|
||
- Der Nonce-Key ist schon länger abgelaufen und wurde gelöscht. Abgelaufene Nonce-Keys werden nach einigen Tagen
|
||
gelöscht.
|
||
|
||
### <a name="error-7417"></a> #7417 - Digest nonce expired
|
||
Server-Nonce ist abgelaufen. Nonce-Keys sind maximal 24 Stunden gültig und danach muss die Authentifizierung neu
|
||
initialisiert werden. Beim erneuten Zugriff (auch schon beim Ausliefern des Fehlers) wird automatisch ein neuer
|
||
Nonce-Key erzeugt und dem Client mitgeteilt (im www-authenticate Header). Der Client muss bei den weiteren
|
||
Zugriffen den neuen Nonce-Key verwenden.
|
||
|
||
### <a name="error-7418"></a> #7418 - Auth username empty
|
||
Der Benutzername darf nicht leer sein.
|
||
|
||
### <a name="error-7419"></a> #7419 - Authorization type not allowed
|
||
Authorization-Header war vorhanden, aber die Authentifizierung-Methode ist nicht erlaubt. Vermutlich Zugriff mit
|
||
Basic-Auth.
|
||
|
||
### <a name="error-7420"></a> #7420 - Digest nonce count not matching
|
||
Fehler nicht möglich: Der Nonce-Count wird momentan nicht geprüft.
|
||
|
||
### <a name="error-7421"></a> #7421 - Missing Permission
|
||
API-Account hat nicht die benötigten Berechtigungen
|
||
|
||
## Routing-Fehler
|
||
### <a name="error-7431"></a> #7431 - Route not found
|
||
### <a name="error-7432"></a> #7432 - Method not allowed
|
||
### <a name="error-7433"></a> #7433 - API-Method not found
|
||
|
||
## Endpoint-Fehler
|
||
### <a name="error-7451"></a> #7451 - Bad Request
|
||
### <a name="error-7452"></a> #7452 - Resource not found
|
||
Mögliche Ursachen:
|
||
- Das Ergebnis wurde über Filter zu stark begrenzt.
|
||
- Beim Abrufen einer einzelnen Resource wurde eine nicht existierende ID angegeben.
|
||
- Über die Paginierung wurde eine zu hohe Seite eingestellt. Siehe `pagination`-Property; der Wert von
|
||
`page_current` darf nicht über dem von `page_last` liegen.
|
||
- Die entsprechende Datenbanktabelle hat keine Inhalte.
|
||
|
||
### <a name="error-7453"></a> #7453 - Validation error
|
||
Dieser Fehler kann nur beim Ändern oder Anlegen von Resourcen auftreten. Bei der Validierung der Eingabedaten
|
||
ist ein Fehler aufgetreten.
|
||
|
||
In diesem Fall beinhaltet der Error-Response das Property `details`, das Aufschluss über die fehlerhaften Felder
|
||
gibt.
|
||
|
||
### <a name="error-7454"></a> #7454 - Invalid argument
|
||
Es wurde ein unzulässiger Request-Parameter (GET-Parameter) verwendet z.B. ein Filter-Parameter der nicht
|
||
zulässig ist.
|
||
|
||
### <a name="error-7455"></a> #7455 - Malformed request body
|
||
Das JSON- oder XML-Dokument im Request-Body konnte nicht dekodiert werden. Ungültige Zeichen oder eine
|
||
fehlerhafte Struktur können die Ursache sein. Überprüfen Sie die Daten ggf. mit Online-Validatoren.
|
||
|
||
### <a name="error-7456"></a> #7456 - Content type not supported
|
||
Der Request-Body konnte nicht dekodiert werden, weil kein gültiger Content-Type übergeben wurde.
|
||
|
||
## Webserver-Konfiguration fehlerhaft
|
||
|
||
### <a name="error-7481"></a> #7481 - Webserver-Konfiguration fehlerhaft (nicht genauer beschrieben)
|
||
|
||
### <a name="error-7482"></a> #7482 - PATH_INFO ist nicht gesetzt oder leer
|
||
Die PHP-Variable `$_SERVER['PATH_INFO']` ist nicht gesetzt oder leer, obwohl die aufgerufene URL darauf
|
||
schließen lässt dass die Variable gefüllt sein müsste. Der Fehler deutet darauf hin dass die
|
||
Webserver-Konfiguration fehlerhaft ist. Sie können sich mit der <a href="#failsafe">Failsafe-Variante</a>
|
||
behelfen. Damit kann die API auch ohne eine spezielle Webserver-Konfiguration verwendet werden, z.B. auf einem
|
||
Webspace bei dem die Änderung der Webserver-Konfiguration eingeschränkt ist.
|
||
Zur Fehlerbehebung siehe Abschnitt <a href="#nginx">Nginx-Konfiguration</a> oder
|
||
<a href="#apache">Apache-Konfiguration</a>
|
||
|
||
- title: Debug-Modus
|
||
content: |
|
||
Im Auslieferungszustand gibt die REST-API bei Fehlern nur ausgewählte Fehlertypen zurück (siehe
|
||
<a href="#fehler_codes">Fehler-Codes</a>).
|
||
|
||
### Beispiel Fehler-Response; Debug-Modus inaktiv
|
||
```json
|
||
{
|
||
"error": {
|
||
"code": 7482,
|
||
"http_code": 500,
|
||
"message": "Webserver configuration incorrect. Pathinfo is invalid.",
|
||
"href": "http://www.example.com/api/docs.html#error-7482"
|
||
}
|
||
}
|
||
```
|
||
|
||
Zur Fehleranalyse kann der Debug-Modus aktiviert werden um zusätzliche Informationen über Request- und
|
||
Konfigurationsvariablen zu erhalten. Debug-Informationen werden nur beim Auftreten eines Fehlers angehangen.
|
||
|
||
### Beispiel Fehler-Response mit aktivierten Debug-Modus
|
||
```json
|
||
{
|
||
"error": {
|
||
"code": 7482,
|
||
"http_code": 500,
|
||
"message": "Webserver configuration incorrect. Pathinfo is invalid.",
|
||
"href": "http://www.example.com/api/docs.html#error-7482"
|
||
},
|
||
"debug": {
|
||
"router": {
|
||
"controllerClass": "Xentral\\Modules\\Api\\Controller\\Version1\\StartController",
|
||
"controllerAction": "indexAction",
|
||
"resourceClass": "Xentral\\Modules\\Api\\Resource\\Resource",
|
||
"routerParams": []
|
||
},
|
||
"request": {
|
||
"isFailsafe": false,
|
||
"pathInfo": {
|
||
"actual": "",
|
||
"expected": "/v1/adressen/123"
|
||
},
|
||
"info": {
|
||
"method": "PUT",
|
||
"requestUri": "/api/v1/adressen/123",
|
||
"fullUri": "http://www.example.com/api/v1/adressen/123"
|
||
},
|
||
"serverParams": {
|
||
|
||
// Ausgabe entfernt; wie PHP-Variable `$_SERVER`
|
||
|
||
},
|
||
"header": {
|
||
"Content-Type": "application/json",
|
||
"Authorization": "Digest .........",
|
||
"Host": "www.example.com",
|
||
"Accept": "application/json"
|
||
},
|
||
"getParams": [],
|
||
"postParams": [],
|
||
"additionalParams": []
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
## Debug-Modus aktivieren
|
||
|
||
**Der Debug-Modus ist nicht für Produktiv-Systeme geeignet und sollte nur zur Fehlersuche aktiviert werden.**
|
||
|
||
### Debug-Modus global aktivieren
|
||
|
||
In der Datei `/www/api/index.php` die Konstante `DEBUG_MODE` auf `true` stellen.
|
||
|
||
```php
|
||
define('DEBUG_MODE', true);
|
||
```
|
||
|
||
Der Debug-Modus ist dann global für alle API-Accounts aktiviert. Debug-Informationen werden aber nur beim
|
||
Auftreten eines Fehlers erzeugt.
|
||
|
||
- title: PHP Beispiel-Clients
|
||
content: |
|
||
## cURL
|
||
```php
|
||
if (!function_exists('curl_version')) {
|
||
throw new Exception('curl-Extension fehlt');
|
||
}
|
||
|
||
$api = array(
|
||
'url' => 'http://www.example.com/api/',
|
||
'resource' => 'v1/adressen?page=1&items=5',
|
||
'username' => 'Your-Username',
|
||
'password' => 'Your-Passwort',
|
||
);
|
||
|
||
$options = array(
|
||
CURLOPT_URL => $api['url'] . $api['resource'],
|
||
CURLOPT_HEADER => false,
|
||
CURLOPT_HTTPHEADER => array('Accept: application/json'), // oder 'application/xml'
|
||
CURLOPT_RETURNTRANSFER => true,
|
||
CURLOPT_FOLLOWLOCATION => true,
|
||
CURLOPT_HTTPAUTH => CURLAUTH_DIGEST, // Digest Authentifizierung
|
||
CURLOPT_USERPWD => $api['username'] . ':' . $api['password'],
|
||
);
|
||
|
||
$ch = curl_init();
|
||
curl_setopt_array($ch, $options);
|
||
$response = curl_exec($ch);
|
||
|
||
if (curl_errno($ch)) {
|
||
throw new Exception(curl_error($ch));
|
||
}
|
||
|
||
$contentType = curl_getinfo($ch, CURLINFO_CONTENT_TYPE);
|
||
$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
|
||
$result = json_decode($response, true);
|
||
|
||
echo "<pre>";
|
||
echo "<h1>HTTP-Status: {$statusCode}</h1>";
|
||
echo "<h2>Content-Type: {$contentType}</h2>";
|
||
var_dump($result);
|
||
echo "</pre>";
|
||
|
||
if ($ch != null) {
|
||
curl_close($ch);
|
||
}
|
||
```
|
||
|
||
## Guzzle
|
||
```php
|
||
if (!class_exists('GuzzleHttp\Client')) {
|
||
throw new Exception('Guzzle konnte nicht gefunden werden');
|
||
}
|
||
|
||
$api = array(
|
||
'url' => 'http://www.example.com/api/',
|
||
'resource' => 'v1/adressen?page=1&items=5',
|
||
'username' => 'Your-Username',
|
||
'password' => 'Your-Passwort',
|
||
);
|
||
|
||
$client = new GuzzleHttp\Client(array(
|
||
'base_url' => $api['url'],
|
||
));
|
||
|
||
$options = array(
|
||
'headers' => array('Accept' => 'application/json'), // oder 'application/xml'
|
||
'auth' => array($api['username'], $api['password'], 'digest'), // Digest Authentifizierung
|
||
);
|
||
$request = $client->createRequest('GET', $api['resource'], $options);
|
||
$response = $client->send($request);
|
||
|
||
$contentType = $response->getHeader('Content-Type');
|
||
$statusCode = $response->getStatusCode();
|
||
$statusMsg = $response->getReasonPhrase();
|
||
$result = json_decode($response->getBody()->getContents(), true);
|
||
|
||
echo "<pre>";
|
||
echo "<h1>HTTP-Status: {$statusCode} {$statusMsg}</h1>";
|
||
echo "<h2>Content-Type: {$contentType}</h2>";
|
||
var_dump($result);
|
||
echo "</pre>";
|
||
```
|
||
|
||
- title: Webserver-Konfiguration
|
||
content: |
|
||
## <a name="apache"></a> Apache
|
||
|
||
Damit die API richtig funktioniert sollte `mod_rewrite` aktiviert sein.
|
||
|
||
Der Aufruf ohne `mod_rewrite` ist ebenfalls möglich, dann muss allerdings die index.php in der URL vorkommen:
|
||
z.B.: `/www/api/index.php/v1/adressen`
|
||
|
||
### mod_rewrite aktivieren
|
||
```
|
||
$ sudo a2enmod rewrite
|
||
Enabling module rewrite.
|
||
To activate the new configuration, you need to run:
|
||
systemctl restart apache2
|
||
|
||
$ sudo systemctl restart apache2
|
||
```
|
||
|
||
### .htaccess Einbindung erlauben
|
||
Bei Ubuntu- und Debian-basierten Betriebssystemen geschieht das für den gesamten Webserver in der Datei
|
||
`/etc/apache2/apache2.conf`. Dort nach folgendem Eintrag suchen:
|
||
|
||
```
|
||
<Directory /var/www/>
|
||
Options Indexes FollowSymLinks
|
||
AllowOverride None
|
||
Require all granted
|
||
</Directory>
|
||
```
|
||
|
||
Hier muss das `AllowOverride None` zu `AllowOverride All` geändert werden. Anschließend die Apache2-Konfiguration
|
||
neu einlesen mit: `sudo service apache2 reload`.
|
||
|
||
Wichtig: Diese Anpassung ist nur exemplarisch. Aus Sicherheitsgründen sollten Sie die Einstellung nicht für
|
||
den gesamten Webserver erlauben. Um die Einstellung für einzelne Webseites vorzunehmen, sollten sie die
|
||
entsprechende VHost-Konfiguration anpassen.
|
||
|
||
### Beispiel VHost-Konfiguration für Apache 2.4
|
||
```
|
||
<VirtualHost *:80>
|
||
# ServerName auskommentieren falls Sie per IP zugreifen
|
||
ServerName xentral.example.com
|
||
ServerAdmin webmaster@example.com
|
||
|
||
# Pfad zum www-Verzeichnis ihrer Xentral-Installation
|
||
DocumentRoot /var/www/xentral/www
|
||
|
||
<Directory /var/www/xentral/www/>
|
||
AllowOverride All
|
||
Require all granted
|
||
</Directory>
|
||
|
||
ErrorLog ${APACHE_LOG_DIR}/xentral-error.log
|
||
CustomLog ${APACHE_LOG_DIR}/xentral-access.log combined
|
||
</VirtualHost>
|
||
```
|
||
|
||
## <a name="nginx"></a> Nginx
|
||
|
||
### Beispiel-Konfiguration
|
||
|
||
```
|
||
server {
|
||
listen 80 default_server;
|
||
listen [::]:80 default_server;
|
||
|
||
root /var/www/xentral/www;
|
||
|
||
index index.php index.html index.htm;
|
||
|
||
server_name www.example.com;
|
||
|
||
location / {
|
||
# First attempt to serve request as file, then
|
||
# as directory, then fall back to displaying a 404.
|
||
try_files $uri $uri/ =404;
|
||
}
|
||
|
||
location /api/ {
|
||
# '/api/' befindet sich relativ zum Document-Root und muss ggf. angepasst werden.
|
||
try_files $uri $uri/ @xentral_api;
|
||
}
|
||
|
||
location @xentral_api {
|
||
# '/api/' befindet sich relativ zum Document-Root und muss ggf. angepasst werden.
|
||
rewrite ^/api/(.*)$ /api/index.php/$1 last;
|
||
}
|
||
|
||
location ~ [^/]\.php(/|$) {
|
||
# Path Info korrekt an PHP-Skript weitergeben
|
||
fastcgi_split_path_info ^(.+?\.php)(/.*)$;
|
||
if (!-f $document_root$fastcgi_script_name) {
|
||
return 404;
|
||
}
|
||
|
||
# Mitigate https://httpoxy.org/ vulnerabilities
|
||
fastcgi_param HTTP_PROXY "";
|
||
|
||
# With php-fpm (or other unix sockets):
|
||
fastcgi_pass unix:/var/run/php/php-fpm.sock;
|
||
# With php-cgi (or other tcp sockets):
|
||
#fastcgi_pass 127.0.0.1:9000;
|
||
|
||
fastcgi_index index.php;
|
||
|
||
include fastcgi_params;
|
||
fastcgi_param PATH_INFO $fastcgi_path_info;
|
||
fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info;
|
||
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
|
||
}
|
||
|
||
# deny access to .htaccess files, if Apache's document root concurs with nginx's one
|
||
location ~ /\.ht {
|
||
deny all;
|
||
}
|
||
}
|
||
```
|
||
|
||
Außerdem muss `cgi.fix_pathinfo` in der php.ini auf `1` gestellt sein (Default).
|
||
|
||
Quelle: <https://www.nginx.com/resources/wiki/start/topics/examples/phpfcgi/>
|
||
|
||
## <a name="failsafe"></a> Failsafe-Alternative
|
||
|
||
Sollte die Konfiguration des Webservers Probleme bereiten, oder aus anderen Gründen nicht möglich sein, so gibt
|
||
es die Möglichkeit die API ohne Anpassung der Webserver-Konfiguration zu nutzen.
|
||
|
||
Der Endpunkt wird dann nicht als Teil der Pfades übergeben, sondern als Query-Parameter `path`.
|
||
|
||
Beispiel: `/api/index.php?path=/v1/artikelkategorien&sort=bezeichnung`
|
||
|
||
- title: Standard API-Aufrufe
|
||
content: |
|
||
Es gibt auch die Möglichkeit die standard API über die neue URL abzurufen.
|
||
|
||
Struktur: `http://www.example.com/api/{Action}`
|
||
|
||
Beispiel: `http://www.example.com/api/ArtikelGet`
|
||
|
||
Eine Übersicht der möglichen Requests/Actions mit Beispielen:
|
||
<https://xentral.biz/helpdesk/api>
|
||
|
||
**In diesem Fall erwartet die API immer einen POST-Request und die Nutzdaten müssen im Request-Body
|
||
mitgeschickt werden.**
|
||
|
||
- title: Test-System
|
||
content: |
|
||
Um auf die API eines <a href="https://xentral.com/helpdesk/testsystem" target="_blank">Test-Systems</a>
|
||
zugreifen zu können, kann im HTTP-Header `MultiDb` der Datenbankname des Test-Systems angegeben werden.
|
||
Der Header muss bei jedem Request mitgeschickt werden.
|
||
|
||
### Beispiel HTTP-Request
|
||
```http
|
||
GET /api/v1/adressen HTTP/1.1
|
||
Host: www.example.com
|
||
Accept: application/json
|
||
MultiDb: xentral_test
|
||
```
|
||
|
||
|
||
/v1/aboartikel:
|
||
get:
|
||
displayName: Abo-Artikel abrufen
|
||
description: |
|
||
Endpunkt zum Abrufen von Abo-Artikeln.
|
||
|
||
Permission: `list_subscriptions`
|
||
queryParameters:
|
||
bezeichnung:
|
||
description: Suche nach Abo-Artikel-Bezeichnung (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
bezeichnung_equals:
|
||
description: Suche nach Abo-Artikel-Bezeichnung (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
bezeichnung_startswith:
|
||
description: Suche nach Abo-Artikel-Bezeichnung (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
bezeichnung_endswith:
|
||
description: Suche nach Abo-Artikel-Bezeichnung (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
rabatt:
|
||
description: Suche nach Rabatt in Prozent (genaue Übereinstimmung)
|
||
type: number
|
||
multipleOf: 0.01
|
||
required: false
|
||
rabatt_gt:
|
||
description: Suche nach Rabatt in Prozent (Rabatt größer Suchwert)
|
||
type: number
|
||
multipleOf: 0.01
|
||
required: false
|
||
rabatt_gte:
|
||
description: Suche nach Rabatt in Prozent (Rabatt größer gleich Suchwert)
|
||
type: number
|
||
multipleOf: 0.01
|
||
required: false
|
||
rabatt_lt:
|
||
description: Suche nach Rabatt in Prozent (Rabatt kleiner Suchwert)
|
||
type: number
|
||
multipleOf: 0.01
|
||
required: false
|
||
rabatt_lte:
|
||
description: Suche nach Rabatt in Prozent (Rabatt kleiner gleich Suchwert)
|
||
type: number
|
||
multipleOf: 0.01
|
||
required: false
|
||
preis:
|
||
description: Suche nach Preis (genaue Übereinstimmung)
|
||
type: number
|
||
multipleOf: 0.0001
|
||
required: false
|
||
preis_gt:
|
||
description: Suche nach Preis (Preis größer Suchwert)
|
||
type: number
|
||
multipleOf: 0.0001
|
||
required: false
|
||
preis_gte:
|
||
description: Suche nach Preis (Preis größer gleich Suchwert)
|
||
type: number
|
||
multipleOf: 0.0001
|
||
required: false
|
||
preis_lt:
|
||
description: Suche nach Preis (Preis kleiner Suchwert)
|
||
type: number
|
||
multipleOf: 0.0001
|
||
required: false
|
||
preis_lte:
|
||
description: Suche nach Preis (Preis kleiner gleich Suchwert)
|
||
type: number
|
||
multipleOf: 0.0001
|
||
required: false
|
||
menge:
|
||
description: Suche nach Menge (Menge Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
menge_gt:
|
||
description: Suche nach Menge (Menge größer Suchwert)
|
||
type: integer
|
||
required: false
|
||
menge_gte:
|
||
description: Suche nach Menge (Menge größer gleich Suchwert)
|
||
type: integer
|
||
required: false
|
||
menge_lt:
|
||
description: Suche nach Menge (Menge kleiner Suchwert)
|
||
type: integer
|
||
required: false
|
||
menge_lte:
|
||
description: Suche nach Menge (Menge kleiner gleich Suchwert)
|
||
type: integer
|
||
required: false
|
||
startdatum:
|
||
description: Suche nach Startdatum (Startdatum Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
startdatum_gt:
|
||
description: Suche nach Startdatum (Startdatum größer Suchwert)
|
||
type: string
|
||
required: false
|
||
startdatum_gte:
|
||
description: Suche nach Startdatum (Startdatum größer gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
startdatum_lt:
|
||
description: Suche nach Startdatum (Startdatum kleiner Suchwert)
|
||
type: string
|
||
required: false
|
||
startdatum_lte:
|
||
description: Suche nach Startdatum (Startdatum kleiner gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
enddatum:
|
||
description: Suche nach Enddatum (Enddatum Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
enddatum_gt:
|
||
description: Suche nach Enddatum (Enddatum größer Suchwert)
|
||
type: string
|
||
required: false
|
||
enddatum_gte:
|
||
description: Suche nach Enddatum (Enddatum größer gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
enddatum_lt:
|
||
description: Suche nach Enddatum (Enddatum kleiner Suchwert)
|
||
type: string
|
||
required: false
|
||
enddatum_lte:
|
||
description: Suche nach Enddatum (Enddatum kleiner gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
waehrung:
|
||
description: Suche nach Waehrungscode (ISO3; genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
preisart:
|
||
description: |
|
||
Suche nach Preisart
|
||
|
||
(Gültige Werte `monat`, `monatx`, `jahr`, `wochen`, `30tage`, `360tage` oder `einmalig`)
|
||
type: string
|
||
required: false
|
||
dokumenttyp:
|
||
description: Suche nach Dokument-Typ (Gültige Werte `rechnung` oder `auftrag`)
|
||
type: string
|
||
required: false
|
||
artikel:
|
||
description: Suche nach Artikel-ID (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
adresse:
|
||
description: Suche nach Adressen-ID (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
kundennummer:
|
||
description: Suche nach Kundennummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
gruppe:
|
||
description: Suche nach Abogruppen-ID (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
projekt:
|
||
description: Suche nach Projekt-ID (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=-bezeichnung,rabatt`)
|
||
|
||
Verfügbare Felder: `bezeichnung`, `rabatt`, `preis`, `menge`, `startdatum`, `enddatum`,
|
||
`abgerechnet_bis`, `reihenfolge`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=artikel`)
|
||
|
||
Verfügbare Includes: `gruppe`, `artikel`, `adresse`, `projekt`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Abo-Artikel anlegen
|
||
description: |
|
||
Abo-Artikel anlegen
|
||
|
||
Permission: `create_subscription`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
artikelnummer:
|
||
description: Artikelnummer (Pflichfeld)
|
||
required: true
|
||
type: string
|
||
bezeichnung:
|
||
description: Name des Abo-Artikels (Pflichtfeld)
|
||
required: true
|
||
type: string
|
||
beschreibung:
|
||
description: Abo-Artikel-Beschreibung
|
||
required: false
|
||
type: string
|
||
beschreibung_ersetzen:
|
||
description: |
|
||
Wenn `1`, wird nur die Beschreibung von hier ohne Artikelbeschreibung aus den Stammdaten
|
||
angezeigt. (Default `0`)
|
||
required: false
|
||
type: integer
|
||
startdatum:
|
||
description: Erstes Startdatum (Format `YYYY-MM-DD`) (Default = Aktuelles Datum)
|
||
required: false
|
||
type: date-only
|
||
enddatum:
|
||
description: Enddatum (Format `YYYY-MM-DD`) (Default `0000-00-00`)
|
||
required: false
|
||
type: date-only
|
||
preisart:
|
||
description: |
|
||
Zulässige Werte `monat`, `monatx`, `jahr`, `wochen`, `einmalig`, `30tage`, `360tage`
|
||
|
||
(Default `monat`)
|
||
required: false
|
||
type: string
|
||
zahlzyklus:
|
||
description: abhängig von `preisart` (Default `1`)
|
||
required: false
|
||
type: integer
|
||
dokumenttyp:
|
||
description: Automatisch anlegen als Auftrag oder Rechnung.
|
||
Zulässige Werte `rechnung`, `auftrag` (Default `rechnung`)
|
||
required: false
|
||
type: string
|
||
preis:
|
||
description: Netto Artikelpreis (Default `0.00`)
|
||
required: false
|
||
type: number
|
||
multipleOf: 0.0001
|
||
menge:
|
||
description: Artikelmenge (Default `0`)
|
||
required: false
|
||
type: number
|
||
multipleOf: 0.01
|
||
rabatt:
|
||
description: Rabatt in Prozent (Default `0.00`)
|
||
required: false
|
||
type: number
|
||
multipleOf: 0.01
|
||
waehrung:
|
||
description: Währung; dreistelliger ISO-Code (Default `EUR`)
|
||
required: false
|
||
type: string
|
||
gruppe:
|
||
description: Abo-Gruppen-ID (Default `0`)
|
||
required: false
|
||
type: integer
|
||
adresse:
|
||
description: |
|
||
Adressen-ID (Default `0`)
|
||
|
||
Wird überschrieben wenn Feld `kundennummer` gefüllt ist.
|
||
required: false
|
||
type: integer
|
||
kundennummer:
|
||
description: |
|
||
Kundennummer (kein Default)
|
||
|
||
Wenn gefüllt, wird Adress-ID ermittelt und in Feld `adresse` geschrieben.
|
||
required: false
|
||
type: string
|
||
projekt:
|
||
description: |
|
||
Projekt-ID (Default `0`)
|
||
|
||
Die erstellte Rechnung läuft auf dieses Projekt
|
||
required: false
|
||
type: integer
|
||
reihenfolge:
|
||
description: |
|
||
Wenn mehrere Artikel in einer Rechnung vorkommen, kann die Reihenfolge der Artikel damit
|
||
angepasst werden (Default `1`)
|
||
required: false
|
||
type: integer
|
||
example: |
|
||
{
|
||
"bezeichnung": "Abo-Artikel 001",
|
||
"artikelnummer": "700006",
|
||
"preis": 9.52,
|
||
"zahlzyklus": 2,
|
||
"preisart": "wochen",
|
||
"kundennummer": "10001"
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegter Abo-Artikel wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 21,
|
||
"bezeichnung": "Abo-Artikel 001",
|
||
"beschreibung": "",
|
||
"beschreibung_ersetzen": 0,
|
||
"startdatum": "2019-05-27",
|
||
"enddatum": "0000-00-00",
|
||
"abgerechnet_bis": "0000-00-00",
|
||
"zahlzyklus": 2,
|
||
"preis": "9.5200",
|
||
"rabatt": "0.00",
|
||
"waehrung": "EUR",
|
||
"menge": 0,
|
||
"preisart": "wochen",
|
||
"dokumenttyp": "rechnung",
|
||
"artikel": 6,
|
||
"gruppe": 0,
|
||
"adresse": 3,
|
||
"kundennummer": "10000",
|
||
"reihenfolge": 1,
|
||
"projekt": 0
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelnen Abo-Artikel abrufen oder bearbeiten.
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Abo-Artikel-ID
|
||
get:
|
||
displayName: Einzelnen Abo-Artikel abrufen
|
||
description: |
|
||
Einzelnen Abo-Artikel abrufen
|
||
|
||
Permission: `edit_subscription`
|
||
put:
|
||
displayName: Abo-Artikel bearbeiten
|
||
description: |
|
||
Abo-Artikel bearbeiten (Felder siehe "Abo-Artikel anlegen")
|
||
|
||
Permission: `view_subscription`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"bezeichnung": "Abo-Artikel 001",
|
||
"beschreibung_ersetzen": 0,
|
||
"startdatum": "2019-01-01",
|
||
"enddatum": "2019-12-31",
|
||
"rabatt": "3.00",
|
||
"zahlzyklus": 1,
|
||
"waehrung": "EUR",
|
||
"preisart": "wochen",
|
||
"dokumenttyp": "rechnung",
|
||
"kundennummer": "10000"
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierter Abo-Artikel wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 1,
|
||
"bezeichnung": "Abo-Artikel 001",
|
||
"beschreibung": "",
|
||
"beschreibung_ersetzen": 0,
|
||
"startdatum": "2019-01-01",
|
||
"enddatum": "2019-12-31",
|
||
"abgerechnet_bis": "2019-07-31",
|
||
"zahlzyklus": 1,
|
||
"preis": "0.17",
|
||
"rabatt": "3.00",
|
||
"waehrung": "EUR",
|
||
"menge": 100,
|
||
"preisart": "wochen",
|
||
"dokumenttyp": "rechnung",
|
||
"artikel": 2,
|
||
"gruppe": 1,
|
||
"adresse": 3,
|
||
"kundennummer": "10000",
|
||
"reihenfolge": 1,
|
||
"projekt": 0
|
||
}
|
||
}
|
||
|
||
delete:
|
||
displayName: Abo-Artikel löschen
|
||
description: |
|
||
Endpunkt zum Löschen von Abo-Artikeln
|
||
|
||
Permission: `delete_subscription`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; id des gelöschten Aboartikels wird zurückgegeben
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 1
|
||
}
|
||
}
|
||
404:
|
||
description: id wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://localhost/xentral/20.1/www/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
|
||
/v1/abogruppen:
|
||
get:
|
||
displayName: Abo-Gruppen abrufen
|
||
description: |
|
||
Endpunkt zum Abrufen von Abo-Gruppen
|
||
|
||
Permission: `list_subscription_groups`
|
||
queryParameters:
|
||
bezeichnung:
|
||
description: Suche nach bestimmter Abo-Gruppen-Bezeichnung (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
bezeichnung_equals:
|
||
description: Suche nach bestimmter Abo-Gruppen-Bezeichnung (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
bezeichnung_startswith:
|
||
description: Suche nach bestimmter Abo-Gruppen-Bezeichnung (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
bezeichnung_endswith:
|
||
description: Suche nach bestimmter Abo-Gruppen-Bezeichnung (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
gruppensumme:
|
||
description: Suche nach Gruppensumme-Kennzeichen (1 = aktiv / 0 = inaktiv)
|
||
type: integer
|
||
required: false
|
||
rabatt:
|
||
description: Suche nach Rabatt in Prozent (genaue Übereinstimmung)
|
||
type: number
|
||
multipleOf: 0.01
|
||
required: false
|
||
rabatt_gt:
|
||
description: Suche nach Rabatt in Prozent (Rabatt größer Suchwert)
|
||
type: number
|
||
multipleOf: 0.01
|
||
required: false
|
||
rabatt_gte:
|
||
description: Suche nach Rabatt in Prozent (Rabatt größer gleich Suchwert)
|
||
type: number
|
||
multipleOf: 0.01
|
||
required: false
|
||
rabatt_lt:
|
||
description: Suche nach Rabatt in Prozent (Rabatt kleiner Suchwert)
|
||
type: number
|
||
multipleOf: 0.01
|
||
required: false
|
||
rabatt_lte:
|
||
description: Suche nach Rabatt in Prozent (Rabatt kleiner gleich Suchwert)
|
||
type: number
|
||
multipleOf: 0.01
|
||
required: false
|
||
projekt:
|
||
description: Suche nach bestimmter Projekt-ID (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=-bezeichnung,rabatt`)
|
||
|
||
Verfügbare Felder: `bezeichnung`, `rabatt`, `reihenfolge`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=projekt`)
|
||
|
||
Verfügbare Includes: `projekt`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Abo-Gruppe anlegen
|
||
description: |
|
||
Abo-Gruppe anlegen
|
||
|
||
Permission: `create_subscription_group`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
bezeichnung:
|
||
description: Name der Gruppe; erscheint auf der Rechnung (Pflichtfeld)
|
||
required: true
|
||
type: string
|
||
beschreibung:
|
||
description: Beschreibung der Gruppe; erscheint auf der Rechnung (optional)
|
||
required: false
|
||
type: string
|
||
rabatt:
|
||
description: Rabatt in Prozent (Default = 0.00)
|
||
required: false
|
||
type: number
|
||
multipleOf: 0.01
|
||
gruppensumme:
|
||
description: Nach jeder Auflistung der Artikel einer Gruppe, wird eine Gruppensumme auf dem Beleg
|
||
ausgegeben (1 = aktiv / 0 = inaktiv) (Default = 0)
|
||
required: false
|
||
type: integer
|
||
projekt:
|
||
description: |
|
||
Projekt-ID (Default = 0)
|
||
|
||
Die erstellte Rechnung läuft auf dieses Projekt
|
||
required: false
|
||
type: integer
|
||
reihenfolge:
|
||
description: Wenn mehrere Gruppen in einer Rechnung vorkommen, kann die Reihenfolge der Gruppen damit
|
||
angepasst werden (ab Version 18.3) (Default = 0)
|
||
required: false
|
||
type: integer
|
||
example: |
|
||
{
|
||
"bezeichnung": "Abo-Gruppe Verbrauchsmaterial",
|
||
"rabatt": 2.50,
|
||
"gruppensumme": 1,
|
||
"projekt": 1,
|
||
"reihenfolge": 123
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegte Abo-Gruppe wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 14,
|
||
"bezeichnung": "Abo-Gruppe Verbrauchsmaterial",
|
||
"beschreibung": "",
|
||
"rabatt": "2.50",
|
||
"gruppensumme": 1,
|
||
"projekt": 1,
|
||
"reihenfolge": 123
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelne Abo-Gruppe abrufen oder bearbeiten
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Abo-Gruppen-ID
|
||
get:
|
||
displayName: Einzelne Abo-Gruppe abrufen
|
||
description: |
|
||
Einzelne Abo-Gruppe abrufen
|
||
|
||
Permission: `view_subscription_group`
|
||
put:
|
||
displayName: Abo-Gruppe bearbeiten
|
||
description: |
|
||
Abo-Gruppe bearbeiten (Felder siehe "Abo-Gruppe anlegen")
|
||
|
||
Permission: `edit_subscription_group`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"bezeichnung": "Abo-Gruppe Verbrauchsmaterial",
|
||
"rabatt": 3.00
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierte Abo-Gruppe wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 14,
|
||
"bezeichnung": "Abo-Gruppe Verbrauschsmaterial",
|
||
"beschreibung": "",
|
||
"rabatt": "3.00",
|
||
"gruppensumme": 1,
|
||
"projekt": 1,
|
||
"reihenfolge": 123
|
||
}
|
||
}
|
||
|
||
|
||
/v1/adressen:
|
||
description: Adressen anlegen, bearbeiten und abrufen
|
||
get:
|
||
displayName: Adressliste abrufen
|
||
description: |
|
||
Adressenliste abrufen
|
||
|
||
Permission: `list_addresses`
|
||
queryParameters:
|
||
kundennummer:
|
||
description: Suche nach bestimmter Adresse mit Kundennummer
|
||
type: string
|
||
required: false
|
||
default: ""
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
responses:
|
||
200:
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": [
|
||
{
|
||
"id": 7,
|
||
"typ": "firma",
|
||
"sprache": "deutsch",
|
||
"name": "Schrauben Meier",
|
||
"abteilung": "",
|
||
"unterabteilung": "",
|
||
"land": "DE",
|
||
"strasse": "Musterstrasse 6",
|
||
"ort": "Musterdorf",
|
||
"plz": "13245",
|
||
"telefon": "12345678",
|
||
"telefax": "",
|
||
"mobile": "",
|
||
"email": "schrauben@meiermusterdorf.de",
|
||
"projekt": 1,
|
||
"...": "Ausgabe gekürzt"
|
||
},
|
||
{
|
||
"id": 8,
|
||
"...": "Ausgabe gekürzt"
|
||
}
|
||
],
|
||
"pagination": {
|
||
"items_total": 50,
|
||
"items_current": 20,
|
||
"items_per_page": 20,
|
||
"page_current": 1,
|
||
"page_last": 3
|
||
}
|
||
}
|
||
post:
|
||
displayName: Adressen anlegen
|
||
description: |
|
||
Neue Adresse anlegen
|
||
|
||
Permission: `create_address`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"typ": "firma",
|
||
"sprache": "deutsch",
|
||
"name": "Max Muster",
|
||
"land": "DE",
|
||
"strasse": "Musterstrasse 6",
|
||
"ort": "Musterdorf",
|
||
"plz": "12345",
|
||
"telefon": "0821123456789",
|
||
"telefax": "0821123456790",
|
||
"email": "info@maxmuellermuster.de",
|
||
"projekt": 1
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Angelegte Adresse wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 33,
|
||
"typ": "firma",
|
||
"sprache": "deutsch",
|
||
"name": "Max Muster",
|
||
"abteilung": "",
|
||
"unterabteilung": "",
|
||
"land": "DE",
|
||
"strasse": "Musterstrasse 6",
|
||
"ort": "Musterdorf",
|
||
"plz": "12345",
|
||
"telefon": "0821123456789",
|
||
"telefax": "0821123456790",
|
||
"mobile": "",
|
||
"email": "info@maxmuellermuster.de",
|
||
"projekt": 1,
|
||
"...": "Ausgabe gekürzt"
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelne Adresse per ID abrufen
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Adressen-ID
|
||
get:
|
||
displayName: Einzelne Adresse abrufen
|
||
description: |
|
||
Einzelne Adresse abrufen
|
||
|
||
Permission: `view_address`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 7,
|
||
"typ": "firma",
|
||
"sprache": "deutsch",
|
||
"name": "Schrauben Meier GmbH",
|
||
"abteilung": "",
|
||
"unterabteilung": "",
|
||
"land": "DE",
|
||
"strasse": "Musterstrasse 6",
|
||
"ort": "Musterdorf",
|
||
"plz": "13245",
|
||
"telefon": "12345678",
|
||
"telefax": "",
|
||
"mobile": "",
|
||
"email": "schrauben@meiermusterdorf.de",
|
||
"projekt": 1,
|
||
"...": "Ausgabe gekürzt"
|
||
}
|
||
}
|
||
404:
|
||
description: Adresse wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
put:
|
||
displayName: Adresse bearbeiten
|
||
description: |
|
||
Adresse bearbeiten
|
||
|
||
Permission: `edit_address`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"name": "Schrauben Meier GmbH",
|
||
"strasse": "Dorfstrasse 123",
|
||
"ort": "Musterdorf",
|
||
"plz": "12345",
|
||
"telefon": "0987654321"
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierte Adresse wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 7,
|
||
"typ": "firma",
|
||
"sprache": "deutsch",
|
||
"name": "Schrauben Meier GmbH",
|
||
"abteilung": "",
|
||
"unterabteilung": "",
|
||
"land": "DE",
|
||
"strasse": "Dorfstrasse 123",
|
||
"ort": "Musterdorf",
|
||
"plz": "12345",
|
||
"telefon": "0987654321",
|
||
"telefax": "",
|
||
"mobile": "",
|
||
"email": "schrauben@meiermusterdorf.de",
|
||
"projekt": 1,
|
||
"...": "Ausgabe gekürzt"
|
||
}
|
||
}
|
||
|
||
|
||
/v2/adressen:
|
||
description: Adressen abrufen
|
||
get:
|
||
displayName: Adressenliste abrufen
|
||
description: |
|
||
Adressenliste abrufen
|
||
|
||
Permission: `list_addresses`
|
||
queryParameters:
|
||
projekt:
|
||
description: Suche nach bestimmter Projekt-ID (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
firma:
|
||
description: Suche nach bestimmter Firmen-ID (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
rolle:
|
||
description: Suche nach bestimmter Rolle (Wert `kunde` oder `lieferant`)
|
||
type: string
|
||
required: false
|
||
typ:
|
||
description: Suche nach bestimmtem Adresstyp (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
sprache:
|
||
description: Suche nach bestimmter Sprache (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
waehrung:
|
||
description: Suche nach bestimmtem Währungscode (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
land:
|
||
description: Suche nach bestimmtem Ländercode (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kundennummer:
|
||
description: Suche nach bestimmter Kundennummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kundennummer_equals:
|
||
description: Suche nach bestimmter Kundennummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kundennummer_startswith:
|
||
description: Suche nach bestimmter Kundennummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
kundennummer_endswith:
|
||
description: Suche nach bestimmter Kundennummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
lieferantennummer:
|
||
description: Suche nach bestimmter Lieferantennummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
lieferantennummer_equals:
|
||
description: Suche nach bestimmter Lieferantennummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
lieferantennummer_startswith:
|
||
description: Suche nach bestimmter Lieferantennummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
lieferantennummer_endswith:
|
||
description: Suche nach bestimmter Lieferantennummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
mitarbeiternummer:
|
||
description: Suche nach bestimmter Mitarbeiternummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
mitarbeiternummer_equals:
|
||
description: Suche nach bestimmter Mitarbeiternummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
mitarbeiternummer_startswith:
|
||
description: Suche nach bestimmter Mitarbeiternummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
mitarbeiternummer_endswith:
|
||
description: Suche nach bestimmter Mitarbeiternummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
email:
|
||
description: Suche nach bestimmter E-Mail-Adresse (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
email_equals:
|
||
description: Suche nach bestimmter E-Mail-Adresse (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
email_startswith:
|
||
description: Suche nach bestimmter E-Mail-Adresse (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
email_endswith:
|
||
description: Suche nach bestimmter E-Mail-Adresse (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
freifeld[1-10]:
|
||
description: |
|
||
Suche nach bestimmtem Wert im Freifeld1 bis Freifeld10 (ungefähre Übereinstimmung)
|
||
|
||
(Beispiel: `freifeld3=42`)
|
||
type: string
|
||
required: false
|
||
freifeld[1-10]_equals:
|
||
description: |
|
||
Suche nach bestimmtem Wert im Freifeld1 bis Freifeld10 (genaue Übereinstimmung)
|
||
|
||
(Beispiel: `freifeld3_equals=42`)
|
||
type: string
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=name,-kundennummer`)
|
||
|
||
Verfügbare Felder: `name`, `kundennummer`, `lieferantennummer`, `mitarbeiternummer`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
responses:
|
||
200:
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": [
|
||
{
|
||
"id": 7,
|
||
"rolle": "lieferant",
|
||
"typ": "firma",
|
||
"sprache": "deutsch",
|
||
"name": "Schrauben Meier",
|
||
"abteilung": "",
|
||
"unterabteilung": "",
|
||
"land": "DE",
|
||
"strasse": "Musterstrasse 6",
|
||
"ort": "Musterdorf",
|
||
"plz": "13245",
|
||
"telefon": "12345678",
|
||
"telefax": "",
|
||
"mobile": "",
|
||
"email": "schrauben@meiermusterdorf.de",
|
||
"projekt": 1,
|
||
"...": "Ausgabe gekürzt"
|
||
},
|
||
{
|
||
"id": 8,
|
||
"...": "Ausgabe gekürzt"
|
||
}
|
||
],
|
||
"pagination": {
|
||
"items_total": 50,
|
||
"items_current": 20,
|
||
"items_per_page": 20,
|
||
"page_current": 1,
|
||
"page_last": 3
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelne Adresse per ID abrufen
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Adressen-ID
|
||
get:
|
||
displayName: Einzelne Adresse abrufen
|
||
description: |
|
||
Einzelne Adresse abrufen
|
||
|
||
Permission: `view_address`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 7,
|
||
"rolle": "lieferant",
|
||
"typ": "firma",
|
||
"sprache": "deutsch",
|
||
"name": "Schrauben Meier GmbH",
|
||
"abteilung": "",
|
||
"unterabteilung": "",
|
||
"land": "DE",
|
||
"strasse": "Musterstrasse 6",
|
||
"ort": "Musterdorf",
|
||
"plz": "13245",
|
||
"telefon": "12345678",
|
||
"telefax": "",
|
||
"mobile": "",
|
||
"email": "schrauben@meiermusterdorf.de",
|
||
"projekt": 1,
|
||
"...": "Ausgabe gekürzt"
|
||
}
|
||
}
|
||
404:
|
||
description: Adresse wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
|
||
|
||
/v1/adresstyp:
|
||
description: Adresstyp anlegen, bearbeiten und abrufen
|
||
get:
|
||
displayName: Adresstypen abrufen
|
||
description: |
|
||
Adresstypen abrufen
|
||
|
||
Permission: `list_address_types`
|
||
queryParameters:
|
||
bezeichnung:
|
||
description: Adresstyp mit bestimmter Bezeichnung suchen (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
bezeichnung_exakt:
|
||
description: Adresstyp mit bestimmter Bezeichnung suchen (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
type:
|
||
description: |
|
||
Nach bestimmten Typ filtern (genaue Übereinstimmung)
|
||
|
||
Mögliche Werte: `herr`, `frau`, `firma`
|
||
type: string
|
||
required: false
|
||
projekt:
|
||
description: Adresstyp eines Projekts filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
netto:
|
||
description: Netto-Adresstypen filtern (1 = netto / 0 = brutto)
|
||
type: boolean
|
||
required: false
|
||
aktiv:
|
||
description: Aktive/Inaktive Adresstypen filtern (1 = aktiv / 0 = inaktiv)
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=type,-bezeichnung`)
|
||
|
||
Verfügbare Felder: `bezeichnung`, `type`, `projekt`, `modul`, `aktiv`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=projekt`)
|
||
|
||
Verfügbare Includes: `projekt`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Adresstyp anlegen
|
||
description: |
|
||
Adresstyp anlegen
|
||
|
||
Permission: `create_address_type`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
bezeichnung:
|
||
description: Bezeichnung des Adresstyps
|
||
required: true
|
||
type: string
|
||
type:
|
||
description: Adresstyp; Mögliche Werte `herr`, `frau`, `firma`
|
||
required: true
|
||
type: string
|
||
projekt:
|
||
description: Projekt
|
||
required: false
|
||
type: integer
|
||
netto:
|
||
description: Anzeige Belege in Netto (`1` = netto / `0` = brutto)
|
||
required: false
|
||
type: integer
|
||
aktiv:
|
||
description: Aktiv (`1` = aktiv / `0` = inaktiv)
|
||
required: false
|
||
type: integer
|
||
example: |
|
||
{
|
||
"type": "herr",
|
||
"bezeichnung": "Gentleman",
|
||
"aktiv": 1,
|
||
"projekt": 1
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegter Adresstyp wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": "5",
|
||
"type": "herr",
|
||
"bezeichnung": "Gentleman",
|
||
"projekt": "1",
|
||
"netto": "0",
|
||
"aktiv": "1"
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelner Adresstyp abrufen oder bearbeiten
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Adresstyp-ID
|
||
get:
|
||
displayName: Einzelnen Adresstyp abrufen
|
||
description: |
|
||
Einzelnen Adresstyp abrufen
|
||
|
||
Permission: `view_address_type`
|
||
queryParameters:
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=projekt`)
|
||
|
||
Verfügbare Includes: `projekt`
|
||
type: string
|
||
required: false
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": "1",
|
||
"type": "firma",
|
||
"bezeichnung": "Firma",
|
||
"projekt": "0",
|
||
"netto": "1",
|
||
"aktiv": "1"
|
||
}
|
||
}
|
||
404:
|
||
description: Adresstyp wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
put:
|
||
displayName: Adresstyp bearbeiten
|
||
description: |
|
||
Adresstyp bearbeiten
|
||
|
||
Permission: `edit_address_type`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"type": "herr",
|
||
"bezeichnung": "Mr",
|
||
"aktiv": "1",
|
||
"projekt": "1"
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierter Adresstyp wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": "5",
|
||
"type": "herr",
|
||
"bezeichnung": "Mr",
|
||
"projekt": "1",
|
||
"netto": "0",
|
||
"aktiv": "1"
|
||
}
|
||
}
|
||
|
||
|
||
/v1/artikel:
|
||
description: Artikel abrufen
|
||
get:
|
||
displayName: Artikelliste abrufen
|
||
description: |
|
||
Artikelliste abrufen
|
||
|
||
Permission: `list_articles`
|
||
queryParameters:
|
||
typ:
|
||
description: |
|
||
Artikel eines bestimmten Typs suchen (genaue Übereinstimmung)
|
||
|
||
Mögliche Werte: `produkt`, `gebuehr`
|
||
type: string
|
||
required: false
|
||
nummer:
|
||
description: Suche nach Artikeln mit bestimmter Artikelnummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
nummer_equals:
|
||
description: Suche nach Artikeln mit bestimmter Artikelnummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
nummer_startswith:
|
||
description: Suche nach Artikeln mit bestimmter Artikelnummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
nummer_endswith:
|
||
description: Suche nach Artikeln mit bestimmter Artikelnummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
name_de:
|
||
description: Suche nach Artikeln mit bestimmtem deutschem Namen (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
name_de_equals:
|
||
description: Suche nach Artikeln mit bestimmtem deutschem Namen (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
name_de_startswith:
|
||
description: Suche nach Artikeln mit bestimmtem deutschem Namen (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
name_de_endswith:
|
||
description: Suche nach Artikeln mit bestimmtem deutschem Namen (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
name_en:
|
||
description: Suche nach Artikeln mit bestimmtem englischem Namen (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
name_en_equals:
|
||
description: Suche nach Artikeln mit bestimmtem englischem Namen (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
name_en_startswith:
|
||
description: Suche nach Artikeln mit bestimmtem englischem Namen (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
name_en_endswith:
|
||
description: Suche nach Artikeln mit bestimmtem englischem Namen (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
projekt:
|
||
description: Artikel nach Projekt filtern
|
||
type: integer
|
||
required: false
|
||
adresse:
|
||
description: Artikel nach Adresse filtern
|
||
type: integer
|
||
required: false
|
||
firma:
|
||
description: Artikel nach Firma filtern
|
||
type: integer
|
||
required: false
|
||
katalog:
|
||
description: Artikel nach Katalog filtern
|
||
type: integer
|
||
required: false
|
||
ausverkauft:
|
||
description: Suche nach ausverkauften Artikeln (1 = ausverkauft / 0 = nicht ausverkauft)
|
||
type: integer
|
||
required: false
|
||
startseite:
|
||
description: Suche nach Artikeln auf Startseite (1 = Startseite / 0 = nicht Startseite)
|
||
type: integer
|
||
required: false
|
||
topseller:
|
||
description: Suche nach Topseller-Artikeln (1 = Topseller / 0 = kein Topseller)
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=typ,-nummer`)
|
||
|
||
Verfügbare Felder: `name_de`, `name_en`, `nummer`, `typ`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=projekt,verkaufpreise`)
|
||
|
||
Verfügbare Includes: `projekt`, `verkaufspreise`, `dateien`, `lagerbestand`
|
||
|
||
###### Lagerbestand
|
||
|
||
**Beispiel – Lagerartikel**
|
||
|
||
```json
|
||
"lagerbestand": {
|
||
"lagernd": 12,
|
||
"reserviert": 0,
|
||
"offene_auftraege": 33,
|
||
"offene_bestellungen": 1,
|
||
"berechneter_bestand": -21,
|
||
"verkaufbar": 0
|
||
}
|
||
```
|
||
|
||
**Beispiel – Kein Lagerartikel**
|
||
|
||
```json
|
||
"lagerbestand": []
|
||
```
|
||
|
||
**Erklärung**
|
||
|
||
* **Lagernd**: Lagernde Menge über alle Lager, außer Sperrlager;
|
||
* **Reserviert**: Reservierte Menge
|
||
* **Offene Aufträge**: Menge aus offenen Aufträgen;
|
||
Es werden nur Aufträge mit dem Status FREIGEGEBEN berücksichtigt;
|
||
Aufträge mit Status ANGELEGT werden nicht berücksichtigt;
|
||
* **Offene Bestellungen**:
|
||
Es werden nur Bestellungen mit dem Status FREIGEGEBEN berücksichtigt;
|
||
Bestellungen mit Status ANGELEGT werden nicht berücksichtigt;
|
||
* **Berechneter Bestand**: *Lagernder Bestand* minus *Offene Aufträge*
|
||
* **Verkaufbar**: Wie *Berechneter Bestand*; wird nur nicht kleiner als `0`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
responses:
|
||
200:
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": [
|
||
{
|
||
"id": 1,
|
||
"typ": "produkt",
|
||
"nummer": "700001",
|
||
"checksum": "",
|
||
"projekt": 1,
|
||
"inaktiv": "",
|
||
"ausverkauft": 0,
|
||
"warengruppe": "",
|
||
"name_de": "Schraube M10x20",
|
||
"name_en": "",
|
||
"kurztext_de": "",
|
||
"kurztext_en": "",
|
||
"beschreibung_de": "",
|
||
"beschreibung_en": "",
|
||
"uebersicht_de": "",
|
||
"uebersicht_en": "",
|
||
"links_de": "",
|
||
"links_en": "",
|
||
"startseite_de": "",
|
||
"startseite_en": "",
|
||
"standardbild": "",
|
||
"herstellerlink": "",
|
||
"hersteller": "",
|
||
"teilbar": "",
|
||
"...": "Ausgabe gekürzt"
|
||
},
|
||
{
|
||
"id": 2,
|
||
"...": "Ausgabe gekürzt"
|
||
}
|
||
]
|
||
}
|
||
# post:
|
||
# displayName: Artikel anlegen
|
||
# description: Neuen Artikel anlegen
|
||
# body:
|
||
# application/json:
|
||
# example: |
|
||
# {
|
||
# "name_de": "Name vom Artikel",
|
||
# "aktiv": "1",
|
||
# "hersteller": "Herstellername",
|
||
# "herstellernummer": "123",
|
||
# "ean": "234",
|
||
# "zolltarifnummer": "345",
|
||
# "mindestlager": "10",
|
||
# "mindestbestellung": "5",
|
||
# "gewicht": "1.5",
|
||
# "lagerartikel": "1",
|
||
# "einkaufspreise": {
|
||
# "staffelpreis": {
|
||
# "lieferantennummer": "70000",
|
||
# "ab_menge": "1",
|
||
# "bestellnummer": "123456789",
|
||
# "bezeichnunglieferant": "Artikel 123456789",
|
||
# "preis": "1.20",
|
||
# "waehrung": "EUR"
|
||
# }
|
||
# },
|
||
# "verkaufspreise": {
|
||
# "staffelpreis": {
|
||
# "ab_menge": "1",
|
||
# "preis": "2.20",
|
||
# "waehrung": "EUR"
|
||
# }
|
||
# }
|
||
# }
|
||
# responses:
|
||
# 200:
|
||
# description: Request erfolgreich; Angelegte Adresse wird zurückgeliefert
|
||
# body:
|
||
# application/json:
|
||
# example: |
|
||
# {
|
||
# "data": {
|
||
# "id": 20,
|
||
# "typ": "",
|
||
# "nummer": "1000005",
|
||
# "projekt": 0,
|
||
# "inaktiv": "0",
|
||
# "ausverkauft": "0",
|
||
# "name_de": "Name vom Artikel",
|
||
# "name_en": "",
|
||
# "kurztext_de": "",
|
||
# "kurztext_en": "",
|
||
# "beschreibung_de": "",
|
||
# "beschreibung_en": "",
|
||
# "hersteller": "Herstellername",
|
||
# "gewicht": "1.5",
|
||
# "lagerartikel": "1",
|
||
# "mindestlager": "10",
|
||
# "mindestbestellung": "5",
|
||
# "herstellernummer": "123",
|
||
# "ean": "234",
|
||
# "...": "Ausgabe gekürzt",
|
||
# "einkaufspreise": {
|
||
# "staffelpreis": {
|
||
# "ab_menge": "1.0000",
|
||
# "preis": "1.20000000",
|
||
# "waehrung": "EUR",
|
||
# "lieferantennummer": "70000",
|
||
# "projekt": "STANDARD",
|
||
# "bestellnummer": "123456789",
|
||
# "bezeichnunglieferant": "Artikel 123456789"
|
||
# }
|
||
# },
|
||
# "verkaufspreise": {
|
||
# "staffelpreis": {
|
||
# "ab_menge": "1.0000",
|
||
# "preis": "2.20000000",
|
||
# "vpe": "1",
|
||
# "waehrung": "EUR"
|
||
# }
|
||
# }
|
||
# }
|
||
# }
|
||
|
||
/{id}:
|
||
description: Einzelnen Artikel per ID abrufen
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Artikel-ID
|
||
get:
|
||
displayName: Einzelnen Artikel abrufen
|
||
description: |
|
||
Einzelnen Artikel abrufen
|
||
|
||
Permission: `view_article`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 1,
|
||
"typ": "produkt",
|
||
"nummer": "700001",
|
||
"checksum": "",
|
||
"projekt": 1,
|
||
"inaktiv": "",
|
||
"ausverkauft": 0,
|
||
"warengruppe": "",
|
||
"name_de": "Schraube M10x20",
|
||
"name_en": "",
|
||
"kurztext_de": "",
|
||
"kurztext_en": "",
|
||
"beschreibung_de": "",
|
||
"beschreibung_en": "",
|
||
"uebersicht_de": "",
|
||
"uebersicht_en": "",
|
||
"links_de": "",
|
||
"links_en": "",
|
||
"startseite_de": "",
|
||
"startseite_en": "",
|
||
"standardbild": "",
|
||
"herstellerlink": "",
|
||
"hersteller": "",
|
||
"teilbar": "",
|
||
"nteile": "",
|
||
"...": "Ausgabe gekürzt"
|
||
}
|
||
}
|
||
404:
|
||
description: Artikel wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
# put:
|
||
# displayName: Artikel bearbeiten
|
||
# description: Artikel bearbeiten
|
||
# body:
|
||
# application/json:
|
||
# example: |
|
||
# {
|
||
# "nummer": "100001",
|
||
# "name_de": "Name neu von Artikel",
|
||
# "aktiv": "1",
|
||
# "anabregs_text": "Text für Angebot, Auftrag, Rechnung usw.",
|
||
# "hersteller": "Herstellername",
|
||
# "herstellernummer": "123",
|
||
# "ean": "234",
|
||
# "zolltarifnummer": "345",
|
||
# "mindestlager": "10",
|
||
# "mindestbestellung": "5",
|
||
# "gewicht": "1.5",
|
||
# "lagerartikel": "1"
|
||
# }
|
||
# responses:
|
||
# 200:
|
||
# description: Request erfolgreich; Aktualisierter Artikel wird zurückgeliefert
|
||
# body:
|
||
# application/json:
|
||
# example: |
|
||
# {
|
||
# "data": {
|
||
# "id": 1,
|
||
# "typ": "produkt",
|
||
# "nummer": "700001",
|
||
# "checksum": "",
|
||
# "projekt": 1,
|
||
# "inaktiv": "",
|
||
# "ausverkauft": 0,
|
||
# "warengruppe": "",
|
||
# "name_de": "Schraube M10x20",
|
||
# "name_en": "",
|
||
# "kurztext_de": "",
|
||
# "kurztext_en": "",
|
||
# "beschreibung_de": "",
|
||
# "beschreibung_en": "",
|
||
# "uebersicht_de": "",
|
||
# "uebersicht_en": "",
|
||
# "links_de": "",
|
||
# "links_en": "",
|
||
# "startseite_de": "",
|
||
# "startseite_en": "",
|
||
# "standardbild": "",
|
||
# "herstellerlink": "",
|
||
# "hersteller": "",
|
||
# "teilbar": "",
|
||
# "nteile": "",
|
||
# "...": "Ausgabe gekürzt"
|
||
# }
|
||
# }
|
||
|
||
|
||
/v1/artikelkategorien:
|
||
description: Artikelkategorien anlegen, bearbeiten und abrufen
|
||
get:
|
||
displayName: Artikelkategorien abrufen
|
||
description: |
|
||
Artikelkategorien abrufen
|
||
|
||
Permission: `list_article_categories`
|
||
queryParameters:
|
||
parent:
|
||
description: Artikelkategorien mit Parent-ID filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
projekt:
|
||
description: Artikelkategorien mit Projekt filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
bezeichnung:
|
||
description: Artikelkategorie mit bestimmter Bezeichnung suchen (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
bezeichnung_exakt:
|
||
description: Artikelkategorie mit bestimmter Bezeichnung suchen (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
id_ext:
|
||
description: Artikelkategorie mit externer ID filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=parent,-bezeichnung`)
|
||
|
||
Verfügbare Felder: `bezeichnung`, `parent`, `projekt`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Artikelkategorie anlegen
|
||
description: |
|
||
Artikelkategorie anlegen
|
||
|
||
Permission: `create_article_category`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
bezeichnung:
|
||
description: Name der Artikelkategorie
|
||
required: true
|
||
type: string
|
||
projekt:
|
||
description: Projekt-ID
|
||
required: false
|
||
type: integer
|
||
parent:
|
||
description: ID der Elternkategorie
|
||
required: false
|
||
type: integer
|
||
example: |
|
||
{
|
||
"bezeichnung": "Schaufelradbagger",
|
||
"projekt": 1,
|
||
"parent": 10
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegte Artikelkategorie wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 19,
|
||
"bezeichnung": "Schaufelradbagger",
|
||
"next_nummer": "",
|
||
"projekt": 1,
|
||
"geloescht": "0",
|
||
"externenummer": "0",
|
||
"parent": 10,
|
||
"steuer_erloese_inland_normal": "",
|
||
"steuer_aufwendung_inland_normal": "",
|
||
"steuer_erloese_inland_ermaessigt": "",
|
||
"steuer_aufwendung_inland_ermaessigt": "",
|
||
"steuer_erloese_inland_steuerfrei": "",
|
||
"steuer_aufwendung_inland_steuerfrei": "",
|
||
"steuer_erloese_inland_innergemeinschaftlich": "",
|
||
"steuer_aufwendung_inland_innergemeinschaftlich": "",
|
||
"steuer_erloese_inland_eunormal": "",
|
||
"steuer_erloese_inland_nichtsteuerbar": "",
|
||
"steuer_erloese_inland_euermaessigt": "",
|
||
"steuer_aufwendung_inland_nichtsteuerbar": "",
|
||
"steuer_aufwendung_inland_eunormal": "",
|
||
"steuer_aufwendung_inland_euermaessigt": "",
|
||
"steuer_erloese_inland_export": "",
|
||
"steuer_aufwendung_inland_import": "",
|
||
"steuertext_innergemeinschaftlich": null,
|
||
"steuertext_export": null,
|
||
"id_ext": 0
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelne Artikelkategorie abrufen oder bearbeiten
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Artikelkategorie-ID
|
||
get:
|
||
displayName: Einzelne Artikelkategorie abrufen
|
||
description: |
|
||
Einzelne Artikelkategorie abrufen
|
||
|
||
Permission: `view_article_category`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 1,
|
||
"bezeichnung": "1000000 Sonstiges",
|
||
"next_nummer": "1000000",
|
||
"projekt": 0,
|
||
"geloescht": "0",
|
||
"externenummer": "0",
|
||
"parent": 0,
|
||
"...": "Ausgabe gekürzt",
|
||
"id_ext": 0
|
||
}
|
||
}
|
||
404:
|
||
description: Artikelkategorie wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
put:
|
||
displayName: Artikelkategorie bearbeiten
|
||
description: |
|
||
Artikelkategorie bearbeiten
|
||
|
||
Permission: `edit_article_category`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"bezeichnung": "Schwimmbagger"
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierte Artikelkategorie wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 19,
|
||
"bezeichnung": "Schwimmbagger",
|
||
"next_nummer": "",
|
||
"projekt": 1,
|
||
"geloescht": "0",
|
||
"externenummer": "0",
|
||
"parent": 0,
|
||
"...": "Ausgabe gekürzt",
|
||
"id_ext": 0
|
||
}
|
||
}
|
||
|
||
/v1/eigenschaften:
|
||
description: Eigenschaften für Artikel abrufen, erstellen, bearbeiten und löschen
|
||
get:
|
||
displayName: Eigenschaften abrufen
|
||
description: |
|
||
Eigenschaften abrufen
|
||
|
||
Permission: `list_property`
|
||
queryParameters:
|
||
artikel:
|
||
description: Artikel Id der die Eigenschaft zugewiesen ist (genaue Übereinstimmung) - Standardmäßig 0, da die Zuordnung zum Artikel über den Wert realisiert wird
|
||
type: integer
|
||
required: false
|
||
name:
|
||
description: Name der Eigenschaft (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
typ:
|
||
description: Typ der Eigenschaft (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
projekt:
|
||
description: Projekt dem die Eigenschaft zugewiesen ist (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
geloescht:
|
||
description: Markiert die Eigenschaft als gelöscht (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=artikel,-name`)
|
||
|
||
Verfügbare Felder: `artikel`, `name`, `typ`, `projekt`, `geloescht`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Eigenschaft anlegen
|
||
description: |
|
||
Eigenschaft anlegen
|
||
|
||
Permission: `create_property`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
artikel:
|
||
description: Artikel Id der die Eigenschaft zugewiesen werden soll
|
||
type: integer
|
||
required: false
|
||
name:
|
||
description: Name der Eigenschaft (muss eindeutig sein)
|
||
type: string
|
||
required: true
|
||
typ:
|
||
description: Typ der Eigenschaft
|
||
type: string
|
||
required: false
|
||
projekt:
|
||
description: Projekt dem die Eigenschaft zugewiesen ist
|
||
type: integer
|
||
required: false
|
||
geloescht:
|
||
description: Markiert die Eigenschaft als gelöscht
|
||
type: integer
|
||
required: false
|
||
example: |
|
||
{
|
||
"name": "Farbe",
|
||
"typ": "einzeilig"
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegte Eigenschaft wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 19,
|
||
"artikel": 0,
|
||
"name": "Farbe",
|
||
"typ": "einzeilig",
|
||
"projekt": 0,
|
||
"geloescht": "0"
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelne Eigenschaft abrufen, bearbeiten, oder löschen
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Eigenschaft-ID
|
||
get:
|
||
displayName: Einzelne Eigenschaft abrufen
|
||
description: |
|
||
Einzelne Eigenschaft abrufen
|
||
|
||
Permission: `view_property`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 19,
|
||
"artikel": 0,
|
||
"name": "Farbe",
|
||
"typ": "einzeilig",
|
||
"projekt": 0,
|
||
"geloescht": "0"
|
||
}
|
||
}
|
||
404:
|
||
description: Eigenschaft wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
put:
|
||
displayName: Eigenschaft bearbeiten
|
||
description: |
|
||
Eigenschaft bearbeiten
|
||
|
||
Permission: `edit_property`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"name": "Material"
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierte Eigenschaft wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 19,
|
||
"artikel": 0,
|
||
"name": "Material",
|
||
"typ": "einzeilig",
|
||
"projekt": 0,
|
||
"geloescht": "0"
|
||
}
|
||
}
|
||
delete:
|
||
displayName: Einzelne Eigenschaft löschen
|
||
description: |
|
||
Einzelne Eigenschaft löschen - Eigenschaften sollten nur dann gelöscht werden wenn auch keine Werte mehr für sie vorliegen
|
||
|
||
Permission: `delete_property`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 19
|
||
}
|
||
}
|
||
404:
|
||
description: Eigenschaft wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://localhost/xentral/20.1/www/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
|
||
/v1/eigenschaftenwerte:
|
||
description: Eigenschaftenwerte für Artikel abrufen, erstellen, bearbeiten und löschen
|
||
get:
|
||
displayName: Eigenschaftenwerte abrufen
|
||
description: |
|
||
Eigenschaften abrufen
|
||
|
||
Permission: `list_property_value`
|
||
queryParameters:
|
||
artikel:
|
||
description: Artikel Id der die Eigenschaft zugewiesen ist (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
artikeleigenschaften:
|
||
description: Id der Eigenschaft (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
wert:
|
||
description: Wert der Eigenschaft (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=artikel,-wert`)
|
||
|
||
Verfügbare Felder: `artikel`, `wert`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Eigenschaftwert anlegen
|
||
description: |
|
||
Eigenschaftenwert anlegen
|
||
|
||
Permission: `create_property_value`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
artikel:
|
||
description: Artikel Id der der Eigenschaftenwert zugewiesen werden soll
|
||
type: integer
|
||
required: true
|
||
artikeleigenschaften:
|
||
description: Id der Eigenschaft
|
||
type: integer
|
||
required: true
|
||
wert:
|
||
description: Wert der Eigenschaft
|
||
type: string
|
||
required: false
|
||
example: |
|
||
{
|
||
"artikel": 1,
|
||
"artikeleigenschaften": 19,
|
||
"wert": "Gelb"
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegter Eigenschaftenwert wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 203,
|
||
"artikel": 1,
|
||
"artikeleigenschaften": 19,
|
||
"wert": "Gelb"
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelnen Eigenschaftenwert abrufen, bearbeiten, oder löschen
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Eigenschaftenwert-ID
|
||
get:
|
||
displayName: Einzelnen Eigenschaftenwert abrufen
|
||
description: |
|
||
Einzelnen Eigenschaftenwert abrufen
|
||
|
||
Permission: `view_property_value`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 203,
|
||
"artikel": 1,
|
||
"artikeleigenschaften": 19,
|
||
"wert": "Gelb"
|
||
}
|
||
}
|
||
404:
|
||
description: Eigenschaftenwert wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
put:
|
||
displayName: Eigenschaftenwert bearbeiten
|
||
description: |
|
||
Eigenschaftenwert bearbeiten
|
||
|
||
Permission: `edit_property_value`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"wert": "Holz"
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierter Eigenschaftenwert wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 203,
|
||
"artikel": 1,
|
||
"artikeleigenschaften": 19,
|
||
"wert": "Holz"
|
||
}
|
||
}
|
||
delete:
|
||
displayName: Einzelnen Eigenschaftenwert löschen
|
||
description: |
|
||
Einzelnen Eigenschaftenwert löschen
|
||
|
||
Permission: `delete_property_value`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 203
|
||
}
|
||
}
|
||
404:
|
||
description: Eigenschaftenwert wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://localhost/xentral/20.1/www/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
|
||
/v1/belege/angebote:
|
||
description: Angebote abrufen
|
||
get:
|
||
displayName: Angebotsliste abrufen
|
||
description: |
|
||
Angebotsliste abrufen und Angebote suchen
|
||
|
||
Permission: `list_quotes`
|
||
queryParameters:
|
||
status:
|
||
description: |
|
||
Suche nach Angebotsstatus (genaue Übereinstimmung)
|
||
|
||
Mögliche Werte: `angelegt`, `abgelehnt`, `beauftragt`, `bestellt`, `freigegeben`, `versendet`, `storniert`
|
||
type: string
|
||
required: false
|
||
belegnr:
|
||
description: Suche nach Belegnummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
belegnr_equals:
|
||
description: Suche nach Belegnummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
belegnr_startswith:
|
||
description: Suche nach Belegnummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
belegnr_endswith:
|
||
description: Suche nach Belegnummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
kundennummer:
|
||
description: Suche nach Kundennummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kundennummer_equals:
|
||
description: Suche nach Kundennummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kundennummer_startswith:
|
||
description: Suche nach Kundennummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
kundennummer_endswith:
|
||
description: Suche nach Kundennummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
datum:
|
||
description: Suche nach bestimmtem Belegdatum (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
datum_gt:
|
||
description: Suche nach bestimmtem Belegdatum (Datum größer Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_gte:
|
||
description: Suche nach bestimmtem Belegdatum (Datum größer gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lt:
|
||
description: Suche nach bestimmtem Belegdatum (Datum kleiner Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lte:
|
||
description: Suche nach bestimmtem Belegdatum (Datum kleiner gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
projekt:
|
||
description: Angebote eines bestimmten Projekt filtern
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=belegnr`)
|
||
|
||
Verfügbare Felder: `belegnr`, `datum`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=positionen`)
|
||
|
||
Verfügbare Includes: `positionen`, `protokoll`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
|
||
/{id}:
|
||
description: Einzelnes Angebot abrufen
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Angebots-ID
|
||
get:
|
||
displayName: Einzelnes Angebot abrufen
|
||
description: |
|
||
Einzelnes Angebot abrufen
|
||
|
||
Permission: `list_quotes`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 4,
|
||
"firma": 1,
|
||
"projekt": "1",
|
||
"status": "versendet",
|
||
"belegnr": "100003",
|
||
"kundennummer": "10000",
|
||
"datum": "2019-06-28",
|
||
"gueltigbis": "2019-04-10",
|
||
"adresse": 3,
|
||
"typ": "firma",
|
||
"name": "Max Muster",
|
||
"titel": "",
|
||
"strasse": "Musterstrasse 6",
|
||
"plz": "12345",
|
||
"ort": "Musterdorf",
|
||
"land": "DE",
|
||
"...": "Ausgabe gekürzt"
|
||
}
|
||
}
|
||
404:
|
||
description: Angebot wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
|
||
|
||
/v1/belege/auftraege:
|
||
description: Aufträge abrufen
|
||
get:
|
||
displayName: Auftragsliste abrufen
|
||
description: |
|
||
Auftragsliste abrufen und Aufträge suchen
|
||
|
||
Permission: `list_orders`
|
||
queryParameters:
|
||
status:
|
||
description: |
|
||
Suche nach Auftragssstatus (genaue Übereinstimmung)
|
||
|
||
Mögliche Werte: `angelegt`, `bestellt`, `freigegeben`, `versendet`, `abgeschlossen`, `storniert`,
|
||
type: string
|
||
required: false
|
||
belegnr:
|
||
description: Suche nach Belegnummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
belegnr_equals:
|
||
description: Suche nach Belegnummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
belegnr_startswith:
|
||
description: Suche nach Belegnummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
belegnr_endswith:
|
||
description: Suche nach Belegnummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
kundennummer:
|
||
description: Suche nach Kundennummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kundennummer_equals:
|
||
description: Suche nach Kundennummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kundennummer_startswith:
|
||
description: Suche nach Kundennummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
kundennummer_endswith:
|
||
description: Suche nach Kundennummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
datum:
|
||
description: Suche nach bestimmtem Belegdatum (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
datum_gt:
|
||
description: Suche nach bestimmtem Belegdatum (Datum größer Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_gte:
|
||
description: Suche nach bestimmtem Belegdatum (Datum größer gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lt:
|
||
description: Suche nach bestimmtem Belegdatum (Datum kleiner Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lte:
|
||
description: Suche nach bestimmtem Belegdatum (Datum kleiner gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
angebot:
|
||
description: Aufträge nach Angebotsnummer filtern (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
angebotid:
|
||
description: Aufträge nach Angebots-ID filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
projekt:
|
||
description: Aufträge eines bestimmten Projekt filtern
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=belegnr`)
|
||
|
||
Verfügbare Felder: `belegnr`, `datum`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=positionen`)
|
||
|
||
Verfügbare Includes: `positionen`, `protokoll`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
|
||
/{id}:
|
||
description: Einzelnen Auftrag abrufen
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Auftrag-ID
|
||
get:
|
||
displayName: Einzelnen Auftrag abrufen
|
||
description: |
|
||
Einzelnen Auftrag abrufen
|
||
|
||
Permission: `list_orders`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 4,
|
||
"firma": 1,
|
||
"projekt": "1",
|
||
"status": "freigegeben",
|
||
"belegnr": "200003",
|
||
"kundennummer": "10002",
|
||
"ihrebestellnummer": null,
|
||
"datum": "2019-02-26",
|
||
"adresse": 5,
|
||
"typ": "firma",
|
||
"name": "Hans Huber",
|
||
"titel": "",
|
||
"strasse": "Musterstrasse 6",
|
||
"plz": "12345",
|
||
"ort": "Musterstadt",
|
||
"land": "DE",
|
||
"...": "Ausgabe gekürzt"
|
||
}
|
||
}
|
||
404:
|
||
description: Auftrag wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
|
||
|
||
/v1/belege/lieferscheine:
|
||
description: Lieferscheine abrufen
|
||
get:
|
||
displayName: Lieferscheinliste abrufen
|
||
description: |
|
||
Lieferscheinliste abrufen und Lieferscheine suchen
|
||
|
||
Permission: `list_delivery_notes`
|
||
queryParameters:
|
||
status:
|
||
description: |
|
||
Suche nach Lieferschein-Status (genaue Übereinstimmung)
|
||
|
||
Mögliche Werte: `angelegt`, `freigegeben`, `abgeschlossen`, `versendet`, `storniert`
|
||
type: string
|
||
required: false
|
||
belegnr:
|
||
description: Suche nach Belegnummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
belegnr_equals:
|
||
description: Suche nach Belegnummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
belegnr_startswith:
|
||
description: Suche nach Belegnummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
belegnr_endswith:
|
||
description: Suche nach Belegnummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
internet:
|
||
description: Suche nach Internetnummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
internet_equals:
|
||
description: Suche nach Internetnummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
internet_startswith:
|
||
description: Suche nach Internetnummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
internet_endswith:
|
||
description: Suche nach Internetnummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
kundennummer:
|
||
description: Suche nach Kundennummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kundennummer_equals:
|
||
description: Suche nach Kundennummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kundennummer_startswith:
|
||
description: Suche nach Kundennummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
kundennummer_endswith:
|
||
description: Suche nach Kundennummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
datum:
|
||
description: Suche nach bestimmtem Belegdatum (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
datum_gt:
|
||
description: Suche nach bestimmtem Belegdatum (Datum größer Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_gte:
|
||
description: Suche nach bestimmtem Belegdatum (Datum größer gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lt:
|
||
description: Suche nach bestimmtem Belegdatum (Datum kleiner Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lte:
|
||
description: Suche nach bestimmtem Belegdatum (Datum kleiner gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
auftrag:
|
||
description: Lieferscheine nach Auftragsnummer filtern (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
auftragid:
|
||
description: Lieferscheine nach Auftrags-ID filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
projekt:
|
||
description: Lieferscheine eines bestimmten Projekt filtern
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=belegnr`)
|
||
|
||
Verfügbare Felder: `belegnr`, `datum`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=positionen`)
|
||
|
||
Verfügbare Includes: `positionen`, `protokoll`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
|
||
/{id}:
|
||
description: Einzelnen Lieferschein abrufen
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Lieferschein-ID
|
||
get:
|
||
displayName: Einzelnen Lieferschein abrufen
|
||
description: |
|
||
Einzelnen Lieferschein abrufen
|
||
|
||
Permission: `list_delivery_notes`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 4,
|
||
"firma": 1,
|
||
"projekt": "1",
|
||
"status": "freigegeben",
|
||
"lieferscheinart": "",
|
||
"belegnr": "300003",
|
||
"kundennummer": "10001",
|
||
"ihrebestellnummer": "",
|
||
"datum": "2019-06-12",
|
||
"adresse": 4,
|
||
"typ": "frau",
|
||
"name": "Eva Müller",
|
||
"strasse": "Musterweg 12a",
|
||
"plz": "12345",
|
||
"ort": "Musterdorf",
|
||
"land": "DE",
|
||
"...": "Ausgabe gekürzt"
|
||
}
|
||
}
|
||
404:
|
||
description: Lieferschein wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
|
||
|
||
/v1/belege/rechnungen:
|
||
description: Rechnungen abrufen
|
||
get:
|
||
displayName: Rechnungsliste abrufen
|
||
description: |
|
||
Rechnungsliste abrufen und Rechnungen suchen
|
||
|
||
Permission: `list_invoices`
|
||
queryParameters:
|
||
status:
|
||
description: |
|
||
Suche nach Rechnungs-Status (genaue Übereinstimmung)
|
||
|
||
Mögliche Werte: `angelegt`, `freigegeben`, `versendet`, `storniert`
|
||
type: string
|
||
required: false
|
||
belegnr:
|
||
description: Suche nach Belegnummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
belegnr_equals:
|
||
description: Suche nach Belegnummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
belegnr_startswith:
|
||
description: Suche nach Belegnummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
belegnr_endswith:
|
||
description: Suche nach Belegnummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
kundennummer:
|
||
description: Suche nach Kundennummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kundennummer_equals:
|
||
description: Suche nach Kundennummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kundennummer_startswith:
|
||
description: Suche nach Kundennummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
kundennummer_endswith:
|
||
description: Suche nach Kundennummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
datum:
|
||
description: Suche nach bestimmtem Belegdatum (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
datum_gt:
|
||
description: Suche nach bestimmtem Belegdatum (Datum größer Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_gte:
|
||
description: Suche nach bestimmtem Belegdatum (Datum größer gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lt:
|
||
description: Suche nach bestimmtem Belegdatum (Datum kleiner Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lte:
|
||
description: Suche nach bestimmtem Belegdatum (Datum kleiner gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
auftrag:
|
||
description: Rechnungen nach Auftragsnummer filtern (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
auftragid:
|
||
description: Rechnungen nach Auftrags-ID filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
projekt:
|
||
description: Rechnungen eines bestimmten Projekt filtern
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=belegnr`)
|
||
|
||
Verfügbare Felder: `belegnr`, `datum`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=positionen`)
|
||
|
||
Verfügbare Includes: `positionen`, `protokoll`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
|
||
/{id}:
|
||
description: Einzelne Rechnung abrufen oder löschen
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Rechnungs-ID
|
||
get:
|
||
displayName: Einzelne Rechnung abrufen
|
||
description: |
|
||
Einzelne Rechnung abrufen
|
||
|
||
Permission: `view_invoice`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 4,
|
||
"firma": 1,
|
||
"projekt": "1",
|
||
"status": "versendet",
|
||
"belegnr": "400002",
|
||
"datum": "2019-05-21",
|
||
"kundennummer": "10000",
|
||
"adresse": 3,
|
||
"typ": "firma",
|
||
"name": "Max Muster",
|
||
"strasse": "Musterstrasse 6",
|
||
"plz": "12345",
|
||
"ort": "Musterdorf",
|
||
"land": "DE",
|
||
"...": "Ausgabe gekürzt"
|
||
}
|
||
}
|
||
404:
|
||
description: Rechnung wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
|
||
delete:
|
||
displayName: Einzelne Rechnung löschen
|
||
description: |
|
||
Einzelne Rechnung löschen
|
||
|
||
Permission: `delete_invoice`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 18
|
||
}
|
||
}
|
||
404:
|
||
description: Rechnung wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://localhost/xentral/20.1/www/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
|
||
|
||
/v1/belege/gutschriften:
|
||
description: Gutschriften/Stornorechnungen abrufen
|
||
get:
|
||
displayName: Gutschriftenliste abrufen
|
||
description: |
|
||
Gutschriftenliste abrufen und Gutschriften suchen
|
||
|
||
Permission: `list_credit_memos`
|
||
queryParameters:
|
||
status:
|
||
description: |
|
||
Suche nach Gutschriften-Status (genaue Übereinstimmung)
|
||
|
||
Mögliche Werte: `angelegt`, `freigegeben`, `versendet`, `storniert`
|
||
type: string
|
||
required: false
|
||
belegnr:
|
||
description: Suche nach Belegnummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
belegnr_equals:
|
||
description: Suche nach Belegnummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
belegnr_startswith:
|
||
description: Suche nach Belegnummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
belegnr_endswith:
|
||
description: Suche nach Belegnummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
kundennummer:
|
||
description: Suche nach Kundennummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kundennummer_equals:
|
||
description: Suche nach Kundennummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kundennummer_startswith:
|
||
description: Suche nach Kundennummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
kundennummer_endswith:
|
||
description: Suche nach Kundennummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
datum:
|
||
description: Suche nach bestimmtem Belegdatum (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
datum_gt:
|
||
description: Suche nach bestimmtem Belegdatum (Datum größer Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_gte:
|
||
description: Suche nach bestimmtem Belegdatum (Datum größer gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lt:
|
||
description: Suche nach bestimmtem Belegdatum (Datum kleiner Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lte:
|
||
description: Suche nach bestimmtem Belegdatum (Datum kleiner gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
rechnung:
|
||
description: Gutschriften nach Rechnungsnummer filtern (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
rechnungid:
|
||
description: Gutschriften nach Rechnungs-ID filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
projekt:
|
||
description: Gutschriften eines bestimmten Projekt filtern
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=belegnr`)
|
||
|
||
Verfügbare Felder: `belegnr`, `datum`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=positionen`)
|
||
|
||
Verfügbare Includes: `positionen`, `protokoll`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
|
||
/{id}:
|
||
description: Einzelne Gutschrift abrufen
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Gutschriften-ID
|
||
get:
|
||
displayName: Einzelne Gutschrift abrufen
|
||
description: |
|
||
Einzelne Gutschrift abrufen
|
||
|
||
Permission: `view_credit_memo`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 1,
|
||
"firma": 1,
|
||
"projekt": "1",
|
||
"status": "versendet",
|
||
"belegnr": "900000",
|
||
"datum": "2019-08-07",
|
||
"stornorechnung": 0,
|
||
"kundennummer": "10001",
|
||
"adresse": 4,
|
||
"typ": "frau",
|
||
"name": "Eva Müller",
|
||
"strasse": "Musterweg 12a",
|
||
"plz": "12345",
|
||
"ort": "Musterdorf",
|
||
"land": "DE",
|
||
"...": "Ausgabe gekürzt"
|
||
}
|
||
}
|
||
404:
|
||
description: Gutschrift wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
|
||
/v1/crmdokumente:
|
||
description: CRM-Dokumente abrufen, anlegen und bearbeiten
|
||
get:
|
||
displayName: CRM-Dokumente abrufen
|
||
description: |
|
||
CRM-Dokumente abrufen und suchen
|
||
|
||
Permission: `list_crm_documents`
|
||
queryParameters:
|
||
typ:
|
||
description: Suche nach CRM-Dokumenten eines Typs (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
typ_equals:
|
||
description: |
|
||
Suche nach CRM-Dokumenten eines Typs (genaue Übereinstimmung)
|
||
|
||
Verfügbare Typen: `brief`, `email`, `telefon`, `notiz`
|
||
type: string
|
||
required: false
|
||
typ_exact:
|
||
description: (deprecated) gleich wie typ_equals
|
||
type: string
|
||
required: false
|
||
betreff:
|
||
description: Suche nach Betreff (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
betreff_equals:
|
||
description: Suche nach Betreff (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
betreff_exakt:
|
||
description: (deprecated) gleich wie betreff_equals
|
||
type: string
|
||
required: false
|
||
projekt:
|
||
description: Filtere nach Projekt (Projekt-ID)
|
||
type: integer
|
||
required: false
|
||
adresse_from:
|
||
description: Filtere nach Absender (Adresse-ID)
|
||
type: integer
|
||
required: false
|
||
adresse_to:
|
||
description: Filtere nach Empfänger (Adresse-ID)
|
||
type: integer
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=projekt`)
|
||
|
||
Verfügbare Includes: `projekt`, `adresse_to`, `adresse_from`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: CRM-Dokument anlegen
|
||
description: |
|
||
CRM-Dokument anlegen
|
||
|
||
Permission: `create_crm_document`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
typ:
|
||
description: Mögliche Werte sind `email`, `brief`, `telefon`, `notiz`
|
||
required: true
|
||
type: string
|
||
betreff:
|
||
description: Betreff des CRM-Dokuments
|
||
required: true
|
||
type: string
|
||
content:
|
||
description: Inhalt des CRM-Dokuments
|
||
required: false
|
||
type: string
|
||
adresse_from:
|
||
description: Absender/Mitarbeiter (Adresse-ID)
|
||
required: false
|
||
type: integer
|
||
adresse_to:
|
||
description: Empfänger/Kunde (Adresse-ID)
|
||
required: false
|
||
type: integer
|
||
von:
|
||
description: Anzeigename Absender
|
||
required: false
|
||
type: string
|
||
an:
|
||
description: Anzeigename Empfänger
|
||
required: false
|
||
type: string
|
||
email_an:
|
||
description: E-Mail Adresse Empfänger
|
||
required: false
|
||
type: string
|
||
email_cc:
|
||
description: E-Mail Adresse CC
|
||
required: false
|
||
type: string
|
||
email_bcc:
|
||
description: E-Mail Adresse BCC
|
||
required: false
|
||
type: string
|
||
adresse:
|
||
description: Anschrift 1. Adresszeile
|
||
required: false
|
||
type: string
|
||
plz:
|
||
description: Anschrift Postleitzahl
|
||
required: false
|
||
type: string
|
||
ort:
|
||
description: Anschrift Ort
|
||
required: false
|
||
type: string
|
||
land:
|
||
description: Anschrift Land
|
||
required: false
|
||
type: string
|
||
datum:
|
||
description: Datum des Dokuments
|
||
required: false
|
||
type: date-only
|
||
uhrzeit:
|
||
description: Uhrzeit des Dokuments
|
||
required: false
|
||
type: time-only
|
||
projekt:
|
||
description: Projekt-ID
|
||
required: false
|
||
type: integer
|
||
signatur:
|
||
description: Signatur verwendet (1=ja, 0=nein)
|
||
required: false
|
||
type: integer
|
||
printer:
|
||
description: Nachricht wurde gedruckt (1=ja, 0=nein)
|
||
required: false
|
||
type: integer
|
||
fax:
|
||
description: Fax wurde versendet (1=ja, 0=nein)
|
||
required: false
|
||
type: integer
|
||
sent:
|
||
description: Nachricht wurde versendet (1=ja, 0=nein)
|
||
required: false
|
||
type: integer
|
||
deleted:
|
||
description: Nachricht wurde gelöscht (1=ja, 0=nein)
|
||
required: false
|
||
type: integer
|
||
example: |
|
||
{
|
||
"typ": "email",
|
||
"betreff": "AW: Antwort auf eine Frage",
|
||
"adresse_from": 1,
|
||
"adresse_to": 7,
|
||
"projekt": 1
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 14,
|
||
"adresse_from": 1,
|
||
"adresse_to": 7,
|
||
"typ": "email",
|
||
"von": "",
|
||
"an": "",
|
||
"email_an": "",
|
||
"send_as": "",
|
||
"email": "",
|
||
"email_cc": null,
|
||
"email_bcc": null,
|
||
"bearbeiter": null,
|
||
"firma_an": "",
|
||
"adresse": "",
|
||
"ansprechpartner": null,
|
||
"plz": "",
|
||
"ort": "",
|
||
"land": "",
|
||
"datum": "0000-00-00",
|
||
"uhrzeit": null,
|
||
"betreff": "AW: Antwort auf eine Frage",
|
||
"content": "",
|
||
"projekt": 1,
|
||
"internebezeichnung": "",
|
||
"signatur": 0,
|
||
"fax": 0,
|
||
"sent": 0,
|
||
"printer": 0,
|
||
"deleted": 0
|
||
}
|
||
}
|
||
400:
|
||
description: Request Body Fehlerhaft
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7453,
|
||
"http_code": 400,
|
||
"message": "Validation error",
|
||
"href": "http://localhost/xentral/20.1/www/api/docs.html#error-7453",
|
||
"details": [
|
||
"The attribute 'betreff' is required."
|
||
]
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelne CRM-Dokumente abrufen
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: CRM-Dokumenten-ID
|
||
get:
|
||
displayName: Einzelnes CRM-Dokument abrufen
|
||
description: |
|
||
Einzelnes CRM-Dokument abrufen.
|
||
|
||
Permission: `view_crm_document`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 4,
|
||
"adresse_from": 1,
|
||
"adresse_to": 7,
|
||
"typ": "telefon",
|
||
"von": "",
|
||
"an": "",
|
||
"email_an": "",
|
||
"send_as": "",
|
||
"email": "",
|
||
"email_cc": "",
|
||
"email_bcc": "",
|
||
"bearbeiter": "Mitarbeiter XY",
|
||
"firma_an": "",
|
||
"adresse": "",
|
||
"ansprechpartner": "",
|
||
"plz": "",
|
||
"ort": "",
|
||
"land": "",
|
||
"datum": "2019-11-05",
|
||
"uhrzeit": "12:04:00",
|
||
"betreff": "Fragen zur Bedienung",
|
||
"content": "- Keine Fragen, alles klar",
|
||
"projekt": 1,
|
||
"internebezeichnung": "",
|
||
"signatur": 0,
|
||
"fax": 0,
|
||
"sent": 0,
|
||
"printer": 0,
|
||
"deleted": 0
|
||
}
|
||
}
|
||
404:
|
||
description: CRM-Dokument wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
put:
|
||
displayName: CRM-Dokument bearbeiten
|
||
description: |
|
||
CRM-Dokument bearbeiten
|
||
|
||
Permission: `view_crm_document`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
typ:
|
||
description: Mögliche Werte sind `email`, `brief`, `telefon`, `notiz`
|
||
required: true
|
||
type: string
|
||
betreff:
|
||
description: Betreff des CRM-Dokuments
|
||
required: true
|
||
type: string
|
||
content:
|
||
description: Inhalt des CRM-Dokuments
|
||
required: false
|
||
type: string
|
||
adresse_from:
|
||
description: Absender/Mitarbeiter (Adresse-ID)
|
||
required: false
|
||
type: integer
|
||
adresse_to:
|
||
description: Empfänger/Kunde (Adresse-ID)
|
||
required: false
|
||
type: integer
|
||
von:
|
||
description: Anzeigename Absender
|
||
required: false
|
||
type: string
|
||
an:
|
||
description: Anzeigename Empfänger
|
||
required: false
|
||
type: string
|
||
email_an:
|
||
description: E-Mail Adresse Empfänger
|
||
required: false
|
||
type: string
|
||
email_cc:
|
||
description: E-Mail Adresse CC
|
||
required: false
|
||
type: string
|
||
email_bcc:
|
||
description: E-Mail Adresse BCC
|
||
required: false
|
||
type: string
|
||
adresse:
|
||
description: Anschrift 1. Adresszeile
|
||
required: false
|
||
type: string
|
||
plz:
|
||
description: Anschrift Postleitzahl
|
||
required: false
|
||
type: string
|
||
ort:
|
||
description: Anschrift Ort
|
||
required: false
|
||
type: string
|
||
land:
|
||
description: Anschrift Land
|
||
required: false
|
||
type: string
|
||
datum:
|
||
description: Datum des Dokuments
|
||
required: false
|
||
type: date-only
|
||
uhrzeit:
|
||
description: Uhrzeit des Dokuments
|
||
required: false
|
||
type: time-only
|
||
projekt:
|
||
description: Projekt-ID
|
||
required: false
|
||
type: integer
|
||
signatur:
|
||
description: Signatur verwendet (1=ja, 0=nein)
|
||
required: false
|
||
type: integer
|
||
printer:
|
||
description: Nachricht wurde gedruckt (1=ja, 0=nein)
|
||
required: false
|
||
type: integer
|
||
fax:
|
||
description: Fax wurde versendet (1=ja, 0=nein)
|
||
required: false
|
||
type: integer
|
||
sent:
|
||
description: Nachricht wurde versendet (1=ja, 0=nein)
|
||
required: false
|
||
type: integer
|
||
deleted:
|
||
description: Nachricht wurde gelöscht (1=ja, 0=nein)
|
||
required: false
|
||
type: integer
|
||
example: |
|
||
{
|
||
"typ": "brief",
|
||
"betreff": "Test Brief 14"
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 14,
|
||
"adresse_from": 1,
|
||
"adresse_to": 7,
|
||
"typ": "brief",
|
||
"von": "",
|
||
"an": "",
|
||
"email_an": "",
|
||
"send_as": "",
|
||
"email": "",
|
||
"email_cc": null,
|
||
"email_bcc": null,
|
||
"bearbeiter": null,
|
||
"firma_an": "",
|
||
"adresse": "",
|
||
"ansprechpartner": null,
|
||
"plz": "",
|
||
"ort": "",
|
||
"land": "",
|
||
"datum": "0000-00-00",
|
||
"uhrzeit": null,
|
||
"betreff": "Test Brief 14",
|
||
"content": "",
|
||
"projekt": 1,
|
||
"internebezeichnung": "",
|
||
"signatur": 0,
|
||
"fax": 0,
|
||
"sent": 0,
|
||
"printer": 0,
|
||
"deleted": 0
|
||
}
|
||
}
|
||
400:
|
||
description: Request Body Fehlerhaft
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7453,
|
||
"http_code": 400,
|
||
"message": "Validation error",
|
||
"href": "http://localhost/xentral/20.1/www/api/docs.html#error-7453",
|
||
"details": [
|
||
"The attribute 'betreff' is required."
|
||
]
|
||
}
|
||
}
|
||
404:
|
||
description: CRM-Dokument wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
delete:
|
||
displayName: CRM-Dokument löschen
|
||
description: |
|
||
CRM-Dokument löschen
|
||
|
||
Permission: `delete_crm_document`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 14
|
||
}
|
||
}
|
||
404:
|
||
description: CRM-Dokument wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
|
||
/v1/dateien:
|
||
description: Dateiliste abrufen und Dateien downloaden
|
||
get:
|
||
displayName: Dateiliste abrufen
|
||
description: |
|
||
Dateiliste abrufen.
|
||
|
||
Permission: `list_files`
|
||
queryParameters:
|
||
titel:
|
||
description: Suche nach Dateititel (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
titel_equals:
|
||
description: Suche nach Dateititel (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
titel_startswith:
|
||
description: Suche nach Dateititel (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
titel_endswith:
|
||
description: Suche nach Dateititel (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
dateiname:
|
||
description: Suche nach Dateiname (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
dateiname_equals:
|
||
description: Suche nach Dateiname (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
dateiname_startswith:
|
||
description: Suche nach Dateiname (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
dateiname_endswith:
|
||
description: Suche nach Dateiname (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
belegtyp:
|
||
description: Suche nach Zuweisungen zu Belegtyp (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
stichwort:
|
||
description: Suche nach Stichwort (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=dateiname`)
|
||
|
||
Verfügbare Felder: `dateiname`, `datum`, `titel`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=stichwoerter`)
|
||
|
||
Verfügbare Includes: `stichwoerter`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Datei anlegen/hochladen
|
||
description: |
|
||
Datei anlegen/hochladen
|
||
|
||
Permission: `create_files`
|
||
body:
|
||
application/x-www-form-urlencoded:
|
||
properties:
|
||
file_content:
|
||
description: Datei-Inhalt (Raw-Daten)
|
||
required: true
|
||
type: file
|
||
titel:
|
||
description: Datei-Titel
|
||
required: true
|
||
type: string
|
||
dateiname:
|
||
description: Dateiname (ohne Verzeichnis; Beispiel `foo.jpg`)
|
||
required: true
|
||
type: string
|
||
beschreibung:
|
||
description: Beschreibungstext
|
||
required: false
|
||
type: string
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegte Datei wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 123,
|
||
"titel": "Rechnung 400027",
|
||
"beschreibung": "Rechnung 400027 von Kunde Max Mustermann",
|
||
"nummer": "",
|
||
"firma": 1,
|
||
"ersteller": "",
|
||
"datum": "2018-11-15",
|
||
"version": 1,
|
||
"dateiname": "RE400027.pdf",
|
||
"bemerkung": "Initiale Version",
|
||
"size": "8427",
|
||
"stichwoerter": null,
|
||
"belegtypen": null,
|
||
"mimetype": "application/pdf",
|
||
"links": {
|
||
"download": "http://www.example.com/api/v1/dateien/123/download",
|
||
"base64": "http://www.example.com/api/v1/dateien/123/base64"
|
||
}
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Informationen zu einer Datei abrufen
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Datei-ID
|
||
get:
|
||
displayName: Informationen zu einer Datei abrufen
|
||
description: |
|
||
Informationen zu einer Datei abrufen
|
||
|
||
Permission: `view_file`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 115,
|
||
"titel": "Rechnung 400027",
|
||
"beschreibung": "",
|
||
"nummer": "",
|
||
"firma": 1,
|
||
"ersteller": "Max Mustermann",
|
||
"datum": "2018-11-15",
|
||
"version": 1,
|
||
"dateiname": "RE400027.pdf",
|
||
"bemerkung": "Initiale Version",
|
||
"size": "8427",
|
||
"stichwoerter": "Belege",
|
||
"belegtypen": "Verbindlichkeiten",
|
||
"mimetype": "application/pdf",
|
||
"links": {
|
||
"download": "http://www.example.com/api/v1/dateien/115/download",
|
||
"base64": "http://www.example.com/api/v1/dateien/115/base64"
|
||
}
|
||
}
|
||
}
|
||
404:
|
||
description: Datei wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
/download:
|
||
description: Datei downloaden
|
||
get:
|
||
displayName: Datei downloaden
|
||
description: |
|
||
Datei downloaden
|
||
|
||
Permission: `handle_assets`
|
||
responses:
|
||
200:
|
||
description: |
|
||
Request erfolgreich
|
||
|
||
Der Content-Type ist abhängig vom Mime-Type der Datei die gesendet wird.
|
||
/base64:
|
||
description: Dateiinhalt base64-kodiert abrufen
|
||
get:
|
||
displayName: Dateiinhalt base64-kodiert abrufen
|
||
description: |
|
||
Dateiinhalt base64-kodiert abrufen
|
||
|
||
Permission: `handle_assets`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
text/plain:
|
||
example: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=
|
||
|
||
/v1/docscan:
|
||
description: DocumentScanner-Dateiliste abrufen und Dateien downloaden
|
||
get:
|
||
displayName: DocumentScanner-Dateiliste abrufen
|
||
description: |
|
||
DocumentScanner-Dateiliste abrufen
|
||
|
||
Permission: `list_scanned_documents`
|
||
queryParameters:
|
||
titel:
|
||
description: Suche nach Dateititel (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
titel_equals:
|
||
description: Suche nach Dateititel (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
titel_startswith:
|
||
description: Suche nach Dateititel (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
titel_endswith:
|
||
description: Suche nach Dateititel (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
dateiname:
|
||
description: Suche nach Dateiname (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
dateiname_equals:
|
||
description: Suche nach Dateiname (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
dateiname_startswith:
|
||
description: Suche nach Dateiname (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
dateiname_endswith:
|
||
description: Suche nach Dateiname (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
datum:
|
||
description: Suche nach Datum (genaue Übereinstimmung; Format `YYYY-MM-DD`)
|
||
type: string
|
||
required: false
|
||
datum_gt:
|
||
description: Suche nach Datum (Datum größer Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_gte:
|
||
description: Suche nach Datum (Datum größer gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lt:
|
||
description: Suche nach Datum (Datum kleiner Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lte:
|
||
description: Suche nach Datum (Datum kleiner gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
belegtyp:
|
||
description: Suche nach Zuweisungen zu Belegtyp (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
stichwort:
|
||
description: Suche nach Stichwort (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
firma:
|
||
description: Suche nach Firmen-ID
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=dateiname`)
|
||
|
||
Verfügbare Felder: `dateiname`, `datum`, `titel`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=stichwoerter`)
|
||
|
||
Verfügbare Includes: `stichwoerter`, `metadata`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: DocumentScanner-Datei anlegen/hochladen
|
||
description: |
|
||
DocumentScanner-Datei anlegen/hochladen
|
||
|
||
Permission: `create_scanned_documents`
|
||
body:
|
||
multipart/form-data:
|
||
properties:
|
||
file_content:
|
||
description: Datei-Inhalt
|
||
required: true
|
||
type: file
|
||
titel:
|
||
description: Datei-Titel
|
||
required: true
|
||
type: string
|
||
dateiname:
|
||
description: Dateiname (ohne Verzeichnis; Beispiel `beleg.pdf`)
|
||
required: true
|
||
type: string
|
||
beschreibung:
|
||
description: Datei-Beschreibungstext
|
||
required: false
|
||
type: string
|
||
meta:
|
||
description: Meta-Daten
|
||
required: false
|
||
type: array
|
||
meta.invoice_number:
|
||
description: Rechnungsnummer
|
||
required: false
|
||
type: string
|
||
meta.invoice_date:
|
||
description: Rechnungsdatum (Format `YYYY-MM-DD`)
|
||
required: false
|
||
type: string
|
||
meta.invoice_amount:
|
||
description: Rechnungsbetrag brutto (Beispiel `12345.67`)
|
||
required: false
|
||
type: string
|
||
meta.invoice_tax:
|
||
description: Mehrwertsteuerbetrag der Rechnung (Beispiel `12345.67`)
|
||
required: false
|
||
type: string
|
||
meta.invoice_currency:
|
||
description: Währungscode der Rechnung (Beispiel `EUR`)
|
||
required: false
|
||
type: string
|
||
application/x-www-form-urlencoded:
|
||
properties:
|
||
file_content:
|
||
description: Datei-Inhalt (Raw-Daten)
|
||
required: true
|
||
type: string
|
||
titel:
|
||
description: Datei-Titel
|
||
required: true
|
||
type: string
|
||
dateiname:
|
||
description: Dateiname (ohne Verzeichnis; Beispiel `beleg.pdf`)
|
||
required: true
|
||
type: string
|
||
beschreibung:
|
||
description: Datei-Beschreibungstext
|
||
required: false
|
||
type: string
|
||
meta:
|
||
description: Meta-Daten
|
||
required: false
|
||
type: array
|
||
meta.invoice_number:
|
||
description: Rechnungsnummer
|
||
required: false
|
||
type: string
|
||
meta.invoice_date:
|
||
description: Rechnungsdatum (Format `YYYY-MM-DD`)
|
||
required: false
|
||
type: string
|
||
meta.invoice_amount:
|
||
description: Rechnungsbetrag brutto (Beispiel `12345.67`)
|
||
required: false
|
||
type: string
|
||
meta.invoice_tax:
|
||
description: Mehrwertsteuerbetrag der Rechnung (Beispiel `12345.67`)
|
||
required: false
|
||
type: string
|
||
meta.invoice_currency:
|
||
description: Währungscode der Rechnung (Beispiel `EUR`)
|
||
required: false
|
||
type: string
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegte Datei wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 123,
|
||
"titel": "Rechnung 400027",
|
||
"beschreibung": "Rechnung 400027 von Kunde Max Mustermann",
|
||
"nummer": "",
|
||
"firma": 1,
|
||
"ersteller": "",
|
||
"datum": "2018-11-15",
|
||
"version": 1,
|
||
"dateiname": "RE400027.pdf",
|
||
"bemerkung": "Initiale Version",
|
||
"size": "8427",
|
||
"mimetype": "application/pdf",
|
||
"links": {
|
||
"download": "http://www.example.com/api/v1/dateien/123/download",
|
||
"base64": "http://www.example.com/api/v1/dateien/123/base64"
|
||
}
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Informationen zu einer DocumentScanner-Datei abrufen
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Datei-ID
|
||
get:
|
||
displayName: Informationen zu einer DocumentScanner-Datei abrufen
|
||
description: |
|
||
Informationen zu einer DocumentScanner-Datei abrufen
|
||
|
||
Permission: `view_scanned_documents`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 115,
|
||
"titel": "Rechnung 400027",
|
||
"beschreibung": "",
|
||
"nummer": "",
|
||
"firma": 1,
|
||
"ersteller": "Max Mustermann",
|
||
"datum": "2018-11-15",
|
||
"version": 1,
|
||
"dateiname": "RE400027.pdf",
|
||
"bemerkung": "Initiale Version",
|
||
"size": "8427",
|
||
"mimetype": "application/pdf",
|
||
"links": {
|
||
"download": "http://www.example.com/api/v1/dateien/115/download",
|
||
"base64": "http://www.example.com/api/v1/dateien/115/base64"
|
||
}
|
||
}
|
||
}
|
||
404:
|
||
description: Datei wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
|
||
/v1/gruppen:
|
||
description: Gruppen anlegen, bearbeiten und abrufen
|
||
get:
|
||
displayName: Gruppenliste abrufen
|
||
description: |
|
||
Gruppenliste abrufen
|
||
|
||
Permission: `list_groups`
|
||
queryParameters:
|
||
name:
|
||
description: Gruppe mit bestimmter Bezeichnung suchen (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
name_exakt:
|
||
description: Gruppe mit bestimmter Bezeichnung suchen (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kennziffer:
|
||
description: Gruppen mit bestimmter Kennziffer suchen (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
kennziffer_exakt:
|
||
description: Gruppen mit bestimmter Kennziffer suchen (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
art:
|
||
description: |
|
||
Gruppen mit bestimmter Art suchen (genaue Übereinstimmung)
|
||
|
||
Mögliche Werte: `gruppe`, `preisgruppe`, `verband`, `regionalgruppe`, `kategorie`, `vertreter`
|
||
type: string
|
||
required: false
|
||
projekt:
|
||
description: Gruppen mit bestimmten Projekt filtern
|
||
type: integer
|
||
required: false
|
||
kategorie:
|
||
description: Gruppen mit bestimmter Kategorie filtern
|
||
type: integer
|
||
required: false
|
||
aktiv:
|
||
description: Aktive/Inaktive Gruppen filtern (1 = aktiv / 0 = inaktiv)
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=projekt,-bezeichnung`)
|
||
|
||
Verfügbare Felder: `name`, `art`, `kennziffer`, `projekt`, `kategorie`, `aktiv`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=projekt`)
|
||
|
||
Verfügbare Includes: `projekt`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Gruppe anlegen
|
||
description: |
|
||
Gruppe anlegen
|
||
|
||
Permission: `create_groups`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
name:
|
||
description: Bezeichnung der Gruppe
|
||
required: true
|
||
type: string
|
||
art:
|
||
description: Mögliche Werte sind `gruppe`, `preisgruppe`, `verband`, `regionalgruppe`, `kategorie` , `vertreter`
|
||
required: true
|
||
type: string
|
||
kennziffer:
|
||
description: Einmalige Kennziffer
|
||
required: true
|
||
type: string
|
||
projekt:
|
||
description: Projekt-ID
|
||
required: false
|
||
type: integer
|
||
kategorie:
|
||
description: Projekt-ID
|
||
required: false
|
||
type: integer
|
||
aktiv:
|
||
description: Gruppe aktiv? (1 = Aktiv / 0 = Inaktiv)
|
||
required: false
|
||
type: integer
|
||
example: |
|
||
{
|
||
"name": "Support",
|
||
"art": "gruppe",
|
||
"kennziffer": "SUPPORT",
|
||
"projekt": 0,
|
||
"kategorie": 0,
|
||
"aktiv": 1
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegte Gruppe wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": "11",
|
||
"name": "Support",
|
||
"art": "gruppe",
|
||
"kennziffer": "SUPPORT",
|
||
"internebemerkung": "",
|
||
"projekt": "0",
|
||
"kategorie": "0",
|
||
"aktiv": "1"
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelne Gruppe abrufen oder bearbeiten
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Gruppe-ID
|
||
get:
|
||
displayName: Einzelne Gruppe abrufen
|
||
description: |
|
||
Einzelne Gruppe abrufen
|
||
|
||
Permission: `view_group`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": "1",
|
||
"name": "Vertriebsleiter",
|
||
"art": "vertreter",
|
||
"kennziffer": "VETRL",
|
||
"internebemerkung": "",
|
||
"projekt": "0",
|
||
"kategorie": "0",
|
||
"aktiv": "1"
|
||
}
|
||
}
|
||
404:
|
||
description: Gruppe wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
put:
|
||
displayName: Gruppe bearbeiten
|
||
description: |
|
||
Gruppe bearbeiten
|
||
|
||
Permission: `update_group`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"name": "Support (inaktiv)",
|
||
"art": "gruppe",
|
||
"kennziffer": "SUPPORT",
|
||
"aktiv": "0"
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierte Gruppe wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": "11",
|
||
"name": "Support (inaktiv)",
|
||
"art": "gruppe",
|
||
"kennziffer": "SUPPORT",
|
||
"internebemerkung": "",
|
||
"projekt": "0",
|
||
"kategorie": "0",
|
||
"aktiv": "0"
|
||
}
|
||
}
|
||
|
||
|
||
/v1/laender:
|
||
description: Länder anlegen, bearbeiten und abrufen
|
||
get:
|
||
displayName: Länderliste abrufen
|
||
description: |
|
||
Länderliste abrufen
|
||
|
||
Permission: `list_countries`
|
||
queryParameters:
|
||
eu:
|
||
description: Länder innerhalb/außerhalb EU filtern (1 = EU / 0 = Nicht EU)
|
||
type: integer
|
||
required: false
|
||
iso:
|
||
description: Länder mit ISO-Code filtern (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
bezeichnung_de:
|
||
description: Länder mit bestimmter Bezeichnung suchen (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
bezeichnung_en:
|
||
description: Länder mit bestimmter Bezeichnung suchen (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
id_ext:
|
||
description: Land mit externer ID filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=iso,-bezeichnung`)
|
||
|
||
Verfügbare Felder: `bezeichnung`, `bezeichnung_de`, `bezeichnung_en`, `iso` , `eu`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Land anlegen
|
||
description: |
|
||
Land anlegen
|
||
|
||
Permission: `create_countries`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
bezeichnung_de:
|
||
description: Deutsche Bezeichnung des Landes
|
||
required: true
|
||
type: string
|
||
bezeichnung_en:
|
||
description: Englische Bezeichnung des Landes
|
||
required: true
|
||
type: string
|
||
iso:
|
||
description: ISO-Code (ISO-3166 ALPHA 2)
|
||
required: true
|
||
type: string
|
||
eu:
|
||
description: EU (1 = EU / 0 = Nicht EU)
|
||
required: false
|
||
type: integer
|
||
example: |
|
||
{
|
||
"bezeichnung_de": "Republik Togo",
|
||
"bezeichnung_en": "République Togolaise",
|
||
"iso": "TG",
|
||
"eu": 0
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegtes Land wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": "246",
|
||
"iso": "TG",
|
||
"bezeichnung_de": "Republik Togo",
|
||
"bezeichnung_en": "République Togolaise",
|
||
"eu": "0",
|
||
"id_ext": null
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelnes Land abrufen oder bearbeiten
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Land-ID
|
||
get:
|
||
displayName: Einzelnes Land abrufen
|
||
description: |
|
||
Einzelnes Land abrufen
|
||
|
||
Permission: `view_country`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": "43",
|
||
"iso": "DE",
|
||
"bezeichnung_de": "Deutschland",
|
||
"bezeichnung_en": "Germany",
|
||
"eu": "1",
|
||
"id_ext": null
|
||
}
|
||
}
|
||
404:
|
||
description: Land wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
put:
|
||
displayName: Land bearbeiten
|
||
description: |
|
||
Land bearbeiten
|
||
|
||
Permission: `edit_country`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"bezeichnung_de": "Togo",
|
||
"bezeichnung_en": "Republique Togolaise",
|
||
"iso": "TX",
|
||
"eu": 0
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisiertes Land wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": "246",
|
||
"iso": "TX",
|
||
"bezeichnung_de": "Togo",
|
||
"bezeichnung_en": "Republique Togolaise",
|
||
"eu": "0",
|
||
"id_ext": null
|
||
}
|
||
}
|
||
|
||
|
||
/v1/lagercharge:
|
||
description: Lagercharge abrufen
|
||
get:
|
||
displayName: Lagercharge abrufen
|
||
description: |
|
||
Lagercharge abrufen
|
||
|
||
Permission: `view_storage_batch`
|
||
queryParameters:
|
||
artikelnummer:
|
||
description: Suche nach bestimmter Artikelnummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
artikelnummer_equals:
|
||
description: Suche nach bestimmter Artikelnummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
artikelnummer_startswith:
|
||
description: Suche nach bestimmter Artikelnummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
artikelnummer_endswith:
|
||
description: Suche nach bestimmter Artikelnummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
artikel:
|
||
description: Suche nach bestimmter Artikel-ID (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
lagerplatzbezeichnung:
|
||
description: Suche nach bestimmter Lagerplatzbezeichnung (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
lagerplatzbezeichnung_equals:
|
||
description: Suche nach bestimmter Lagerplatzbezeichnung (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
lagerplatzbezeichnung_startswith:
|
||
description: Suche nach bestimmter Lagerplatzbezeichnung (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
lagerplatzbezeichnung_endswith:
|
||
description: Suche nach bestimmter Lagerplatzbezeichnung (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
lagerplatz:
|
||
description: Suche nach bestimmter Lagerplatz-ID (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
charge:
|
||
description: Suche nach bestimmter Charge (ungefähre Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
charge_equals:
|
||
description: Suche nach bestimmter Charge (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
charge_startswith:
|
||
description: Suche nach bestimmter Charge (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
charge_endswith:
|
||
description: Suche nach bestimmter Charge (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
datum:
|
||
description: Suche nach bestimmtem Datum (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
datum_gt:
|
||
description: Suche nach bestimmtem Datum (Datum größer Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_gte:
|
||
description: Suche nach bestimmtem Datum (Datum größer gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lt:
|
||
description: Suche nach bestimmtem Datum (Datum kleiner Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lte:
|
||
description: Suche nach bestimmtem Datum (Datum kleiner gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=artikelnummer,-menge`)
|
||
|
||
Verfügbare Felder: `lagerplatzbezeichnung`, `artikelnummer`, `charge`, `datum` , `menge`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=artikel`)
|
||
|
||
Verfügbare Includes: `artikel`, `lagerplatz`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
responses:
|
||
200:
|
||
description: |
|
||
Request erfolgreich
|
||
|
||
Die Menge wird gruppiert über drei Felder: `artikel`, `lagerplatz` und `charge`.
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": [
|
||
{
|
||
"artikel": 1,
|
||
"artikelnummer": "700001",
|
||
"lagerplatz": 1,
|
||
"lagerplatzbezeichnung": "HL001A",
|
||
"charge": "111111",
|
||
"datum": "2018-12-21",
|
||
"menge": "200.0000",
|
||
"internebemerkung": ""
|
||
},
|
||
{
|
||
"artikel": 1,
|
||
"artikelnummer": "700001",
|
||
"lagerplatz": 2,
|
||
"lagerplatzbezeichnung": "HL001B",
|
||
"charge": "222222",
|
||
"datum": "2018-12-21",
|
||
"menge": "300.0000",
|
||
"internebemerkung": ""
|
||
}
|
||
],
|
||
"pagination": {
|
||
"items_per_page": 20,
|
||
"items_current": 2,
|
||
"items_total": 2,
|
||
"page_current": 1,
|
||
"page_last": 1
|
||
}
|
||
}
|
||
|
||
|
||
/v1/lagermhd:
|
||
description: Lager-Mindesthaltbarkeitdatum abrufen
|
||
get:
|
||
displayName: Lager-Mindesthaltbarkeitdatum abrufen
|
||
description: |
|
||
Lager-Mindesthaltbarkeitdatum abrufen
|
||
|
||
Permission: `view_storage_best_before`
|
||
queryParameters:
|
||
artikelnummer:
|
||
description: Suche nach bestimmter Artikelnummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
artikelnummer_equals:
|
||
description: Suche nach bestimmter Artikelnummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
artikelnummer_startswith:
|
||
description: Suche nach bestimmter Artikelnummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
artikelnummer_endswith:
|
||
description: Suche nach bestimmter Artikelnummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
artikel:
|
||
description: Suche nach bestimmter Artikel-ID (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
lagerplatzbezeichnung:
|
||
description: Suche nach bestimmter Lagerplatzbezeichnung (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
lagerplatzbezeichnung_equals:
|
||
description: Suche nach bestimmter Lagerplatzbezeichnung (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
lagerplatzbezeichnung_startswith:
|
||
description: Suche nach bestimmter Lagerplatzbezeichnung (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
lagerplatzbezeichnung_endswith:
|
||
description: Suche nach bestimmter Lagerplatzbezeichnung (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
lagerplatz:
|
||
description: Suche nach bestimmter Lagerplatz-ID (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
charge:
|
||
description: Suche nach bestimmter Charge (ungefähre Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
charge_equals:
|
||
description: Suche nach bestimmter Charge (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
charge_startswith:
|
||
description: Suche nach bestimmter Charge (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
charge_endswith:
|
||
description: Suche nach bestimmter Charge (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
mhddatum:
|
||
description: Suche nach bestimmtem MHD-Datum (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
mhddatum_gt:
|
||
description: Suche nach bestimmtem MHD-Datum (MHD-Datum größer Suchwert)
|
||
type: string
|
||
required: false
|
||
mhddatum_gte:
|
||
description: Suche nach bestimmtem MHD-Datum (MHD-Datum größer gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
mhddatum_lt:
|
||
description: Suche nach bestimmtem MHD-Datum (MHD-Datum kleiner Suchwert)
|
||
type: string
|
||
required: false
|
||
mhddatum_lte:
|
||
description: Suche nach bestimmtem MHD-Datum (MHD-Datum kleiner gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
datum:
|
||
description: Suche nach bestimmtem Datum (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
datum_gt:
|
||
description: Suche nach bestimmtem Datum (Datum größer Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_gte:
|
||
description: Suche nach bestimmtem Datum (Datum größer gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lt:
|
||
description: Suche nach bestimmtem Datum (Datum kleiner Suchwert)
|
||
type: string
|
||
required: false
|
||
datum_lte:
|
||
description: Suche nach bestimmtem Datum (Datum kleiner gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=artikelnummer,-menge`)
|
||
|
||
Verfügbare Felder: `lagerplatzbezeichnung`, `artikelnummer`, `charge`, `mhddatum`, `datum` , `menge`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=artikel`)
|
||
|
||
Verfügbare Includes: `artikel`, `lagerplatz`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
responses:
|
||
200:
|
||
description: |
|
||
Request erfolgreich
|
||
|
||
Die Menge wird gruppiert über vier Felder: `artikel`, `lagerplatz`, `charge` und `mhddatum`.
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": [
|
||
{
|
||
"artikel": 1,
|
||
"artikelnummer": "700001",
|
||
"lagerplatz": 1,
|
||
"lagerplatzbezeichnung": "HL001A",
|
||
"charge": "444444",
|
||
"mhddatum": "2019-12-24",
|
||
"datum": "2018-12-21",
|
||
"menge": "300.0000",
|
||
"internebemerkung": "Charge und / oder MHD angelegt"
|
||
},
|
||
{
|
||
"artikel": 1,
|
||
"artikelnummer": "700001",
|
||
"lagerplatz": 4,
|
||
"lagerplatzbezeichnung": "HL002",
|
||
"charge": "555555",
|
||
"mhddatum": "2019-12-23",
|
||
"datum": "2018-12-21",
|
||
"menge": "289.0000",
|
||
"internebemerkung": "Produktion 400003 Einlagern"
|
||
}
|
||
],
|
||
"pagination": {
|
||
"items_per_page": 20,
|
||
"items_current": 2,
|
||
"items_total": 2,
|
||
"page_current": 1,
|
||
"page_last": 1
|
||
}
|
||
}
|
||
|
||
|
||
/v1/lieferadressen:
|
||
description: Lieferadressen anlegen, bearbeiten und abrufen
|
||
get:
|
||
displayName: Lieferadressen abrufen
|
||
description: |
|
||
Lieferadressen abrufen
|
||
|
||
Permission: `list_delivery_addresses`
|
||
queryParameters:
|
||
adresse:
|
||
description: Suche nach allen Lieferadressen einer bestimmten Hauptadresse
|
||
type: integer
|
||
required: false
|
||
standardlieferadresse:
|
||
description: Ist Standard-Lieferadresse? (0 = Keine Standard-Lieferadresse / 1 = Ist Standard-Lieferadresse)
|
||
type: integer
|
||
required: false
|
||
typ:
|
||
description: |
|
||
Nach bestimmten Adresstyp filtern (genaue Übereinstimmung)
|
||
|
||
Mögliche Werte: Siehe Adresstyp-Endpunkt: [GET /adresstyp](#adresstyp).
|
||
type: string
|
||
required: false
|
||
name:
|
||
description: Suche nach Name (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
name_equals:
|
||
description: Suche nach Name (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
name_startswith:
|
||
description: Suche nach Name (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
name_endswith:
|
||
description: Suche nach Name (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
land:
|
||
description: Suche nach Lieferadressen aus einem bestimmten Land (zweistelliger ISO-Code)
|
||
type: string
|
||
required: false
|
||
id_ext:
|
||
description: Lieferadresse mit externer ID filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=plz,-land`)
|
||
|
||
Verfügbare Felder: `typ`, `name`, `plz`, `land`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Lieferadresse anlegen
|
||
description: |
|
||
Lieferadresse anlegen
|
||
|
||
Permission: `create_delivery_address`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
name:
|
||
description: Name der Firma bzw. Person
|
||
required: true
|
||
type: string
|
||
adresse:
|
||
description: ID der Hauptadresse; Die angelegte Lieferadresse wird dieser Hauptadresse zugeordnet.
|
||
required: false
|
||
type: integer
|
||
typ:
|
||
description: Adresstyp; Siehe [Adresstyp-Endpunkt](#adresstyp) Feld `type`.
|
||
required: false
|
||
type: string
|
||
abteilung:
|
||
required: false
|
||
type: string
|
||
strasse:
|
||
required: false
|
||
type: string
|
||
ort:
|
||
required: false
|
||
type: string
|
||
plz:
|
||
required: false
|
||
type: string
|
||
telefon:
|
||
required: false
|
||
type: string
|
||
telefax:
|
||
required: false
|
||
type: string
|
||
email:
|
||
required: false
|
||
type: string
|
||
land:
|
||
description: ISO-Code (ISO-3166 ALPHA 2)
|
||
required: false
|
||
type: string
|
||
standardlieferadresse:
|
||
description: |
|
||
Als Standard-Lieferadresse markieren?
|
||
|
||
(`0` = Keine Standard-Lieferadresse / `1` = Ist Standard-Lieferadresse)
|
||
required: false
|
||
type: integer
|
||
ust_befreit:
|
||
description: |
|
||
Besteuerung
|
||
|
||
(`0` = Inland / `1` = EU-Lieferung / `2` = Export / `3` = Steuerfrei Inland)
|
||
required: false
|
||
type: integer
|
||
example: |
|
||
{
|
||
"adresse": 5,
|
||
"typ": "herr",
|
||
"name": "Max Mustermann",
|
||
"abteilung": "Musterabteilung",
|
||
"strasse": "Musterweg",
|
||
"ort": "Musterort",
|
||
"plz": "12345",
|
||
"land": "DE",
|
||
"telefon": "0123-456789-9",
|
||
"telefax": "0123-456789-0",
|
||
"email": "max@mustermann.de",
|
||
"standardlieferadresse": 1,
|
||
"ust_befreit": 0
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegte Lieferadresse wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 23,
|
||
"typ": "herr",
|
||
"name": "Max Mustermann",
|
||
"abteilung": "Musterabteilung",
|
||
"...": "Ausgabe gekürzt",
|
||
"standardlieferadresse": 1,
|
||
"ust_befreit": 0,
|
||
"id_ext": null
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelne Lieferadresse abrufen oder bearbeiten
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Lieferadressen-ID
|
||
get:
|
||
displayName: Einzelne Lieferadresse abrufen
|
||
description: |
|
||
Einzelne Lieferadresse abrufen
|
||
|
||
Permission: `view_delivery_address`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 1,
|
||
"typ": "herr",
|
||
"name": "Max Mustermann",
|
||
"abteilung": "Musterabteilung",
|
||
"...": "Ausgabe gekürzt",
|
||
"standardlieferadresse": 1,
|
||
"ust_befreit": 0,
|
||
"id_ext": null
|
||
}
|
||
}
|
||
404:
|
||
description: Lieferadresse wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
put:
|
||
displayName: Lieferadresse bearbeiten
|
||
description: |
|
||
Lieferadresse bearbeiten
|
||
|
||
Permission: `edit_delivery_address`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"typ": "firma",
|
||
"name": "Mustermann Gmbh"
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierte Lieferadresse wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 1,
|
||
"typ": "firma",
|
||
"name": "Mustermann Gmbh",
|
||
"abteilung": "Musterabteilung",
|
||
"...": "Ausgabe gekürzt",
|
||
"standardlieferadresse": 1,
|
||
"ust_befreit": 0,
|
||
"id_ext": null
|
||
}
|
||
}
|
||
delete:
|
||
displayName: Lieferadresse löschen
|
||
description: |
|
||
Lieferadresse löschen
|
||
|
||
Permission: `delete_delivery_address`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; ID der gelöschten Lieferadresse wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 1
|
||
}
|
||
}
|
||
|
||
/v1/reports:
|
||
displayName: /v1/reports
|
||
description: Berichte (neues Modul) abrufen
|
||
|
||
/{id}/download:
|
||
description: |
|
||
Einzelnen Bericht per ID herunterladen
|
||
|
||
Permission: `view_report`
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Bericht-ID
|
||
get:
|
||
displayName: Einzelnen Bericht herunterladen
|
||
description: Einzelnen Bericht herunterladen
|
||
queryParameters:
|
||
parameter:
|
||
description: Jeder Parameter, der in der Abfrage des Berichts vorkommt.
|
||
type: any
|
||
required: false
|
||
responses:
|
||
200:
|
||
description: |
|
||
Request erfolgreich
|
||
|
||
Der Content-Type ist abhängig vom Mime-Type des Formats, das im Bericht hinterlegt ist.
|
||
403:
|
||
description: Der Bericht ist nicht für den Zugriff über diesen API Account freigegeben.
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"http_code": 403,
|
||
"message": "Access denied"
|
||
}
|
||
}
|
||
404:
|
||
description: Bericht wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
500:
|
||
description: Der Bericht konnte nicht erstellt werden. Der Bericht ist eventuell fehlerhaft.
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7499,
|
||
"http_code": 500,
|
||
"message": "Unknown server error",
|
||
"href": "http://localhost/xentral/20.1/www/api/docs.html#error-7499"
|
||
}
|
||
}
|
||
/v1/steuersaetze:
|
||
description: Steuersätze anlegen, bearbeiten und abrufen
|
||
get:
|
||
displayName: Steuersätze abrufen
|
||
description: |
|
||
Steuersätze abrufen
|
||
|
||
Permission: `list_tax_rates`
|
||
queryParameters:
|
||
bezeichnung:
|
||
description: Steuersatz mit bestimmter Bezeichnung suchen (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
satz:
|
||
description: Nach Steuersatz filtern (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
aktiv:
|
||
description: Aktive/Inaktive Steuersätze filtern (1 = aktiv / 0 = inaktiv)
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=satz,-bezeichnung`)
|
||
|
||
Verfügbare Felder: `bezeichnung`, `satz`, `aktiv`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Steuersatz anlegen
|
||
description: |
|
||
Steuersatz anlegen
|
||
|
||
Permission: `create_tax_rate`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
bezeichnung:
|
||
description: Bezeichnung des Steuersatzes
|
||
required: true
|
||
type: string
|
||
satz:
|
||
description: Steuersatz in Prozent (ohne Prozentzeichen; Dezimaltrenner = Punkt)
|
||
required: true
|
||
type: string
|
||
aktiv:
|
||
description: Aktiv (1 = aktiv / 0 = inaktiv)
|
||
required: false
|
||
type: integer
|
||
example: |
|
||
{
|
||
"bezeichnung": "Steuer DE ermäßigt",
|
||
"satz": "7.00",
|
||
"aktiv": 1
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegter Steuersatz wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": "14",
|
||
"bezeichnung": "Steuer DE ermäßigt",
|
||
"satz": "7.00",
|
||
"aktiv": "1"
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelnen Steuersatz abrufen oder bearbeiten
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Steuersatz-ID
|
||
get:
|
||
displayName: Einzelnen Steuersatz abrufen
|
||
description: |
|
||
Einzelnen Steuersatz abrufen
|
||
|
||
Permission: `view_tax_rate`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": "1",
|
||
"bezeichnung": "Steuersatz DE normal",
|
||
"country_code": "DE",
|
||
"satz": "19.00",
|
||
"aktiv": "1"
|
||
}
|
||
}
|
||
404:
|
||
description: Steuersatz wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
put:
|
||
displayName: Steuersatz bearbeiten
|
||
description: |
|
||
Steuersatz bearbeiten
|
||
|
||
Permission: `edit_tax_rates`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
bezeichnung:
|
||
description: Bezeichnung des Steuersatzes
|
||
required: true
|
||
type: string
|
||
country_code:
|
||
description: Ländercode des Steuersatzes
|
||
required: false
|
||
type: string
|
||
satz:
|
||
description: Steuersatz in Prozent (ohne Prozentzeichen; Dezimaltrenner = Punkt)
|
||
required: true
|
||
type: string
|
||
aktiv:
|
||
description: Aktiv (1 = aktiv / 0 = inaktiv)
|
||
required: false
|
||
type: integer
|
||
example: |
|
||
{
|
||
"bezeichnung": "Steuer DE normal",
|
||
"satz": "19.00"
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierter Steuersatz wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": "1",
|
||
"bezeichnung": "Steuer DE normal",
|
||
"country_code": "DE",
|
||
"satz": "19.00",
|
||
"aktiv": "1"
|
||
}
|
||
}
|
||
|
||
|
||
/v1/trackingnummern:
|
||
get:
|
||
displayName: Trackingnummern abrufen
|
||
description: |
|
||
Endpunkt zum Abrufen von Trackingnummern
|
||
|
||
Permission: `list_tracking_numbers`
|
||
queryParameters:
|
||
tracking:
|
||
description: Suche nach bestimmter Trackingnummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
tracking_equals:
|
||
description: Suche nach bestimmter Trackingnummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
tracking_startswith:
|
||
description: Suche nach bestimmter Trackingnummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
tracking_endswith:
|
||
description: Suche nach bestimmter Trackingnummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
lieferschein:
|
||
description: Suche nach bestimmter Lieferscheinnummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
lieferschein_equals:
|
||
description: Suche nach bestimmter Lieferscheinnummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
lieferschein_startswith:
|
||
description: Suche nach bestimmter Lieferscheinnummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
lieferschein_endswith:
|
||
description: Suche nach bestimmter Lieferscheinnummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
auftrag:
|
||
description: Suche nach bestimmter Auftragsnummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
auftrag_equals:
|
||
description: Suche nach bestimmter Auftragsnummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
auftrag_startswith:
|
||
description: Suche nach bestimmter Auftragsnummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
auftrag_endswith:
|
||
description: Suche nach bestimmter Auftragsnummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
internet:
|
||
description: Suche nach bestimmter Internetnummer (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
internet_equals:
|
||
description: Suche nach bestimmter Internetnummer (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
internet_startswith:
|
||
description: Suche nach bestimmter Internetnummer (Übereinstimmung am Anfang)
|
||
type: string
|
||
required: false
|
||
internet_endswith:
|
||
description: Suche nach bestimmter Internetnummer (Übereinstimmung am Ende)
|
||
type: string
|
||
required: false
|
||
versandart:
|
||
description: Suche nach bestimmter Versandart (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
versendet_am:
|
||
description: Suche nach bestimmtem Versanddatum (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
versendet_am_gt:
|
||
description: Suche nach bestimmtem Versanddatum (Datum größer Suchwert)
|
||
type: string
|
||
required: false
|
||
versendet_am_gte:
|
||
description: Suche nach bestimmtem Versanddatum (Datum größer gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
versendet_am_lt:
|
||
description: Suche nach bestimmtem Versanddatum (Datum kleiner Suchwert)
|
||
type: string
|
||
required: false
|
||
versendet_am_lte:
|
||
description: Suche nach bestimmtem Versanddatum (Datum kleiner gleich Suchwert)
|
||
type: string
|
||
required: false
|
||
adresse:
|
||
description: Suche nach bestimmter Adress-ID (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
projekt:
|
||
description: Suche nach bestimmter Projekt-ID (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
land:
|
||
description: Suche nach bestimmtem Ländercode (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=-versendet_am,lieferschein`)
|
||
|
||
Verfügbare Felder: `tracking`, `auftrag`, `lieferschein`, `versandart`, `versendet_am` , `abgeschlossen`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=projekt`)
|
||
|
||
Verfügbare Includes: `projekt`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Trackingnummer anlegen
|
||
description: |
|
||
Trackingnummer anlegen
|
||
|
||
Eines der Felder `internet`, `auftrag` oder `lieferschein` muss mindestens gefüllt sein!
|
||
|
||
Permission: `create_tracking_number`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
tracking:
|
||
description: Trackingnummer
|
||
required: true
|
||
type: string
|
||
internet:
|
||
description: Internetnummer aus Auftrag (Pflichtfeld, wenn Auftragsnummer und Lieferscheinnummer leer)
|
||
required: false
|
||
type: string
|
||
auftrag:
|
||
description: Auftragsnummer (Pflichtfeld, wenn Internetnummer und Lieferscheinnummer leer)
|
||
required: false
|
||
type: string
|
||
lieferschein:
|
||
description: Lieferscheinnummer (Pflichtfeld, wenn Auftragsnummer und Internetnummer leer)
|
||
required: false
|
||
type: string
|
||
anzahlpakete:
|
||
description: Anzahl Pakete
|
||
required: true
|
||
type: integer
|
||
gewicht:
|
||
description: Gewicht
|
||
required: true
|
||
type: string
|
||
versendet_am:
|
||
description: Versanddatum im Format `YYYY-MM-DD`
|
||
required: true
|
||
type: string
|
||
example: |
|
||
{
|
||
"tracking": "11223344556677889900",
|
||
"internet": "111001",
|
||
"auftrag": "200001",
|
||
"lieferschein": "300001",
|
||
"anzahlpakete": 1,
|
||
"gewicht": "2 kg",
|
||
"versendet_am": "2019-07-25"
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegte Trackingnummer wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 8,
|
||
"tracking": "11223344556677889900",
|
||
"adresse": 5,
|
||
"internet": "111001",
|
||
"auftrag": "200001",
|
||
"lieferschein": "300001",
|
||
"projekt": 1,
|
||
"versandart": "versandunternehmen",
|
||
"land": "DE",
|
||
"gewicht": "2 kg",
|
||
"abgeschlossen": 0,
|
||
"versendet_am": "2019-07-25",
|
||
"anzahlpakete": 1,
|
||
"retoure": 0,
|
||
"klaergrund": ""
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelne Trackingnummer abrufen oder bearbeiten
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Trackingnummer-ID
|
||
get:
|
||
displayName: Einzelne Trackingnummer abrufen
|
||
description: |
|
||
Einzelne Trackingnummer abrufen
|
||
|
||
Permission: `view_tracking_number`
|
||
put:
|
||
displayName: Trackingnummer bearbeiten
|
||
description: |
|
||
Trackingnummer bearbeiten (Felder siehe "Trackingnummer anlegen")
|
||
|
||
Permission: `edit_tracking_number`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"tracking": "11223344556677889900",
|
||
"versendet_am": "2019-06-22",
|
||
"anzahlpakete": 2
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierter Trackingnummern-Eintrag wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 8,
|
||
"tracking": "11223344556677889900",
|
||
"adresse": 5,
|
||
"internet": "111001",
|
||
"auftrag": "200001",
|
||
"lieferschein": "300001",
|
||
"projekt": 1,
|
||
"versandart": "versandunternehmen",
|
||
"land": "DE",
|
||
"gewicht": "2 kg",
|
||
"abgeschlossen": 0,
|
||
"versendet_am": "2019-06-22",
|
||
"anzahlpakete": 2,
|
||
"retoure": 0,
|
||
"klaergrund": ""
|
||
}
|
||
}
|
||
|
||
|
||
/v1/versandarten:
|
||
description: Versandarten anlegen, bearbeiten und abrufen
|
||
get:
|
||
displayName: Versandarten abrufen
|
||
description: |
|
||
Versandarten abrufen
|
||
|
||
Permission: `list_shipping_methods`
|
||
queryParameters:
|
||
bezeichnung:
|
||
description: Versandart mit bestimmter Bezeichnung suchen (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
bezeichnung_exakt:
|
||
description: Versandart mit bestimmter Bezeichnung suchen (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
type:
|
||
description: Versandart eines bestimmten Typs suchen (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
type_exakt:
|
||
description: Versandart eines bestimmten Typs suchen (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
projekt:
|
||
description: Versandarten eines Projekts filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
modul:
|
||
description: Versandarten mit bestimmtem Modul filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
aktiv:
|
||
description: Aktive/Inaktive Versandarten filtern (1 = aktiv / 0 = inaktiv)
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=type,-bezeichnung`)
|
||
|
||
Verfügbare Felder: `bezeichnung`, `type`, `projekt`, `modul`, `aktiv`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=projekt`)
|
||
|
||
Verfügbare Includes: `projekt`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Versandart anlegen
|
||
description: |
|
||
Versandart anlegen
|
||
|
||
Permission: `create_shipping_method`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
bezeichnung:
|
||
description: Bezeichnung der Versandart
|
||
required: true
|
||
type: string
|
||
type:
|
||
description: Versandart-Typ (einmaliger Wert)
|
||
required: true
|
||
type: string
|
||
projekt:
|
||
description: Projekt
|
||
required: false
|
||
type: integer
|
||
aktiv:
|
||
description: Aktiv (1 = aktiv / 0 = inaktiv)
|
||
required: false
|
||
type: integer
|
||
example: |
|
||
{
|
||
"type": "DHL",
|
||
"bezeichnung": "DHL",
|
||
"aktiv": 1,
|
||
"projekt": 1
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegte Versandart wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": "15",
|
||
"type": "DHL",
|
||
"bezeichnung": "DHL",
|
||
"aktiv": "1",
|
||
"projekt": "1",
|
||
"modul": "",
|
||
"paketmarke_drucker": "0",
|
||
"export_drucker": "0",
|
||
"ausprojekt": "1",
|
||
"versandmail": "0",
|
||
"geschaeftsbrief_vorlage": "0"
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelne Versandart abrufen oder bearbeiten
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Versandarten-ID
|
||
get:
|
||
displayName: Einzelnen Versandart abrufen
|
||
description: |
|
||
Einzelnen Versandart abrufen
|
||
|
||
Permission: `view_shipping_method`
|
||
queryParameters:
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=projekt`)
|
||
|
||
Verfügbare Includes: `projekt`
|
||
type: string
|
||
required: false
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": "15",
|
||
"type": "DHL",
|
||
"bezeichnung": "DHL",
|
||
"aktiv": "1",
|
||
"projekt": "1",
|
||
"modul": "",
|
||
"paketmarke_drucker": "0",
|
||
"export_drucker": "0",
|
||
"ausprojekt": "1",
|
||
"versandmail": "0",
|
||
"geschaeftsbrief_vorlage": "0"
|
||
}
|
||
}
|
||
404:
|
||
description: Versandart wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
put:
|
||
displayName: Versandart bearbeiten
|
||
description: |
|
||
Versandart bearbeiten
|
||
|
||
Permission: `edit_shipping_method`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"type": "DHL_Paket",
|
||
"bezeichnung": "DHL Paket",
|
||
"aktiv": "1",
|
||
"projekt": "1"
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierte Versandart wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": "15",
|
||
"type": "DHL_Paket",
|
||
"bezeichnung": "DHL Paket",
|
||
"aktiv": "1",
|
||
"projekt": "1",
|
||
"modul": "",
|
||
"paketmarke_drucker": "0",
|
||
"export_drucker": "0",
|
||
"ausprojekt": "1",
|
||
"versandmail": "0",
|
||
"geschaeftsbrief_vorlage": "0"
|
||
}
|
||
}
|
||
|
||
|
||
/v1/wiedervorlagen:
|
||
description: Wiedervorlagen anlegen, bearbeiten und abrufen
|
||
get:
|
||
displayName: Wiedervorlagen abrufen
|
||
description: |
|
||
Wiedervorlagen abrufen
|
||
|
||
Permission: `list_resubmissions`
|
||
queryParameters:
|
||
adresse:
|
||
description: Wiedervorlagen mit bestimmter Address-ID filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
adresse_mitarbeiter:
|
||
description: Wiedervorlagen filtern die einem bestimmten Mitarbeiter (Address-ID) zugewiesen sind (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
bearbeiter:
|
||
description: Wiedervorlagen filtern die einem bestimmten Bearbeiter (Address-ID) zugewiesen sind (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
projekt:
|
||
description: Wiedervorlagen mit bestimmter Projekt-ID filtern (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
stages:
|
||
description: Wiedervorlagen mit bestimmter Stage-ID filtern (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
id_ext:
|
||
description: Wiedervorlage mit externer ID filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=iso,-bezeichnung`)
|
||
|
||
Verfügbare Felder: `bezeichnung`, `datum_angelegt`, `zeit_angelegt`, `datum_erinnerung` , `zeit_erinnerung`,
|
||
`stages`, `prio`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Wiedervorlage anlegen
|
||
description: |
|
||
Wiedervorlage anlegen
|
||
|
||
Permission: `create_resubmission`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
datum_erinnerung:
|
||
description: Fälligkeits-Datum der Wiedervorlage (Format `2019-12-31`)
|
||
required: true
|
||
type: date-only
|
||
zeit_erinnerung:
|
||
description: Fälligkeits-Uhrzeit der Wiedervorlage (Format `23:59:59`)
|
||
required: true
|
||
type: time-only
|
||
datum_angelegt:
|
||
description: Anlage-Datum der Wiedervorlage (Format `2019-12-31`)
|
||
required: false
|
||
type: date-only
|
||
zeit_angelegt:
|
||
description: Anlage-Uhrzeit der Wiedervorlage (Format `23:59:59`)
|
||
required: false
|
||
type: time-only
|
||
bezeichnung:
|
||
description: Kurzbeschreibung
|
||
required: true
|
||
type: string
|
||
beschreibung:
|
||
description: Langbeschreibung
|
||
required: false
|
||
type: string
|
||
bearbeiter:
|
||
description: Address-ID des Bearbeiters
|
||
required: false
|
||
type: integer
|
||
adresse_mitarbeiter:
|
||
description: Address-ID des zuständigen Mitarbeiters
|
||
required: false
|
||
type: integer
|
||
datum_abschluss:
|
||
description: Abschlussdatum der Wiedervorlage (Format `2019-12-31`)
|
||
required: false
|
||
type: date-only
|
||
example: |
|
||
{
|
||
"bearbeiter": 4,
|
||
"bezeichnung": "Blumengießen",
|
||
"beschreibung": "Alle Blumen im Büro gießen",
|
||
"datum_erinnerung": "2019-12-31",
|
||
"zeit_erinnerung": "23:59:59",
|
||
"datum_abschluss": "2020-01-06",
|
||
"adresse_mitarbeiter": 1
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegte Wiedervorlage wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": 49,
|
||
"adresse": 0,
|
||
"projekt": 0,
|
||
"bezeichnung": "Blumengießen",
|
||
"beschreibung": "Alle Blumen im Büro gießen",
|
||
"bearbeiter": 4,
|
||
"adresse_mitarbeiter": 1,
|
||
"datum_erinnerung": "2019-12-31",
|
||
"zeit_erinnerung": "23:59:59",
|
||
"datum_abschluss": "2020-01-06",
|
||
"oeffentlich": 0,
|
||
"abgeschlossen": 0,
|
||
"prio": 0,
|
||
"stages": 0,
|
||
"color": "",
|
||
"id_ext": null
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelne Wiedervorlage abrufen oder bearbeiten
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Wiedervorlage-ID
|
||
get:
|
||
displayName: Einzelne Wiedervorlage abrufen
|
||
description: |
|
||
Einzelne Wiedervorlage abrufen
|
||
|
||
Permission: `view_resubmission`
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 49,
|
||
"adresse": 1,
|
||
"projekt": 1,
|
||
"bezeichnung": "Blumengießen",
|
||
"beschreibung": "Alle Blumen im Büro gießen",
|
||
"ergebnis": "",
|
||
"betrag": "5.00",
|
||
"erinnerung_per_mail": 0,
|
||
"bearbeiter": 4,
|
||
"adresse_mitarbeiter": 1,
|
||
"datum_angelegt": null,
|
||
"zeit_angelegt": null,
|
||
"datum_erinnerung": "2019-12-31",
|
||
"zeit_erinnerung": "23:59:00",
|
||
"datum_abschluss": "2020-01-06",
|
||
"oeffentlich": 0,
|
||
"abgeschlossen": 1,
|
||
"chance": 100,
|
||
"prio": 0,
|
||
"stages": 2,
|
||
"color": "",
|
||
"id_ext": null
|
||
}
|
||
}
|
||
404:
|
||
description: Wiedervorlage wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
put:
|
||
displayName: Wiedervorlage bearbeiten
|
||
description: |
|
||
Wiedervorlage bearbeiten
|
||
|
||
Permission: `edit_resubmission`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"bearbeiter": 1,
|
||
"bezeichnung": "Blumengießen",
|
||
"datum_erinnerung": "2019-12-31",
|
||
"zeit_erinnerung": "23:59:59"
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierte Wiedervorlage wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": 49,
|
||
"adresse": 1,
|
||
"projekt": 1,
|
||
"bezeichnung": "Blumengießen",
|
||
"beschreibung": "Alle Blumen im Büro gießen",
|
||
"ergebnis": "",
|
||
"betrag": "5.00",
|
||
"erinnerung_per_mail": 0,
|
||
"bearbeiter": 1,
|
||
"adresse_mitarbeiter": 1,
|
||
"datum_angelegt": null,
|
||
"zeit_angelegt": null,
|
||
"datum_erinnerung": "2019-12-31",
|
||
"zeit_erinnerung": "23:59:00",
|
||
"datum_abschluss": "2020-01-06",
|
||
"oeffentlich": 0,
|
||
"abgeschlossen": 1,
|
||
"chance": 100,
|
||
"prio": 0,
|
||
"stages": 2,
|
||
"color": "",
|
||
"id_ext": null
|
||
}
|
||
}
|
||
|
||
|
||
/v1/zahlungsweisen:
|
||
description: Zahlungsweisen anlegen, bearbeiten und abrufen
|
||
get:
|
||
displayName: Zahlungsweisen abrufen
|
||
description: |
|
||
Zahlungsweisen abrufen
|
||
|
||
Permission: `list_payment_methods`
|
||
queryParameters:
|
||
bezeichnung:
|
||
description: Zahlungsweise mit bestimmter Bezeichnung suchen (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
bezeichnung_exakt:
|
||
description: Zahlungsweise mit bestimmter Bezeichnung suchen (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
type:
|
||
description: Nach bestimmten Typ filtern (ungefähre Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
type_exakt:
|
||
description: Nach bestimmten Typ filtern (genaue Übereinstimmung)
|
||
type: string
|
||
required: false
|
||
projekt:
|
||
description: Zahlungsweise eines Projekts filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
modul:
|
||
description: Nach bestimmtem Modul filtern (genaue Übereinstimmung)
|
||
type: integer
|
||
required: false
|
||
aktiv:
|
||
description: Aktive/Inaktive Zahlungsweise filtern (1 = aktiv / 0 = inaktiv)
|
||
type: integer
|
||
required: false
|
||
sort:
|
||
description: |
|
||
Sortierung (Beispiel: `sort=type,-bezeichnung`)
|
||
|
||
Verfügbare Felder: `bezeichnung`, `type`, `projekt`, `modul`, `aktiv`
|
||
type: string
|
||
required: false
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=projekt`)
|
||
|
||
Verfügbare Includes: `projekt`
|
||
type: string
|
||
required: false
|
||
page:
|
||
description: Seitenzahl
|
||
type: integer
|
||
required: false
|
||
default: 1
|
||
maximum: 1000
|
||
items:
|
||
description: Anzahl der Ergebnisse pro Seite
|
||
type: integer
|
||
required: false
|
||
default: 20
|
||
maximum: 1000
|
||
post:
|
||
displayName: Zahlungsweisen anlegen
|
||
description: |
|
||
Zahlungsweisen anlegen
|
||
|
||
Permission: `create_payment_method`
|
||
body:
|
||
application/json:
|
||
properties:
|
||
bezeichnung:
|
||
description: Bezeichnung der Zahlungsweise
|
||
required: true
|
||
type: string
|
||
type:
|
||
description: Zahlungsweise-Typ (einmaliger Wert)
|
||
required: true
|
||
type: string
|
||
verhalten:
|
||
description: Verhalten; Zulässige Werte sind `vorkasse`, `rechnung`, `lastschrift`
|
||
required: false
|
||
type: string
|
||
projekt:
|
||
description: Projekt
|
||
required: false
|
||
type: integer
|
||
aktiv:
|
||
description: Aktiv (`1` = aktiv / `0` = inaktiv)
|
||
required: false
|
||
type: integer
|
||
example: |
|
||
{
|
||
"type": "vorkasse",
|
||
"bezeichnung": "Vorkasse",
|
||
"verhalten": "vorkasse",
|
||
"aktiv": 1,
|
||
"projekt": 1
|
||
}
|
||
responses:
|
||
201:
|
||
description: Request erfolgreich; Angelegte Zahlungsweise wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": "10",
|
||
"type": "vorkasse",
|
||
"bezeichnung": "Vorkasse",
|
||
"freitext": "",
|
||
"aktiv": "1",
|
||
"automatischbezahlt": "0",
|
||
"automatischbezahltverbindlichkeit": "0",
|
||
"projekt": "1",
|
||
"vorkasse": "0",
|
||
"verhalten": "vorkasse",
|
||
"modul": ""
|
||
}
|
||
}
|
||
|
||
/{id}:
|
||
description: Einzelne Zahlungsweise abrufen oder bearbeiten
|
||
uriParameters:
|
||
id:
|
||
type: integer
|
||
description: Zahlungsweisen-ID
|
||
get:
|
||
displayName: Einzelnen Zahlungsweise abrufen
|
||
description: |
|
||
Einzelnen Zahlungsweise abrufen
|
||
|
||
Permission: `view_payment_method`
|
||
queryParameters:
|
||
include:
|
||
description: |
|
||
Unter-Resourcen in Resource einbinden (Beispiel: `include=projekt`)
|
||
|
||
Verfügbare Includes: `projekt`
|
||
type: string
|
||
required: false
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"data": {
|
||
"id": "1",
|
||
"type": "vorkasse",
|
||
"bezeichnung": "Vorkasse",
|
||
"freitext": "",
|
||
"aktiv": "1",
|
||
"automatischbezahlt": "0",
|
||
"automatischbezahltverbindlichkeit": "0",
|
||
"projekt": "0",
|
||
"vorkasse": "0",
|
||
"verhalten": "vorkasse",
|
||
"modul": ""
|
||
}
|
||
}
|
||
404:
|
||
description: Zahlungsweise wurde nicht gefunden
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"error": {
|
||
"code": 7452,
|
||
"http_code": 404,
|
||
"message": "Resource not found",
|
||
"href": "http://www.example.com/api/docs.html#error-7452"
|
||
}
|
||
}
|
||
put:
|
||
displayName: Zahlungsweise bearbeiten
|
||
description: |
|
||
Zahlungsweise bearbeiten
|
||
|
||
Permission: `edit_payment_method`
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"type": "lastschrift",
|
||
"bezeichnung": "Lastschrift",
|
||
"aktiv": "1",
|
||
"projekt": "1",
|
||
"verhalten": "lastschrift"
|
||
}
|
||
responses:
|
||
200:
|
||
description: Request erfolgreich; Aktualisierte Zahlungsweise wird zurückgeliefert
|
||
body:
|
||
application/json:
|
||
example: |
|
||
{
|
||
"success": true,
|
||
"data": {
|
||
"id": "10",
|
||
"type": "lastschrift",
|
||
"bezeichnung": "Lastschrift",
|
||
"freitext": "",
|
||
"aktiv": "1",
|
||
"automatischbezahlt": "0",
|
||
"automatischbezahltverbindlichkeit": "0",
|
||
"projekt": "1",
|
||
"vorkasse": "0",
|
||
"verhalten": "lastschrift",
|
||
"modul": ""
|
||
}
|
||
}
|
||
|
||
|
||
#types:
|
||
# ZeroValue:
|
||
# description: Zero-value numbers, accepting either 0 or 0.00
|
||
# type: number
|
||
# enum:
|
||
# - 0
|
||
# - 0.00
|
||
# HundredthsValue:
|
||
# description: Non-zero two-decimal place values (positive and negative)
|
||
# type: number
|
||
# multipleOf: 0.01
|
||
# decimal:
|
||
# description: this type describes any monetary value comprised between -9,999,999,999,999.99 and 9,999,999,999,999.99
|
||
# type: ZeroValue | HundredthsValue
|
||
# default: 0.00
|
||
# minimum: -9999999999999.99
|
||
# maximum: 9999999999999.99
|
||
# examples:
|
||
# zero: 0
|
||
# zerozero: 0.00
|
||
# tenten: 10.10
|
||
# negative: -0.10
|