accountingAPI-Referenz
PUT
/v2/accounting/connections/{connectionId}Buchhaltungseinstellungen speichern
Speichert die normalisierten Einstellungen einer Verbindung. Fehlende Einstellungen erhalten Standardwerte; ein fehlendes contact_field_mapping bewahrt die bisherige Kontaktzuordnung. document_mode akzeptiert draft/issue/send, position_strategy custom/article. Für send sind Betreff und eine Nachricht mit [Network Link] erforderlich. Die Aktivierung automatischer Rechnungen prüft notwendige Zuordnungen. Änderungen können fehlgeschlagene Rechnungsereignisse wieder öffnen und versenden; erfordert canConfigure.
Operation-ID put_v2_accounting_connections_connectionId
01
Vertrag & Verhalten
- Dokumentationsstand
- reviewed
- Ändert Zustand
- Ja
- Als readOnly markiert
- Nein
- Für Automation markiert
- Nein
02
Authentifizierung
Eine der folgenden Alternativen muss erfüllt sein (ODER). Innerhalb jeder Alternative werden alle angegebenen Schemas gemeinsam benötigt (UND).
Alternative 1
bearerAuthhttp · bearerExisting edoobox v2 access token. Never substitute API key/secret headers.
Format: JWT
Security-Schema als JSON
{
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT",
"description": "Existing edoobox v2 access token. Never substitute API key/secret headers."
}accountContextapiKeySelected login/account context from the JWT, not a database primary key. Required even for a JWT with one account.
header: edid
Security-Schema als JSON
{
"type": "apiKey",
"in": "header",
"name": "edid",
"description": "Selected login/account context from the JWT, not a database primary key. Required even for a JWT with one account."
}Alternative 2
sessionCookieapiKeyExisting browser login session, with the same permission checks as Bearer authentication.
cookie: _edlogin
Security-Schema als JSON
{
"type": "apiKey",
"in": "cookie",
"name": "_edlogin",
"description": "Existing browser login session, with the same permission checks as Bearer authentication."
}accountContextapiKeySelected login/account context from the JWT, not a database primary key. Required even for a JWT with one account.
header: edid
Security-Schema als JSON
{
"type": "apiKey",
"in": "header",
"name": "edid",
"description": "Selected login/account context from the JWT, not a database primary key. Required even for a JWT with one account."
}03
Parameter
Pfadparameter
connectionIderforderlichVerbindungs-ID aus connections, im aktuellen Konto.
string
Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.
- pattern
"^accountingconnection_[a-f0-9]{12}_-?[0-9]+$"
Schema-Beispiel
"accountingconnection_012345abcdef_123456"Vollständiges Schema als JSON
{
"type": "string",
"pattern": "^accountingconnection_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"accountingconnection_012345abcdef_123456"
]
}Header
languageoptionalAccount language code, where the resource supports setLanguage().
string
Schema-Beispiel
"de"Vollständiges Schema als JSON
{
"type": "string",
"examples": [
"de"
]
}X-Edoobox-If-RevisionoptionalOptional account mutation revision from a preceding authenticated auth-context snapshot. The dispatcher compares it while holding the account lock; mismatch409 requires a new review.
string
- pattern
"^[a-f0-9]{32}$"
Schema-Beispiel
"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"Vollständiges Schema als JSON
{
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"examples": [
"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
]
}04
Request Body
optionalapplication/json
object
data object settings object automatic_invoice Typ nicht eingeschränkt PHP-Bool-Normalisierung; Standard false.
Kanonischer Typ nach Normalisierung: boolean. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "boolean"
}document_mode string Getrimmt und kleingeschrieben; draft, issue oder send.
payment_sync_inbound Typ nicht eingeschränkt PHP-Bool-Normalisierung; Standard false.
Kanonischer Typ nach Normalisierung: boolean. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "boolean"
}payment_sync_outbound Typ nicht eingeschränkt PHP-Bool-Normalisierung; Standard false.
Kanonischer Typ nach Normalisierung: boolean. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "boolean"
}position_strategy string Getrimmt und kleingeschrieben; custom oder article.
contact_field_mapping object salutation string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"first_name string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"last_name string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"street string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"house_number string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"address_addition string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"postal_code string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"city string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"country string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"email string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"phone string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"mobile string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"remarks string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"Zusätzliche Felder sind in diesem Teilschema ausgeschlossen.
send object subject string - maxLength
255
message string - maxLength
20000
mark_as_open Typ nicht eingeschränkt PHP-Bool-Normalisierung; Standard true.
Kanonischer Typ nach Normalisierung: boolean. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "boolean"
}attach_pdf Typ nicht eingeschränkt PHP-Bool-Normalisierung; Standard true.
Kanonischer Typ nach Normalisierung: boolean. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "boolean"
}Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Vollständiges Schema als JSON
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"settings": {
"type": "object",
"properties": {
"automatic_invoice": {
"description": "PHP-Bool-Normalisierung; Standard false.",
"x-edoobox-canonicalType": "boolean"
},
"document_mode": {
"type": "string",
"description": "Getrimmt und kleingeschrieben; draft, issue oder send."
},
"payment_sync_inbound": {
"description": "PHP-Bool-Normalisierung; Standard false.",
"x-edoobox-canonicalType": "boolean"
},
"payment_sync_outbound": {
"description": "PHP-Bool-Normalisierung; Standard false.",
"x-edoobox-canonicalType": "boolean"
},
"position_strategy": {
"type": "string",
"description": "Getrimmt und kleingeschrieben; custom oder article."
},
"contact_field_mapping": {
"type": "object",
"properties": {
"salutation": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"first_name": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"last_name": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"street": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"house_number": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"address_addition": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"postal_code": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"city": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"country": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"email": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"phone": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"mobile": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"remarks": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
}
},
"additionalProperties": false
},
"send": {
"type": "object",
"properties": {
"subject": {
"type": "string",
"maxLength": 255
},
"message": {
"type": "string",
"maxLength": 20000
},
"mark_as_open": {
"description": "PHP-Bool-Normalisierung; Standard true.",
"x-edoobox-canonicalType": "boolean"
},
"attach_pdf": {
"description": "PHP-Bool-Normalisierung; Standard true.",
"x-edoobox-canonicalType": "boolean"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}Buchhaltungseinstellungen speichern
{
"data": {
"settings": {
"automatic_invoice": false,
"document_mode": "draft",
"position_strategy": "custom"
}
}
}05
Antworten
11HTTP-Status und Antwortinhalt gemeinsam auswerten. In dieser API können auch Antworten mit HTTP 200 einen Fehler enthalten.
200application/json
Objekt mit gespeicherter connection.
Response Header
X-Edoobox-Revision
Rotated account revision supplied for the next action in one reviewed sequence.
string
- pattern
"^[a-f0-9]{32}$"
Vollständiges Schema als JSON
{
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}application/json
object
success boolean error boolean | string error_code string data object connection object id string Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.
- pattern
"^accountingconnection_[a-f0-9]{12}_-?[0-9]+$"
Schema-Beispiel
"accountingconnection_012345abcdef_123456"provider string status string company object id string name string Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
scopes array Array-Elemente
string
settings object automatic_invoice boolean | string | number | null PHP-Bool-Normalisierung; Standard false.
document_mode string Getrimmt und kleingeschrieben; draft, issue oder send.
payment_sync_inbound boolean | string | number | null PHP-Bool-Normalisierung; Standard false.
payment_sync_outbound boolean | string | number | null PHP-Bool-Normalisierung; Standard false.
position_strategy string Getrimmt und kleingeschrieben; custom oder article.
contact_field_mapping object salutation string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"first_name string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"last_name string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"street string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"house_number string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"address_addition string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"postal_code string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"city string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"country string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"email string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"phone string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"mobile string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"remarks string Erlaubte Werte
"""gender""first_name""last_name""street""postcode""location""country""email""phone_number""company""data_1""data_2""data_3""data_4""data_5""data_6""data_7""data_8""data_9""data_10""data_11""data_12""data_13""data_14""data_15""data_16""data_17""data_18""data_19""data_20""data_21""data_22""data_23""data_24""data_25""data_26""data_27""data_28""data_29""data_30"Zusätzliche Felder sind in diesem Teilschema ausgeschlossen.
send object subject string - maxLength
255
message string - maxLength
20000
mark_as_open boolean | string | number | null PHP-Bool-Normalisierung; Standard true.
attach_pdf boolean | string | number | null PHP-Bool-Normalisierung; Standard true.
Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
connected_at Typ nicht eingeschränkt anyOf · Mindestens eine Variante muss passen
Variante 1 string Variante 2 null token_expires_at Typ nicht eingeschränkt anyOf · Mindestens eine Variante muss passen
Variante 1 string Variante 2 null last_sync_at Typ nicht eingeschränkt anyOf · Mindestens eine Variante muss passen
Variante 1 string Variante 2 null health object last_check_at Typ nicht eingeschränkt anyOf · Mindestens eine Variante muss passen
Variante 1 string Variante 2 null last_error string last_error_code string Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
type string Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Vollständiges Schema als JSON
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"error": {
"type": [
"boolean",
"string"
]
},
"error_code": {
"type": "string"
},
"data": {
"type": "object",
"properties": {
"connection": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^accountingconnection_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"accountingconnection_012345abcdef_123456"
]
},
"provider": {
"type": "string"
},
"status": {
"type": "string"
},
"company": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": true
},
"scopes": {
"type": "array",
"items": {
"type": "string"
}
},
"settings": {
"type": "object",
"properties": {
"automatic_invoice": {
"type": [
"boolean",
"string",
"number",
"null"
],
"description": "PHP-Bool-Normalisierung; Standard false."
},
"document_mode": {
"type": "string",
"description": "Getrimmt und kleingeschrieben; draft, issue oder send."
},
"payment_sync_inbound": {
"type": [
"boolean",
"string",
"number",
"null"
],
"description": "PHP-Bool-Normalisierung; Standard false."
},
"payment_sync_outbound": {
"type": [
"boolean",
"string",
"number",
"null"
],
"description": "PHP-Bool-Normalisierung; Standard false."
},
"position_strategy": {
"type": "string",
"description": "Getrimmt und kleingeschrieben; custom oder article."
},
"contact_field_mapping": {
"type": "object",
"properties": {
"salutation": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"first_name": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"last_name": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"street": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"house_number": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"address_addition": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"postal_code": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"city": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"country": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"email": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"phone": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"mobile": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"remarks": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
}
},
"additionalProperties": false
},
"send": {
"type": "object",
"properties": {
"subject": {
"type": "string",
"maxLength": 255
},
"message": {
"type": "string",
"maxLength": 20000
},
"mark_as_open": {
"type": [
"boolean",
"string",
"number",
"null"
],
"description": "PHP-Bool-Normalisierung; Standard true."
},
"attach_pdf": {
"type": [
"boolean",
"string",
"number",
"null"
],
"description": "PHP-Bool-Normalisierung; Standard true."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"connected_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"token_expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"last_sync_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"health": {
"type": "object",
"properties": {
"last_check_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"last_error": {
"type": "string"
},
"last_error_code": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"type": {
"type": "string"
}
},
"additionalProperties": true
}Beispiel
{
"success": true,
"error": false,
"data": {
"connection": {
"id": "accountingconnection_012345abcdef_123456",
"provider": "bexio",
"status": "active",
"company": {
"id": "example-company",
"name": "Beispielfirma"
},
"scopes": []
}
}
}400application/json
Invalid request.
application/json
Typ nicht eingeschränkt
Kein Schema angegeben. Daraus lässt sich kein vollständiger Feldvertrag ableiten.
Beispiel
{
"success": false,
"error": "ED40006"
}401application/json
Missing/expired token, missing account context, account paused or model-specific authorization failure.
application/json
Typ nicht eingeschränkt
Kein Schema angegeben. Daraus lässt sich kein vollständiger Feldvertrag ableiten.
Beispiel
{
"success": false,
"error": "ED40103"
}402application/json
Missing/invalid action data or subscription/operation restriction.
application/json
Typ nicht eingeschränkt
Kein Schema angegeben. Daraus lässt sich kein vollständiger Feldvertrag ableiten.
Beispiel
{
"success": false,
"error": "ED80100"
}403application/json
Permission denied. Browser CORS rejection may have an empty body.
application/json
Typ nicht eingeschränkt
Kein Schema angegeben. Daraus lässt sich kein vollständiger Feldvertrag ableiten.
Beispiel
{
"success": false,
"error": "ED40340"
}404application/json
Unknown resource/action or unsupported method.
application/json
Typ nicht eingeschränkt
Kein Schema angegeben. Daraus lässt sich kein vollständiger Feldvertrag ableiten.
Beispiel
{
"success": false,
"error": "ED80019"
}409application/json
The account changed after the reviewed read. No domain operation is dispatched; obtain fresh state and review again.
application/json
object
Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Vollständiges Schema als JSON
{
"type": "object",
"additionalProperties": true
}Beispiel
{
"error": "ED40901",
"error_code": "mutation_revision_conflict"
}422application/json
Validation failed.
application/json
Typ nicht eingeschränkt
Kein Schema angegeben. Daraus lässt sich kein vollständiger Feldvertrag ableiten.
Beispiel
{
"success": false,
"error": "ED80020"
}429application/json
Request/login rate limit exceeded. Honor Retry-After when supplied; legacy rate-limit paths may omit it. Retry only proven reads within a bounded deadline; a mutation is never automatically replayed after an ambiguous response.
Response Header
Retry-After
Optional server delay in whole seconds or an HTTP date. Absence is not permission for an immediate retry.
string
Schema-Beispiel
"30"Vollständiges Schema als JSON
{
"type": "string",
"examples": [
"30"
]
}application/json
Typ nicht eingeschränkt
Kein Schema angegeben. Daraus lässt sich kein vollständiger Feldvertrag ableiten.
Beispiel
{
"success": false,
"error": "ED42902"
}502application/json
Server-side operation failed.
application/json
Typ nicht eingeschränkt
Kein Schema angegeben. Daraus lässt sich kein vollständiger Feldvertrag ableiten.
Beispiel
{
"success": false,
"error": "ED50201"
}503application/json
The account mutation lock or revision store is unavailable. No unprotected fallback is executed.
Response Header
Retry-After
integer
Fester Wert: 1
Vollständiges Schema als JSON
{
"type": "integer",
"const": 1
}application/json
object
Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Vollständiges Schema als JSON
{
"type": "object",
"additionalProperties": true
}Beispiel
{
"error": "ED50301",
"error_code": "mutation_revision_busy"
}06
Quelle & Metadaten
Quelle laut Spezifikation
application/models/v2/Accounting.php:184updateAccounting()Diese Angaben stammen unverändert aus der gelieferten OpenAPI-Datei. Zusätzliche Freigaben, Vorbedingungen, sensible Felder und Hinweise stehen in den Erweiterungen.
x-edoobox-mutates-state
truex-edoobox-runtimeMutationGuard
truex-edoobox-documentationReview
{
"file": "docs/openapi/operation-contracts/04-accounting.json",
"notes": []
}x-edoobox-source
{
"file": "application/models/v2/Accounting.php",
"method": "updateAccounting",
"line": 184
}x-edoobox-documentationStatus
"reviewed"x-edoobox-readOnly
falsex-edoobox-safeForAutomation
falsex-edoobox-permission
{
"resource": "accounting",
"short": "acco",
"checkedByDispatcher": true,
"levels": [
3,
4
],
"description": "Resource permission mapping from APIPermissions(), Authfunc::_getCheckJWT. Additional model/admin/plugin checks may apply; resources absent from api_permission do not acquire a fictitious scope."
}Vollständige Operation als JSON
{
"operationId": "put_v2_accounting_connections_connectionId",
"summary": "Buchhaltungseinstellungen speichern",
"description": "Speichert die normalisierten Einstellungen einer Verbindung. Fehlende Einstellungen erhalten Standardwerte; ein fehlendes contact_field_mapping bewahrt die bisherige Kontaktzuordnung. document_mode akzeptiert draft/issue/send, position_strategy custom/article. Für send sind Betreff und eine Nachricht mit [Network Link] erforderlich. Die Aktivierung automatischer Rechnungen prüft notwendige Zuordnungen. Änderungen können fehlgeschlagene Rechnungsereignisse wieder öffnen und versenden; erfordert canConfigure.",
"tags": [
"accounting"
],
"security": [
{
"bearerAuth": [],
"accountContext": []
},
{
"sessionCookie": [],
"accountContext": []
}
],
"parameters": [
{
"name": "connectionId",
"in": "path",
"required": true,
"description": "Verbindungs-ID aus connections, im aktuellen Konto.",
"schema": {
"type": "string",
"pattern": "^accountingconnection_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"accountingconnection_012345abcdef_123456"
]
}
},
{
"name": "language",
"in": "header",
"required": false,
"description": "Account language code, where the resource supports setLanguage().",
"schema": {
"type": "string",
"examples": [
"de"
]
}
},
{
"name": "X-Edoobox-If-Revision",
"in": "header",
"required": false,
"schema": {
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"examples": [
"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
]
},
"description": "Optional account mutation revision from a preceding authenticated auth-context snapshot. The dispatcher compares it while holding the account lock; mismatch409 requires a new review."
}
],
"responses": {
"200": {
"description": "Objekt mit gespeicherter connection.",
"content": {
"application/json": {
"example": {
"success": true,
"error": false,
"data": {
"connection": {
"id": "accountingconnection_012345abcdef_123456",
"provider": "bexio",
"status": "active",
"company": {
"id": "example-company",
"name": "Beispielfirma"
},
"scopes": []
}
}
},
"schema": {
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"error": {
"type": [
"boolean",
"string"
]
},
"error_code": {
"type": "string"
},
"data": {
"type": "object",
"properties": {
"connection": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^accountingconnection_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"accountingconnection_012345abcdef_123456"
]
},
"provider": {
"type": "string"
},
"status": {
"type": "string"
},
"company": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": true
},
"scopes": {
"type": "array",
"items": {
"type": "string"
}
},
"settings": {
"type": "object",
"properties": {
"automatic_invoice": {
"type": [
"boolean",
"string",
"number",
"null"
],
"description": "PHP-Bool-Normalisierung; Standard false."
},
"document_mode": {
"type": "string",
"description": "Getrimmt und kleingeschrieben; draft, issue oder send."
},
"payment_sync_inbound": {
"type": [
"boolean",
"string",
"number",
"null"
],
"description": "PHP-Bool-Normalisierung; Standard false."
},
"payment_sync_outbound": {
"type": [
"boolean",
"string",
"number",
"null"
],
"description": "PHP-Bool-Normalisierung; Standard false."
},
"position_strategy": {
"type": "string",
"description": "Getrimmt und kleingeschrieben; custom oder article."
},
"contact_field_mapping": {
"type": "object",
"properties": {
"salutation": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"first_name": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"last_name": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"street": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"house_number": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"address_addition": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"postal_code": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"city": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"country": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"email": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"phone": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"mobile": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"remarks": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
}
},
"additionalProperties": false
},
"send": {
"type": "object",
"properties": {
"subject": {
"type": "string",
"maxLength": 255
},
"message": {
"type": "string",
"maxLength": 20000
},
"mark_as_open": {
"type": [
"boolean",
"string",
"number",
"null"
],
"description": "PHP-Bool-Normalisierung; Standard true."
},
"attach_pdf": {
"type": [
"boolean",
"string",
"number",
"null"
],
"description": "PHP-Bool-Normalisierung; Standard true."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"connected_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"token_expires_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"last_sync_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"health": {
"type": "object",
"properties": {
"last_check_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"last_error": {
"type": "string"
},
"last_error_code": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"type": {
"type": "string"
}
},
"additionalProperties": true
}
}
},
"headers": {
"X-Edoobox-Revision": {
"schema": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
},
"description": "Rotated account revision supplied for the next action in one reviewed sequence."
}
}
},
"400": {
"description": "Invalid request.",
"content": {
"application/json": {
"example": {
"success": false,
"error": "ED40006"
}
}
}
},
"401": {
"description": "Missing/expired token, missing account context, account paused or model-specific authorization failure.",
"content": {
"application/json": {
"example": {
"success": false,
"error": "ED40103"
}
}
}
},
"402": {
"description": "Missing/invalid action data or subscription/operation restriction.",
"content": {
"application/json": {
"example": {
"success": false,
"error": "ED80100"
}
}
}
},
"403": {
"description": "Permission denied. Browser CORS rejection may have an empty body.",
"content": {
"application/json": {
"example": {
"success": false,
"error": "ED40340"
}
}
}
},
"404": {
"description": "Unknown resource/action or unsupported method.",
"content": {
"application/json": {
"example": {
"success": false,
"error": "ED80019"
}
}
}
},
"409": {
"description": "The account changed after the reviewed read. No domain operation is dispatched; obtain fresh state and review again.",
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": true
},
"example": {
"error": "ED40901",
"error_code": "mutation_revision_conflict"
}
}
}
},
"422": {
"description": "Validation failed.",
"content": {
"application/json": {
"example": {
"success": false,
"error": "ED80020"
}
}
}
},
"429": {
"description": "Request/login rate limit exceeded. Honor Retry-After when supplied; legacy rate-limit paths may omit it. Retry only proven reads within a bounded deadline; a mutation is never automatically replayed after an ambiguous response.",
"content": {
"application/json": {
"example": {
"success": false,
"error": "ED42902"
}
}
},
"headers": {
"Retry-After": {
"description": "Optional server delay in whole seconds or an HTTP date. Absence is not permission for an immediate retry.",
"schema": {
"type": "string",
"examples": [
"30"
]
}
}
}
},
"502": {
"description": "Server-side operation failed.",
"content": {
"application/json": {
"example": {
"success": false,
"error": "ED50201"
}
}
}
},
"503": {
"description": "The account mutation lock or revision store is unavailable. No unprotected fallback is executed.",
"headers": {
"Retry-After": {
"schema": {
"type": "integer",
"const": 1
}
}
},
"content": {
"application/json": {
"schema": {
"type": "object",
"additionalProperties": true
},
"example": {
"error": "ED50301",
"error_code": "mutation_revision_busy"
}
}
}
}
},
"x-edoobox-mutates-state": true,
"requestBody": {
"required": false,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"settings": {
"type": "object",
"properties": {
"automatic_invoice": {
"description": "PHP-Bool-Normalisierung; Standard false.",
"x-edoobox-canonicalType": "boolean"
},
"document_mode": {
"type": "string",
"description": "Getrimmt und kleingeschrieben; draft, issue oder send."
},
"payment_sync_inbound": {
"description": "PHP-Bool-Normalisierung; Standard false.",
"x-edoobox-canonicalType": "boolean"
},
"payment_sync_outbound": {
"description": "PHP-Bool-Normalisierung; Standard false.",
"x-edoobox-canonicalType": "boolean"
},
"position_strategy": {
"type": "string",
"description": "Getrimmt und kleingeschrieben; custom oder article."
},
"contact_field_mapping": {
"type": "object",
"properties": {
"salutation": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"first_name": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"last_name": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"street": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"house_number": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"address_addition": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"postal_code": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"city": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"country": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"email": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"phone": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"mobile": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
},
"remarks": {
"type": "string",
"enum": [
"",
"gender",
"first_name",
"last_name",
"street",
"postcode",
"location",
"country",
"email",
"phone_number",
"company",
"data_1",
"data_2",
"data_3",
"data_4",
"data_5",
"data_6",
"data_7",
"data_8",
"data_9",
"data_10",
"data_11",
"data_12",
"data_13",
"data_14",
"data_15",
"data_16",
"data_17",
"data_18",
"data_19",
"data_20",
"data_21",
"data_22",
"data_23",
"data_24",
"data_25",
"data_26",
"data_27",
"data_28",
"data_29",
"data_30"
]
}
},
"additionalProperties": false
},
"send": {
"type": "object",
"properties": {
"subject": {
"type": "string",
"maxLength": 255
},
"message": {
"type": "string",
"maxLength": 20000
},
"mark_as_open": {
"description": "PHP-Bool-Normalisierung; Standard true.",
"x-edoobox-canonicalType": "boolean"
},
"attach_pdf": {
"description": "PHP-Bool-Normalisierung; Standard true.",
"x-edoobox-canonicalType": "boolean"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"examples": {
"request": {
"summary": "Buchhaltungseinstellungen speichern",
"value": {
"data": {
"settings": {
"automatic_invoice": false,
"document_mode": "draft",
"position_strategy": "custom"
}
}
}
}
}
}
}
},
"x-edoobox-runtimeMutationGuard": true,
"x-edoobox-documentationReview": {
"file": "docs/openapi/operation-contracts/04-accounting.json",
"notes": []
},
"x-edoobox-source": {
"file": "application/models/v2/Accounting.php",
"method": "updateAccounting",
"line": 184
},
"x-edoobox-documentationStatus": "reviewed",
"x-edoobox-readOnly": false,
"x-edoobox-safeForAutomation": false,
"x-edoobox-permission": {
"resource": "accounting",
"short": "acco",
"checkedByDispatcher": true,
"levels": [
3,
4
],
"description": "Resource permission mapping from APIPermissions(), Authfunc::_getCheckJWT. Additional model/admin/plugin checks may apply; resources absent from api_permission do not acquire a fictitious scope."
}
}