Skip to content

Commit 5253fd7

Browse files
committed
v1.83.0 (2023-08-28)
1 parent 273c178 commit 5253fd7

File tree

98 files changed

+4120
-90
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

98 files changed

+4120
-90
lines changed

.openapi-generator/FILES

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ docs/Api/CustomerGroupApi.md
1010
docs/Api/DiscountApi.md
1111
docs/Api/DocumentApi.md
1212
docs/Api/DocumentPaymentApi.md
13+
docs/Api/DocumentVersionApi.md
1314
docs/Api/LoginsApi.md
1415
docs/Api/PdfTemplatesApi.md
1516
docs/Api/PositionApi.md
@@ -43,7 +44,11 @@ docs/Model/DocumentPayment.md
4344
docs/Model/DocumentPayments.md
4445
docs/Model/DocumentPosition.md
4546
docs/Model/DocumentRecurring.md
47+
docs/Model/DocumentVersion.md
48+
docs/Model/DocumentVersionItem.md
49+
docs/Model/DocumentVersions.md
4650
docs/Model/Documents.md
51+
docs/Model/FileFormatConfig.md
4752
docs/Model/Login.md
4853
docs/Model/LoginSecurity.md
4954
docs/Model/Logins.md
@@ -86,6 +91,7 @@ lib/Api/CustomerGroupApi.php
8691
lib/Api/DiscountApi.php
8792
lib/Api/DocumentApi.php
8893
lib/Api/DocumentPaymentApi.php
94+
lib/Api/DocumentVersionApi.php
8995
lib/Api/LoginsApi.php
9096
lib/Api/PdfTemplatesApi.php
9197
lib/Api/PositionApi.php
@@ -122,7 +128,11 @@ lib/Model/DocumentPayment.php
122128
lib/Model/DocumentPayments.php
123129
lib/Model/DocumentPosition.php
124130
lib/Model/DocumentRecurring.php
131+
lib/Model/DocumentVersion.php
132+
lib/Model/DocumentVersionItem.php
133+
lib/Model/DocumentVersions.php
125134
lib/Model/Documents.php
135+
lib/Model/FileFormatConfig.php
126136
lib/Model/Login.php
127137
lib/Model/LoginSecurity.php
128138
lib/Model/Logins.php
@@ -160,5 +170,8 @@ lib/Model/WebHookLastResponse.php
160170
lib/Model/WebHooks.php
161171
lib/ObjectSerializer.php
162172
phpunit.xml.dist
163-
test/Model/PDFTemplateSettingsEmailTest.php
164-
test/Model/PDFTemplateSettingsTest.php
173+
test/Api/DocumentVersionApiTest.php
174+
test/Model/DocumentVersionItemTest.php
175+
test/Model/DocumentVersionTest.php
176+
test/Model/DocumentVersionsTest.php
177+
test/Model/FileFormatConfigTest.php

