Änderungen in Version v1.1.0
Übersicht
| Thema | Änderung | Zeile |
|---|---|---|
| Gegenstand der Änderung | Beschreibung & Begründung | Welcher Parameter ist betroffen? |
| Anpassung der Verantwortlichen | Die Liste der Verantwortlichen wurde aktualisiert, um die aktuellen Ansprechpartner und deren Rollen korrekt widerzuspiegeln. | Zeile 4 |
| Aktualisieren der API-Version | Aktualisieren der Version auf 1.1.0 | Zeile 10 |
| Nachtrag 2026-04-13 Anpassung der Bezeichnung eines Felds | Das Pflichtfeld für den Gesamtbetrag wurde von grosAmount in grossAmount umbenannt. | Zeile 230 - 237 |
| Anpassung des Datentyps für die Beschreibung des Payment Requests | Der Datentyp für die Beschreibung des Payment Requests wurde geändert, um die Verwendung von normativen Schriftzeichen gemäß DIN SPEC 91379 zu ermöglichen, was eine präzisere und konsistentere Darstellung der Daten gewährleistet. | Zeile 250 - 256 |
| Anpassung des Datentyps für die Beschreibung von PaymentItem | Der Datentyp für die Beschreibung von PaymentItem wurde überarbeitet, um die Datenintegrität zu verbessern, indem er die Schriftzeichen für Namen natürlicher Personen gemäß den hoheitlichen Dokumenten unterstützt. | Zeile 300 - 307 |
| Anpassung des Datentyps für den Namen des Anfragenden - DatatypeA | Der Datentyp für den Namen des Anfragenden wurde auf DatatypeA geändert, um die Schriftzeichen zu unterstützen, die in hoheitlichen Dokumenten für Namen natürlicher Personen verwendet werden, und somit eine einheitliche Struktur und Validierung zu gewährleisten. | Zeile 376 - 383 |
| Anpassung des Datentyps für den Vornamen des Anfragenden | Der Datentyp für den Vornamen des Anfragenden wurde angepasst, um die Eingabekonsistenz zu verbessern, indem er die normativen Schriftzeichen der DIN SPEC unterstützt. | Zeile 384 - 392 |
| Anpassung des Datentyps für den Organisationsnamen des Anfragenden | Der Datentyp für den Organisationsnamen des Anfragenden wurde geändert, um die Datenstruktur zu vereinheitlichen und die Validierung zu erleichtern, indem er die Schriftzeichen für juristische Personen und Produktnamen unterstützt. | Zeile 404 - 411 |
| Anpassung des Datentyps für die Straßenadresse | Der Datentyp für die Straßenadresse wurde angepasst, um die Genauigkeit und Konsistenz der Adressdaten zu verbessern, indem er die Schriftzeichen für sonstige Namen wie Orts- und Straßennamen unterstützt. | Zeile 419 - 426 |
| Anpassung des Datentyps für die Adresszeile | Der Datentyp für die Adresszeile wurde geändert, um die Flexibilität und Genauigkeit der Adressinformationen zu erhöhen, indem er die normativen Schriftzeichen der DIN SPEC unterstützt. | Zeile 434 - 445 |
| Anpassung des Datentyps für die Stadtadresse | Der Datentyp für die Stadtadresse wurde angepasst, um die Konsistenz und Validierung der Ortsangaben zu verbessern, indem er die Schriftzeichen für sonstige Namen wie Ortsnamen unterstützt. | Zeile 454 - 461 |
| Hinzufügen von Datentypdefinitionen | Neue Datentypdefinitionen wurden hinzugefügt, um die Struktur und Validierung der Daten zu verbessern, indem sie die normativen Schriftzeichen der DIN SPEC 91379 unterstützen und zukünftige Erweiterungen erleichtern. | Zeile 516 - 531 |
Details
Nachfolgend sind alle Änderung als Auszug aus der .yaml-Datei detailliert gelistet. Zusätzlich finden Sie unter jedem Auszug eine entsprechende Erklärung der veränderten Passage im Vergleich zur Vorgängerversion.
Zeile 4
description: '<h1>Standardisierte Schnittstelle für Bezahldienste im Portalverbund</h1> <p>Diese Seite enthält nur die Schnittstellenspezifikation im OpenAPI3 Format. Weitere Dokumentation zur Schnittstelle finden Sie im <a href="https://docs.fitko.de/xbezahldienste/">Entwicklungsportal der FITKO</a>.</p> <h2>Ansprechpartner</h2> <ul><li>Betrieb: Koordinierungsstelle für IT-Standards</li> <li>Federführung: Fred Kellermann (BMF Referat II E 2)</li> <li>Technischer Entwurf: Stefan Nowak (Capgemini im Auftrag des BMI)</li><li>Weiterentwicklung: Denny Hübner und Martin Köhn (Nortal im Auftrag der KoSIT)</li></ul>'
→ Änderung: Anpassung der Verantwortlichen
Zeile 10
version: 1.1.0
→ Änderung: Aktualisieren der API-Version
Zeile 230 - 237
grossAmount:
type: number
format: double
minimum: 0
maximum: 999999
exclusiveMinimum: true
example: 30.00
description: Der Gesamtbetrag dient dem Bezahldienst zur Validierung der einzelnen Positionen.
→ Änderung: Umbenennung des Pflichtfelds für den Gesamtbetrag von grosAmount zu grossAmount
Zeile 250 - 256
description:
allOf:
- $ref: "#/components/schemas/DatatypeC"
- minLength: 1
maxLength: 250
example: "Anträge für Antragsformulare"
description: N Die Beschreibung des Payment Requests. Kann auf der Paypage / PSP Seite angezeigt werden.
→ Änderung: Anpassung des Datentyps für die Beschreibung des Payment Requests
Zeile 300 - 307
description:
type: string
allOf:
- $ref: "#/components/schemas/DatatypeC"
- minLength: 1
- maxLength: 250
example: "XYZ22113-01 - Antrag auf Erteilung eines Antragsformulars"
description: Beschreibung der Position vom Online-Dienst zur Verwendung z. B. auf der Pay-Page.
→ Änderung: Anpassung des Datentyps für die Beschreibung von PaymentItem
Zeile 376 - 383
name:
type: string
allOf:
- $ref: "#/components/schemas/DatatypeA"
- minLength: 1
- maxLength: 250
example: "Mustermann"
description: Familienname des Bezahlers
→ Änderung: Anpassung des Datentyps für den Namen des Anfragenden - DatatypeA
Zeile 384 - 392
firstName:
type: string
allOf:
- $ref: "#/components/schemas/DatatypeA"
- minLength: 1
- maxLength: 250
pattern: '^[\w\d\s-,\.\u00C0-\u017F]+$'
example: "Max"
description: Vorname(n) des Bezahlers
→ Änderung: Anpassung des Datentyps für den Vornamen des Anfragenden
Zeile 404 - 411
organizationName:
type: string
allOf:
- $ref: "#/components/schemas/DatatypeD"
- minLength: 1
- maxLength: 250
example: "Bundesministerium der Finanzen"
description: "Soll nur existieren, wenn isOrganization == true"
→ Änderung: Anpassung des Datentyps für den Organisationsnamen des Anfragenden
Zeile 419 - 426
street:
type: string
allOf:
- $ref: "#/components/schemas/DatatypeB"
- minLength: 1
- maxLength: 250
example: "Wilhelmstraße"
description: Strasse
→ Änderung: Anpassung des Datentyps für die Straßenadresse
Zeile 434 - 445
addressLine:
type: array
minItems: 0
maxItems: 9
items:
type: string
allOf:
- $ref: "#/components/schemas/DatatypeB"
- minLength: 1
- maxLength: 250
example: ["Dienstsitz Berlin", "Postanschrift: 11016 Berlin"]
description: Zum Abbilden von Internationalen Adressen werden generische "Adresszeilen" verwendet und nicht "Straße / Hausnummer".
→ Änderung: Anpassung des Datentyps für die Adresszeile
Zeile 454 - 461
city:
type: string
allOf:
- $ref: "#/components/schemas/DatatypeB"
- minLength: 1
- maxLength: 250
example: "Berlin"
description: "Stadt"
→ Änderung: Anpassung des Datentyps für die Stadtadresse
Zeile 516 - 531
DatatypeA:
type: string
description: Der Datentyp A gibt wieder, welche Schriftzeichen in hoheitlichen Dokumenten für Namen natürlicher Personen verwendet werden.
pattern: '( |'|[,-\\.]|[A-\\Z]|[`-\\z]|~|¨|´|·|[À-\\Ö]|[Ø-\\ö]|[ø-\\ž]|[Ƈ-\\ƈ]|Ə|Ɨ|[Ơ-\\ơ]|[Ư-\\ư]|Ʒ|[Ǎ-\\ǜ]|[Ǟ-\\ǟ]|[Ǣ-\\ǰ]|[Ǵ-\\ǵ]|[Ǹ-\\ǿ]|[Ȓ-\\ȓ]|[Ș-\\ț]|[Ȟ-\\ȟ]|[ȧ-\\ȳ]|ə|ɨ|ʒ|[ʹ-\\ʺ]|[ʾ-\\ʿ]|ˈ|ˌ|[Ḃ-\\ḃ]|[Ḇ-\\ḇ]|[Ḋ-\\ḑ]|[Ḝ-\\ḫ]|[ḯ-\\ḷ]|[Ḻ-\\ḻ]|[Ṁ-\\ṉ]|[Ṓ-\\ṛ]|[Ṟ-\\ṣ]|[Ṫ-\\ṯ]|[Ẁ-\\ẇ]|[Ẍ-\\ẗ]|ẞ|[Ạ-\\ỹ]|’|‡|A̋|C(̀|̄|̆|̈|̕|̣|̦|̨̆)|D̂|F(̀|̄)|G̀|H(̄|̦|̱)|J(́|̌)|K(̀|̂|̄|̇|̕|̛|̦|͟H|͟h)|L(̂|̥|̥̄|̦)|M(̀|̂|̆|̐)|N(̂|̄|̆|̦)|P(̀|̄|̕|̣)|R(̆|̥|̥̄)|S(̀|̄|̛̄|̱)|T(̀|̄|̈|̕|̛)|U̇|Z(̀|̄|̆|̈|̧)|a̋|c(̀|̄|̆|̈|̕|̣|̦|̨̆)|d̂|f(̀|̄)|g̀|h(̄|̦)|j́|k(̀|̂|̄|̇|̕|̛|̦|͟h)|l(̂|̥|̥̄|̦)|m(̀|̂|̆|̐)|n(̂|̄|̆|̦)|p(̀|̄|̕|̣)|r(̆|̥|̥̄)|s(̀|̄|̛̄|̱)|t(̀|̄|̕|̛)|u̇|z(̀|̄|̆|̈|̧)|Ç̆|Û̄|ç̆|û̄|ÿ́|Č(̕|̣)|č(̕|̣)|Ī́|ī́|Ž(̦|̧)|ž(̦|̧)|Ḳ̄|ḳ̄|Ṣ̄|ṣ̄|Ṭ̄|ṭ̄|Ạ̈|ạ̈|Ọ̈|ọ̈|Ụ(̄|̈)|ụ(̄|̈))*'
DatatypeB:
type: string
description: Der Datentyp B wurde vor allem für sonstige Namen, wie z. B. Ortsnamen und Straßennamen mit Hausnummer, entworfen.
pattern: '([ -\\~]|[¡-\\£]|¥|[§-\\¬]|[®-\\·]|[¹-\\»]|[¿-\\ž]|[Ƈ-\\ƈ]|Ə|Ɨ|[Ơ-\\ơ]|[Ư-\\ư]|Ʒ|[Ǎ-\\ǜ]|[Ǟ-\\ǟ]|[Ǣ-\\ǰ]|[Ǵ-\\ǵ]|[Ǹ-\\ǿ]|[Ȓ-\\ȓ]|[Ș-\\ț]|[Ȟ-\\ȟ]|[ȧ-\\ȳ]|ə|ɨ|ʒ|[ʹ-\\ʺ]|[ʾ-\\ʿ]|ˈ|ˌ|[Ḃ-\\ḃ]|[Ḇ-\\ḇ]|[Ḋ-\\ḑ]|[Ḝ-\\ḫ]|[ḯ-\\ḷ]|[Ḻ-\\ḻ]|[Ṁ-\\ṉ]|[Ṓ-\\ṛ]|[Ṟ-\\ṣ]|[Ṫ-\\ṯ]|[Ẁ-\\ẇ]|[Ẍ-\\ẗ]|ẞ|[Ạ-\\ỹ]|’|‡|€|A̋|C(̀|̄|̆|̈|̕|̣|̦|̨̆)|D̂|F(̀|̄)|G̀|H(̄|̦|̱)|J(́|̌)|K(̀|̂|̄|̇|̕|̛|̦|͟H|͟h)|L(̂|̥|̥̄|̦)|M(̀|̂|̆|̐)|N(̂|̄|̆|̦)|P(̀|̄|̕|̣)|R(̆|̥|̥̄)|S(̀|̄|̛̄|̱)|T(̀|̄|̈|̕|̛)|U̇|Z(̀|̄|̆|̈|̧)|a̋|c(̀|̄|̆|̈|̕|̣|̦|̨̆)|d̂|f(̀|̄)|g̀|h(̄|̦)|j́|k(̀|̂|̄|̇|̕|̛|̦|͟h)|l(̂|̥|̥̄|̦)|m(̀|̂|̆|̐)|n(̂|̄|̆|̦)|p(̀|̄|̕|̣)|r(̆|̥|̥̄)|s(̀|̄|̛̄|̱)|t(̀|̄|̕|̛)|u̇|z(̀|̄|̆|̈|̧)|Ç̆|Û̄|ç̆|û̄|ÿ́|Č(̕|̣)|č(̕|̣)|Ī́|ī́|Ž(̦|̧)|ž(̦|̧)|Ḳ̄|ḳ̄|Ṣ̄|ṣ̄|Ṭ̄|ṭ̄|Ạ̈|ạ̈|Ọ̈|ọ̈|Ụ(̄|̈)|ụ(̄|̈))*'
DatatypeC:
type: string
description: Der Datentyp C wurde für alle normativen Schriftzeichen der DIN SPEC entworfen. Er ist somit die technische Umsetzung der Schnittstellenvereinbarung Alle nach DIN SPEC 91379 normativen Schriftzeichen. Texte mit griechischen oder kyrillischen Buchstaben oder mit erweiterten (nicht-normativen) Nicht-Buchstaben sind unzulässig.
pattern: '([	-\\
]|
|[ -\\~]|[ -\\¬]|[®-\\ž]|[Ƈ-\\ƈ]|Ə|Ɨ|[Ơ-\\ơ]|[Ư-\\ư]|Ʒ|[Ǎ-\\ǜ]|[Ǟ-\\ǟ]|[Ǣ-\\ǰ]|[Ǵ-\\ǵ]|[Ǹ-\\ǿ]|[Ȓ-\\ȓ]|[Ș-\\ț]|[Ȟ-\\ȟ]|[ȧ-\\ȳ]|ə|ɨ|ʒ|[ʹ-\\ʺ]|[ʾ-\\ʿ]|ˈ|ˌ|[Ḃ-\\ḃ]|[Ḇ-\\ḇ]|[Ḋ-\\ḑ]|[Ḝ-\\ḫ]|[ḯ-\\ḷ]|[Ḻ-\\ḻ]|[Ṁ-\\ṉ]|[Ṓ-\\ṛ]|[Ṟ-\\ṣ]|[Ṫ-\\ṯ]|[Ẁ-\\ẇ]|[Ẍ-\\ẗ]|ẞ|[Ạ-\\ỹ]|’|‡|€|A̋|C(̀|̄|̆|̈|̕|̣|̦|̨̆)|D̂|F(̀|̄)|G̀|H(̄|̦|̱)|J(́|̌)|K(̀|̂|̄|̇|̕|̛|̦|͟H|͟h)|L(̂|̥|̥̄|̦)|M(̀|̂|̆|̐)|N(̂|̄|̆|̦)|P(̀|̄|̕|̣)|R(̆|̥|̥̄)|S(̀|̄|̛̄|̱)|T(̀|̄|̈|̕|̛)|U̇|Z(̀|̄|̆|̈|̧)|a̋|c(̀|̄|̆|̈|̕|̣|̦|̨̆)|d̂|f(̀|̄)|g̀|h(̄|̦)|j́|k(̀|̂|̄|̇|̕|̛|̦|͟h)|l(̂|̥|̥̄|̦)|m(̀|̂|̆|̐)|n(̂|̄|̆|̦)|p(̀|̄|̕|̣)|r(̆|̥|̥̄)|s(̀|̄|̛̄|̱)|t(̀|̄|̕|̛)|u̇|z(̀|̄|̆|̈|̧)|Ç̆|Û̄|ç̆|û̄|ÿ́|Č(̕|̣)|č(̕|̣)|Ī́|ī́|Ž(̦|̧)|ž(̦|̧)|Ḳ̄|ḳ̄|Ṣ̄|ṣ̄|Ṭ̄|ṭ̄|Ạ̈|ạ̈|Ọ̈|ọ̈|Ụ(̄|̈)|ụ(̄|̈))*'
DatatypeD:
type: string
description: Der Datentyp D wurde vor allem für Namen juristischer Personen und für Produktnamen entworfen.
pattern: '([ -\\~]|[¡-\\¬]|[®-\\ž]|[Ƈ-\\ƈ]|Ə|ƒ|Ɨ|[Ơ-\\ơ]|[Ư-\\ư]|Ʒ|[Ǎ-\\ǜ]|[Ǟ-\\ǟ]|[Ǣ-\\ǰ]|[Ǵ-\\ǵ]|[Ǹ-\\ǿ]|[Ȓ-\\ȓ]|[Ș-\\ț]|[Ȟ-\\ȟ]|[ȧ-\\ȳ]|ə|ɨ|ʒ|ʰ|ʳ|[ʹ-\\ʺ]|[ʾ-\\ʿ]|ˆ|ˈ|ˌ|˜|ˢ|Ά|[Έ-\\Ί]|Ό|[Ύ-\\Ρ]|[Σ-\\ώ]|ᵈ|ᵗ|[Ḃ-\\ḃ]|[Ḇ-\\ḇ]|[Ḋ-\\ḑ]|[Ḝ-\\ḫ]|[ḯ-\\ḷ]|[Ḻ-\\ḻ]|[Ṁ-\\ṉ]|[Ṓ-\\ṛ]|[Ṟ-\\ṣ]|[Ṫ-\\ṯ]|[Ẁ-\\ẇ]|[Ẍ-\\ẗ]|ẞ|[Ạ-\\ỹ]|[‘-\\‚]|[“-\\„]|[†-\\‡]|…|‰|[‹-\\›]|⁰|[⁴-\\⁹]|[ⁿ-\\₉]|€|™|∞|[≤-\\≥]|A̋|C(̀|̄|̆|̈|̕|̣|̦|̨̆)|D̂|F(̀|̄)|G̀|H(̄|̦|̱)|J(́|̌)|K(̀|̂|̄|̇|̕|̛|̦|͟H|͟h)|L(̂|̥|̥̄|̦)|M(̀|̂|̆|̐)|N(̂|̄|̆|̦)|P(̀|̄|̕|̣)|R(̆|̥|̥̄)|S(̀|̄|̛̄|̱)|T(̀|̄|̈|̕|̛)|U̇|Z(̀|̄|̆|̈|̧)|a̋|c(̀|̄|̆|̈|̕|̣|̦|̨̆)|d̂|f(̀|̄)|g̀|h(̄|̦)|j́|k(̀|̂|̄|̇|̕|̛|̦|͟h)|l(̂|̥|̥̄|̦)|m(̀|̂|̆|̐)|n(̂|̄|̆|̦)|p(̀|̄|̕|̣)|r(̆|̥|̥̄)|s(̀|̄|̛̄|̱)|t(̀|̄|̕|̛)|u̇|z(̀|̄|̆|̈|̧)|Ç̆|Û̄|ç̆|û̄|ÿ́|Č(̕|̣)|č(̕|̣)|Ī́|ī́|Ž(̦|̧)|ž(̦|̧)|Ḳ̄|ḳ̄|Ṣ̄|ṣ̄|Ṭ̄|ṭ̄|Ạ̈|ạ̈|Ọ̈|ọ̈|Ụ(̄|̈)|ụ(̄|̈))*'
→ Änderung: Hinzufügen von Datentypdefinitionen