Skip to content

Datev Datenfelder

Kunde

Debitor / Kunde 8.2
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
{
    "type": "array",
    "items": {
        "type": "object",
        "properties": {
        "id": {
            "type": "string",
            "maxLength": 9,
            "description": "ID of the business partner, is equal to the account number of the business partner shown at maximum length; 9 digits (technical length); the ID may not be entered with POST; for PUT, the ID is a mandatory field and must be filled with the account number of the business partner",
            "example": "100990000"
        },
        "account_number": {
            "type": "integer",
            "maxLength": 9,
            "example": 100990000,
            "description": "Account number of the business partner shown at maximum length; 9 digits (technical length); for POST and PUT, the account_number may not be entered"
        },
        "accounting_information": {
            "type": "object",
            "properties": {
            "account_statement": {
                "enum": [
                "not_specified",
                "account_statement_for_all_items",
                "account_statement_dunnable_only",
                "account_statement_all_dunnable_items",
                "no_account_statement_for_customer"
                ],
                "type": "string",
                "description": "Bank account statement (not specified, account statement for all items, account statement dunnable only, account statement all dunnable items, no account statement for customer)",
                "example": "not_specified"
            },
            "account_statement_text": {
                "enum": [
                "not_specified",
                "account_statement_text1",
                "account_statement_text2",
                "account_statement_text3",
                "account_statement_text4",
                "account_statement_text5",
                "account_statement_text6",
                "account_statement_text7",
                "account_statement_text8",
                "no_account_statement_text"
                ],
                "type": "string",
                "description": "Account statement text group (not specified, account statement text 1, account statement text 2, account statement text 3, account statement text 4, account statement text 5, account statement text 6, account statement text 7, account statement text 8, account statement text 9, no account statement text)",
                "example": "not_specified"
            },
            "alternative_contact_person": {
                "type": "string",
                "maxLength": 40,
                "description": "Alternative contact person",
                "example": "Maxima Mustermann"
            },
            "clerk": {
                "type": "string",
                "maxLength": 40,
                "description": "Clerk",
                "example": "Torben Mustermann"
            },
            "client_bank_position": {
                "type": "integer",
                "format": "int32",
                "maxLength": 3,
                "maximum": 999,
                "description": "Client bank (numbering), allocation of the saved client bank that should be used for the direct debit with debitors and payments with creditors",
                "example": 2
            },
            "contact_person": {
                "type": "string",
                "maxLength": 40,
                "description": "Contact person",
                "example": "Rainer Mustermann"
            },
            "credit_limit": {
                "type": "integer",
                "format": "int64",
                "maxLength": 13,
                "description": "Credit limit",
                "example": 1250
            },
            "currency_management": {
                "enum": [
                "payments_in_input_currency",
                "payments_in_euro"
                ],
                "type": "string",
                "description": "Currency management (payments in input currency, payments in euro)",
                "example": "payments_in_euro"
            },
            "direct_debit": {
                "enum": [
                "not_specified",
                "sepa_direct_debit",
                "sepa_direct_debit_with_multiple_invoices",
                "no_direct_debit_with_this_debitor"
                ],
                "type": "string",
                "description": "Direct debit (not specified, SEPA direct debit, SEPA direct debit with multiple invoices, no direct debit with this debitor)<br>For public sector: permanent direct debit block (not specified, no direct debit with this debitor)",
                "example": "not_specified"
            },
            "dunning_final_deadline": {
                "type": "integer",
                "format": "int32",
                "description": "Dunning final deadline (in days)",
                "minimum": 0,
                "maximum": 999,
                "maxLength": 3,
                "example": 100
            },
            "dunning_interest_rate1": {
                "type": "number",
                "maxLength": 5,
                "format": "decimal",
                "description": "Dunning interest rate 1",
                "example": 2.75
            },
            "dunning_interest_rate2": {
                "type": "number",
                "maxLength": 5,
                "format": "decimal",
                "description": "Dunning interest rate 2",
                "example": 3
            },
            "dunning_interest_rate3": {
                "type": "number",
                "maxLength": 5,
                "format": "decimal",
                "description": "Dunning interest rate 3",
                "example": 3.75
            },
            "dunning_limit_amount": {
                "type": "number",
                "maxLength": 9,
                "format": "decimal",
                "description": "Dunning limit amount",
                "example": 500
            },
            "dunning_limit_percent": {
                "type": "number",
                "maxLength": 5,
                "format": "decimal",
                "description": "Dunning limit as a percentage",
                "example": 10
            },
            "dunning_period1": {
                "type": "integer",
                "format": "int32",
                "description": "Dunning period 1 (in days)",
                "minimum": 0,
                "maximum": 999,
                "maxLength": 3,
                "example": 100
            },
            "dunning_period2": {
                "type": "integer",
                "format": "int32",
                "description": "Dunning period 2 (in days)",
                "minimum": 0,
                "maximum": 999,
                "maxLength": 3,
                "example": 100
            },
            "dunning_period3": {
                "type": "integer",
                "format": "int32",
                "description": "Dunning period 3 (in days)",
                "minimum": 0,
                "maximum": 999,
                "maxLength": 3,
                "example": 100
            },
            "dunning_period_calculation": {
                "enum": [
                "not_specified",
                "calculate_dunning_period"
                ],
                "type": "string",
                "description": "Dunning period calculation (not specified, calculate dunning period)",
                "example": "calculate_dunning_period"
            },
            "dunning_procedure": {
                "enum": [
                "not_specified",
                "first_dun",
                "second_dun",
                "first_and_second_dun",
                "third_dun",
                "second_and_third_dun",
                "first_second_and_third_dun",
                "no_dun"
                ],
                "type": "string",
                "description": "Dunning procedure (not specified, first dun, second dun, first and second dun, third dun, second and third dun, first second and third dun, no dun)<br>For public sector: permanent dunning block (not specified, no dun)",
                "example": "not_specified"
            },
            "dunning_text1": {
                "enum": [
                "not_specified",
                "text_group1",
                "text_group2",
                "text_group3",
                "text_group4",
                "text_group5",
                "text_group6",
                "text_group7",
                "text_group8",
                "text_group9"
                ],
                "type": "string",
                "example": "text_group2",
                "description": "#/definitions/datev.dunning-text"
            },
            "dunning_text2": {
                "$ref": "#/items/properties/accounting_information/properties/dunning_text1"
            },
            "dunning_text3": {
                "$ref": "#/items/properties/accounting_information/properties/dunning_text1"
            },
            "has_enforcement_block": {
                "type": "boolean",
                "description": "Enforcement block",
                "example": true
            },
            "interest_calculation": {
                "enum": [
                "not_specified",
                "fixed_interest_rate",
                "interest_rate_based_on_sliding_scale",
                "no_interest_calculated_for_this_debitor"
                ],
                "type": "string",
                "description": "Interest calculation (not specified, fixed interest rate, interest rate based on sliding scale, no interest calculated for this debitor)",
                "example": "fixed_interest_rate"
            },
            "is_insolvent": {
                "type": "boolean",
                "description": "Insolvency status identifier",
                "example": true
            },
            "is_various_account": {
                "type": "boolean",
                "description": "Differing account indicator",
                "example": true
            },
            "language": {
                "enum": [
                "not_specified",
                "german",
                "french",
                "english",
                "spanish",
                "italian"
                ],
                "type": "string",
                "description": "Language (not specified, german, french, english, spanish, italian)",
                "example": "german"
            },
            "output_destination": {
                "enum": [
                "not_specified",
                "print",
                "fax",
                "email"
                ],
                "type": "string",
                "description": "Output destination (not specified, print, fax, e-mail)",
                "example": "fax"
            },
            "tax_number": {
                "type": "string",
                "maxLength": 20,
                "description": "Tax number",
                "example": 40
            },
            "temp_direct_debit_block": {
                "type": "string",
                "format": "date-time",
                "description": "Temporary direct debit block",
                "example": "2015-12-31T23:00:00.000Z"
            },
            "temp_enforcement_block": {
                "type": "string",
                "format": "date-time",
                "description": "Temporary enforcement block",
                "example": "2015-12-31T23:00:00.000Z"
            },
            "temp_dunning_block": {
                "type": "string",
                "format": "date-time",
                "description": "Temporary dunning block",
                "example": "2015-12-31T23:00:00.000Z"
            },
            "term_of_payment_id": {
                "type": "integer",
                "format": "int32",
                "maxLength": 3,
                "description": "Term of payment, a saved term of payment can be assigned to a business partner here",
                "example": 123
            },
            "individual_fields": {
                "items": {
                "properties": {
                    "content": {
                    "type": "string",
                    "maxLength": 40,
                    "description": "Content of the individual field",
                    "example": "Color"
                    },
                    "position": {
                    "type": "integer",
                    "maxLength": 2,
                    "format": "int32",
                    "description": "Number of the individual field (zero-based numbering)",
                    "example": 12
                    }
                },
                "description": "#/definitions/datev.individual-field"
                },
                "type": "array",
                "minItems": 1,
                "maxItems": 10
            }
            },
            "description": "#/definitions/datev.debitor-accounting-information"
        },
        "addressee_id": {
            "type": "string",
            "maxLength": 210,
            "description": "Addressee ID, required when using PUT",
            "example": "342842bf-3af2-4e0d-adda-a2d1dff2a6a5"
        },
        "alternative_search_name": {
            "type": "string",
            "maxLength": 50,
            "description": "Alternative search name",
            "example": "Gewerbe"
        },
        "business_partner_number": {
            "type": "string",
            "description": "Customer/supplier number, cannot be changed when using centralized business partners (see property business_partner_relation_id)",
            "example": "2250829"
        },
        "business_partner_relation_id": {
            "type": "string",
            "maxLength": 210,
            "description": "ID of the business partner (customer relation ID); with POST, the business_partner_relation_id can be assigned; with PUT, the business_partner_relation_id that has already been used for the business partner being updated must be used again. If business_partner_relation_id contains an empty GUID (00000000-0000-0000-0000-000000000000), it is a not centralized business partner.",
            "example": "d7e3c10f-8b5a-42d4-b790-e84c1762b8b9"
        },
        "caption": {
            "readOnly": true,
            "type": "string",
            "description": "Account caption",
            "example": "Mustermann"
        },
        "complimentary_close": {
            "type": "string",
            "maxLength": 50,
            "description": "Complimentary close of a letter",
            "example": "Kind regards"
        },
        "correspondence_title": {
            "type": "string",
            "maxLength": 30,
            "description": "Title",
            "example": "business-partner"
        },
        "date_last_modification": {
            "format": "date-time",
            "type": "string",
            "readOnly": true,
            "description": "Date of last modification",
            "example": "2016-05-23T22:00:00.000Z"
        },
        "eu_vat_id_country_code": {
            "type": "string",
            "maxLength": 2,
            "description": "EU member state, is a component of the VAT ID no., see Info Database, document [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
            "example": "DE"
        },
        "eu_vat_id_number": {
            "type": "string",
            "maxLength": 13,
            "description": "EU VAT ID number, is a component of the VAT ID no., see Info Database, document [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
            "example": "12345678901"
        },
        "is_business_partner_active": {
            "type": "boolean",
            "description": "Active business partner identifier",
            "example": true
        },
        "is_organization_business_partner": {
            "type": "boolean",
            "description": "Indicator as to whether the business partner is an organization business partner",
            "example": true
        },
        "legal_entity_type": {
            "enum": [
            "not_specified",
            "natural_person",
            "legal_person"
            ],
            "type": "string",
            "description": "Addressee type (not specified, natural person, legal person)",
            "example": "legal_person",
            "default": "legal_person"
        },
        "salutation": {
            "type": "string",
            "maxLength": 100,
            "description": "Letter salutation",
            "example": "Dear ladies and gentleman"
        },
        "short_name": {
            "type": "string",
            "description": "Short name",
            "maxLength": 15,
            "example": "Mustermann"
        },
        "third_party_number": {
            "type": "string",
            "maxLength": 15,
            "description": "Number in third-party system",
            "example": "abcdeft123"
        },
        "natural_person": {
            "properties": {
            "date_of_birth": {
                "type": "string",
                "format": "date-time",
                "description": "Date of birth",
                "example": "1979-12-31T23:00:00.000Z"
            },
            "degree": {
                "type": "string",
                "maxLength": 25,
                "description": "Title/academic level",
                "example": "Sir"
            },
            "firstname": {
                "type": "string",
                "maxLength": 30,
                "description": "First name",
                "example": "Max"
            },
            "name_prefix": {
                "type": "string",
                "maxLength": 14,
                "description": "Name prefix",
                "example": "de la"
            },
            "surname": {
                "type": "string",
                "maxLength": 30,
                "description": "Last name",
                "example": "Mustermann"
            },
            "title_of_nobility": {
                "type": "string",
                "maxLength": 15,
                "description": "Title of nobility",
                "example": "Truchsess"
            }
            },
            "type": "object",
            "description": "#/definitions/datev.natural-person"
        },
        "legal_person": {
            "properties": {
            "enterprise_purpose": {
                "type": "string",
                "maxLength": 50,
                "description": "Enterprise purpose",
                "example": "commercial trade"
            },
            "legal_form": {
                "type": "string",
                "maxLength": 6,
                "description": "Legal form",
                "example": "S00010"
            },
            "legal_name": {
                "type": "string",
                "maxLength": 50,
                "description": "Legal name",
                "example": "Mustergewerbe"
            }
            },
            "type": "object",
            "description": "#/definitions/datev.legal-person"
        },
        "not_specified_person": {
            "properties": {
            "name": {
                "type": "string",
                "description": "Name",
                "maxLength": 50,
                "example": "Chuck Norris"
            }
            },
            "type": "object",
            "description": "#/definitions/datev.not-specified-person"
        },
        "addresses": {
            "items": {
            "required": [
                "address_usage_type"
            ],
            "properties": {
                "id": {
                "type": "string",
                "description": "ID of the subobject address",
                "example": "1b9c4079-2432-47b8-84c2-eebaa97e7376"
                },
                "additional_correspondence_title": {
                "type": "string",
                "maxLength": 30,
                "description": "Differing title",
                "example": "chancellery"
                },
                "additional_delivery_text1": {
                "type": "string",
                "maxLength": 50,
                "description": "Differing delivery text 1",
                "example": "differing delivery text 1"
                },
                "additional_delivery_text2": {
                "type": "string",
                "maxLength": 36,
                "description": "Differing delivery text 2",
                "example": "differing delivery text 2"
                },
                "address_appendix": {
                "type": "string",
                "maxLength": 36,
                "description": "Address supplement",
                "example": "z. Hd. Herrn Mustermann"
                },
                "address_manually_edited": {
                "readOnly": true,
                "type": "string",
                "maxLength": 210,
                "description": "Manually edited address"
                },
                "address_type": {
                "enum": [
                    "not_specified",
                    "street_address",
                    "post_office_box_address",
                    "corporate_client_address"
                ],
                "type": "string",
                "description": "Address type, if the address type is not indicated, it will be automatically completed based on the transferred fields (street, post office box or postal code), (not specified, street address, post office box address, corporate client address)",
                "example": "not_specified"
                },
                "address_usage_type": {
                "properties": {
                    "is_correspondence_address": {
                    "type": "boolean",
                    "description": "Correspondence address",
                    "example": true
                    },
                    "is_default_delivery_address": {
                    "type": "boolean",
                    "description": "Default delivery address",
                    "example": true
                    },
                    "is_default_payment_address": {
                    "type": "boolean",
                    "description": "Default invoice address",
                    "example": true
                    },
                    "is_delivery_address": {
                    "type": "boolean",
                    "description": "Delivery address",
                    "example": true
                    },
                    "is_main_post_office_box_address": {
                    "type": "boolean",
                    "description": "Main post office box address (set on default if the address type is \"post_office_box_address\")",
                    "example": true
                    },
                    "is_main_street_address": {
                    "type": "boolean",
                    "description": "Main street address (set on default if the address type is \"street_address\")",
                    "example": true
                    },
                    "is_management_address": {
                    "type": "boolean",
                    "description": "Management address",
                    "example": true
                    }
                },
                "type": "object",
                "description": "#/definitions/datev.address-usage-type"
                },
                "city": {
                "type": "string",
                "maxLength": 30,
                "description": "City",
                "example": "Nuremberg"
                },
                "country_code": {
                "type": "string",
                "maxLength": 2,
                "description": "Country, see Info Database, document [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
                "example": "DE"
                },
                "district": {
                "type": "string",
                "description": "District (public sector)",
                "example": "Soho"
                },
                "individual_shipping_information": {
                "type": "string",
                "maxLength": 50,
                "description": "Additional shipping information",
                "example": "free delivery"
                },
                "is_address_manually_edited": {
                "readOnly": true,
                "type": "boolean",
                "description": "Usage identifier for a manually edited address",
                "example": true
                },
                "note": {
                "type": "string",
                "description": "Note",
                "example": "Sample text"
                },
                "post_office_box": {
                "type": "string",
                "maxLength": 10,
                "description": "Post office box, if both a street address and a post office box are indicated, both values will be added to the database; the post office box will be displayed on the business card in the debitor/creditor master data",
                "example": "101010"
                },
                "postal_code": {
                "type": "string",
                "description": "Zip code, depends on the country code. When the property \"country_code\" is set, the zip code length of the corresponding country is taken into account. When the property \"country_code\" is not set, the country is taken from the client's national law",
                "example": "90491"
                },
                "street": {
                "type": "string",
                "maxLength": 36,
                "description": "Street, if both a street address and a post office box are indicated, both values will be added to the database; the post office box will be displayed on the business card in the debitor/creditor master data",
                "example": "Exemplary street 1"
                },
                "valid_from": {
                "type": "string",
                "format": "date-time",
                "description": "Valid from",
                "example": "2015-12-31T23:00:00.000Z"
                },
                "valid_to": {
                "type": "string",
                "format": "date-time",
                "description": "Valid to",
                "example": "9999-12-30T23:00:00.000Z"
                }
            },
            "type": "object",
            "description": "#/definitions/datev.address"
            },
            "type": "array",
            "description": "Addresses"
        },
        "communications": {
            "items": {
            "properties": {
                "id": {
                "type": "string",
                "description": "ID of the subobject communication",
                "example": "1b9c4079-2432-47b8-84c2-eebaa97e7376"
                },
                "communication_data_content": {
                "type": "string",
                "maxLength": 60,
                "description": "Content of the communication type",
                "example": "+49 911 999882"
                },
                "communication_type": {
                "enum": [
                    "not_specified",
                    "phone",
                    "email",
                    "url",
                    "fax",
                    "other"
                ],
                "type": "string",
                "description": "Communication method (not specified, phone, email, url, fax, other)",
                "example": "phone"
                },
                "note": {
                "type": "string",
                "maxLength": 40,
                "description": "Note",
                "example": "Note example text"
                },
                "communication_usage_type": {
                "properties": {
                    "is_main_communication_usage_type": {
                    "type": "boolean",
                    "description": "Main communication usage type, is not allowed with \"communication_type\" = other",
                    "example": true
                    },
                    "is_main_management_phone": {
                    "type": "boolean",
                    "maxLength": 60,
                    "description": "Management phone indicator",
                    "example": true
                    }
                },
                "type": "object",
                "description": "#/definitions/datev.communication-usage-type"
                }
            },
            "type": "object",
            "description": "#/definitions/datev.communication"
            },
            "type": "array",
            "description": "Communications"
        },
        "banks": {
            "type": "array",
            "items": {
            "properties": {
                "id": {
                "type": "string",
                "description": "ID of the subobject bank",
                "example": "cdb9e6a9-16b9-4c2f-9705-83a0fc7c9908"
                },
                "bank_account_number": {
                "type": "string",
                "maxLength": 10,
                "description": "Bank account number",
                "example": "121540061"
                },
                "bank_code": {
                "type": "string",
                "maxLength": 8,
                "description": "Bank code",
                "example": "76050000"
                },
                "bank_name": {
                "type": "string",
                "maxLength": 30,
                "description": "Bank name",
                "example": "BayernLB Nürnberg"
                },
                "bic": {
                "type": "string",
                "maxLength": 11,
                "description": "BIC",
                "example": "BYLADEMMXXX"
                },
                "business_partner_bank_position": {
                "type": "integer",
                "minimum": 1,
                "maximum": 999,
                "maxLength": 3,
                "format": "int32",
                "description": "Business partner bank (numbering), required when a bank is transferred",
                "example": 1
                },
                "country_code": {
                "type": "string",
                "maxLength": 2,
                "description": "Country, see Info Database, document [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
                "example": "EUR"
                },
                "differing_account_holder": {
                "type": "string",
                "maxLength": 70,
                "description": "Differing account holder",
                "example": "Max Mustermann"
                },
                "iban": {
                "type": "string",
                "maxLength": 34,
                "description": "IBAN",
                "example": "DE38760500000121540061"
                },
                "is_business_partner_bank": {
                "type": "boolean",
                "description": "Business partner bank, usage identifier, only a bank account belonging to a debitor/creditor can be labeled as a business partner bank account.<br>If exactly **one** bank account is specified, the usage identifier is always set to \"true\".",
                "example": true
                },
                "sepa_mandate_reference": {
                "type": "string",
                "maxLength": 35,
                "description": "SEPA mandate reference, in the \"sepa_mandate_reference\" field; one mandate reference per bank can be entered for the business partner; in order to be used correctly, SEPA mandate management must include the mandate reference applicable to the authorizing customer",
                "example": "503000000001"
                },
                "note": {
                "type": "string",
                "description": "Note",
                "example": "Sample text"
                },
                "valid_from": {
                "type": "string",
                "format": "date-time",
                "description": "Valid from",
                "example": "2015-12-31T23:00:00.000Z"
                },
                "valid_to": {
                "type": "string",
                "format": "date-time",
                "description": "Valid to",
                "example": "9999-12-30T23:00:00.000Z"
                }
            },
            "type": "object",
            "description": "#/definitions/datev.bank"
            }
        }
        },
        "description": "#/definitions/debitor"
    }
    }