README.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -178,6 +178,9 @@ Class | Method | HTTP request | Description
178178
*DocumentPaymentApi* | [**documentPaymentsIdDelete**](docs/Api/DocumentPaymentApi.md#documentpaymentsiddelete) | **DELETE** /document-payments/{id} | Delete document payment
179179
*DocumentPaymentApi* | [**documentPaymentsIdGet**](docs/Api/DocumentPaymentApi.md#documentpaymentsidget) | **GET** /document-payments/{id} | Fetch document payment
180180
*DocumentPaymentApi* | [**documentPaymentsPost**](docs/Api/DocumentPaymentApi.md#documentpaymentspost) | **POST** /document-payments | Create document payment
181+
*DocumentVersionApi* | [**documentsIdVersionsGet**](docs/Api/DocumentVersionApi.md#documentsidversionsget) | **GET** /documents/{id}/versions | List all versions of a given document
182+
*DocumentVersionApi* | [**documentsIdVersionsVersionIdGet**](docs/Api/DocumentVersionApi.md#documentsidversionsversionidget) | **GET** /documents/{id}/versions/{versionId} | Show a single version of a given document
183+
*DocumentVersionApi* | [**documentsIdVersionsVersionIdItemsVersionItemIdDownloadGet**](docs/Api/DocumentVersionApi.md#documentsidversionsversioniditemsversionitemiddownloadget) | **GET** /documents/{id}/versions/{versionId}/items/{versionItemId}/download | Download a specific file for a single version of a given document
181184
*LoginsApi* | [**loginsGet**](docs/Api/LoginsApi.md#loginsget) | **GET** /logins |
182185
*LoginsApi* | [**loginsIdGet**](docs/Api/LoginsApi.md#loginsidget) | **GET** /logins/{id} |
183186
*PdfTemplatesApi* | [**pdfTemplatesGet**](docs/Api/PdfTemplatesApi.md#pdftemplatesget) | **GET** /pdf-templates | Fetch PDF Templates list
@@ -254,7 +257,11 @@ Class | Method | HTTP request | Description
254257
- [DocumentPayments](docs/Model/DocumentPayments.md)
255258
- [DocumentPosition](docs/Model/DocumentPosition.md)
256259
- [DocumentRecurring](docs/Model/DocumentRecurring.md)
260+
- [DocumentVersion](docs/Model/DocumentVersion.md)
261+
- [DocumentVersionItem](docs/Model/DocumentVersionItem.md)
262+
- [DocumentVersions](docs/Model/DocumentVersions.md)
257263
- [Documents](docs/Model/Documents.md)
264+
- [FileFormatConfig](docs/Model/FileFormatConfig.md)
258265
- [Login](docs/Model/Login.md)
259266
- [LoginSecurity](docs/Model/LoginSecurity.md)
260267
- [Logins](docs/Model/Logins.md)
@@ -321,5 +328,5 @@ vendor/bin/phpunit
321328

322329
This PHP package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
323330

324-
- API version: `1.82.0`
331+
- API version: `1.83.0`
325332
- Build package: `org.openapitools.codegen.languages.PhpClientCodegen`

docs/Api/DocumentVersionApi.md

Lines changed: 215 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,215 @@
1+
# cbeyersdorf\easybill\DocumentVersionApi
2+
3+
All URIs are relative to https://api.easybill.de/rest/v1, except if the operation defines another base path.
4+
5+
| Method | HTTP request | Description |
6+
| ------------- | ------------- | ------------- |
7+
| [**documentsIdVersionsGet()**](DocumentVersionApi.md#documentsIdVersionsGet) | **GET** /documents/{id}/versions | List all versions of a given document |
8+
| [**documentsIdVersionsVersionIdGet()**](DocumentVersionApi.md#documentsIdVersionsVersionIdGet) | **GET** /documents/{id}/versions/{versionId} | Show a single version of a given document |
9+
| [**documentsIdVersionsVersionIdItemsVersionItemIdDownloadGet()**](DocumentVersionApi.md#documentsIdVersionsVersionIdItemsVersionItemIdDownloadGet) | **GET** /documents/{id}/versions/{versionId}/items/{versionItemId}/download | Download a specific file for a single version of a given document |
10+
11+
12+
## `documentsIdVersionsGet()`
13+
14+
```php
15+
documentsIdVersionsGet($id, $limit, $page): \cbeyersdorf\easybill\Model\DocumentVersions
16+
```
17+
18+
List all versions of a given document
19+
20+
### Example
21+
22+
```php
23+
<?php
24+
require_once(__DIR__ . '/vendor/autoload.php');
25+
26+
27+
// Configure HTTP basic authorization: basicAuth
28+
$config = cbeyersdorf\easybill\Configuration::getDefaultConfiguration()
29+
->setUsername('YOUR_USERNAME')
30+
->setPassword('YOUR_PASSWORD');
31+
32+
// Configure API key authorization: Bearer
33+
$config = cbeyersdorf\easybill\Configuration::getDefaultConfiguration()->setApiKey('Authorization', 'YOUR_API_KEY');
34+
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
35+
// $config = cbeyersdorf\easybill\Configuration::getDefaultConfiguration()->setApiKeyPrefix('Authorization', 'Bearer');
36+
37+
38+
$apiInstance = new cbeyersdorf\easybill\Api\DocumentVersionApi(
39+
// If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
40+
// This is optional, `GuzzleHttp\Client` will be used as default.
41+
new GuzzleHttp\Client(),
42+
$config
43+
);
44+
$id = 56; // int | ID of document
45+
$limit = 56; // int | Limited the result. Default is 100. Maximum can be 1000.
46+
$page = 56; // int | Set current Page. Default is 1.
47+
48+
try {
49+
$result = $apiInstance->documentsIdVersionsGet($id, $limit, $page);
50+
print_r($result);
51+
} catch (Exception $e) {
52+
echo 'Exception when calling DocumentVersionApi->documentsIdVersionsGet: ', $e->getMessage(), PHP_EOL;
53+
}
54+
```
55+
56+
### Parameters
57+
58+
| Name | Type | Description | Notes |
59+
| ------------- | ------------- | ------------- | ------------- |
60+
| **id** | **int**| ID of document | |
61+
| **limit** | **int**| Limited the result. Default is 100. Maximum can be 1000. | [optional] |
62+
| **page** | **int**| Set current Page. Default is 1. | [optional] |
63+
64+
### Return type
65+
66+
[**\cbeyersdorf\easybill\Model\DocumentVersions**](../Model/DocumentVersions.md)
67+
68+
### Authorization
69+
70+
[basicAuth](../../README.md#basicAuth), [Bearer](../../README.md#Bearer)
71+
72+
### HTTP request headers
73+
74+
- **Content-Type**: Not defined
75+
- **Accept**: `application/json`
76+
77+
[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
78+
[[Back to Model list]](../../README.md#models)
79+
[[Back to README]](../../README.md)
80+
81+
## `documentsIdVersionsVersionIdGet()`
82+
83+
```php
84+
documentsIdVersionsVersionIdGet($id, $version_id): \cbeyersdorf\easybill\Model\DocumentVersion
85+
```
86+
87+
Show a single version of a given document
88+
89+
### Example
90+
91+
```php
92+
<?php
93+
require_once(__DIR__ . '/vendor/autoload.php');
94+
95+
96+
// Configure HTTP basic authorization: basicAuth
97+
$config = cbeyersdorf\easybill\Configuration::getDefaultConfiguration()
98+
->setUsername('YOUR_USERNAME')
99+
->setPassword('YOUR_PASSWORD');
100+
101+
// Configure API key authorization: Bearer
102+
$config = cbeyersdorf\easybill\Configuration::getDefaultConfiguration()->setApiKey('Authorization', 'YOUR_API_KEY');
103+
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
104+
// $config = cbeyersdorf\easybill\Configuration::getDefaultConfiguration()->setApiKeyPrefix('Authorization', 'Bearer');
105+
106+
107+
$apiInstance = new cbeyersdorf\easybill\Api\DocumentVersionApi(
108+
// If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
109+
// This is optional, `GuzzleHttp\Client` will be used as default.
110+
new GuzzleHttp\Client(),
111+
$config
112+
);
113+
$id = 56; // int | ID of document
114+
$version_id = 56; // int | ID of document version
115+
116+
try {
117+
$result = $apiInstance->documentsIdVersionsVersionIdGet($id, $version_id);
118+
print_r($result);
119+
} catch (Exception $e) {
120+
echo 'Exception when calling DocumentVersionApi->documentsIdVersionsVersionIdGet: ', $e->getMessage(), PHP_EOL;
121+
}
122+
```
123+
124+
### Parameters
125+
126+
| Name | Type | Description | Notes |
127+
| ------------- | ------------- | ------------- | ------------- |
128+
| **id** | **int**| ID of document | |
129+
| **version_id** | **int**| ID of document version | |
130+
131+
### Return type
132+
133+
[**\cbeyersdorf\easybill\Model\DocumentVersion**](../Model/DocumentVersion.md)
134+
135+
### Authorization
136+
137+
[basicAuth](../../README.md#basicAuth), [Bearer](../../README.md#Bearer)
138+
139+
### HTTP request headers
140+
141+
- **Content-Type**: Not defined
142+
- **Accept**: `application/json`
143+
144+
[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
145+
[[Back to Model list]](../../README.md#models)
146+
[[Back to README]](../../README.md)
147+
148+
## `documentsIdVersionsVersionIdItemsVersionItemIdDownloadGet()`
149+
150+
```php
151+
documentsIdVersionsVersionIdItemsVersionItemIdDownloadGet($id, $version_id, $version_item_id): \SplFileObject
152+
```
153+
154+
Download a specific file for a single version of a given document
155+
156+
### Example
157+
158+
```php
159+
<?php
160+
require_once(__DIR__ . '/vendor/autoload.php');
161+
162+
163+
// Configure HTTP basic authorization: basicAuth
164+
$config = cbeyersdorf\easybill\Configuration::getDefaultConfiguration()
165+
->setUsername('YOUR_USERNAME')
166+
->setPassword('YOUR_PASSWORD');
167+
168+
// Configure API key authorization: Bearer
169+
$config = cbeyersdorf\easybill\Configuration::getDefaultConfiguration()->setApiKey('Authorization', 'YOUR_API_KEY');
170+
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
171+
// $config = cbeyersdorf\easybill\Configuration::getDefaultConfiguration()->setApiKeyPrefix('Authorization', 'Bearer');
172+
173+
174+
$apiInstance = new cbeyersdorf\easybill\Api\DocumentVersionApi(
175+
// If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
176+
// This is optional, `GuzzleHttp\Client` will be used as default.
177+
new GuzzleHttp\Client(),
178+
$config
179+
);
180+
$id = 56; // int | ID of document
181+
$version_id = 56; // int | ID of document version
182+
$version_item_id = 56; // int | ID of document version item
183+
184+
try {
185+
$result = $apiInstance->documentsIdVersionsVersionIdItemsVersionItemIdDownloadGet($id, $version_id, $version_item_id);
186+
print_r($result);
187+
} catch (Exception $e) {
188+
echo 'Exception when calling DocumentVersionApi->documentsIdVersionsVersionIdItemsVersionItemIdDownloadGet: ', $e->getMessage(), PHP_EOL;
189+
}
190+
```
191+
192+
### Parameters
193+
194+
| Name | Type | Description | Notes |
195+
| ------------- | ------------- | ------------- | ------------- |
196+
| **id** | **int**| ID of document | |
197+
| **version_id** | **int**| ID of document version | |
198+
| **version_item_id** | **int**| ID of document version item | |
199+
200+
### Return type
201+
202+
**\SplFileObject**
203+
204+
### Authorization
205+
206+
[basicAuth](../../README.md#basicAuth), [Bearer](../../README.md#Bearer)
207+
208+
### HTTP request headers
209+
210+
- **Content-Type**: Not defined
211+
- **Accept**: `application/pdf`, `text/xml`
212+
213+
[[Back to top]](#) [[Back to API list]](../../README.md#endpoints)
214+
[[Back to Model list]](../../README.md#models)
215+
[[Back to README]](../../README.md)

docs/Model/Document.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,5 +68,6 @@ Name | Type | Description | Notes
6868
**vat_id** | **string** | | [optional] [readonly] [default to '']
6969
**fulfillment_country** | **string** | | [optional] [default to 'null']
7070
**vat_option** | **string** | NULL: Normal steuerbar&lt;br/&gt; nStb: Nicht steuerbar (Drittland)&lt;br/&gt; nStbUstID: Nicht steuerbar (EU mit USt-IdNr.)&lt;br/&gt; nStbNoneUstID: Nicht steuerbar (EU ohne USt-IdNr.)&lt;br/&gt; nStbIm: Nicht steuerbarer Innenumsatz&lt;br/&gt; revc: Steuerschuldwechsel §13b (Inland)&lt;br/&gt; IG: Innergemeinschaftliche Lieferung&lt;br/&gt; AL: Ausfuhrlieferung&lt;br/&gt; sStfr: sonstige Steuerbefreiung&lt;br/&gt; smallBusiness: Kleinunternehmen (Keine MwSt.) | [optional] [default to 'null']
71+
**file_format_config** | [**\cbeyersdorf\easybill\Model\FileFormatConfig[]**](FileFormatConfig.md) | | [optional]
7172

7273
[[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)

docs/Model/DocumentVersion.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# # DocumentVersion
2+
3+
## Properties
4+
5+
Name | Type | Description | Notes
6+
------------ | ------------- | ------------- | -------------
7+
**created_at** | **\DateTime** | | [optional] [readonly]
8+
**document_id** | **int** | | [optional] [readonly]
9+
**id** | **int** | | [optional] [readonly]
10+
**items** | [**\cbeyersdorf\easybill\Model\DocumentVersionItem[]**](DocumentVersionItem.md) | | [optional]
11+
**reason** | **string** | | [optional] [readonly]
12+
13+
[[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)

docs/Model/DocumentVersionItem.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
# # DocumentVersionItem
2+
3+
## Properties
4+
5+
Name | Type | Description | Notes
6+
------------ | ------------- | ------------- | -------------
7+
**document_version_item_type** | **string** | | [optional] [readonly]
8+
**id** | **int** | | [optional] [readonly]
9+
10+
[[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)

docs/Model/DocumentVersions.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# # DocumentVersions
2+
3+
## Properties
4+
5+
Name | Type | Description | Notes
6+
------------ | ------------- | ------------- | -------------
7+
**page** | **int** | The current page |
8+
**pages** | **int** | Max possible pages |
9+
**limit** | **int** | Items limitation. Max 1000 |
10+
**total** | **int** | Total Items |
11+
**items** | [**\cbeyersdorf\easybill\Model\DocumentVersion[]**](DocumentVersion.md) | | [optional]
12+
13+
[[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)

docs/Model/FileFormatConfig.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# # FileFormatConfig
2+
3+
## Properties
4+
5+
Name | Type | Description | Notes
6+
------------ | ------------- | ------------- | -------------
7+
**type** | **string** | |
8+
9+
[[Back to Model list]](../../README.md#models) [[Back to API list]](../../README.md#endpoints) [[Back to README]](../../README.md)

lib/Api/AttachmentApi.php

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
*
1515
* The first version of the easybill REST API. [CHANGELOG](https://api.easybill.de/rest/v1/CHANGELOG.md) ## Authentication You can choose between two available methods: `Basic Auth` or `Bearer Token`. In each HTTP request, one of the following HTTP headers is required: ``` # Basic Auth Authorization: Basic base64_encode('<email>:<api_key>') # Bearer Token Authorization: Bearer <api_key> ``` ## Limitations ### Request Limit * PLUS: 10 requests per minute * BUSINESS: 60 requests per minute If the limit is exceeded, you will receive the HTTP error: `429 Too Many Requests` ### Result Limit All result lists are limited to 100 by default. This limit can be increased by the query parameter `limit` to a maximum of 1000. ## Query filter Many list resources can be filtered. In `/documents` you can filter e.g. by number with `/documents?number=111028654`. If you want to filter multiple numbers, you can either enter them separated by commas `/documents?number=111028654,222006895` or as an array `/documents?number[]=111028654&number[]=222006895`. **Warning**: The maximum size of an HTTP request line in bytes is 4094. If this limit is exceeded, you will receive the HTTP error: `414 Request-URI Too Large` ### Escape commas in query You can escape commans in query `name=Patrick\\, Peter` if you submit the header `X-Easybill-Escape: true` in your request. ## Property login_id This is the login of your admin or employee account. ## Date and Date-Time format Please use the timezone `Europe/Berlin`. * **date** = *Y-m-d* = `2016-12-31` * **date-time** = *Y-m-d H:i:s* = `2016-12-31 03:13:37` Date or datetime can be `null` because the attributes have been added later and the entry is older.
1616
*
17-
* The version of the OpenAPI document: 1.82.0
17+
* The version of the OpenAPI document: 1.83.0
1818
* Generated by: https://openapi-generator.tech
1919
* OpenAPI Generator version: 7.0.1-SNAPSHOT
2020
*/

lib/Api/ContactApi.php

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
*
1515
* The first version of the easybill REST API. [CHANGELOG](https://api.easybill.de/rest/v1/CHANGELOG.md) ## Authentication You can choose between two available methods: `Basic Auth` or `Bearer Token`. In each HTTP request, one of the following HTTP headers is required: ``` # Basic Auth Authorization: Basic base64_encode('<email>:<api_key>') # Bearer Token Authorization: Bearer <api_key> ``` ## Limitations ### Request Limit * PLUS: 10 requests per minute * BUSINESS: 60 requests per minute If the limit is exceeded, you will receive the HTTP error: `429 Too Many Requests` ### Result Limit All result lists are limited to 100 by default. This limit can be increased by the query parameter `limit` to a maximum of 1000. ## Query filter Many list resources can be filtered. In `/documents` you can filter e.g. by number with `/documents?number=111028654`. If you want to filter multiple numbers, you can either enter them separated by commas `/documents?number=111028654,222006895` or as an array `/documents?number[]=111028654&number[]=222006895`. **Warning**: The maximum size of an HTTP request line in bytes is 4094. If this limit is exceeded, you will receive the HTTP error: `414 Request-URI Too Large` ### Escape commas in query You can escape commans in query `name=Patrick\\, Peter` if you submit the header `X-Easybill-Escape: true` in your request. ## Property login_id This is the login of your admin or employee account. ## Date and Date-Time format Please use the timezone `Europe/Berlin`. * **date** = *Y-m-d* = `2016-12-31` * **date-time** = *Y-m-d H:i:s* = `2016-12-31 03:13:37` Date or datetime can be `null` because the attributes have been added later and the entry is older.
1616
*
17-
* The version of the OpenAPI document: 1.82.0
17+
* The version of the OpenAPI document: 1.83.0
1818
* Generated by: https://openapi-generator.tech
1919
* OpenAPI Generator version: 7.0.1-SNAPSHOT
2020
*/

0 commit comments

Comments
 (0)