/v2/dunning/configMahnregeln und Aktivierung speichern
Speichert enabled (ohne Angabe false) und ersetzt bei vorhandenem rules beide Regelgruppen vollständig. Regeln werden nach Tagen und sort_order sortiert; höchstens zehn je Kontext und keine Regel nach einer Stornierungsregel. Nicht-Mahngebühren werden auf 0 gesetzt; cancellation erhält keinen Versandweg. Regel-IDs dürfen nur aus dem eigenen Konto stammen; Regeln ohne passende ID werden angelegt.
Operation-ID put_v2_dunning_config
Vertrag & Verhalten
- Dokumentationsstand
- reviewed
- Ändert Zustand
- Ja
- Als readOnly markiert
- Nein
- Für Automation markiert
- Nein
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."
}Parameter
Header
languageoptionalAccount language code, where the resource supports setLanguage().
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.
- pattern
"^[a-f0-9]{32}$"
Schema-Beispiel
"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"Vollständiges Schema als JSON
{
"type": "string",
"pattern": "^[a-f0-9]{32}$",
"examples": [
"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
]
}Request Body
optionalapplication/json
data object enabled Typ nicht eingeschränkt boolValue: true/1 beziehungsweise 1,true,yes,y,on,aktiv,active aktivieren; Auslassung deaktiviert.
Kanonischer Typ nach Normalisierung: boolean. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "boolean"
}rules Typ nicht eingeschränkt Vollständiger Ersatz beider Kontexte: fehlende Regeln/Kontexte werden entfernt. Alternativ Liste mit context je Regel (Standard invoice). Höchstens zehn je Kontext, nach cancellation darf keine spätere Regel folgen.
anyOf · Mindestens eine Variante muss passen
Variante 1 object invoice array Array-Elemente
id string Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.
- pattern
"^dunningrule_[a-f0-9]{12}_-?[0-9]+$"
Schema-Beispiel
"dunningrule_012345abcdef_123456"context string "invoice""booking_without_invoice"days_without_payment Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}name string name_translations Typ nicht eingeschränkt Sprachkürzel auf Text; alternativ JSON-Text oder einzelner Name in der Kontosprache.
anyOf · Mindestens eine Variante muss passen
Variante 1 object Schema für zusätzliche Felder
anyOf · Mindestens eine Variante muss passen
Variante 1 string Variante 2 object name string value string Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Variante 2 string action string "reminder""dunning""cancellation"fee_amount Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: number. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "number"
}level Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}delivery string email_template Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}post_template Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}active Typ nicht eingeschränkt boolValue akzeptiert true, 1 und die Zeichenfolgen 1/true/yes/y/on/aktiv/active; sonst false. Ohne active/status standardmäßig true.
Kanonischer Typ nach Normalisierung: boolean. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "boolean"
}status Typ nicht eingeschränkt Alternative zu active; active hat Vorrang.
Kanonischer Typ nach Normalisierung: boolean. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "boolean"
}sort_order Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}action_type string "reminder""dunning""cancellation"delivery_type string dunning_level Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
booking_without_invoice array Array-Elemente
id string Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.
- pattern
"^dunningrule_[a-f0-9]{12}_-?[0-9]+$"
Schema-Beispiel
"dunningrule_012345abcdef_123456"context string "invoice""booking_without_invoice"days_without_payment Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}name string name_translations Typ nicht eingeschränkt Sprachkürzel auf Text; alternativ JSON-Text oder einzelner Name in der Kontosprache.
anyOf · Mindestens eine Variante muss passen
Variante 1 object Schema für zusätzliche Felder
anyOf · Mindestens eine Variante muss passen
Variante 1 string Variante 2 object name string value string Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Variante 2 string action string "reminder""dunning""cancellation"fee_amount Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: number. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "number"
}level Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}delivery string email_template Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}post_template Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}active Typ nicht eingeschränkt boolValue akzeptiert true, 1 und die Zeichenfolgen 1/true/yes/y/on/aktiv/active; sonst false. Ohne active/status standardmäßig true.
Kanonischer Typ nach Normalisierung: boolean. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "boolean"
}status Typ nicht eingeschränkt Alternative zu active; active hat Vorrang.
Kanonischer Typ nach Normalisierung: boolean. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "boolean"
}sort_order Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}action_type string "reminder""dunning""cancellation"delivery_type string dunning_level Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Variante 2 array Array-Elemente
id string Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.
- pattern
"^dunningrule_[a-f0-9]{12}_-?[0-9]+$"
Schema-Beispiel
"dunningrule_012345abcdef_123456"context string "invoice""booking_without_invoice"days_without_payment Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}name string name_translations Typ nicht eingeschränkt Sprachkürzel auf Text; alternativ JSON-Text oder einzelner Name in der Kontosprache.
anyOf · Mindestens eine Variante muss passen
Variante 1 object Schema für zusätzliche Felder
anyOf · Mindestens eine Variante muss passen
Variante 1 string Variante 2 object name string value string Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Variante 2 string action string "reminder""dunning""cancellation"fee_amount Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: number. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "number"
}level Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}delivery string email_template Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}post_template Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}active Typ nicht eingeschränkt boolValue akzeptiert true, 1 und die Zeichenfolgen 1/true/yes/y/on/aktiv/active; sonst false. Ohne active/status standardmäßig true.
Kanonischer Typ nach Normalisierung: boolean. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "boolean"
}status Typ nicht eingeschränkt Alternative zu active; active hat Vorrang.
Kanonischer Typ nach Normalisierung: boolean. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "boolean"
}sort_order Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}action_type string "reminder""dunning""cancellation"delivery_type string dunning_level Typ nicht eingeschränkt Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.
Kanonischer Typ nach Normalisierung: integer. Dies ist keine zusätzliche Einschränkung des Eingabetyps.
Feld-Metadaten aus der Spezifikation
{
"x-edoobox-canonicalType": "integer"
}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": {
"enabled": {
"description": "boolValue: true/1 beziehungsweise 1,true,yes,y,on,aktiv,active aktivieren; Auslassung deaktiviert.",
"x-edoobox-canonicalType": "boolean"
},
"rules": {
"anyOf": [
{
"type": "object",
"properties": {
"invoice": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^dunningrule_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"dunningrule_012345abcdef_123456"
]
},
"context": {
"type": "string",
"enum": [
"invoice",
"booking_without_invoice"
]
},
"days_without_payment": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"name": {
"type": "string"
},
"name_translations": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"additionalProperties": true
}
]
}
},
{
"type": "string"
}
],
"description": "Sprachkürzel auf Text; alternativ JSON-Text oder einzelner Name in der Kontosprache."
},
"action": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"fee_amount": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "number"
},
"level": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"delivery": {
"type": "string"
},
"email_template": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"post_template": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"active": {
"description": "boolValue akzeptiert true, 1 und die Zeichenfolgen 1/true/yes/y/on/aktiv/active; sonst false. Ohne active/status standardmäßig true.",
"x-edoobox-canonicalType": "boolean"
},
"status": {
"description": "Alternative zu active; active hat Vorrang.",
"x-edoobox-canonicalType": "boolean"
},
"sort_order": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"action_type": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"delivery_type": {
"type": "string"
},
"dunning_level": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
}
},
"additionalProperties": true
}
},
"booking_without_invoice": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^dunningrule_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"dunningrule_012345abcdef_123456"
]
},
"context": {
"type": "string",
"enum": [
"invoice",
"booking_without_invoice"
]
},
"days_without_payment": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"name": {
"type": "string"
},
"name_translations": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"additionalProperties": true
}
]
}
},
{
"type": "string"
}
],
"description": "Sprachkürzel auf Text; alternativ JSON-Text oder einzelner Name in der Kontosprache."
},
"action": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"fee_amount": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "number"
},
"level": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"delivery": {
"type": "string"
},
"email_template": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"post_template": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"active": {
"description": "boolValue akzeptiert true, 1 und die Zeichenfolgen 1/true/yes/y/on/aktiv/active; sonst false. Ohne active/status standardmäßig true.",
"x-edoobox-canonicalType": "boolean"
},
"status": {
"description": "Alternative zu active; active hat Vorrang.",
"x-edoobox-canonicalType": "boolean"
},
"sort_order": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"action_type": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"delivery_type": {
"type": "string"
},
"dunning_level": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^dunningrule_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"dunningrule_012345abcdef_123456"
]
},
"context": {
"type": "string",
"enum": [
"invoice",
"booking_without_invoice"
]
},
"days_without_payment": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"name": {
"type": "string"
},
"name_translations": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"additionalProperties": true
}
]
}
},
{
"type": "string"
}
],
"description": "Sprachkürzel auf Text; alternativ JSON-Text oder einzelner Name in der Kontosprache."
},
"action": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"fee_amount": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "number"
},
"level": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"delivery": {
"type": "string"
},
"email_template": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"post_template": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"active": {
"description": "boolValue akzeptiert true, 1 und die Zeichenfolgen 1/true/yes/y/on/aktiv/active; sonst false. Ohne active/status standardmäßig true.",
"x-edoobox-canonicalType": "boolean"
},
"status": {
"description": "Alternative zu active; active hat Vorrang.",
"x-edoobox-canonicalType": "boolean"
},
"sort_order": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"action_type": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"delivery_type": {
"type": "string"
},
"dunning_level": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
}
},
"additionalProperties": true
}
}
],
"description": "Vollständiger Ersatz beider Kontexte: fehlende Regeln/Kontexte werden entfernt. Alternativ Liste mit context je Regel (Standard invoice). Höchstens zehn je Kontext, nach cancellation darf keine spätere Regel folgen."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}Mahnregeln und Aktivierung speichern
{
"data": {
"enabled": true,
"rules": {
"invoice": [
{
"days_without_payment": 7,
"action": "reminder",
"delivery": "email",
"level": 1,
"name_translations": {
"de": "Erste Zahlungserinnerung"
},
"active": true
}
],
"booking_without_invoice": []
}
}
}Antworten
11HTTP-Status und Antwortinhalt gemeinsam auswerten. In dieser API können auch Antworten mit HTTP 200 einen Fehler enthalten.
200application/json
update=true und die gespeicherte Konfiguration.
Response Header
X-Edoobox-Revision
Rotated account revision supplied for the next action in one reviewed sequence.
- pattern
"^[a-f0-9]{32}$"
Vollständiges Schema als JSON
{
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}application/json
success boolean error boolean | string error_code string data object update boolean config object enabled boolean rules object invoice array Array-Elemente
id string Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.
- pattern
"^dunningrule_[a-f0-9]{12}_-?[0-9]+$"
Schema-Beispiel
"dunningrule_012345abcdef_123456"context string "invoice""booking_without_invoice"days_without_payment integer name string name_translations object Schema für zusätzliche Felder
action string "reminder""dunning""cancellation"fee_amount number level integer delivery string email_template integer post_template integer active boolean status integer sort_order integer Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
booking_without_invoice array Array-Elemente
id string Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.
- pattern
"^dunningrule_[a-f0-9]{12}_-?[0-9]+$"
Schema-Beispiel
"dunningrule_012345abcdef_123456"context string "invoice""booking_without_invoice"days_without_payment integer name string name_translations object Schema für zusätzliche Felder
action string "reminder""dunning""cancellation"fee_amount number level integer delivery string email_template integer post_template integer active boolean status integer sort_order integer Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
max_rules_per_context Typ nicht eingeschränkt Fester Wert: 10
contexts object invoice object id string name string Zusätzliche, hier nicht aufgeführte Felder sind erlaubt.
booking_without_invoice object id string name 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.
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": {
"update": {
"type": "boolean"
},
"config": {
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
},
"rules": {
"type": "object",
"properties": {
"invoice": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^dunningrule_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"dunningrule_012345abcdef_123456"
]
},
"context": {
"type": "string",
"enum": [
"invoice",
"booking_without_invoice"
]
},
"days_without_payment": {
"type": "integer"
},
"name": {
"type": "string"
},
"name_translations": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"action": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"fee_amount": {
"type": "number"
},
"level": {
"type": "integer"
},
"delivery": {
"type": "string"
},
"email_template": {
"type": "integer"
},
"post_template": {
"type": "integer"
},
"active": {
"type": "boolean"
},
"status": {
"type": "integer"
},
"sort_order": {
"type": "integer"
}
},
"additionalProperties": true
}
},
"booking_without_invoice": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^dunningrule_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"dunningrule_012345abcdef_123456"
]
},
"context": {
"type": "string",
"enum": [
"invoice",
"booking_without_invoice"
]
},
"days_without_payment": {
"type": "integer"
},
"name": {
"type": "string"
},
"name_translations": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"action": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"fee_amount": {
"type": "number"
},
"level": {
"type": "integer"
},
"delivery": {
"type": "string"
},
"email_template": {
"type": "integer"
},
"post_template": {
"type": "integer"
},
"active": {
"type": "boolean"
},
"status": {
"type": "integer"
},
"sort_order": {
"type": "integer"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"max_rules_per_context": {
"const": 10
},
"contexts": {
"type": "object",
"properties": {
"invoice": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": true
},
"booking_without_invoice": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"type": {
"type": "string"
}
},
"additionalProperties": true
}Beispiel
{
"success": true,
"error": false,
"data": {
"update": true,
"config": {
"enabled": false,
"rules": {
"invoice": [],
"booking_without_invoice": []
},
"max_rules_per_context": 10,
"contexts": {
"invoice": {
"id": "invoice",
"name": ""
},
"booking_without_invoice": {
"id": "booking_without_invoice",
"name": ""
}
}
}
}
}400application/json
Invalid request.
application/json
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
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
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
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
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
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
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.
Schema-Beispiel
"30"Vollständiges Schema als JSON
{
"type": "string",
"examples": [
"30"
]
}application/json
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
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
Fester Wert: 1
Vollständiges Schema als JSON
{
"type": "integer",
"const": 1
}application/json
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"
}Quelle & Metadaten
application/models/v2/Dunning.php:90updateDunning()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/Dunning.php",
"method": "updateDunning",
"line": 90
}x-edoobox-documentationStatus
"reviewed"x-edoobox-readOnly
falsex-edoobox-safeForAutomation
falsex-edoobox-permission
{
"resource": "dunning",
"short": "dunn",
"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_dunning_config",
"summary": "Mahnregeln und Aktivierung speichern",
"description": "Speichert enabled (ohne Angabe false) und ersetzt bei vorhandenem rules beide Regelgruppen vollständig. Regeln werden nach Tagen und sort_order sortiert; höchstens zehn je Kontext und keine Regel nach einer Stornierungsregel. Nicht-Mahngebühren werden auf 0 gesetzt; cancellation erhält keinen Versandweg. Regel-IDs dürfen nur aus dem eigenen Konto stammen; Regeln ohne passende ID werden angelegt.",
"tags": [
"dunning"
],
"security": [
{
"bearerAuth": [],
"accountContext": []
},
{
"sessionCookie": [],
"accountContext": []
}
],
"parameters": [
{
"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": "update=true und die gespeicherte Konfiguration.",
"content": {
"application/json": {
"example": {
"success": true,
"error": false,
"data": {
"update": true,
"config": {
"enabled": false,
"rules": {
"invoice": [],
"booking_without_invoice": []
},
"max_rules_per_context": 10,
"contexts": {
"invoice": {
"id": "invoice",
"name": ""
},
"booking_without_invoice": {
"id": "booking_without_invoice",
"name": ""
}
}
}
}
},
"schema": {
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"error": {
"type": [
"boolean",
"string"
]
},
"error_code": {
"type": "string"
},
"data": {
"type": "object",
"properties": {
"update": {
"type": "boolean"
},
"config": {
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
},
"rules": {
"type": "object",
"properties": {
"invoice": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^dunningrule_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"dunningrule_012345abcdef_123456"
]
},
"context": {
"type": "string",
"enum": [
"invoice",
"booking_without_invoice"
]
},
"days_without_payment": {
"type": "integer"
},
"name": {
"type": "string"
},
"name_translations": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"action": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"fee_amount": {
"type": "number"
},
"level": {
"type": "integer"
},
"delivery": {
"type": "string"
},
"email_template": {
"type": "integer"
},
"post_template": {
"type": "integer"
},
"active": {
"type": "boolean"
},
"status": {
"type": "integer"
},
"sort_order": {
"type": "integer"
}
},
"additionalProperties": true
}
},
"booking_without_invoice": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^dunningrule_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"dunningrule_012345abcdef_123456"
]
},
"context": {
"type": "string",
"enum": [
"invoice",
"booking_without_invoice"
]
},
"days_without_payment": {
"type": "integer"
},
"name": {
"type": "string"
},
"name_translations": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"action": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"fee_amount": {
"type": "number"
},
"level": {
"type": "integer"
},
"delivery": {
"type": "string"
},
"email_template": {
"type": "integer"
},
"post_template": {
"type": "integer"
},
"active": {
"type": "boolean"
},
"status": {
"type": "integer"
},
"sort_order": {
"type": "integer"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"max_rules_per_context": {
"const": 10
},
"contexts": {
"type": "object",
"properties": {
"invoice": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": true
},
"booking_without_invoice": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": true
}
},
"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": {
"enabled": {
"description": "boolValue: true/1 beziehungsweise 1,true,yes,y,on,aktiv,active aktivieren; Auslassung deaktiviert.",
"x-edoobox-canonicalType": "boolean"
},
"rules": {
"anyOf": [
{
"type": "object",
"properties": {
"invoice": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^dunningrule_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"dunningrule_012345abcdef_123456"
]
},
"context": {
"type": "string",
"enum": [
"invoice",
"booking_without_invoice"
]
},
"days_without_payment": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"name": {
"type": "string"
},
"name_translations": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"additionalProperties": true
}
]
}
},
{
"type": "string"
}
],
"description": "Sprachkürzel auf Text; alternativ JSON-Text oder einzelner Name in der Kontosprache."
},
"action": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"fee_amount": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "number"
},
"level": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"delivery": {
"type": "string"
},
"email_template": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"post_template": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"active": {
"description": "boolValue akzeptiert true, 1 und die Zeichenfolgen 1/true/yes/y/on/aktiv/active; sonst false. Ohne active/status standardmäßig true.",
"x-edoobox-canonicalType": "boolean"
},
"status": {
"description": "Alternative zu active; active hat Vorrang.",
"x-edoobox-canonicalType": "boolean"
},
"sort_order": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"action_type": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"delivery_type": {
"type": "string"
},
"dunning_level": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
}
},
"additionalProperties": true
}
},
"booking_without_invoice": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^dunningrule_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"dunningrule_012345abcdef_123456"
]
},
"context": {
"type": "string",
"enum": [
"invoice",
"booking_without_invoice"
]
},
"days_without_payment": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"name": {
"type": "string"
},
"name_translations": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"additionalProperties": true
}
]
}
},
{
"type": "string"
}
],
"description": "Sprachkürzel auf Text; alternativ JSON-Text oder einzelner Name in der Kontosprache."
},
"action": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"fee_amount": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "number"
},
"level": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"delivery": {
"type": "string"
},
"email_template": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"post_template": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"active": {
"description": "boolValue akzeptiert true, 1 und die Zeichenfolgen 1/true/yes/y/on/aktiv/active; sonst false. Ohne active/status standardmäßig true.",
"x-edoobox-canonicalType": "boolean"
},
"status": {
"description": "Alternative zu active; active hat Vorrang.",
"x-edoobox-canonicalType": "boolean"
},
"sort_order": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"action_type": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"delivery_type": {
"type": "string"
},
"dunning_level": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"pattern": "^dunningrule_[a-f0-9]{12}_-?[0-9]+$",
"description": "Öffentliche v2-ID aus diesem Konto; keine interne Datenbank-ID.",
"examples": [
"dunningrule_012345abcdef_123456"
]
},
"context": {
"type": "string",
"enum": [
"invoice",
"booking_without_invoice"
]
},
"days_without_payment": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"name": {
"type": "string"
},
"name_translations": {
"anyOf": [
{
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"additionalProperties": true
}
]
}
},
{
"type": "string"
}
],
"description": "Sprachkürzel auf Text; alternativ JSON-Text oder einzelner Name in der Kontosprache."
},
"action": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"fee_amount": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "number"
},
"level": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"delivery": {
"type": "string"
},
"email_template": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"post_template": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"active": {
"description": "boolValue akzeptiert true, 1 und die Zeichenfolgen 1/true/yes/y/on/aktiv/active; sonst false. Ohne active/status standardmäßig true.",
"x-edoobox-canonicalType": "boolean"
},
"status": {
"description": "Alternative zu active; active hat Vorrang.",
"x-edoobox-canonicalType": "boolean"
},
"sort_order": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
},
"action_type": {
"type": "string",
"enum": [
"reminder",
"dunning",
"cancellation"
]
},
"delivery_type": {
"type": "string"
},
"dunning_level": {
"description": "Wird serverseitig numerisch normalisiert; Tage, Stufe, Gebühr und Templatewerte werden mindestens 0. Standardwerte gelten bei Auslassung.",
"x-edoobox-canonicalType": "integer"
}
},
"additionalProperties": true
}
}
],
"description": "Vollständiger Ersatz beider Kontexte: fehlende Regeln/Kontexte werden entfernt. Alternativ Liste mit context je Regel (Standard invoice). Höchstens zehn je Kontext, nach cancellation darf keine spätere Regel folgen."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"examples": {
"request": {
"summary": "Mahnregeln und Aktivierung speichern",
"value": {
"data": {
"enabled": true,
"rules": {
"invoice": [
{
"days_without_payment": 7,
"action": "reminder",
"delivery": "email",
"level": 1,
"name_translations": {
"de": "Erste Zahlungserinnerung"
},
"active": true
}
],
"booking_without_invoice": []
}
}
}
}
}
}
}
},
"x-edoobox-runtimeMutationGuard": true,
"x-edoobox-documentationReview": {
"file": "docs/openapi/operation-contracts/04-accounting.json",
"notes": []
},
"x-edoobox-source": {
"file": "application/models/v2/Dunning.php",
"method": "updateDunning",
"line": 90
},
"x-edoobox-documentationStatus": "reviewed",
"x-edoobox-readOnly": false,
"x-edoobox-safeForAutomation": false,
"x-edoobox-permission": {
"resource": "dunning",
"short": "dunn",
"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."
}
}