Debitor / Kunde 8.1
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
{
"type": "array",
"items": {
    "type": "object",
    "properties": {
    "id": {
        "type": "string",
        "maxLength": 9,
        "description": "ID des Geschäftspartners, entspricht der Kontonummer des Geschäftspartners in Maximallänge, 9-stellig (technische Länge), beim POST darf die ID nicht angegeben werden, beim PUT ist die ID ein Pflichtfeld und muss mit der Kontonummer des Geschäftspartners befüllt werden",
        "example": "100990000"
    },
    "account_number": {
        "type": "integer",
        "maxLength": 9,
        "example": 100990000,
        "description": "Kontonummer des Geschäftspartners in Maximallänge, 9-stellig (technische Länge), beim POST und beim PUT darf die account_number nicht angegeben werden"
    },
    "accounting_information": {
        "type": "object",
        "properties": {
        "account_statement": {
            "enum": [
            "not_specified",
            "account_statement_for_all_items",
            "account_statement_dunnable_only",
            "account_statement_all_dunnable_items",
            "no_account_statement_for_customer"
            ],
            "type": "string",
            "description": "Kontoauszug (keine Angabe, Kontoauszug mit allen Posten, Kontoauszug nur wenn Posten mahnfällig, Auszug für alle mahnfälligen Posten, kein Kontoauszug)",
            "example": "not_specified"
        },
        "account_statement_text": {
            "enum": [
            "not_specified",
            "account_statement_text1",
            "account_statement_text2",
            "account_statement_text3",
            "account_statement_text4",
            "account_statement_text5",
            "account_statement_text6",
            "account_statement_text7",
            "account_statement_text8",
            "no_account_statement_text"
            ],
            "type": "string",
            "description": "Kontoauszugstextgruppe (keine Angabe, Textgruppe 1, Textgruppe 2, Textgruppe 3, Textgruppe 4, Textgruppe 5, Textgruppe 6, Textgruppe 7, Textgruppe 8, Kein Kontoauszugtext)",
            "example": "not_specified"
        },
        "alternative_contact_person": {
            "type": "string",
            "maxLength": 40,
            "description": "Alternative Kontaktperson",
            "example": "Maxima Mustermann"
        },
        "clerk": {
            "type": "string",
            "maxLength": 40,
            "description": "Sachbearbeiter",
            "example": "Torben Mustermann"
        },
        "client_bank_position": {
            "type": "integer",
            "format": "int32",
            "maxLength": 3,
            "maximum": 999,
            "description": "Mandantenbank (Nummerierung), Zuordnung der gespeicherten Mandantenbanken, die für das Lastschriftverfahren bei Debitoren und Zahlungen an Kreditoren verwendet werden soll",
            "example": 2
        },
        "contact_person": {
            "type": "string",
            "maxLength": 40,
            "description": "Ansprechpartner",
            "example": "Rainer Mustermann"
        },
        "credit_limit": {
            "type": "integer",
            "format": "int64",
            "maxLength": 13,
            "description": "Kreditlimit",
            "example": 1250
        },
        "currency_management": {
            "enum": [
            "payments_in_input_currency",
            "payments_in_euro"
            ],
            "type": "string",
            "description": "Währungssteuerung (Eingabewährung, EUR)",
            "example": "payments_in_euro"
        },
        "direct_debit": {
            "enum": [
            "not_specified",
            "sepa_direct_debit",
            "sepa_direct_debit_with_multiple_invoices",
            "no_direct_debit_with_this_debitor"
            ],
            "type": "string",
            "description": "Lastschriften (keine Angabe, SEPA-Lastschrift mit einer Rechnung, SEPA-Lastschrift mit mehreren Rechnungen, kein Lastschriftverfahren bei diesem Debitor).<br>Für kommunale Anwendungen: Lastschriftensperre dauerhaft (keine Angabe, kein Lastschriftverfahren bei diesem Debitor)",
            "example": "not_specified"
        },
        "direct_debit_procedure": {
            "type": "string",
            "description": "Obsolet"
        },
        "dunning_final_deadline": {
            "type": "integer",
            "format": "int32",
            "description": "Letzte Frist (in Tagen)",
            "minimum": 0,
            "maximum": 999,
            "maxLength": 3
        },
        "dunning_interest_rate1": {
            "type": "number",
            "maxLength": 5,
            "format": "decimal",
            "description": "Mahnzinssatz 1",
            "example": 2.75
        },
        "dunning_interest_rate2": {
            "type": "number",
            "maxLength": 5,
            "format": "decimal",
            "description": "Mahnzinssatz 2",
            "example": 3.5
        },
        "dunning_interest_rate3": {
            "type": "number",
            "maxLength": 5,
            "format": "decimal",
            "description": "Mahnzinssatz 3",
            "example": 5
        },
        "dunning_limit_amount": {
            "type": "number",
            "maxLength": 9,
            "format": "decimal",
            "description": "Mahnlimit Betrag",
            "example": 500
        },
        "dunning_limit_percent": {
            "type": "number",
            "maxLength": 5,
            "format": "decimal",
            "description": "Mahnlimit Prozent",
            "example": 10
        },
        "dunning_period1": {
            "type": "integer",
            "format": "int32",
            "description": "Mahnfrist 1 (in Tagen)",
            "minimum": 0,
            "maximum": 999,
            "maxLength": 3
        },
        "dunning_period2": {
            "type": "integer",
            "format": "int32",
            "description": "Mahnfrist 2 (in Tagen)",
            "minimum": 0,
            "maximum": 999,
            "maxLength": 3
        },
        "dunning_period3": {
            "type": "integer",
            "format": "int32",
            "description": "Mahnfrist 3 (in Tagen)",
            "minimum": 0,
            "maximum": 999,
            "maxLength": 3
        },
        "dunning_period_calculation": {
            "enum": [
            "not_specified",
            "calculate_dunning_period"
            ],
            "type": "string",
            "description": "Fristberechnung (keine Angabe, Berechnung der Mahndauer)",
            "example": "calculate_dunning_period"
        },
        "dunning_procedure": {
            "enum": [
            "not_specified",
            "first_dun",
            "second_dun",
            "first_and_second_dun",
            "third_dun",
            "second_and_third_dun",
            "first_second_and_third_dun",
            "no_dun"
            ],
            "type": "string",
            "description": "Mahnbedingungsform (keine Angabe, erste Mahnung, zweite Mahnung, erste und zweite Mahnung, dritte Mahnung, zweite und dritte Mahnung, erste zweite und dritte Mahnung, keine Mahnung)<br>Für kommunale Anwendungen: Mahnsperre dauerhaft (keine Angabe, keine Mahnung)",
            "example": "first_second_and_third_dun"
        },
        "dunning_text1": {
            "enum": [
            "not_specified",
            "text_group1",
            "text_group2",
            "text_group3",
            "text_group4",
            "text_group5",
            "text_group6",
            "text_group7",
            "text_group8",
            "text_group9"
            ],
            "type": "string",
            "description": "Mahntext (keine Angabe, Textgruppe 1, Textgruppe 2, Textgruppe 3, Textgruppe 4, Textgruppe 5, Textgruppe 6, Textgruppe 7, Textgruppe 8, Textgruppe 9) #/definitions/datev.dunning-text"
        },
        "dunning_text2": {
            "$ref": "#/items/properties/accounting_information/properties/dunning_text1"
        },
        "dunning_text3": {
            "$ref": "#/items/properties/accounting_information/properties/dunning_text1"
        },
        "has_enforcement_block": {
            "type": "boolean",
            "description": "Vollstreckungssperre",
            "example": false
        },
        "interest_calculation": {
            "enum": [
            "not_specified",
            "fixed_interest_rate",
            "interest_rate_based_on_sliding_scale",
            "no_interest_calculated_for_this_debitor"
            ],
            "type": "string",
            "description": "Zinsberechnung (keine Angabe, fester Zinssatz, Zins über Staffel, keine Zinsberechnung)",
            "example": "fixed_interest_rate"
        },
        "is_insolvent": {
            "type": "boolean",
            "maxLength": 1,
            "description": "Insolvenz-Kennzeichen",
            "example": false
        },
        "is_various_account": {
            "type": "boolean",
            "description": "Kennzeichen ob es sich um ein Diverses Konto handelt",
            "example": true
        },
        "language": {
            "enum": [
            "not_specified",
            "german",
            "french",
            "english",
            "spanish",
            "italian"
            ],
            "type": "string",
            "description": "Sprache (keine Angabe, Deutsch, Französisch, Englisch, Spanisch, Italienisch)",
            "example": "german"
        },
        "output_destination": {
            "enum": [
            "not_specified",
            "print",
            "fax",
            "email"
            ],
            "type": "string",
            "description": "Ausgabeziel (keine Angabe, Druck, Fax, E-Mail)",
            "example": "fax"
        },
        "tax_number": {
            "type": "string",
            "maxLength": 20,
            "description": "Steuernummer"
        },
        "temp_direct_debit_block": {
            "type": "string",
            "format": "date-time",
            "description": "Temporäre Lastschriftsperre",
            "example": "2016-01-01T00:00:00.000+01:00"
        },
        "temp_dunning_block": {
            "type": "string",
            "format": "date-time",
            "description": "Temporäre Mahnsperre",
            "example": "2016-01-01T00:00:00.000+01:00"
        },
        "temp_enforcement_block": {
            "type": "string",
            "format": "date-time",
            "description": "Temporäre Vollstreckungssperre",
            "example": "2016-01-01T00:00:00.000+01:00"
        },
        "term_of_payment_id": {
            "type": "integer",
            "format": "int32",
            "maxLength": 3,
            "description": "Zahlungsbedingung, eine gespeicherte Zahlungsbedingung kann hier einem Geschäftspartner zugeordnet werden"
        },
        "individual_fields": {
            "items": {
            "properties": {
                "content": {
                "type": "string",
                "maxLength": 40,
                "description": "Inhalt des individuellen Feldes"
                },
                "position": {
                "type": "integer",
                "maxLength": 2,
                "format": "int32",
                "description": "Nummer des individuellen Feldes (Nullbasierte Nummerierung)"
                }
            },
            "description": "#/definitions/datev.individual-field"
            },
            "type": "array",
            "minItems": 1,
            "maxItems": 10
        }
        },
        "description": "#/definitions/datev.debitor-accounting-information"
    },
    "addressee_id": {
        "type": "string",
        "maxLength": 210,
        "description": "Schlüssel/ID des Adressaten, beim PUT ist dies ein Pflichtfeld",
        "example": "342842bf-3af2-4e0d-adda-a2d1dff2a6a5"
    },
    "alternative_search_name": {
        "type": "string",
        "maxLength": 50,
        "description": "Alternativer Suchname",
        "example": "Gewerbe"
    },
    "business_partner_number": {
        "type": "string",
        "description": "Kunden- bzw. Lieferantennummer, kann nicht geändert werden, wenn zentralisierte Geschäftspartner (siehe Property business_partner_relation_id) verwendet werden",
        "example": "2250829"
    },
    "business_partner_relation_id": {
        "type": "string",
        "maxLength": 210,
        "description": "Schlüssel/ID des Geschäftspartners (Kundenbeziehungs-ID), beim POST kann die business_partner_relation_ID vergeben werden, beim PUT muss die business_partner_relation_id verwendet werden, die bereits für den zu aktualisierenden Geschäftspartner verwendet wurde. Wenn business_partner_relation_id eine leere GUID beinhaltet (00000000-0000-0000-0000-000000000000), handelt es sich um einen nicht zentralisierten Geschäftspartner.",
        "example": "d7e3c10f-8b5a-42d4-b790-e84c1762b8b9"
    },
    "caption": {
        "readOnly": true,
        "type": "string",
        "description": "Kontobeschriftung",
        "example": "Mustermann"
    },
    "complimentary_close": {
        "type": "string",
        "maxLength": 50,
        "description": "Brief Grußformel",
        "example": "Mit freundlichem Gruß"
    },
    "correspondence_title": {
        "type": "string",
        "maxLength": 30,
        "description": "Anrede",
        "example": "Geschäftspartner"
    },
    "date_last_modification": {
        "format": "date-time",
        "type": "string",
        "readOnly": true,
        "description": "Datum der letzten Änderung",
        "example": "2016-05-24T00:00:00.000+02:00"
    },
    "eu_vat_id_country_code": {
        "type": "string",
        "maxLength": 2,
        "description": "EU-Mitgliedstaat, ist ein Bestandteil der USt-IdNr., siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
        "example": "FR"
    },
    "eu_vat_id_number": {
        "type": "string",
        "maxLength": 13,
        "description": "EU-Umsatzsteuernummer, ist ein Bestandteil der USt-IdNr., siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
        "example": "12345678901"
    },
    "is_business_partner_active": {
        "type": "boolean",
        "description": "Geschäftspartner Aktiv-Kennzeichen",
        "example": true
    },
    "is_organization_business_partner": {
        "type": "boolean",
        "description": "Kennzeichen, ob es sich um einen Geschäftspartner einer Kanzlei handelt"
    },
    "legal_entity_type": {
        "type": "string",
        "enum": [
        "not_specified",
        "natural_person",
        "legal_person"
        ],
        "description": "Adressatentyp (keine Angabe, Natürliche Person, Unternehmen/Vereinigung)",
        "example": "legal_person",
        "default": "legal_person"
    },
    "salutation": {
        "type": "string",
        "maxLength": 100,
        "description": "Briefanrede",
        "example": "Sehr geehrte Damen und Herren"
    },
    "short_name": {
        "type": "string",
        "description": "Kurzbezeichnung",
        "maxLength": 15,
        "example": "Mustermann"
    },
    "third_party_number": {
        "type": "string",
        "maxLength": 15,
        "description": "Nummer Fremdsystem",
        "example": "bcdeft123"
    },
    "natural_person": {
        "properties": {
        "date_of_birth": {
            "type": "string",
            "format": "date-time",
            "description": "Geburtsdatum",
            "example": "1980-01-01T00:00:00.000+01:00"
        },
        "degree": {
            "type": "string",
            "maxLength": 25,
            "description": "Titel/Akademischer Grad",
            "example": "Sir"
        },
        "firstname": {
            "type": "string",
            "maxLength": 30,
            "description": "Vorname",
            "example": "Max"
        },
        "name_prefix": {
            "type": "string",
            "maxLength": 14,
            "description": "Namensvorsatz",
            "example": "de la"
        },
        "surname": {
            "type": "string",
            "maxLength": 30,
            "description": "Nachname",
            "example": "Mustermann"
        },
        "title_of_nobility": {
            "type": "string",
            "maxLength": 15,
            "description": "Adelstitel"
        }
        },
        "type": "object",
        "description": "#/definitions/datev.natural-person"
    },
    "legal_person": {
        "properties": {
        "enterprise_purpose": {
            "type": "string",
            "maxLength": 50,
            "description": "Unternehmensgegenstand",
            "example": "Mustergewerbe"
        },
        "legal_form": {
            "type": "string",
            "maxLength": 6,
            "description": "Unternehmensform",
            "example": "S00010"
        },
        "legal_name": {
            "type": "string",
            "maxLength": 50,
            "description": "Unternehmensname",
            "example": "Mustergewerbe"
        }
        },
        "type": "object",
        "description": "#/definitions/datev.legal-person"
    },
    "not_specified_person": {
        "properties": {
        "name": {
            "type": "string",
            "description": "Name",
            "maxLength": 50
        }
        },
        "type": "object",
        "description": "#/definitions/datev.not-specified-person"
    },
    "addresses": {
        "items": {
        "required": [
            "address_usage_type"
        ],
        "properties": {
            "id": {
            "type": "string",
            "description": "Schlüssel/ID des Unterobjekts Adresse",
            "example": "1b9c4079-2432-47b8-84c2-eebaa97e7376"
            },
            "additional_correspondence_title": {
            "type": "string",
            "maxLength": 30,
            "description": "Abweichende Anrede",
            "example": "Kanzlei"
            },
            "additional_delivery_text1": {
            "type": "string",
            "maxLength": 50,
            "description": "Abweichende Zustellbezeichnung 1",
            "example": "zus. Zustellungstext 1"
            },
            "additional_delivery_text2": {
            "type": "string",
            "maxLength": 36,
            "description": "Abweichende Zustellbezeichnung 2",
            "example": "zus. Zustellungstext 2"
            },
            "address_appendix": {
            "type": "string",
            "maxLength": 36,
            "description": "Adresszusatz",
            "example": "z. Hd. Herrn Mustermann"
            },
            "address_manually_edited": {
            "readOnly": true,
            "type": "string",
            "maxLength": 210,
            "description": "Aufbereitete Anschrift"
            },
            "address_type": {
            "enum": [
                "not_specified",
                "street_address",
                "post_office_box_address",
                "corporate_client_address"
            ],
            "type": "string",
            "description": "Adressart, wird die Adressart nicht übergeben, wird sie automatisch in Abhängigkeit zu den übergebenen Feldern (Straße, Postfach oder PLZ ) gesetzt (keine Angabe, Straßen-Adresse, Postfach, Großkundenadresse)",
            "example": "street_address"
            },
            "address_usage_type": {
            "properties": {
                "is_correspondence_address": {
                "type": "boolean",
                "description": "Korrespondenzadresse",
                "example": true
                },
                "is_default_delivery_address": {
                "type": "boolean",
                "description": "Standard-Lieferadresse",
                "example": false
                },
                "is_default_payment_address": {
                "type": "boolean",
                "description": "Standard-Rechnungsadresse",
                "example": false
                },
                "is_delivery_address": {
                "type": "boolean",
                "description": "Lieferadresse",
                "example": false
                },
                "is_main_post_office_box_address": {
                "type": "boolean",
                "description": "Hauptpostfachadresse (wird automatisch gesetzt, wenn Adressart ein Postfach ist)",
                "example": false
                },
                "is_main_street_address": {
                "type": "boolean",
                "description": "Hauptstraßenadresse (wird automatisch gesetzt, wenn Adressart eine Straßen-Adresse ist)",
                "example": false
                },
                "is_management_address": {
                "type": "boolean",
                "description": "Geschäftsleitungsadresse",
                "example": false
                }
            },
            "type": "object",
            "description": "#/definitions/datev.address-usage-type"
            },
            "city": {
            "type": "string",
            "maxLength": 30,
            "description": "Ort",
            "example": "Nürnberg"
            },
            "country_code": {
            "type": "string",
            "maxLength": 2,
            "description": "Land, siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
            "example": "DE"
            },
            "district": {
            "type": "string",
            "description": "Ortsteil (für kommunale Anwendungen)"
            },
            "individual_shipping_information": {
            "type": "string",
            "maxLength": 50,
            "description": "Versandzusatz"
            },
            "is_address_manually_edited": {
            "readOnly": true,
            "type": "boolean",
            "description": "Verwendungskennzeichen für aufbereitete Anschrift",
            "example": false
            },
            "note": {
            "type": "string",
            "description": "Notiz",
            "example": "Notizen Beispieltext"
            },
            "post_office_box": {
            "type": "string",
            "maxLength": 10,
            "description": "Postfach, wird sowohl eine Straße als auch ein Postfach übergeben, werden beide Werte in den Datenbestand übernommen, auf der Visitenkarte in den Debitoren-/Kreditoren-/Stammdaten wird die Postfachadresse angezeigt",
            "example": "101010"
            },
            "postal_code": {
            "type": "string",
            "description": "Postleitzahl, steht in Abhängigkeit zu der Länderkennung.<br>Sollte das Property \"county_code\" gefüllt sein, dann wird die Postleitzahlen-Länge des übergebenen Landes berücksichtigt.<br>Ist das Property \"country_code\" nicht gesetzt, dann zählt das eingestellte nationale Recht aus den Mandantenstammdaten.",
            "example": "90491"
            },
            "street": {
            "type": "string",
            "maxLength": 36,
            "description": "Straße, wird sowohl eine Straße als auch ein Postfach übergeben, werden beide Werte in den Datenbestand übernommen, auf der Visitenkarte in den Debitoren-/Kreditoren-/Stammdaten wird die Postfachadresse angezeigt",
            "example": "Musterstraße 1"
            },
            "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig von",
            "example": "2016-01-01T00:00:00.000+01:00"
            },
            "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig bis",
            "example": "9999-12-31T00:00:00.000+01:00"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.address"
        },
        "type": "array",
        "description": "Adressen"
    },
    "communications": {
        "items": {
        "properties": {
            "id": {
            "type": "string",
            "description": "Schlüssel/ID des Unterobjekts Kommunikation",
            "example": "1b9c4079-2432-47b8-84c2-eebaa97e7376"
            },
            "communication_data_content": {
            "type": "string",
            "maxLength": 60,
            "description": "Inhalt der Kommunikationsart",
            "example": "+49 911 999882"
            },
            "communication_number_standardized": {
            "type": "string",
            "maxLength": 60,
            "description": "Nummer normiert, obsolet",
            "example": "0049911999882"
            },
            "communication_type": {
            "enum": [
                "not_specified",
                "phone",
                "email",
                "url",
                "fax",
                "other"
            ],
            "type": "string",
            "description": "Kommunikationstyp (keine Angabe, Telefon, E-Mail, Internet, URL, Fax, Sonstige)",
            "example": "phone"
            },
            "note": {
            "type": "string",
            "maxLength": 40,
            "description": "Notiz",
            "example": "Notizen Beispieltext"
            },
            "communication_usage_type": {
            "properties": {
                "is_main_communication_usage_type": {
                "type": "boolean",
                "description": "Hauptkommunikationsmittel, darf bei Kommunikationstyp \"Sonstige\" nicht gesetzt werden",
                "example": true
                },
                "is_main_management_phone": {
                "type": "boolean",
                "maxLength": 60,
                "description": "Kennzeichen Geschäftsleitungs-Telefon",
                "example": true
                }
            },
            "type": "object",
            "description": "#/definitions/datev.communication-usage-type"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.communication"
        },
        "type": "array",
        "description": "Kommunikationen"
    },
    "banks": {
        "type": "array",
        "items": {
        "properties": {
            "id": {
            "type": "string",
            "description": "Schlüssel/ID des Unterojekts Bank",
            "example": "cdb9e6a9-16b9-4c2f-9705-83a0fc7c9908"
            },
            "bank_account_number": {
            "type": "string",
            "maxLength": 10,
            "description": "Bankkontonummer",
            "example": "121540061"
            },
            "bank_code": {
            "type": "string",
            "maxLength": 8,
            "description": "Bankleitzahl",
            "example": "76050000"
            },
            "bank_customer_number": {
            "type": "string",
            "maxLength": 35,
            "description": "Bank Kundennummer, obsolet",
            "example": "12345"
            },
            "bank_name": {
            "type": "string",
            "maxLength": 30,
            "description": "Bankname",
            "example": "BayernLB Nürnberg"
            },
            "bic": {
            "type": "string",
            "maxLength": 11,
            "description": "BIC",
            "example": "BYLADEMMXXX"
            },
            "business_partner_bank_position": {
            "type": "integer",
            "maxLength": 3,
            "minimum": 1,
            "maximum": 999,
            "format": "int32",
            "description": "Geschäftspartnerbank (Nummerierung), Pflichtfeld, wenn die Bank mitgegeben wird",
            "example": 1
            },
            "country_code": {
            "type": "string",
            "maxLength": 2,
            "description": "Land, siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
            "example": "DE"
            },
            "currency_code": {
            "type": "string",
            "maxLength": 3,
            "description": "Kontowährung, obsolet",
            "example": "EUR"
            },
            "differing_account_holder": {
            "type": "string",
            "maxLength": 70,
            "description": "Abweichender Kontoinhaber",
            "example": "Max Mustermann"
            },
            "iban": {
            "type": "string",
            "maxLength": 34,
            "description": "IBAN",
            "example": "DE38760500000121540061"
            },
            "is_business_partner_bank": {
            "type": "boolean",
            "description": "Geschäftspartnerbank, Verwendungskennzeichen, nur eine Bankverbindung eines Debitoren/Kreditoren kann als Geschäftspartner-Bankverbindung gekennzeichnet werden.<br>Wenn genau <b>eine</b> Bankverbindung übergeben wird, dann wird dieses Verwendungskennzeichen immer auf \"true\" gesetzt.",
            "example": true
            },
            "sepa_mandate_reference": {
            "type": "string",
            "maxLength": 35,
            "description": "SEPA Mandatsreferenz, im Feld \"sepa_mandate_reference\" kann dem Geschäftspartner je Bank eine Mandatsreferenz eintragen werden, für eine korrekte Verwendung muss in der SEPA-Mandatsverwaltung die Mandatsreferenz für den Lastschriftteilnehmer vorhanden sein",
            "example": "503000000001"
            },
            "note": {
            "type": "string",
            "description": "Bemerkung zur Bankverbindung",
            "example": "Hinweis"
            },
            "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig von",
            "example": "2016-01-01T00:00:00.000+01:00"
            },
            "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig bis",
            "example": "9999-12-31T00:00:00.000+01:00"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.bank"
        },
        "description": "Banken, Eine Bankverbindung muss mindestens die Felder \"BLZ/BIC\" und \"Kontonummer/IBAN\" enthalten"
    }
    },
    "description": "#/definitions/debitor"
}
}
Debitor / Kunde 7.2
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
{
"type": "array",
"items": {
    "type": "object",
    "properties": {
    "id": {
        "type": "string",
        "maxLength": 9,
        "description": "ID des Geschäftspartners, entspricht der Kontonummer des Geschäftspartners in Maximallänge, 9-stellig (technische Länge), beim POST darf die ID nicht angegeben werden, beim PUT ist die ID ein Pflichtfeld und muss mit der Kontonummer des Geschäftspartners befüllt werden",
        "example": "100990000"
    },
    "account_number": {
        "type": "integer",
        "maxLength": 9,
        "example": 100990000,
        "readOnly": true,
        "description": "Kontonummer des Geschäftspartners in Maximallänge, 9-stellig (technische Länge), beim POST und beim PUT darf die account_number nicht angegeben werden"
    },
    "accounting_information": {
        "type": "object",
        "properties": {
        "account_statement": {
            "enum": [
            "not_specified",
            "account_statement_for_all_items",
            "account_statement_dunnable_only",
            "account_statement_all_dunnable_items",
            "no_account_statement_for_customer"
            ],
            "type": "string",
            "description": "Kontoauszug (keine Angabe, Kontoauszug mit allen Posten, Kontoauszug nur wenn Posten mahnfällig, Auszug für alle mahnfälligen Posten, kein Kontoauszug)",
            "example": "not_specified"
        },
        "account_statement_text": {
            "enum": [
            "not_specified",
            "account_statement_text1",
            "account_statement_text2",
            "account_statement_text3",
            "account_statement_text4",
            "account_statement_text5",
            "account_statement_text6",
            "account_statement_text7",
            "account_statement_text8",
            "no_account_statement_text"
            ],
            "type": "string",
            "description": "Kontoauszugstextgruppe (keine Angabe, Textgruppe 1, Textgruppe 2, Textgruppe 3, Textgruppe 4, Textgruppe 5, Textgruppe 6, Textgruppe 7, Textgruppe 8, Kein Kontoauszugtext)",
            "example": "not_specified"
        },
        "alternative_contact_person": {
            "type": "string",
            "maxLength": 40,
            "description": "Alternative Kontaktperson",
            "example": "Maxima Mustermann"
        },
        "clerk": {
            "type": "string",
            "maxLength": 40,
            "description": "Sachbearbeiter",
            "example": "Torben Mustermann"
        },
        "client_bank_position": {
            "type": "integer",
            "format": "int32",
            "maxLength": 3,
            "maximum": 999,
            "description": "Mandantenbank (Nummerierung), Zuordnung der gespeicherten Mandantenbanken, die für das Lastschriftverfahren bei Debitoren und Zahlungen an Kreditoren verwendet werden soll",
            "example": 2
        },
        "contact_person": {
            "type": "string",
            "maxLength": 40,
            "description": "Ansprechpartner",
            "example": "Rainer Mustermann"
        },
        "credit_limit": {
            "type": "integer",
            "format": "int64",
            "maxLength": 13,
            "description": "Kreditlimit",
            "example": 1250
        },
        "currency_management": {
            "enum": [
            "payments_in_input_currency",
            "payments_in_euro"
            ],
            "type": "string",
            "description": "Währungssteuerung (Eingabewährung, EUR)",
            "example": "payments_in_euro"
        },
        "direct_debit": {
            "enum": [
            "not_specified",
            "individual_direct_debit_with_invoice",
            "individual_direct_debit_with_multiple_invoices",
            "collective_direct_debit_with_one_invoice",
            "collective_direct_debit_with_multiple_invoices",
            "data_exchange_with_one_invoice",
            "data_exchange_with_multiple_invoices",
            "sepa_direct_debit",
            "sepa_direct_debit_with_multiple_invoices",
            "no_direct_debit_with_this_debitor"
            ],
            "type": "string",
            "description": "Lastschriften (keine Angabe, Einzellastschrift mit einer Rechnung, Einzellastschrift mit mehreren Rechnungen, Sammellastschrift mit einer Rechnung, Sammellastschrift mit mehreren Rechnungen, Datenträgeraustausch mit einer Rechnung, Datenträgeraustausch mit mehreren Rechnungen, SEPA-Lastschrift mit einer Rechnung, SEPA-Lastschrift mit mehreren Rechnungen, kein Lastschriftverfahren bei diesem Debitor).<br>Für kommunale Anwendungen: Lastschriftensperre dauerhaft (keine Angaben, kein Lastschriftverfahren bei diesem Debitor)",
            "example": "not_specified"
        },
        "direct_debit_procedure": {
            "type": "string",
            "description": "Obsolet"
        },
        "dunning_final_deadline": {
            "type": "integer",
            "format": "int32",
            "description": "Letzte Frist (in Tagen)",
            "minimum": 0,
            "maximum": 999,
            "maxLength": 3
        },
        "dunning_interest_rate1": {
            "type": "number",
            "maxLength": 5,
            "format": "decimal",
            "description": "Mahnzinssatz 1",
            "example": 2.75
        },
        "dunning_interest_rate2": {
            "type": "number",
            "maxLength": 5,
            "format": "decimal",
            "description": "Mahnzinssatz 2",
            "example": 3.5
        },
        "dunning_interest_rate3": {
            "type": "number",
            "maxLength": 5,
            "format": "decimal",
            "description": "Mahnzinssatz 3",
            "example": 5
        },
        "dunning_limit_amount": {
            "type": "number",
            "maxLength": 9,
            "format": "decimal",
            "description": "Mahnlimit Betrag",
            "example": 500
        },
        "dunning_limit_percent": {
            "type": "number",
            "maxLength": 5,
            "format": "decimal",
            "description": "Mahnlimit Prozent",
            "example": 10
        },
        "dunning_period1": {
            "type": "integer",
            "format": "int32",
            "description": "Mahnfrist 1 (in Tagen)",
            "minimum": 0,
            "maximum": 999,
            "maxLength": 3
        },
        "dunning_period2": {
            "type": "integer",
            "format": "int32",
            "description": "Mahnfrist 2 (in Tagen)",
            "minimum": 0,
            "maximum": 999,
            "maxLength": 3
        },
        "dunning_period3": {
            "type": "integer",
            "format": "int32",
            "description": "Mahnfrist 3 (in Tagen)",
            "minimum": 0,
            "maximum": 999,
            "maxLength": 3
        },
        "dunning_period_calculation": {
            "enum": [
            "not_specified",
            "calculate_dunning_period"
            ],
            "type": "string",
            "description": "Fristberechnung",
            "example": "calculate_dunning_period"
        },
        "dunning_procedure": {
            "enum": [
            "not_specified",
            "first_dun",
            "second_dun",
            "first_and_second_dun",
            "third_dun",
            "second_and_third_dun",
            "first_second_and_third_dun",
            "no_dun"
            ],
            "type": "string",
            "description": "Mahnbedingungsform (keine Angabe, erste Mahnung, zweite Mahnung, erste und zweite Mahnung, dritte Mahnung, zweite und dritte Mahnung, erste zweite und dritte Mahnung, keine Mahnung)<br>Für kommunale Anwendungen: Manhnsperre dauerhaft (keine Angabe, keine Mahnung)",
            "example": "first_second_and_third_dun"
        },
        "dunning_text1": {
            "enum": [
            "not_specified",
            "text_group1",
            "text_group2",
            "text_group3",
            "text_group4",
            "text_group5",
            "text_group6",
            "text_group7",
            "text_group8",
            "text_group9"
            ],
            "type": "string",
            "description": "Mahntext (keine Angabe, Textgruppe 1, Textgruppe 2, Textgruppe 3, Textgruppe 4, Textgruppe 5, Textgruppe 6, Textgruppe 7, Textgruppe 8, Textgruppe 9) #/definitions/datev.dunning-text"
        },
        "dunning_text2": {
            "$ref": "#/items/properties/accounting_information/properties/dunning_text1"
        },
        "dunning_text3": {
            "$ref": "#/items/properties/accounting_information/properties/dunning_text1"
        },
        "has_enforcement_block": {
            "type": "boolean",
            "description": "Vollstreckungssperre",
            "example": false
        },
        "interest_calculation": {
            "enum": [
            "not_specified",
            "fixed_interest_rate",
            "interest_rate_based_on_sliding_scale",
            "no_interest_calculated_for_this_debitor"
            ],
            "type": "string",
            "description": "Zinsberechnung (keine Angabe, fester Zinssatz, Zins über Staffel, keine Zinsberechnung)",
            "example": "fixed_interest_rate"
        },
        "is_insolvent": {
            "type": "boolean",
            "maxLength": 1,
            "description": "Insolvenz-Kennzeichen",
            "example": false
        },
        "is_various_account": {
            "type": "boolean",
            "description": "Kennzeichen ob es sich um ein Diverses Konto handelt",
            "example": true
        },
        "language": {
            "enum": [
            "not_specified",
            "german",
            "french",
            "english",
            "spanish",
            "italian"
            ],
            "type": "string",
            "description": "Sprache (keine Angabe, Deutsch, Französisch, Englisch, Spanisch, Italienisch)",
            "example": "german"
        },
        "output_destination": {
            "enum": [
            "not_specified",
            "print",
            "fax",
            "email"
            ],
            "type": "string",
            "description": "Ausgabeziel (keine Angabe, Druck, Fax, E-Mail)",
            "example": "not_specified"
        },
        "tax_number": {
            "type": "string",
            "maxLength": 20,
            "description": "Steuernummer"
        },
        "temp_direct_debit_block": {
            "type": "string",
            "format": "date-time",
            "description": "Temporäre Lastschriftsperre",
            "example": "2015-12-31T23:00:00.000Z"
        },
        "temp_dunning_block": {
            "type": "string",
            "format": "date-time",
            "description": "Temporäre Mahnsperre",
            "example": "2015-12-31T23:00:00.000Z"
        },
        "temp_enforcement_block": {
            "type": "string",
            "format": "date-time",
            "description": "Temporäre Vollstreckungssperre",
            "example": "2015-12-31T23:00:00.000Z"
        },
        "term_of_payment_id": {
            "type": "integer",
            "format": "int32",
            "maxLength": 3,
            "description": "Zahlungsbedingung, eine gespeicherte Zahlungsbedingung kann hier einem Geschäftspartner zugeordnet werden"
        },
        "individual_fields": {
            "items": {
            "properties": {
                "content": {
                "type": "string",
                "maxLength": 40,
                "description": "Beschriftung des individuellen Feldes"
                },
                "position": {
                "type": "integer",
                "maxLength": 2,
                "format": "int32",
                "description": "Nummer des individuellen Feldes"
                }
            },
            "description": "#/definitions/datev.individual-field"
            },
            "type": "array",
            "minItems": 1,
            "maxItems": 10
        }
        },
        "description": "#/definitions/datev.debitor-accounting-information"
    },
    "addressee_id": {
        "type": "string",
        "maxLength": 210,
        "description": "Schlüssel/ID des Adressaten",
        "example": "342842bf-3af2-4e0d-adda-a2d1dff2a6a5"
    },
    "alternative_search_name": {
        "type": "string",
        "maxLength": 50,
        "description": "Alternativer Suchname",
        "example": "Gewerbe"
    },
    "business_partner_number": {
        "type": "string",
        "description": "Kunden- bzw. Lieferantennummer, kann nicht geändert werden, wenn zentralisierte Geschäftspartner (siehe Property business_partner_relation_id) verwendet werden",
        "example": "2250829"
    },
    "business_partner_relation_id": {
        "type": "string",
        "maxLength": 210,
        "description": "Schlüssel/ID des Geschäftspartners (Kundenbeziehungs-ID), beim POST kann die business_partner_relation_id vergeben werden, beim PUT muss die business_partner_relation_id verwendet werden, die bereits für den zu aktualisierenden Geschäftspartner verwendet wurde. Wenn business_partner_relation_id eine leere GUID beinhaltet (00000000-0000-0000-0000-000000000000), handelt es sich um einen nicht zentralisierten Geschäftspartner.",
        "example": "d7e3c10f-8b5a-42d4-b790-e84c1762b8b9"
    },
    "caption": {
        "readOnly": true,
        "type": "string",
        "description": "Kontobeschriftung",
        "example": "Mustermann"
    },
    "complimentary_close": {
        "type": "string",
        "maxLength": 50,
        "description": "Brief Grußformel",
        "example": "Mit freundlichem Gruß"
    },
    "correspondence_title": {
        "type": "string",
        "maxLength": 100,
        "description": "Anrede",
        "example": "Geschäftspartner"
    },
    "date_last_modification": {
        "format": "date-time",
        "type": "string",
        "readOnly": true,
        "description": "Datum der letzten Änderung",
        "example": "2016-05-23T22:00:00.000Z"
    },
    "eu_vat_id_country_code": {
        "type": "string",
        "maxLength": 2,
        "description": "EU-Mitgliedstaat, ist ein Bestandteil der USt-IdNr., siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
        "example": "FR"
    },
    "eu_vat_id_number": {
        "type": "string",
        "maxLength": 13,
        "description": "EU-Umsatzsteuernummer, ist ein Bestandteil der USt-IdNr., siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
        "example": "12345678901"
    },
    "is_business_partner_active": {
        "type": "boolean",
        "description": "Geschäftspartner Aktiv-Kennzeichen",
        "example": true
    },
    "legal_entity_type": {
        "type": "string",
        "enum": [
        "not_specified",
        "natural_person",
        "legal_person"
        ],
        "description": "Adressatentyp (keine Angabe, Natürliche Person, Unternehmen/Vereinigung)",
        "example": "legal_person",
        "default": "legal_person"
    },
    "salutation": {
        "type": "string",
        "maxLength": 100,
        "description": "Briefanrede",
        "example": "Sehr geehrte Damen und Herren"
    },
    "short_name": {
        "type": "string",
        "description": "Kurzbezeichnung",
        "maxLength": 15,
        "example": "Mustermann"
    },
    "third_party_number": {
        "type": "string",
        "maxLength": 15,
        "description": "Nummer Fremdsystem",
        "example": "bcdeft123"
    },
    "natural_person": {
        "properties": {
        "date_of_birth": {
            "type": "string",
            "format": "date-time",
            "description": "Geburtsdatum",
            "example": "1979-12-31T23:00:00.000Z"
        },
        "degree": {
            "type": "string",
            "maxLength": 25,
            "description": "Titel/Akademischer Grad"
        },
        "firstname": {
            "type": "string",
            "maxLength": 30,
            "description": "Vorname"
        },
        "name_prefix": {
            "type": "string",
            "maxLength": 14,
            "description": "Namensvorsatz"
        },
        "surname": {
            "type": "string",
            "maxLength": 30,
            "description": "Nachname"
        },
        "title_of_nobility": {
            "type": "string",
            "maxLength": 15,
            "description": "Adelstitel"
        }
        },
        "type": "object",
        "description": "#/definitions/datev.natural-person"
    },
    "legal_person": {
        "properties": {
        "enterprise_purpose": {
            "type": "string",
            "maxLength": 50,
            "description": "Unternehmensgegenstand",
            "example": "Mustergewerbe"
        },
        "legal_form": {
            "type": "string",
            "maxLength": 6,
            "description": "Unternehmensform"
        },
        "legal_name": {
            "type": "string",
            "maxLength": 50,
            "description": "Unternehmensname",
            "example": "Mustergewerbe"
        }
        },
        "type": "object",
        "description": "#/definitions/datev.legal-person"
    },
    "not_specified_person": {
        "properties": {
        "name": {
            "type": "string",
            "description": "Name",
            "maxLength": 50
        }
        },
        "type": "object",
        "description": "#/definitions/datev.not-specified-person"
    },
    "addresses": {
        "items": {
        "required": [
            "address_usage_type"
        ],
        "properties": {
            "id": {
            "type": "string",
            "description": "Schlüssel/ID des Unterobjekts Adresse",
            "example": "1b9c4079-2432-47b8-84c2-eebaa97e7376"
            },
            "additional_correspondence_title": {
            "type": "string",
            "maxLength": 30,
            "description": "Abweichende Anrede",
            "example": "Kanzlei"
            },
            "additional_delivery_text1": {
            "type": "string",
            "maxLength": 50,
            "description": "Abweichende Zustellbezeichnung 1",
            "example": "zus. Zustellungstext 1"
            },
            "additional_delivery_text2": {
            "type": "string",
            "maxLength": 36,
            "description": "Abweichende Zustellbezeichnung 2",
            "example": "zus. Zustellungstext 2"
            },
            "address_appendix": {
            "type": "string",
            "maxLength": 36,
            "description": "Adresszusatz",
            "example": "z. Hd. Herrn Mustermann"
            },
            "address_manually_edited": {
            "readOnly": true,
            "type": "string",
            "maxLength": 210,
            "description": "Aufbereitete Anschrift"
            },
            "address_type": {
            "enum": [
                "not_specified",
                "street_address",
                "post_office_box_address",
                "corporate_client_address"
            ],
            "type": "string",
            "description": "Adressart, wird die Adressart nicht übergeben, wird sie automatisch in Abhängigkeit zu den übergebenen Feldern (Straße, Postfach oder PLZ ) gesetzt (keine Angabe, Straßen-Adresse, Postfach, Großkundenadresse)",
            "example": "street_address"
            },
            "address_usage_type": {
            "properties": {
                "is_correspondence_address": {
                "type": "boolean",
                "description": "Korrespondenzadresse",
                "example": true
                },
                "is_default_delivery_address": {
                "type": "boolean",
                "description": "Standard-Lieferadresse",
                "example": false
                },
                "is_default_payment_address": {
                "type": "boolean",
                "description": "Standard-Rechnungsadresse",
                "example": false
                },
                "is_delivery_address": {
                "type": "boolean",
                "description": "Lieferadresse",
                "example": false
                },
                "is_main_post_office_box_address": {
                "type": "boolean",
                "description": "Hauptpostfachadresse (wird automatisch gesetzt, wenn Adressart ein Postfach ist)",
                "example": false
                },
                "is_main_street_address": {
                "type": "boolean",
                "description": "Hauptstraßenadresse (wird automatisch gesetzt, wenn Adressart eine Straßen-Adresse ist)",
                "example": false
                },
                "is_management_address": {
                "type": "boolean",
                "description": "Geschäftsleitungsadresse",
                "example": false
                }
            },
            "type": "object",
            "description": "#/definitions/datev.address-usage-type"
            },
            "city": {
            "type": "string",
            "maxLength": 30,
            "description": "Ort",
            "example": "Nürnberg"
            },
            "country_code": {
            "type": "string",
            "maxLength": 2,
            "description": "Land, siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
            "example": "DE"
            },
            "district": {
            "type": "string",
            "description": "Ortsteil"
            },
            "individual_shipping_information": {
            "type": "string",
            "maxLength": 50,
            "description": "Versandzusatz"
            },
            "is_address_manually_edited": {
            "readOnly": true,
            "type": "boolean",
            "description": "Verwendungskennzeichen für aufbereitete Anschrift",
            "example": false
            },
            "note": {
            "type": "string",
            "description": "Notiz",
            "example": "Notizen Beispieltext"
            },
            "post_office_box": {
            "type": "string",
            "maxLength": 10,
            "description": "Postfach, wird sowohl eine Straße als auch ein Postfach übergeben, werden beide Werte in den Datenbestand übernommen, auf der Visitenkarte in den Debitoren-/Kreditoren-/Stammdaten wird die Postfachadresse angezeigt",
            "example": "101010"
            },
            "postal_code": {
            "type": "string",
            "description": "Postleitzahl, steht in Abhängigkeit zu der Länderkennung.<br>Sollte das Property \"county_code\" gefüllt sein, dann wird die Postleitzahlen-Länge des übergebenen Landes berücksichtigt.<br>Ist das Property \"country_code\" nicht gesetzt, dann zählt das eingestellte nationale Recht aus den Mandantenstammdaten.",
            "example": "90491"
            },
            "street": {
            "type": "string",
            "maxLength": 36,
            "description": "Straße, wird sowohl eine Straße als auch ein Postfach übergeben, werden beide Werte in den Datenbestand übernommen, auf der Visitenkarte in den Debitoren-/Kreditoren-/Stammdaten wird die Postfachadresse angezeigt",
            "example": "Musterstraße 1"
            },
            "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig von",
            "example": "2015-12-31T23:00:00.000Z"
            },
            "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig bis",
            "example": "9999-12-30T23:00:00.000Z"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.address"
        },
        "type": "array"
    },
    "communications": {
        "items": {
        "properties": {
            "id": {
            "type": "string",
            "description": "Schlüssel/ID des Unterobjekts Kommunikation",
            "example": "1b9c4079-2432-47b8-84c2-eebaa97e7376"
            },
            "communication_data_content": {
            "type": "string",
            "maxLength": 60,
            "description": "Inhalt der Kommunikationsart",
            "example": "+49 911 999882"
            },
            "communication_number_standardized": {
            "type": "string",
            "maxLength": 60,
            "description": "Nummer normiert, obsolet",
            "example": 49912000000
            },
            "communication_type": {
            "enum": [
                "not_specified",
                "phone",
                "email",
                "url",
                "fax",
                "other"
            ],
            "type": "string",
            "description": "Kommunikationstyp (keine Angabe, Telefon, E-Mail, Internet, URL, Fax, Sonstige)",
            "example": "phone"
            },
            "note": {
            "type": "string",
            "maxLength": 40,
            "description": "Notiz",
            "example": "Notizen Beispieltext"
            },
            "communication_usage_type": {
            "properties": {
                "is_main_communication_usage_type": {
                "type": "boolean",
                "description": "Hauptkommunikationsmittel, darf bei Kommunikationstyp \"Sonstige\" nicht gesetzt werden",
                "example": true
                },
                "is_main_management_phone": {
                "type": "boolean",
                "maxLength": 60,
                "description": "Geschäftstelefon",
                "example": true
                }
            },
            "type": "object",
            "description": "#/definitions/datev.communication-usage-type"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.communication"
        },
        "type": "array"
    },
    "banks": {
        "type": "array",
        "items": {
        "properties": {
            "id": {
            "type": "string",
            "description": "Schlüssel/ID des Unterojekts Bank",
            "example": "cdb9e6a9-16b9-4c2f-9705-83a0fc7c9908"
            },
            "bank_account_number": {
            "type": "string",
            "maxLength": 10,
            "description": "Bankkontonummer",
            "example": "121540061"
            },
            "bank_code": {
            "type": "string",
            "maxLength": 8,
            "description": "Bankleitzahl",
            "example": "76050000"
            },
            "bank_customer_number": {
            "type": "string",
            "maxLength": 35,
            "description": "Kundennummer",
            "example": "12345"
            },
            "bank_name": {
            "type": "string",
            "maxLength": 30,
            "description": "Bankname",
            "example": "BayernLB Nürnberg"
            },
            "bic": {
            "type": "string",
            "maxLength": 11,
            "description": "BIC",
            "example": "BYLADEMMXXX"
            },
            "business_partner_bank_position": {
            "type": "integer",
            "maxLength": 3,
            "minimum": 1,
            "maximum": 999,
            "format": "int32",
            "description": "Geschäftspartnerbank (Nummerierung)",
            "example": 1
            },
            "country_code": {
            "type": "string",
            "maxLength": 2,
            "description": "Land, siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
            "example": "DE"
            },
            "currency_code": {
            "type": "string",
            "maxLength": 3,
            "description": "Kontowährung",
            "example": "EUR"
            },
            "differing_account_holder": {
            "type": "string",
            "maxLength": 70,
            "description": "Abweichender Kontoinhaber",
            "example": "Max Mustermann"
            },
            "iban": {
            "type": "string",
            "maxLength": 34,
            "description": "IBAN",
            "example": "DE38760500000121540061"
            },
            "is_business_partner_bank": {
            "type": "boolean",
            "description": "Geschäftspartnerbank, Verwendungskennzeichen, nur eine Bankverbindung eines Debitoren bzw. Kreditoren kann als Geschäftspartner-Bankverbindung gekennzeichnet werden. Wenn genau eine Bankverbindung übergeben wird, dann wird dieses Verwendungskennzeichen immer auf \"true\" gesetzt.",
            "example": true
            },
            "sepa_mandate_reference": {
            "type": "string",
            "maxLength": 35,
            "description": "SEPA Mandatsreferenz, im Feld \"sepa_mandate_reference\" kann dem Geschäftspartner je Bank eine Mandatsreferenz eintragen werden, für eine korrekte Verwendung muss in der SEPA-Mandatsverwaltung die Mandatsreferenz für den Lastschriftteilnehmer vorhanden sein",
            "example": "503000000001"
            },
            "note": {
            "type": "string",
            "description": "Bemerkung zur Bankverbindung",
            "example": "Hinweis"
            },
            "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig von",
            "example": "2015-12-31T23:00:00.000Z"
            },
            "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig bis",
            "example": "9999-12-30T23:00:00.000Z"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.bank"
        }
    }
    },
    "description": "#/definitions/debitor"
}
}

Kostenträger

Cost systems / Kostenträger 8.2
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
{
"type": "array",
"items": {
    "type": "object",
    "properties": {
        "id": {
            "type": "string",
            "description": "ID of the cost system",
            "maxLength": 1,
            "example": 9
        },
        "short_name": {
            "type": "string",
            "description": "Short name",
            "example": "Kost 1"
        },
        "is_activated_for_postings": {
            "type": "boolean",
            "description": "Posting assistance",
            "example": true
        },
        "cost_field": {
            "type": "string",
            "description": "Associated codt field",
            "example": 2
        },
        "number": {
            "type": "number",
            "format": "short",
            "maxLength": 1,
            "description": "Cost system number, maximum length 1",
            "example": 9
        }
    },
    "description": "#/definitions/cost-system"
    }
}
Cost systems / Kostenträger 8.1
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
"type": "array",
"items": {
    "type": "object",
    "properties": {
    "id": {
        "type": "string",
        "description": "ID des KOST-Systems",
        "maxLength": 1
    },
    "short_name": {
        "type": "string",
        "description": "Kurzbezeichnung des KOST-Systems"
    },
    "is_activated_for_postings": {
        "type": "boolean",
        "description": "Buchungsunterstützung"
    },
    "cost_field": {
        "type": "string",
        "description": "Zugeordnetes KOST-Feld in der Buchungszeile"
    },
    "number": {
        "type": "number",
        "format": "short",
        "maxLength": 1,
        "description": "Nummer des KOST-Systems, maximal 1-stellig"
    }
    },
    "description": "#/definitions/cost-system"
}
}
Cost systems / Kostenträger 7.2
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
{
"type": "array",
"items": {
    "type": "object",
    "properties": {
    "id": {
        "type": "string",
        "description": "ID des KOST-Systems",
        "maxLength": 1
    },
    "short_name": {
        "type": "string",
        "description": "Kurzbezeichnung des Kost-Systems"
    },
    "is_activated_for_postings": {
        "type": "boolean",
        "description": "Buchungsunterstützung"
    },
    "cost_field": {
        "type": "string",
        "description": "Zugeordnetes KOST-Feld in der Buchungszeile"
    },
    "number": {
        "type": "number",
        "format": "short",
        "description": "Nummer des KOST-Systems, maximal 1-stellig"
    }
    },
    "description": "#/definitions/cost-system"
}
}

Lieferant

Creditor / Lieferant 8.2
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
    {
"type": "array",
"items": {
    "type": "object",
    "properties": {
    "id": {
        "type": "string",
        "description": "ID of the business partner, account number of the business partner shown at maximum length; 9 digits (technical length); the ID may not be entered with POST; for PUT, the ID is a mandatory field and must be completed with the account number of the business partner",
        "example": "700990000"
    },
    "account_number": {
        "type": "integer",
        "maxLength": 9,
        "example": 700990000,
        "description": "Account number of the business partner shown at maximum length; 9 digits (technical length); for POST and PUT, the account_number may not be entered"
    },
    "accounting_information": {
        "type": "object",
        "properties": {
        "alternative_contact_person": {
            "type": "string",
            "maxLength": 40,
            "description": "Alternative contact person",
            "example": "Maxima Mustermann"
        },
        "clerk": {
            "type": "string",
            "maxLength": 40,
            "description": "Clerk",
            "example": "Torben Mustermann"
        },
        "client_bank_position": {
            "type": "integer",
            "format": "int32",
            "maxLength": 3,
            "maximum": 999,
            "description": "Client bank (numbering), allocation of the saved client bank that should be used for direct debit with debitors and payments with creditors",
            "example": 2
        },
        "contact_person": {
            "type": "string",
            "maxLength": 40,
            "description": "Contact person,",
            "example": "Rainer Mustermann"
        },
        "currency_management": {
            "enum": [
            "payments_in_input_currency",
            "payments_in_euro"
            ],
            "type": "string",
            "description": "Currency management (payments in input currency, payments in euro)",
            "example": "payments_in_euro"
        },
        "is_insolvent": {
            "type": "boolean",
            "description": "Insolvency status identifier",
            "example": true
        },
        "is_various_account": {
            "type": "boolean",
            "description": "Differing account",
            "example": true
        },
        "language": {
            "enum": [
            "not_specified",
            "german",
            "french",
            "english",
            "spanish",
            "italian"
            ],
            "type": "string",
            "description": "Language (not specified, german, french, english, spanish, italian)",
            "example": "german"
        },
        "output_destination": {
            "enum": [
            "not_specified",
            "print",
            "fax",
            "email"
            ],
            "type": "string",
            "description": "Output destination (not specified, print, fax, e-mail)",
            "example": "not_specified"
        },
        "payment_medium": {
            "enum": [
            "not_specified",
            "individual_check",
            "collective_check",
            "sepa_bank_transfer_with_one_invoice",
            "sepa_bank_transfer_with_multiple_invoices",
            "no_bank_transfer"
            ],
            "type": "string",
            "description": "Payment medium (not specified, individual check, collective check, SEPA bank transfer with one invoice, SEPA bank transfer with multiple invoices, no bank transfer)",
            "example": "sepa_bank_transfer_with_one_invoice"
        },
        "tax_number": {
            "type": "string",
            "maxLength": 20,
            "description": "Tax number"
        },
        "temp_payment_block": {
            "type": "string",
            "format": "date-time",
            "description": "Temporary payment block",
            "example": "2015-12-31T23:00:00.000Z"
        },
        "term_of_payment_id": {
            "type": "integer",
            "format": "int32",
            "maxLength": 3,
            "description": "Term of payment, a saved term of payment can be assigned to a business partner here",
            "example": 123
        },
        "individual_fields": {
            "items": {
            "properties": {
                "content": {
                "type": "string",
                "maxLength": 40,
                "description": "Content of the individual field",
                "example": "Color"
                },
                "position": {
                "type": "integer",
                "maxLength": 2,
                "format": "int32",
                "description": "Number of the individual field (zero-based numbering)",
                "example": 12
                }
            },
            "description": "#/definitions/datev.individual-field"
            },
            "type": "array",
            "minItems": 0,
            "maxItems": 10
        }
        },
        "description": "#/definitions/datev.creditor-accounting-information"
    },
    "addressee_id": {
        "type": "string",
        "description": "Addressee ID, required when using PUT",
        "example": "342842bf-3af2-4e0d-adda-a2d1dff2a6a5"
    },
    "alternative_search_name": {
        "type": "string",
        "maxLength": 50,
        "description": "Alternative search name",
        "example": "Gewerbe"
    },
    "business_partner_number": {
        "type": "string",
        "maxLength": 15,
        "description": "Customer/supplier number, cannot be changed, only when using centralized business partners (see property business_partner_relation_id)",
        "example": "2250829"
    },
    "business_partner_relation_id": {
        "type": "string",
        "maxLength": 210,
        "description": "ID of the business partner (customer relation ID); with POST, the business_partner_relation_id can be assigned; with PUT, the business_partner_relation_id that has already been used for the business partner being updated must be used again. If business_partner_relation_id contains an empty GUID (00000000-0000-0000-0000-000000000000), it is a not centralized business partner.",
        "example": "d7e3c10f-8b5a-42d4-b790-e84c1762b8b9"
    },
    "caption": {
        "readOnly": true,
        "type": "string",
        "description": "Account caption",
        "example": "Mustermann"
    },
    "complimentary_close": {
        "type": "string",
        "maxLength": 50,
        "description": "Complimentary close of a letter",
        "example": "Kind regards"
    },
    "correspondence_title": {
        "type": "string",
        "description": "Title",
        "maxLength": 30,
        "example": "Test business-partner"
    },
    "date_last_modification": {
        "format": "date-time",
        "type": "string",
        "readOnly": true,
        "description": "Date of most recent modification",
        "example": "2016-05-23T22:00:00.000Z"
    },
    "eu_vat_id_country_code": {
        "type": "string",
        "maxLength": 2,
        "description": "EU member state, is a component of the VAT ID no., see Info Database, document [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
        "example": "DE"
    },
    "eu_vat_id_number": {
        "type": "string",
        "maxLength": 13,
        "description": "EU VAT ID number, is a component of the VAT ID no., see Info Database, document [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
        "example": "12345678901"
    },
    "is_business_partner_active": {
        "type": "boolean",
        "description": "Active business partner identifier",
        "example": true
    },
    "is_organization_business_partner": {
        "type": "boolean",
        "description": "Indicator as to whether the business partner is an organization business partner",
        "example": true
    },
    "legal_entity_type": {
        "enum": [
        "not_specified",
        "natural_person",
        "legal_person"
        ],
        "type": "string",
        "description": "Addressee type (not specified, natural person, legal person)",
        "example": "legal_person",
        "default": "legal_person"
    },
    "salutation": {
        "type": "string",
        "description": "Letter salutation",
        "maxLength": 100,
        "example": "Dear ladies and gentleman"
    },
    "short_name": {
        "type": "string",
        "description": "Short name",
        "maxLength": 15,
        "example": "Mustermann"
    },
    "third_party_number": {
        "type": "string",
        "maxLength": 15,
        "description": "Number in third-party system",
        "example": "abcdeft123"
    },
    "natural_person": {
        "properties": {
        "date_of_birth": {
            "type": "string",
            "format": "date-time",
            "description": "Date of birth",
            "example": "1979-12-31T23:00:00.000Z"
        },
        "degree": {
            "type": "string",
            "maxLength": 25,
            "description": "Title/academic level",
            "example": "Sir"
        },
        "firstname": {
            "type": "string",
            "maxLength": 30,
            "description": "First name",
            "example": "Max"
        },
        "name_prefix": {
            "type": "string",
            "maxLength": 14,
            "description": "Name prefix",
            "example": "de la"
        },
        "surname": {
            "type": "string",
            "maxLength": 30,
            "description": "Last name",
            "example": "Mustermann"
        },
        "title_of_nobility": {
            "type": "string",
            "maxLength": 15,
            "description": "Title of nobility",
            "example": "Truchsess"
        }
        },
        "type": "object",
        "description": "#/definitions/datev.natural-person"
    },
    "legal_person": {
        "properties": {
        "enterprise_purpose": {
            "type": "string",
            "maxLength": 50,
            "description": "Enterprise purpose",
            "example": "commercial trade"
        },
        "legal_form": {
            "type": "string",
            "maxLength": 6,
            "description": "Legal form",
            "example": "S00010"
        },
        "legal_name": {
            "type": "string",
            "maxLength": 50,
            "description": "Legal name",
            "example": "Mustergewerbe"
        }
        },
        "type": "object",
        "description": "#/definitions/datev.legal-person"
    },
    "not_specified_person": {
        "properties": {
        "name": {
            "type": "string",
            "description": "Name",
            "maxLength": 50,
            "example": "Chuck Norris"
        }
        },
        "type": "object",
        "description": "#/definitions/datev.not-specified-person"
    },
    "addresses": {
        "items": {
        "required": [
            "address_usage_type"
        ],
        "properties": {
            "id": {
            "type": "string",
            "description": "ID of the subobject address",
            "example": "1b9c4079-2432-47b8-84c2-eebaa97e7376"
            },
            "additional_correspondence_title": {
            "type": "string",
            "maxLength": 30,
            "description": "Differing title",
            "example": "chancellery"
            },
            "additional_delivery_text1": {
            "type": "string",
            "maxLength": 50,
            "description": "Differing delivery text 1",
            "example": "differing delivery text 1"
            },
            "additional_delivery_text2": {
            "type": "string",
            "maxLength": 36,
            "description": "Differing delivery text 2",
            "example": "differing delivery text 2"
            },
            "address_appendix": {
            "type": "string",
            "maxLength": 36,
            "description": "Address supplement",
            "example": "z. Hd. Herrn Mustermann"
            },
            "address_manually_edited": {
            "readOnly": true,
            "type": "string",
            "maxLength": 210,
            "description": "Manually edited address"
            },
            "address_type": {
            "enum": [
                "not_specified",
                "street_address",
                "post_office_box_address",
                "corporate_client_address"
            ],
            "type": "string",
            "description": "Address type, if the address type is not indicated, it will be automatically completed based on the transferred fields (street, post office box or postal code), (not specified, street address, post office box address, corporate client address)",
            "example": "not_specified"
            },
            "address_usage_type": {
            "properties": {
                "is_correspondence_address": {
                "type": "boolean",
                "description": "Correspondence address",
                "example": true
                },
                "is_default_delivery_address": {
                "type": "boolean",
                "description": "Default delivery address",
                "example": true
                },
                "is_default_payment_address": {
                "type": "boolean",
                "description": "Default invoice address",
                "example": true
                },
                "is_delivery_address": {
                "type": "boolean",
                "description": "Delivery address",
                "example": true
                },
                "is_main_post_office_box_address": {
                "type": "boolean",
                "description": "Main post office box address (set on default if the address type is \"post_office_box_address\")",
                "example": true
                },
                "is_main_street_address": {
                "type": "boolean",
                "description": "Main street address (set on default if the address type is \"street_address\")",
                "example": true
                },
                "is_management_address": {
                "type": "boolean",
                "description": "Management address",
                "example": true
                }
            },
            "type": "object",
            "description": "#/definitions/datev.address-usage-type"
            },
            "city": {
            "type": "string",
            "maxLength": 30,
            "description": "City",
            "example": "Nuremberg"
            },
            "country_code": {
            "type": "string",
            "maxLength": 2,
            "description": "Country, see Info Database, document [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
            "example": "DE"
            },
            "district": {
            "type": "string",
            "description": "District (public sector)",
            "example": "Soho"
            },
            "individual_shipping_information": {
            "type": "string",
            "maxLength": 50,
            "description": "Additional shipping information",
            "example": "free delivery"
            },
            "is_address_manually_edited": {
            "readOnly": true,
            "type": "boolean",
            "description": "Usage identifier for a manually edited address",
            "example": true
            },
            "note": {
            "type": "string",
            "description": "Note",
            "example": "Sample text"
            },
            "post_office_box": {
            "type": "string",
            "maxLength": 10,
            "description": "Post office box, if both a street address and a post office box are indicated, both values will be added to the database; the post office box will be displayed on the business card in the debitor/creditor master data",
            "example": "101010"
            },
            "postal_code": {
            "type": "string",
            "description": "Zip code, depends on the country code. When the property \"country_code\" is set, the zip code length of the corresponding country is taken into account. When the property \"country_code\" is not set, the country is taken from the client's national law",
            "example": "90491"
            },
            "street": {
            "type": "string",
            "maxLength": 36,
            "description": "Street, if both a street address and a post office box are indicated, both values will be added to the database; the post office box will be displayed on the business card in the debitor/creditor master data",
            "example": "Exemplary street 1"
            },
            "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Valid from",
            "example": "2015-12-31T23:00:00.000Z"
            },
            "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Valid to",
            "example": "9999-12-30T23:00:00.000Z"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.address"
        },
        "type": "array",
        "description": "Addresses"
    },
    "communications": {
        "items": {
        "properties": {
            "id": {
            "type": "string",
            "description": "ID of the subobject communication",
            "example": "1b9c4079-2432-47b8-84c2-eebaa97e7376"
            },
            "communication_data_content": {
            "type": "string",
            "maxLength": 60,
            "description": "Content of the communication type",
            "example": "+49 911 999882"
            },
            "communication_type": {
            "enum": [
                "not_specified",
                "phone",
                "email",
                "url",
                "fax",
                "other"
            ],
            "type": "string",
            "description": "Communication method (not specified, phone, email, url, fax, other)",
            "example": "phone"
            },
            "note": {
            "type": "string",
            "maxLength": 40,
            "description": "Note",
            "example": "Note example text"
            },
            "communication_usage_type": {
            "properties": {
                "is_main_communication_usage_type": {
                "type": "boolean",
                "description": "Main communication usage type, is not allowed with \"communication_type\" = other",
                "example": true
                },
                "is_main_management_phone": {
                "type": "boolean",
                "maxLength": 60,
                "description": "Management phone indicator",
                "example": true
                }
            },
            "type": "object",
            "description": "#/definitions/datev.communication-usage-type"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.communication"
        },
        "type": "array",
        "description": "Communications"
    },
    "banks": {
        "type": "array",
        "items": {
        "properties": {
            "id": {
            "type": "string",
            "description": "ID of the subobject bank",
            "example": "cdb9e6a9-16b9-4c2f-9705-83a0fc7c9908"
            },
            "bank_account_number": {
            "type": "string",
            "maxLength": 10,
            "description": "Bank account number",
            "example": "121540061"
            },
            "bank_code": {
            "type": "string",
            "maxLength": 8,
            "description": "Bank code",
            "example": "76050000"
            },
            "bank_name": {
            "type": "string",
            "maxLength": 30,
            "description": "Bank name",
            "example": "BayernLB Nürnberg"
            },
            "bic": {
            "type": "string",
            "maxLength": 11,
            "description": "BIC",
            "example": "BYLADEMMXXX"
            },
            "business_partner_bank_position": {
            "type": "integer",
            "minimum": 1,
            "maximum": 999,
            "maxLength": 3,
            "format": "int32",
            "description": "Business partner bank (numbering), required when a bank is transferred",
            "example": 1
            },
            "country_code": {
            "type": "string",
            "maxLength": 2,
            "description": "Country, see Info Database, document [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
            "example": "EUR"
            },
            "differing_account_holder": {
            "type": "string",
            "maxLength": 70,
            "description": "Differing account holder",
            "example": "Max Mustermann"
            },
            "iban": {
            "type": "string",
            "maxLength": 34,
            "description": "IBAN",
            "example": "DE38760500000121540061"
            },
            "is_business_partner_bank": {
            "type": "boolean",
            "description": "Business partner bank, usage identifier, only a bank account belonging to a debitor/creditor can be labeled as a business partner bank account.<br>If exactly **one** bank account is specified, the usage identifier is always set to \"true\".",
            "example": true
            },
            "sepa_mandate_reference": {
            "type": "string",
            "maxLength": 35,
            "description": "SEPA mandate reference, in the \"sepa_mandate_reference\" field; one mandate reference per bank can be entered for the business partner; in order to be used correctly, SEPA mandate management must include the mandate reference applicable to the authorizing customer",
            "example": "503000000001"
            },
            "note": {
            "type": "string",
            "description": "Note",
            "example": "Sample text"
            },
            "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Valid from",
            "example": "2015-12-31T23:00:00.000Z"
            },
            "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Valid to",
            "example": "9999-12-30T23:00:00.000Z"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.bank"
        },
        "description": "Banks, required field for a bank account are \"bank code/BIC\" and \"bank account number/IBAN\""
    }
    },
    "description": "#/definitions/creditor"
}
}
Creditor / Lieferant 8.1
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
{
"type": "array",
"items": {
    "type": "object",
    "properties": {
    "id": {
        "type": "string",
        "description": "ID des Geschäftspartners, entspricht der Kontonummer des Geschäftspartners in Maximallänge, 9-stellig (technische Länge), beim POST darf die ID nicht angegeben werden, beim PUT ist die ID ein Pflichtfeld und muss mit der Kontonummer des Geschäftspartners befüllt werden",
        "example": "700990000"
    },
    "account_number": {
        "type": "integer",
        "maxLength": 9,
        "example": "700990000",
        "description": "Kontonummer des Geschäftspartners in Maximallänge, 9-stellig (technische Länge), beim POST und beim PUT darf die account_number nicht angegeben werden"
    },
    "accounting_information": {
        "type": "object",
        "properties": {
        "alternative_contact_person": {
            "type": "string",
            "maxLength": 40,
            "description": "Alternative Kontaktperson",
            "example": "Maxima Mustermann"
        },
        "clerk": {
            "type": "string",
            "maxLength": 40,
            "description": "Sachbearbeiter",
            "example": "Torben Mustermann"
        },
        "client_bank_position": {
            "type": "integer",
            "format": "int32",
            "maxLength": 3,
            "maximum": 999,
            "description": "Mandantenbank (Nummerierung), Zuordnung der gespeicherten Mandantenbanken, die für das Lastschriftverfahren bei Debitoren und Zahlungen an Kreditoren verwendet werden soll",
            "example": 2
        },
        "contact_person": {
            "type": "string",
            "maxLength": 40,
            "description": "Ansprechpartner",
            "example": "Rainer Mustermann"
        },
        "currency_management": {
            "enum": [
            "payments_in_input_currency",
            "payments_in_euro"
            ],
            "type": "string",
            "description": "Währungssteuerung (Eingabewährung, EUR)",
            "example": "payments_in_euro"
        },
        "is_insolvent": {
            "type": "boolean",
            "maxLength": 1,
            "description": "Insolvenz-Kennzeichen",
            "example": false
        },
        "is_various_account": {
            "type": "boolean",
            "description": "Diverse Konto",
            "example": true
        },
        "language": {
            "enum": [
            "not_specified",
            "german",
            "french",
            "english",
            "spanish",
            "italian"
            ],
            "type": "string",
            "description": "Sprache (keine Angabe, Deutsch, Französisch, Englisch, Spanisch, Italienisch)",
            "example": "german"
        },
        "output_destination": {
            "enum": [
            "not_specified",
            "print",
            "fax",
            "email"
            ],
            "type": "string",
            "description": "Ausgabeziel (keine Angabe, Druck, Fax, E-Mail)",
            "example": "not_specified"
        },
        "payment_medium": {
            "enum": [
            "not_specified",
            "individual_check",
            "collective_check",
            "sepa_bank_transfer_with_one_invoice",
            "sepa_bank_transfer_with_multiple_invoices",
            "no_bank_transfer"
            ],
            "type": "string",
            "description": "Zahlungsträger (keine Angabe, Einzelscheck, Sammelscheck, SEPA-Auslands-Überweisung mit einer Rechnung, SEPA-Auslands-Überweisung mit mehreren Rechnungen, keine Überweisungen)",
            "example": "sepa_bank_transfer_with_one_invoice"
        },
        "tax_number": {
            "type": "string",
            "maxLength": 20,
            "description": "Steuernummer"
        },
        "temp_payment_block": {
            "type": "string",
            "format": "date-time",
            "description": "Temporäre Zahlungssperre",
            "example": "2016-01-01T00:00:00.000+01:00"
        },
        "term_of_payment_id": {
            "type": "integer",
            "format": "int32",
            "maxLength": 3,
            "description": "Zahlungsbedingung, eine gespeicherte Zahlungsbedingung kann hier einem Geschäftspartner zugeordnet werden"
        },
        "individual_fields": {
            "items": {
            "properties": {
                "content": {
                "type": "string",
                "maxLength": 40,
                "description": "Inhalt des individuellen Feldes"
                },
                "position": {
                "type": "integer",
                "maxLength": 2,
                "format": "int32",
                "description": "Nummer des individuellen Feldes (Nullbasierte Nummerierung)"
                }
            },
            "description": "#/definitions/datev.individual-field"
            },
            "type": "array",
            "minItems": 0,
            "maxItems": 10
        }
        },
        "description": "#/definitions/datev.creditor-accounting-information"
    },
    "addressee_id": {
        "type": "string",
        "description": "Schlüssel/ID des Adressaten, beim PUT ist dies ein Pflichtfeld",
        "example": "342842bf-3af2-4e0d-adda-a2d1dff2a6a5"
    },
    "alternative_search_name": {
        "type": "string",
        "maxLength": 50,
        "description": "Alternativer Suchname",
        "example": "Gewerbe"
    },
    "business_partner_number": {
        "type": "string",
        "maxLength": 15,
        "description": "Kunden- bzw. Lieferantennummer, kann nicht geändert werden, wenn zentralisierte Geschäftspartner (siehe Property business_partner_relation_id) verwendet werden",
        "example": "2250829"
    },
    "business_partner_relation_id": {
        "type": "string",
        "maxLength": 210,
        "description": "Schlüssel/ID des Geschäftspartners (Kundenbeziehungs-ID), beim POST kann die business_partner_relation_id vergeben werden, beim PUT muss die business_partner_relation_id verwendet werden, die bereits für den zu aktualisierenden Geschäftspartner verwendet wurde. Wenn business_partner_relation_id eine leere GUID beinhaltet (00000000-0000-0000-0000-000000000000), handelt es sich um einen nicht zentralisierten Geschäftspartner.",
        "example": "d7e3c10f-8b5a-42d4-b790-e84c1762b8b9"
    },
    "caption": {
        "readOnly": true,
        "type": "string",
        "description": "Kontobeschriftung",
        "example": "Mustermann"
    },
    "complimentary_close": {
        "type": "string",
        "maxLength": 50,
        "description": "Brief Grußformel",
        "example": "Mit freundlichem Gruß"
    },
    "correspondence_title": {
        "type": "string",
        "maxLength": 30,
        "description": "Anrede",
        "example": "Geschäftspartner"
    },
    "date_last_modification": {
        "format": "date-time",
        "type": "string",
        "readOnly": true,
        "description": "Datum der letzten Änderung",
        "example": "2016-05-24T00:00:00.000+02:00"
    },
    "eu_vat_id_country_code": {
        "type": "string",
        "maxLength": 2,
        "description": "EU-Mitgliedstaat, ist ein Bestandteil der USt-IdNr., siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
        "example": "FR"
    },
    "eu_vat_id_number": {
        "type": "string",
        "maxLength": 13,
        "description": "EU-Umsatzsteuernummer, ist ein Bestandteil der USt-IdNr., siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
        "example": "12345678901"
    },
    "is_business_partner_active": {
        "type": "boolean",
        "description": "Geschäftspartner Aktiv-Kennzeichen",
        "example": true
    },
    "is_organization_business_partner": {
        "type": "boolean",
        "description": "Kennzeichen, ob es sich um einen Geschäftspartner einer Kanzlei handelt"
    },
    "legal_entity_type": {
        "type": "string",
        "enum": [
        "not_specified",
        "natural_person",
        "legal_person"
        ],
        "description": "Adressatentyp (keine Angabe, natürliche Person, Unternehmen/Vereinigung)",
        "example": "legal_person",
        "default": "legal_person"
    },
    "salutation": {
        "type": "string",
        "description": "Briefanrede",
        "maxLength": 100,
        "example": "Sehr geehrte Damen und Herren"
    },
    "short_name": {
        "type": "string",
        "description": "Kurzbezeichnung",
        "maxLength": 15,
        "example": "Mustermann"
    },
    "third_party_number": {
        "type": "string",
        "maxLength": 15,
        "description": "Nummer Fremdsystem",
        "example": "abcdeft123"
    },
    "natural_person": {
        "properties": {
        "date_of_birth": {
            "type": "string",
            "format": "date-time",
            "description": "Geburtsdatum",
            "example": "1980-01-01T00:00:00.000+01:00"
        },
        "degree": {
            "type": "string",
            "maxLength": 25,
            "description": "Titel/Akademischer Grad",
            "example": "Sir"
        },
        "firstname": {
            "type": "string",
            "maxLength": 30,
            "description": "Vorname",
            "example": "Max"
        },
        "name_prefix": {
            "type": "string",
            "maxLength": 14,
            "description": "Namensvorsatz",
            "example": "de la"
        },
        "surname": {
            "type": "string",
            "maxLength": 30,
            "description": "Nachname",
            "example": "Mustermann"
        },
        "title_of_nobility": {
            "type": "string",
            "maxLength": 15,
            "description": "Adelstitel"
        }
        },
        "type": "object",
        "description": "#/definitions/datev.natural-person"
    },
    "legal_person": {
        "properties": {
        "enterprise_purpose": {
            "type": "string",
            "maxLength": 50,
            "description": "Unternehmensgegenstand",
            "example": "Mustergewerbe"
        },
        "legal_form": {
            "type": "string",
            "maxLength": 6,
            "description": "Unternehmensform",
            "example": "S00010"
        },
        "legal_name": {
            "type": "string",
            "maxLength": 50,
            "description": "Unternehmensname",
            "example": "Mustergewerbe"
        }
        },
        "type": "object",
        "description": "#/definitions/datev.legal-person"
    },
    "not_specified_person": {
        "properties": {
        "name": {
            "type": "string",
            "description": "Name",
            "maxLength": 50
        }
        },
        "type": "object",
        "description": "#/definitions/datev.not-specified-person"
    },
    "addresses": {
        "items": {
        "required": [
            "address_usage_type"
        ],
        "properties": {
            "id": {
            "type": "string",
            "description": "Schlüssel/ID des Unterobjekts Adresse",
            "example": "1b9c4079-2432-47b8-84c2-eebaa97e7376"
            },
            "additional_correspondence_title": {
            "type": "string",
            "maxLength": 30,
            "description": "Abweichende Anrede",
            "example": "Kanzlei"
            },
            "additional_delivery_text1": {
            "type": "string",
            "maxLength": 50,
            "description": "Abweichende Zustellbezeichnung 1",
            "example": "zus. Zustellungstext 1"
            },
            "additional_delivery_text2": {
            "type": "string",
            "maxLength": 36,
            "description": "Abweichende Zustellbezeichnung 2",
            "example": "zus. Zustellungstext 2"
            },
            "address_appendix": {
            "type": "string",
            "maxLength": 36,
            "description": "Adresszusatz",
            "example": "z. Hd. Herrn Mustermann"
            },
            "address_manually_edited": {
            "readOnly": true,
            "type": "string",
            "maxLength": 210,
            "description": "Aufbereitete Anschrift"
            },
            "address_type": {
            "enum": [
                "not_specified",
                "street_address",
                "post_office_box_address",
                "corporate_client_address"
            ],
            "type": "string",
            "description": "Adressart, wird die Adressart nicht übergeben, wird sie automatisch in Abhängigkeit zu den übergebenen Feldern (Straße, Postfach oder PLZ ) gesetzt (keine Angabe, Straßen-Adresse, Postfach, Großkundenadresse)",
            "example": "street_address"
            },
            "address_usage_type": {
            "properties": {
                "is_correspondence_address": {
                "type": "boolean",
                "description": "Korrespondenzadresse",
                "example": true
                },
                "is_default_delivery_address": {
                "type": "boolean",
                "description": "Standard-Lieferadresse",
                "example": false
                },
                "is_default_payment_address": {
                "type": "boolean",
                "description": "Standard-Rechnungsadresse",
                "example": false
                },
                "is_delivery_address": {
                "type": "boolean",
                "description": "Lieferadresse",
                "example": false
                },
                "is_main_post_office_box_address": {
                "type": "boolean",
                "description": "Hauptpostfachadresse (wird automatisch gesetzt, wenn Adressart ein Postfach ist)",
                "example": false
                },
                "is_main_street_address": {
                "type": "boolean",
                "description": "Hauptstraßenadresse (wird automatisch gesetzt, wenn Adressart eine Straßen-Adresse ist)",
                "example": false
                },
                "is_management_address": {
                "type": "boolean",
                "description": "Geschäftsleitungsadresse",
                "example": false
                }
            },
            "type": "object",
            "description": "#/definitions/datev.address-usage-type"
            },
            "city": {
            "type": "string",
            "maxLength": 30,
            "description": "Ort",
            "example": "Nürnberg"
            },
            "country_code": {
            "type": "string",
            "maxLength": 2,
            "description": "Land, siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
            "example": "DE"
            },
            "district": {
            "type": "string",
            "description": "Ortsteil (für kommunale Anwendungen)"
            },
            "individual_shipping_information": {
            "type": "string",
            "maxLength": 50,
            "description": "Versandzusatz"
            },
            "is_address_manually_edited": {
            "readOnly": true,
            "type": "boolean",
            "description": "Verwendungskennzeichen für aufbereitete Anschrift",
            "example": false
            },
            "note": {
            "type": "string",
            "description": "Notiz",
            "example": "Notizen Beispieltext"
            },
            "post_office_box": {
            "type": "string",
            "maxLength": 10,
            "description": "Postfach, wird sowohl eine Straße als auch ein Postfach übergeben, werden beide Werte in den Datenbestand übernommen, auf der Visitenkarte in den Debitoren-/Kreditoren-/Stammdaten wird die Postfachadresse angezeigt",
            "example": "101010"
            },
            "postal_code": {
            "type": "string",
            "description": "Postleitzahl, steht in Abhängigkeit zu der Länderkennung.<br>Sollte das Property \"county_code\" gefüllt sein, dann wird die Postleitzahlen-Länge des übergebenen Landes berücksichtigt.<br>Ist das Property \"country_code\" nicht gesetzt, dann zählt das eingestellte nationale Recht aus den Mandantenstammdaten.",
            "example": "90491"
            },
            "street": {
            "type": "string",
            "maxLength": 36,
            "description": "Straße, wird sowohl eine Straße als auch ein Postfach übergeben, werden beide Werte in den Datenbestand übernommen, auf der Visitenkarte in den Debitoren-/Kreditoren-/Stammdaten wird die Postfachadresse angezeigt",
            "example": "Musterstraße 1"
            },
            "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig von",
            "example": "2016-01-01T00:00:00.000+01:00"
            },
            "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig bis",
            "example": "9999-12-31T00:00:00.000+01:00"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.address"
        },
        "type": "array",
        "description": "Adressen"
    },
    "communications": {
        "items": {
        "properties": {
            "id": {
            "type": "string",
            "description": "Schlüssel/ID des Unterobjekts Kommunikation",
            "example": "1b9c4079-2432-47b8-84c2-eebaa97e7376"
            },
            "communication_data_content": {
            "type": "string",
            "maxLength": 60,
            "description": "Inhalt der Kommunikationsart",
            "example": "+49 911 999882"
            },
            "communication_number_standardized": {
            "type": "string",
            "maxLength": 60,
            "description": "Nummer normiert, obsolet",
            "example": "0049911999882"
            },
            "communication_type": {
            "enum": [
                "not_specified",
                "phone",
                "email",
                "url",
                "fax",
                "other"
            ],
            "type": "string",
            "description": "Kommunikationstyp (keine Angabe, Telefon, E-Mail, Internet, URL, Fax, Sonstige)",
            "example": "phone"
            },
            "note": {
            "type": "string",
            "maxLength": 40,
            "description": "Notiz",
            "example": "Notizen Beispieltext"
            },
            "communication_usage_type": {
            "properties": {
                "is_main_communication_usage_type": {
                "type": "boolean",
                "description": "Hauptkommunikationsmittel, darf bei Kommunikationstyp \"Sonstige\" nicht gesetzt werden",
                "example": true
                },
                "is_main_management_phone": {
                "type": "boolean",
                "maxLength": 60,
                "description": "Kennzeichen Geschäftsleitungs-Telefon",
                "example": true
                }
            },
            "type": "object",
            "description": "#/definitions/datev.communication-usage-type"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.communication"
        },
        "type": "array",
        "description": "Kommunikationen"
    },
    "banks": {
        "type": "array",
        "items": {
        "properties": {
            "id": {
            "type": "string",
            "description": "Schlüssel/ID des Unterojekts Bank",
            "example": "cdb9e6a9-16b9-4c2f-9705-83a0fc7c9908"
            },
            "bank_account_number": {
            "type": "string",
            "maxLength": 10,
            "description": "Bankkontonummer",
            "example": "121540061"
            },
            "bank_code": {
            "type": "string",
            "maxLength": 8,
            "description": "Bankleitzahl",
            "example": "76050000"
            },
            "bank_customer_number": {
            "type": "string",
            "maxLength": 35,
            "description": "Bank Kundennummer, obsolet",
            "example": "12345"
            },
            "bank_name": {
            "type": "string",
            "maxLength": 30,
            "description": "Bankname",
            "example": "BayernLB Nürnberg"
            },
            "bic": {
            "type": "string",
            "maxLength": 11,
            "description": "BIC",
            "example": "BYLADEMMXXX"
            },
            "business_partner_bank_position": {
            "type": "integer",
            "maxLength": 3,
            "minimum": 1,
            "maximum": 999,
            "format": "int32",
            "description": "Geschäftspartnerbank (Nummerierung), Pflichtfeld, wenn die Bank mitgegeben wird",
            "example": 1
            },
            "country_code": {
            "type": "string",
            "maxLength": 2,
            "description": "Land, siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
            "example": "DE"
            },
            "currency_code": {
            "type": "string",
            "maxLength": 3,
            "description": "Kontowährung, obsolet",
            "example": "EUR"
            },
            "differing_account_holder": {
            "type": "string",
            "maxLength": 70,
            "description": "Abweichender Kontoinhaber",
            "example": "Max Mustermann"
            },
            "iban": {
            "type": "string",
            "maxLength": 34,
            "description": "IBAN",
            "example": "DE38760500000121540061"
            },
            "is_business_partner_bank": {
            "type": "boolean",
            "description": "Geschäftspartnerbank, Verwendungskennzeichen, nur eine Bankverbindung eines Debitoren/Kreditoren kann als Geschäftspartner-Bankverbindung gekennzeichnet werden.<br>Wenn genau <b>eine</b> Bankverbindung übergeben wird, dann wird dieses Verwendungskennzeichen immer auf \"true\" gesetzt.",
            "example": true
            },
            "sepa_mandate_reference": {
            "type": "string",
            "maxLength": 35,
            "description": "SEPA Mandatsreferenz, im Feld \"sepa_mandate_reference\" kann dem Geschäftspartner je Bank eine Mandatsreferenz eintragen werden, für eine korrekte Verwendung muss in der SEPA-Mandatsverwaltung die Mandatsreferenz für den Lastschriftteilnehmer vorhanden sein",
            "example": "503000000001"
            },
            "note": {
            "type": "string",
            "description": "Bemerkung zur Bankverbindung",
            "example": "Hinweis"
            },
            "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig von",
            "example": "2016-01-01T00:00:00.000+01:00"
            },
            "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig bis",
            "example": "9999-12-31T00:00:00.000+01:00"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.bank"
        },
        "description": "Banken, Eine Bankverbindung muss mindestens die Felder \"BLZ/BIC\" und \"Kontonummer/IBAN\" enthalten"
    }
    },
    "description": "#/definitions/creditor"
}
}
Creditor / Lieferant 7.2
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
{
"type": "array",
"items": {
    "type": "object",
    "properties": {
    "id": {
        "type": "string",
        "description": "ID des Geschäftspartners, entspricht der Kontonummer des Geschäftspartners in Maximallänge, 9-stellig (technische Länge), beim POST darf die ID nicht angegeben werden, beim PUT ist die ID ein Pflichtfeld und muss mit der Kontonummer des Geschäftspartners befüllt werden",
        "example": "700990000"
    },
    "account_number": {
        "type": "integer",
        "maxLength": 9,
        "example": "700990000",
        "readOnly": true,
        "description": "Kontonummer des Geschäftspartners in Maximallänge, 9-stellig (technische Länge), beim POST und beim PUT darf die account_number nicht angegeben werden"
    },
    "accounting_information": {
        "type": "object",
        "properties": {
        "alternative_contact_person": {
            "type": "string",
            "maxLength": 40,
            "description": "Alternative Kontaktperson",
            "example": "Maxima Mustermann"
        },
        "clerk": {
            "type": "string",
            "maxLength": 40,
            "description": "Sachbearbeiter",
            "example": "Torben Mustermann"
        },
        "client_bank_position": {
            "type": "integer",
            "format": "int32",
            "maxLength": 3,
            "maximum": 999,
            "description": "Mandantenbank (Nummerierung), Zuordnung der gespeicherten Mandantenbanken, die für das Lastschriftverfahren bei Debitoren und Zahlungen an Kreditoren verwendet werden soll",
            "example": 2
        },
        "contact_person": {
            "type": "string",
            "maxLength": 40,
            "description": "Ansprechpartner",
            "example": "Rainer Mustermann"
        },
        "currency_management": {
            "enum": [
            "payments_in_input_currency",
            "payments_in_euro"
            ],
            "type": "string",
            "description": "Währungssteuerung (Eingabewährung, EUR)",
            "example": "payments_in_euro"
        },
        "is_insolvent": {
            "type": "boolean",
            "maxLength": 1,
            "description": "Insolvenz-Kennzeichen",
            "example": false
        },
        "is_various_account": {
            "type": "boolean",
            "description": "Diverse Konto",
            "example": true
        },
        "language": {
            "enum": [
            "not_specified",
            "german",
            "french",
            "english",
            "spanish",
            "italian"
            ],
            "type": "string",
            "description": "Sprache (keine Angabe, Deutsch, Französisch, Englisch, Spanisch, Italienisch)",
            "example": "german"
        },
        "output_destination": {
            "enum": [
            "not_specified",
            "print",
            "fax",
            "email"
            ],
            "type": "string",
            "description": "Ausgabeziel (keine Angabe, Druck, Fax, E-Mail)",
            "example": "not_specified"
        },
        "payment_medium": {
            "enum": [
            "not_specified",
            "individual_bank_transfer_with_one_invoice",
            "individual_bank_transfer_with_multiple_invoices",
            "collective_bank_transfer_with_one_invoice",
            "collective_bank_transfer_with_multiple_invoices",
            "individual_check",
            "collective_check",
            "sepa_bank_transfer_with_one_invoice",
            "sepa_bank_transfer_with_multiple_invoices",
            "no_bank_transfer"
            ],
            "type": "string",
            "description": "Zahlungsträger (keine Angabe, Einzelüberweisung mit einer Rechnung, Einzelüberweisung mit mehreren Rechnungen, Sammelüberweisung mit einer Rechnung, Sammelüberweisung mit mehreren Rechnungen, Einzelscheck, Sammelscheck, SEPA-Auslands-Überweisung mit einer Rechnung, SEPA-Auslands-Überweisung mit mehreren Rechnungen, keine Überweisungen)",
            "example": "sepa_bank_transfer_with_one_invoice"
        },
        "tax_number": {
            "type": "string",
            "maxLength": 20,
            "description": "Steuernummer"
        },
        "temp_payment_block": {
            "type": "string",
            "format": "date-time",
            "description": "Temporäre Zahlungssperre",
            "example": "2015-12-31T23:00:00.000Z"
        },
        "term_of_payment_id": {
            "type": "integer",
            "format": "int32",
            "maxLength": 3,
            "description": "Zahlungsbedingung, eine gespeicherte Zahlungsbedingung kann hier einem Geschäftspartner zugeordnet werden"
        },
        "individual_fields": {
            "items": {
            "properties": {
                "content": {
                "type": "string",
                "maxLength": 40,
                "description": "Beschriftung des individuellen Feldes"
                },
                "position": {
                "type": "integer",
                "maxLength": 2,
                "format": "int32",
                "description": "Nummer des individuellen Feldes"
                }
            },
            "description": "#/definitions/datev.individual-field"
            },
            "type": "array",
            "minItems": 0,
            "maxItems": 10
        }
        },
        "description": "#/definitions/datev.creditor-accounting-information"
    },
    "addressee_id": {
        "type": "string",
        "description": "Schlüssel/ID des Adressaten",
        "example": "342842bf-3af2-4e0d-adda-a2d1dff2a6a5"
    },
    "alternative_search_name": {
        "type": "string",
        "maxLength": 50,
        "description": "Alternativer Suchname",
        "example": "Gewerbe"
    },
    "business_partner_number": {
        "type": "string",
        "maxLength": 15,
        "description": "Kunden- bzw. Lieferantennummer, kann nicht geändert werden, wenn zentralisierte Geschäftspartner (siehe Property business_partner_relation_id) verwendet werden",
        "example": "2250829"
    },
    "business_partner_relation_id": {
        "type": "string",
        "maxLength": 210,
        "description": "Schlüssel/ID des Geschäftspartners (Kundenbeziehungs-ID), beim POST kann die business_partner_relation_id vergeben werden, beim PUT muss die business_partner_relation_id verwendet werden, die bereits für den zu aktualisierenden Geschäftspartner verwendet wurde. Wenn business_partner_relation_id eine leere GUID beinhaltet (00000000-0000-0000-0000-000000000000), handelt es sich um einen nicht zentralisierten Geschäftspartner.",
        "example": "d7e3c10f-8b5a-42d4-b790-e84c1762b8b9"
    },
    "caption": {
        "readOnly": true,
        "type": "string",
        "description": "Kontobeschriftung",
        "example": "Mustermann"
    },
    "complimentary_close": {
        "type": "string",
        "maxLength": 50,
        "description": "Brief Grußformel",
        "example": "Mit freundlichem Gruß"
    },
    "correspondence_title": {
        "type": "string",
        "description": "Anrede",
        "example": "Geschäftspartner"
    },
    "date_last_modification": {
        "format": "date-time",
        "type": "string",
        "readOnly": true,
        "description": "Datum der letzten Änderung",
        "example": "2016-05-23T22:00:00.000Z"
    },
    "eu_vat_id_country_code": {
        "type": "string",
        "maxLength": 2,
        "description": "EU-Mitgliedstaat, ist ein Bestandteil der USt-IdNr., siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
        "example": "FR"
    },
    "eu_vat_id_number": {
        "type": "string",
        "maxLength": 13,
        "description": "EU-Umsatzsteuernummer, ist ein Bestandteil der USt-IdNr., siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
        "example": "12345678901"
    },
    "is_business_partner_active": {
        "type": "boolean",
        "description": "Geschäftspartner Aktiv-Kennzeichen",
        "example": true
    },
    "legal_entity_type": {
        "type": "string",
        "enum": [
        "not_specified",
        "natural_person",
        "legal_person"
        ],
        "description": "Adressatentyp (keine Angabe, Natürliche Person, Unternehmen/Vereinigung)",
        "example": "legal_person",
        "default": "legal_person"
    },
    "salutation": {
        "type": "string",
        "description": "Briefanrede",
        "maxLength": 100,
        "example": "Sehr geehrte Damen und Herren"
    },
    "short_name": {
        "type": "string",
        "description": "Kurzbezeichnung",
        "maxLength": 15,
        "example": "Mustermann"
    },
    "third_party_number": {
        "type": "string",
        "maxLength": 15,
        "description": "Nummer Fremdsystem",
        "example": "abcdeft123"
    },
    "natural_person": {
        "properties": {
        "date_of_birth": {
            "type": "string",
            "format": "date-time",
            "description": "Geburtsdatum",
            "example": "1979-12-31T23:00:00.000Z"
        },
        "degree": {
            "type": "string",
            "maxLength": 25,
            "description": "Titel/Akademischer Grad"
        },
        "firstname": {
            "type": "string",
            "maxLength": 30,
            "description": "Vorname"
        },
        "name_prefix": {
            "type": "string",
            "maxLength": 14,
            "description": "Namensvorsatz"
        },
        "surname": {
            "type": "string",
            "maxLength": 30,
            "description": "Nachname"
        },
        "title_of_nobility": {
            "type": "string",
            "maxLength": 15,
            "description": "Adelstitel"
        }
        },
        "type": "object",
        "description": "#/definitions/datev.natural-person"
    },
    "legal_person": {
        "properties": {
        "enterprise_purpose": {
            "type": "string",
            "maxLength": 50,
            "description": "Unternehmensgegenstand",
            "example": "Mustergewerbe"
        },
        "legal_form": {
            "type": "string",
            "maxLength": 6,
            "description": "Unternehmensform"
        },
        "legal_name": {
            "type": "string",
            "maxLength": 50,
            "description": "Unternehmensname",
            "example": "Mustergewerbe"
        }
        },
        "type": "object",
        "description": "#/definitions/datev.legal-person"
    },
    "not_specified_person": {
        "properties": {
        "name": {
            "type": "string",
            "description": "Name",
            "maxLength": 50
        }
        },
        "type": "object",
        "description": "#/definitions/datev.not-specified-person"
    },
    "addresses": {
        "items": {
        "required": [
            "address_usage_type"
        ],
        "properties": {
            "id": {
            "type": "string",
            "description": "Schlüssel/ID des Unterobjekts Adresse",
            "example": "1b9c4079-2432-47b8-84c2-eebaa97e7376"
            },
            "additional_correspondence_title": {
            "type": "string",
            "maxLength": 30,
            "description": "Abweichende Anrede",
            "example": "Kanzlei"
            },
            "additional_delivery_text1": {
            "type": "string",
            "maxLength": 50,
            "description": "Abweichende Zustellbezeichnung 1",
            "example": "zus. Zustellungstext 1"
            },
            "additional_delivery_text2": {
            "type": "string",
            "maxLength": 36,
            "description": "Abweichende Zustellbezeichnung 2",
            "example": "zus. Zustellungstext 2"
            },
            "address_appendix": {
            "type": "string",
            "maxLength": 36,
            "description": "Adresszusatz",
            "example": "z. Hd. Herrn Mustermann"
            },
            "address_manually_edited": {
            "readOnly": true,
            "type": "string",
            "maxLength": 210,
            "description": "Aufbereitete Anschrift"
            },
            "address_type": {
            "enum": [
                "not_specified",
                "street_address",
                "post_office_box_address",
                "corporate_client_address"
            ],
            "type": "string",
            "description": "Adressart, wird die Adressart nicht übergeben, wird sie automatisch in Abhängigkeit zu den übergebenen Feldern (Straße, Postfach oder PLZ ) gesetzt (keine Angabe, Straßen-Adresse, Postfach, Großkundenadresse)",
            "example": "street_address"
            },
            "address_usage_type": {
            "properties": {
                "is_correspondence_address": {
                "type": "boolean",
                "description": "Korrespondenzadresse",
                "example": true
                },
                "is_default_delivery_address": {
                "type": "boolean",
                "description": "Standard-Lieferadresse",
                "example": false
                },
                "is_default_payment_address": {
                "type": "boolean",
                "description": "Standard-Rechnungsadresse",
                "example": false
                },
                "is_delivery_address": {
                "type": "boolean",
                "description": "Lieferadresse",
                "example": false
                },
                "is_main_post_office_box_address": {
                "type": "boolean",
                "description": "Hauptpostfachadresse (wird automatisch gesetzt, wenn Adressart ein Postfach ist)",
                "example": false
                },
                "is_main_street_address": {
                "type": "boolean",
                "description": "Hauptstraßenadresse (wird automatisch gesetzt, wenn Adressart eine Straßen-Adresse ist)",
                "example": false
                },
                "is_management_address": {
                "type": "boolean",
                "description": "Geschäftsleitungsadresse",
                "example": false
                }
            },
            "type": "object",
            "description": "#/definitions/datev.address-usage-type"
            },
            "city": {
            "type": "string",
            "maxLength": 30,
            "description": "Ort",
            "example": "Nürnberg"
            },
            "country_code": {
            "type": "string",
            "maxLength": 2,
            "description": "Land, siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
            "example": "DE"
            },
            "district": {
            "type": "string",
            "description": "Ortsteil"
            },
            "individual_shipping_information": {
            "type": "string",
            "maxLength": 50,
            "description": "Versandzusatz"
            },
            "is_address_manually_edited": {
            "readOnly": true,
            "type": "boolean",
            "description": "Verwendungskennzeichen für aufbereitete Anschrift",
            "example": false
            },
            "note": {
            "type": "string",
            "description": "Notiz",
            "example": "Notizen Beispieltext"
            },
            "post_office_box": {
            "type": "string",
            "maxLength": 10,
            "description": "Postfach, wird sowohl eine Straße als auch ein Postfach übergeben, werden beide Werte in den Datenbestand übernommen, auf der Visitenkarte in den Debitoren-/Kreditoren-/Stammdaten wird die Postfachadresse angezeigt",
            "example": "101010"
            },
            "postal_code": {
            "type": "string",
            "description": "Postleitzahl, steht in Abhängigkeit zu der Länderkennung.<br>Sollte das Property \"county_code\" gefüllt sein, dann wird die Postleitzahlen-Länge des übergebenen Landes berücksichtigt.<br>Ist das Property \"country_code\" nicht gesetzt, dann zählt das eingestellte nationale Recht aus den Mandantenstammdaten.",
            "example": "90491"
            },
            "street": {
            "type": "string",
            "maxLength": 36,
            "description": "Straße, wird sowohl eine Straße als auch ein Postfach übergeben, werden beide Werte in den Datenbestand übernommen, auf der Visitenkarte in den Debitoren-/Kreditoren-/Stammdaten wird die Postfachadresse angezeigt",
            "example": "Musterstraße 1"
            },
            "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig von",
            "example": "2015-12-31T23:00:00.000Z"
            },
            "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig bis",
            "example": "9999-12-30T23:00:00.000Z"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.address"
        },
        "type": "array"
    },
    "communications": {
        "items": {
        "properties": {
            "id": {
            "type": "string",
            "description": "Schlüssel/ID des Unterobjekts Kommunikation",
            "example": "1b9c4079-2432-47b8-84c2-eebaa97e7376"
            },
            "communication_data_content": {
            "type": "string",
            "maxLength": 60,
            "description": "Inhalt der Kommunikationsart",
            "example": "+49 911 999882"
            },
            "communication_number_standardized": {
            "type": "string",
            "maxLength": 60,
            "description": "Nummer normiert, obsolet",
            "example": 49912000000
            },
            "communication_type": {
            "enum": [
                "not_specified",
                "phone",
                "email",
                "url",
                "fax",
                "other"
            ],
            "type": "string",
            "description": "Kommunikationstyp (keine Angabe, Telefon, E-Mail, Internet, URL, Fax, Sonstige)",
            "example": "phone"
            },
            "note": {
            "type": "string",
            "maxLength": 40,
            "description": "Notiz",
            "example": "Notizen Beispieltext"
            },
            "communication_usage_type": {
            "properties": {
                "is_main_communication_usage_type": {
                "type": "boolean",
                "description": "Hauptkommunikationsmittel, darf bei Kommunikationstyp \"Sonstige\" nicht gesetzt werden",
                "example": true
                },
                "is_main_management_phone": {
                "type": "boolean",
                "maxLength": 60,
                "description": "Geschäftstelefon",
                "example": true
                }
            },
            "type": "object",
            "description": "#/definitions/datev.communication-usage-type"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.communication"
        },
        "type": "array"
    },
    "banks": {
        "type": "array",
        "items": {
        "properties": {
            "id": {
            "type": "string",
            "description": "Schlüssel/ID des Unterojekts Bank",
            "example": "cdb9e6a9-16b9-4c2f-9705-83a0fc7c9908"
            },
            "bank_account_number": {
            "type": "string",
            "maxLength": 10,
            "description": "Bankkontonummer",
            "example": "121540061"
            },
            "bank_code": {
            "type": "string",
            "maxLength": 8,
            "description": "Bankleitzahl",
            "example": "76050000"
            },
            "bank_customer_number": {
            "type": "string",
            "maxLength": 35,
            "description": "Kundennummer",
            "example": "12345"
            },
            "bank_name": {
            "type": "string",
            "maxLength": 30,
            "description": "Bankname",
            "example": "BayernLB Nürnberg"
            },
            "bic": {
            "type": "string",
            "maxLength": 11,
            "description": "BIC",
            "example": "BYLADEMMXXX"
            },
            "business_partner_bank_position": {
            "type": "integer",
            "maxLength": 3,
            "minimum": 1,
            "maximum": 999,
            "format": "int32",
            "description": "Geschäftspartnerbank (Nummerierung)",
            "example": 1
            },
            "country_code": {
            "type": "string",
            "maxLength": 2,
            "description": "Land, siehe Info-DB-Dokument [1080169](https://www.datev.de/dnlexom/client/app/index.html#/document/1080169)",
            "example": "DE"
            },
            "currency_code": {
            "type": "string",
            "maxLength": 3,
            "description": "Kontowährung",
            "example": "EUR"
            },
            "differing_account_holder": {
            "type": "string",
            "maxLength": 70,
            "description": "Abweichender Kontoinhaber",
            "example": "Max Mustermann"
            },
            "iban": {
            "type": "string",
            "maxLength": 34,
            "description": "IBAN",
            "example": "DE38760500000121540061"
            },
            "is_business_partner_bank": {
            "type": "boolean",
            "description": "Geschäftspartnerbank, Verwendungskennzeichen, nur eine Bankverbindung eines Debitoren bzw. Kreditoren kann als Geschäftspartner-Bankverbindung gekennzeichnet werden. Wenn genau eine Bankverbindung übergeben wird, dann wird dieses Verwendungskennzeichen immer auf \"true\" gesetzt.",
            "example": true
            },
            "sepa_mandate_reference": {
            "type": "string",
            "maxLength": 35,
            "description": "SEPA Mandatsreferenz, im Feld \"sepa_mandate_reference\" kann dem Geschäftspartner je Bank eine Mandatsreferenz eintragen werden, für eine korrekte Verwendung muss in der SEPA-Mandatsverwaltung die Mandatsreferenz für den Lastschriftteilnehmer vorhanden sein",
            "example": "503000000001"
            },
            "note": {
            "type": "string",
            "description": "Bemerkung zur Bankverbindung",
            "example": "Hinweis"
            },
            "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig von",
            "example": "2015-12-31T23:00:00.000Z"
            },
            "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig bis",
            "example": "9999-12-30T23:00:00.000Z"
            }
        },
        "type": "object",
        "description": "#/definitions/datev.bank"
        }
    }
    },
    "description": "#/definitions/creditor"
}
}

Sachkonten

General Ledger Account / Sachkonten 8.2
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
{
"type": "array",
"items": {
    "type": "object",
    "properties": {
    "id": {
        "type": "string",
        "description": "ID of the general ledger, account number of the general ledger account shown at maximum length, 8 digits (technical length)",
        "example": 10000000
    },
    "account_number": {
        "type": "integer",
        "format": "int32",
        "description": "Account number of the general ledger account shown at maximum length, 8 digits (technical length)",
        "example": 10000000,
        "minLength": 8,
        "maxLength": 8
    },
    "additional_function": {
        "type": "integer",
        "format": "int32",
        "description": "Tax calculation type/additional function, states which calculation is permissible in connection with the general ledger account (0 = sales tax permissible (field empty), 1 = no sales tax permissible, 3 = only input tax, 8 = only VAT permissible)",
        "example": 3,
        "maxLength": 1
    },
    "caption": {
        "type": "string",
        "description": "General ledger account caption",
        "example": "Umsatzsteuer",
        "maxLength": 40
    },
    "function_description": {
        "type": "string",
        "description": "Function description of the main function number",
        "example": "VAT EU acquisition\""
    },
    "function_extension": {
        "type": "integer",
        "format": "int32",
        "description": "Function extension; the meaning of the function extension is dependent on the main function number, e.g. main function number = 80 (sales tax), function extension 1 = normal rate, 2 = reduced rate, 70 = tax rate of 7.0 percent, 190 = tax rate of 19.0 percent.",
        "example": 80,
        "maxLength": 3
    },
    "main_function": {
        "type": "integer",
        "format": "int32",
        "description": "Main function type (1 = automatic input tax invoice, 2 = automatic VAT invoice, 3 = general function, 4 = collective function, 6 = collective function, automatic input tax, 7 = collective function, automatic VAT)",
        "example": 3,
        "maxLength": 1
    },
    "main_function_number": {
        "type": "integer",
        "format": "int32",
        "description": "Main function number (e.g. 10 = cash account, 11 general ledger account (debitor), 12 entry block, ... 20 = supplier account, 21 = customer account, ... 25 = supplier account (RHB), ... 90 = collective account (debitor), 91 = collective account (creditor), ... 98 = blocked)",
        "example": 11,
        "maxLength": 2
    },
    "tax_rates": {
        "type": "array",
        "items": {
        "properties": {
            "tax_rate": {
            "type": "number",
            "format": "decimal",
            "description": "Tax rate",
            "minimum": 0,
            "maximum": 99.99,
            "maxLength": 5,
            "example": 7
            },
            "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Valid from",
            "example": "2015-12-31T23:00:00.000Z"
            },
            "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Valid to",
            "example": "2015-12-31T23:00:00.000Z"
            }
        },
        "description": "#/definitions/datev.general-ledger-account-tax-rates"
        },
        "description": "Tax rates"
    }
    },
    "description": "#/definitions/general-ledger-account"
}
}
General Ledger Account / Sachkonten 8.1
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
{
"type": "array",
"items": {
    "type": "object",
    "properties": {
    "id": {
        "type": "string",
        "description": "ID des Sachkontos, Kontonummer des Sachkontos in Maximallänge, 8-stellig (technische Länge)"
    },
    "account_number": {
        "type": "integer",
        "format": "int32",
        "description": "Kontonummer des Sachkontos in Maximallänge, 8-stellig (technische Länge)"
    },
    "additional_function": {
        "type": "integer",
        "format": "int32",
        "description": "Steuerrechnungstyp/Zusatzfunktion, gibt an, welche Steuerrechnung in Verbindung mit dem Sachkonto zulässig ist (0 = Umsatzsteuer zulässig (keine Belegung), 1 = keine Umsatzsteuer zulässig, 3 = Nur Vorsteuer zulässig, 8 = Nur Mehrwertsteuer zulässig)"
    },
    "caption": {
        "type": "string",
        "description": "Kontobeschriftung des Sachkontos"
    },
    "function_description": {
        "type": "string",
        "description": "Funktionsbezeichnung der Hauptfunktionsnummer"
    },
    "function_extension": {
        "type": "integer",
        "format": "int32",
        "description": "Funktionsergänzung, die Bedeutung der Funktionsergänzung ergibt sich in Abhängigkeit von der Hauptfunktionsnummer, z.B. Hauptfunktionsnummer = 80 (Umsatzsteuer), Funktionsergänzung 1 = Normal-Satz, 2 = ermäßigter Satz, 70 = Steuersatz 7,0 Prozent, 190 = Steuersatz 19,0 Prozent)"
    },
    "main_function": {
        "type": "integer",
        "format": "int32",
        "description": "Hauptfunktionstyp (0 = keine Hauptfunktion, 1 = Automatische Vorsteuer-Rechnung, 2 = Automatische Mehrwertsteuer-Rechnung, 3 = Allgemeine Funktion, 4 = Sammelfunktion, 6 = Sammelfunktion automatische Vorsteuer, 7 = Sammelfunktion automatische Mehrwertsteuer)"
    },
    "main_function_number": {
        "type": "integer",
        "format": "int32",
        "description": "Hauptfunktionsnummer (z.B. 10 = Geldkonto, 11 = Sachkonto Debitor, 12 = Buchungssperre, ... 20 = Lieferantenskonto, 21 = Kundenskonto, ... 25 = Lieferantenskonto RHB, ... 90 = Sammelkonto Debitor, 91 = Sammelkonto Kreditor, ... 98 = Gesperrt)"
    },
    "tax_rates": {
        "type": "array",
        "items": {
        "properties": {
            "tax_rate": {
            "type": "number",
            "format": "decimal",
            "description": "Steuersatz",
            "minimum": 0,
            "maximum": 99.99,
            "maxLength": 5
            },
            "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig von"
            },
            "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig bis"
            }
        },
        "description": "#/definitions/datev.general-ledger-account-tax-rates"
        },
        "description": "Steuersätze"
    }
    },
    "description": "#/definitions/general-ledger-account"
}
}
General Ledger Account / Sachkonten 7.2
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
{
"type": "array",
"items": {
    "type": "object",
    "properties": {
    "id": {
        "type": "string",
        "description": "ID des Sachkontos, Kontonummer des Sachkontos in Maximallänge, 8-stellig (technische Länge)"
    },
    "account_number": {
        "type": "integer",
        "format": "int32",
        "description": "Kontonummer des Sachkontos in Maximallänge, 8-stellig (technische Länge)"
    },
    "additional_function": {
        "type": "integer",
        "format": "int32",
        "description": "Steuerrechnungstyp/Zusatzfunktion, gibt an, welche Steuerrechnung in Verbindung mit dem Sachkonto zulässig ist (0 = Umsatzsteuer zulässig (keine Belegung), 1 = keine Umsatzsteuer zulässig, 3 = Nur Vorsteuer zulässig, 8 = Nur Mehrwertsteuer zulässig)"
    },
    "caption": {
        "type": "string",
        "description": "Kontobeschriftung des Sachkontos"
    },
    "function_description": {
        "type": "string",
        "description": "Funktionsbezeichnung der Hauptfunktionsnummer"
    },
    "function_extension": {
        "type": "integer",
        "format": "int32",
        "description": "Funktionsergänzung, die Bedeutung der Funktionsergänzung ergibt sich in Abhängigkeit von der Hauptfunktionsnummer, z.B. Hauptfunktionsnummer = 80 (Umsatzsteuer), Funktionsergänzung 1 = Normal-Satz, 2 = ermäßigter Satz, 70 = Steuersatz 7,0 Prozent, 190 = Steuersatz 19,0 Prozent)"
    },
    "main_function": {
        "type": "integer",
        "format": "int32",
        "description": "Hauptfunktionstyp (0 = keine Hauptfunktion, 1 = Automatische Vorsteuer-Rechnung, 2 = Automatische Mehrwertsteuer-Rechnung, 3 = Allgemeine Funktion, 4 = Sammelfunktion, 6 = Sammelfunktion automatische Vorsteuer, 7 = Sammelfunktion automatische Mehrwertsteuer)"
    },
    "main_function_number": {
        "type": "integer",
        "format": "int32",
        "description": "Hauptfunktionsnummer (z.B. 10 = Geldkonto, 11 = Sachkonto Debitor, 12 = Buchungssperre, ... 20 = Lieferantenskonto, 21 = Kundenskonto, ... 25 = Lieferantenskonto RHB, ... 90 = Sammelkonto Debitor, 91 = Sammelkonto Kreditor, ... 98 = Gesperrt)"
    },
    "tax_rates": {
        "type": "array",
        "items": {
        "properties": {
            "tax_rate": {
            "type": "number",
            "format": "decimal",
            "description": "Steuersatz",
            "minimum": 0,
            "maximum": 99.99,
            "maxLength": 5
            },
            "valid_from": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig von"
            },
            "valid_to": {
            "type": "string",
            "format": "date-time",
            "description": "Gültig bis"
            }
        },
        "description": "#/definitions/datev.general-ledger-account-tax-rates"
        },
        "description": "Steuersätze"
    }
    },
    "description": "#/definitions/general-ledger-account"
}
}

Zahlungsbedinungen

Terms of Payment / Zahlungsbedinungen 8.2
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
{
"type": "array",
"items": {
    "required": [
    "caption"
    ],
    "type": "object",
    "properties": {
    "id": {
        "type": "string",
        "description": "ID, corresponds to the number of the term of payment, 3-character functional ID. The ID may not be entered with POST; for PUT, the ID is a mandatory field",
        "minimum": 10,
        "maximum": 999,
        "example": 123
    },
    "caption": {
        "type": "string",
        "maxLength": 40,
        "description": "Description of the term of payment, maximum of 40 characters",
        "example": "44 days net"
    },
    "due_type": {
        "type": "string",
        "enum": [
        "due_in_days",
        "due_as_period"
        ],
        "description": "Type of term of payment (due in days, due as period)",
        "example": "due_as_period"
    },
    "cash_discount1_percentage": {
        "type": "number",
        "format": "decimal",
        "description": "Percentage rate of cash discount 1 if a cash discount is applied",
        "minimum": 0,
        "maximum": 99.99,
        "example": 10
    },
    "cash_discount2_percentage": {
        "type": "number",
        "format": "decimal",
        "description": "Percentage rate of cash discount 2 if a cash discount is applied, have to be lower than \"cash_discount1_percentage\"",
        "minimum": 0,
        "maximum": 99.99,
        "example": 10
    },
    "due_in_days": {
        "properties": {
        "cash_discount1_days": {
            "type": "integer",
            "format": "int32",
            "description": "Due period in days for cash discount 1",
            "example": 10,
            "minimum": 0,
            "maximum": 999
        },
        "cash_discount2_days": {
            "type": "integer",
            "format": "int32",
            "description": "Due period in days for cash discount 2, have to be greater than \"cash_discount1_days\" (if cash discount percentage is specified when cash discount 2 is used)",
            "example": 11,
            "minimum": 0,
            "maximum": 999
        },
        "due_in_days": {
            "type": "integer",
            "format": "int32",
            "description": "Due period in days without discount, have to be greater than \"cash_discount1_days\" or \"cash_discount2_days\"",
            "minimum": 0,
            "maximum": 999,
            "example": 12
        }
        },
        "description": "#/definitions/datev.due-in-days"
    },
    "due_as_period": {
        "required": [
        "period1"
        ],
        "properties": {
        "period1": {
            "required": [
            "invoice_day_of_month",
            "due_date_net"
            ],
            "properties": {
            "invoice_day_of_month": {
                "type": "integer",
                "format": "int32",
                "description": "Latest possible day of the invoice date for this period",
                "minimum": 1,
                "maximum": 31,
                "example": 15
            },
            "due_date_net": {
                "required": [
                "related_month",
                "day_of_month"
                ],
                "properties": {
                "related_month": {
                    "type": "string",
                    "enum": [
                    "current_month",
                    "next_month",
                    "month_after_next"
                    ],
                    "description": "Relative month of the due date depending on the invoice date (current month, next month, month after next)",
                    "example": "month_after_next"
                },
                "day_of_month": {
                    "type": "integer",
                    "format": "int32",
                    "description": "Day of month within the related month \"related_month\"",
                    "minimum": 1,
                    "maximum": 31,
                    "example": 15
                }
                },
                "description": "#/definitions/datev.due-date"
            },
            "due_date_cash_discount1": {
                "$ref": "#/items/properties/due_as_period/properties/period1/properties/due_date_net"
            },
            "due_date_cash_discount2": {
                "$ref": "#/items/properties/due_as_period/properties/period1/properties/due_date_net"
            }
            },
            "description": "#/definitions/datev.period"
        },
        "period2": {
            "$ref": "#/items/properties/due_as_period/properties/period1"
        },
        "period3": {
            "$ref": "#/items/properties/due_as_period/properties/period1"
        }
        },
        "description": "#/definitions/datev.due-as-period"
    }
    },
    "description": "#/definitions/term-of-payment"
}
}
Terms of Payment / Zahlungsbedinungen 8.1
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
{
"type": "array",
"items": {
    "required": [
    "caption",
    "due_type"
    ],
    "type": "object",
    "properties": {
    "id": {
        "type": "string",
        "description": "ID, entspricht der Nummer der Zahlungsbedingung, 3-stellige fachliche ID. Beim POST darf die ID nicht angegeben werden, beim PUT ist die ID ein Pflichtfeld",
        "minimum": 10,
        "maximum": 999
    },
    "caption": {
        "type": "string",
        "maxLength": 40,
        "description": "Bezeichnung der Zahlungsbedingung, maximal 40-stellig"
    },
    "due_type": {
        "type": "string",
        "enum": [
        "due_in_days",
        "due_as_period"
        ],
        "description": "Typ der Zahlungsbedingung (Fälligkeit nach Tagen, Fälligkeit nach Datum)"
    },
    "cash_discount1_percentage": {
        "type": "number",
        "format": "decimal",
        "description": "Skonto-Prozent-Satz bei Inanspruchnahme von Skonto 1",
        "minimum": 0,
        "maximum": 99.99
    },
    "cash_discount2_percentage": {
        "type": "number",
        "format": "decimal",
        "description": "Skonto-Prozent-Satz bei Inanspruchnahme von Skonto 2, Prozentwert Skonto 2 muss kleiner sein als Prozentwert Skonto 1.",
        "minimum": 0,
        "maximum": 99.99
    },
    "due_in_days": {
        "properties": {
        "cash_discount1_days": {
            "type": "integer",
            "format": "int32",
            "description": "Fälligkeitstage für Skonto 1"
        },
        "cash_discount2_days": {
            "type": "integer",
            "format": "int32",
            "description": "Fälligkeitstage für Skonto 2, müssen größer sein als Fälligkeitstage für Skonto 1 (wenn Skonto-Prozent-Satz bei Inanspruchnahme von Skonto 2 mitgegeben wird)"
        },
        "due_in_days": {
            "type": "integer",
            "format": "int32",
            "description": "Fälligkeitstage ohne Abzug, müssen größer sein als Fälligkeitstage für Skonto 1 bzw. Skonto 2",
            "minimum": 0,
            "maximum": 999
        }
        },
        "description": "#/definitions/datev.due-in-days"
    },
    "due_as_period": {
        "required": [
        "period1"
        ],
        "properties": {
        "period1": {
            "required": [
            "invoice_day_of_month",
            "due_date_net"
            ],
            "properties": {
            "invoice_day_of_month": {
                "type": "integer",
                "format": "int32",
                "description": "Höchst mögliches Rechnungsdatum, das für diesen Zeitraum berücksichtigt wird",
                "minimum": 1,
                "maximum": 31
            },
            "due_date_net": {
                "required": [
                "related_month",
                "day_of_month"
                ],
                "properties": {
                "related_month": {
                    "type": "string",
                    "enum": [
                    "current_month",
                    "next_month",
                    "month_after_next"
                    ],
                    "description": "Relativer Monat der Fälligkeit in Abhängigkeit vom Rechnungsdatum (aktueller Monat, nächster Monat, übernächster Monat)"
                },
                "day_of_month": {
                    "type": "integer",
                    "format": "int32",
                    "description": "Tagesangabe der Fälligkeit innerhalb des relativen Monats der Fälligkeit \"related_month\"",
                    "minimum": 1,
                    "maximum": 31
                }
                },
                "description": "#/definitions/datev.due-date"
            },
            "due_date_cash_discount1": {
                "$ref": "#/items/properties/due_as_period/properties/period1/properties/due_date_net"
            },
            "due_date_cash_discount2": {
                "$ref": "#/items/properties/due_as_period/properties/period1/properties/due_date_net"
            }
            },
            "description": "#/definitions/datev.period"
        },
        "period2": {
            "$ref": "#/items/properties/due_as_period/properties/period1"
        },
        "period3": {
            "$ref": "#/items/properties/due_as_period/properties/period1"
        }
        },
        "description": "#/definitions/datev.due-as-period"
    }
    },
    "description": "#/definitions/term-of-payment"
}
}
Terms of Payment / Zahlungsbedinungen 7.2
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
    {
"type": "array",
"items": {
    "required": [
    "caption"
    ],
    "type": "object",
    "properties": {
    "id": {
        "type": "string",
        "description": "ID entspricht der Nummer der Zahlungsbedingung, 3-stellige fachliche Id. Beim POST darf die ID nicht angegeben werden, beim PUT ist die ID ein Pflichtfeld.",
        "minimum": 10,
        "maximum": 999
    },
    "caption": {
        "type": "string",
        "description": "Bezeichnung der Zahlungsbedingung, maximal 40-stellig"
    },
    "due_type": {
        "type": "string",
        "enum": [
        "due_in_days",
        "due_as_period"
        ],
        "description": "Typ der Zahlungsbedingung Fälligkeit nach Tagen bzw. Fälligkeit nach Datum"
    },
    "cash_discount1_percentage": {
        "type": "number",
        "format": "decimal",
        "description": "Skonto-Prozent-Satz bei Inanspruchnahme von Skonto 1",
        "minimum": 0,
        "maximum": 99.99
    },
    "cash_discount2_percentage": {
        "type": "number",
        "format": "decimal",
        "description": "Skonto-Prozent-Satz bei Inanspruchnahme von Skonto 2, Prozentwert Skonto 2 muss kleiner sein als Prozentwert Skonto 1.",
        "minimum": 0,
        "maximum": 99.99
    },
    "due_in_days": {
        "properties": {
        "cash_discount1_days": {
            "type": "integer",
            "format": "int32",
            "description": "Fälligkeitstage für Skonto 1"
        },
        "cash_discount2_days": {
            "type": "integer",
            "format": "int32",
            "description": "Fälligkeitstage für Skonto 2, müssen größer sein als Fälligkeitstage für Skonto 1 (wenn Skonto-Prozent-Satz bei Inanspruchnahme von Skonto 1 mitgegeben wird)"
        },
        "due_in_days": {
            "type": "integer",
            "format": "int32",
            "description": "Fälligkeitstage ohne Abzug, müssen größer sein als Fälligkeitstage für Skonto 1 bzw. Skonto 2",
            "minimum": 0,
            "maximum": 999
        }
        },
        "description": "#/definitions/datev.due-in-days"
    },
    "due_as_period": {
        "required": [
        "period1"
        ],
        "properties": {
        "period1": {
            "required": [
            "invoice_day_of_month",
            "due_date_net"
            ],
            "properties": {
            "invoice_day_of_month": {
                "type": "integer",
                "format": "int32",
                "description": "Höchst mögliches Rechnungsdatum, das für diesen Zeitraum berücksichtigt wird",
                "minimum": 1,
                "maximum": 31
            },
            "due_date_net": {
                "required": [
                "related_month",
                "day_of_month"
                ],
                "properties": {
                "related_month": {
                    "type": "string",
                    "enum": [
                    "current_month",
                    "next_month",
                    "month_after_next"
                    ],
                    "description": "Relativer Monat der Fälligkeit in Abhängigkeit vom Rechnungsdatum"
                },
                "day_of_month": {
                    "type": "integer",
                    "format": "int32",
                    "description": "Tagesangabe der Fälligkeit innerhalb des relativen Monats der Fälligkeit \"related_month\"",
                    "minimum": 1,
                    "maximum": 31
                }
                },
                "description": "#/definitions/datev.due-date"
            },
            "due_date_cash_discount1": {
                "$ref": "#/items/properties/due_as_period/properties/period1/properties/due_date_net"
            },
            "due_date_cash_discount2": {
                "$ref": "#/items/properties/due_as_period/properties/period1/properties/due_date_net"
            }
            },
            "description": "#/definitions/datev.period"
        },
        "period2": {
            "$ref": "#/items/properties/due_as_period/properties/period1"
        },
        "period3": {
            "$ref": "#/items/properties/due_as_period/properties/period1"
        }
        },
        "description": "#/definitions/datev.due-as-period"
    }
    },
    "description": "#/definitions/term-of-payment"
}
}