{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}
{
"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"
}
}