This website uses Cookies to provide you with the best possible service. Please see our Privacy Policy for more information. Click the check box below to accept cookies. Then confirm with a click on "Save".  

/collect/claim/new/

Übergabe einer offenen Forderung an das mediaFinanz Inkassosystem

Request Datentypen

collectRequest ⬆️

Feld Beschreibung Feldeigenschaften mögliche Werte
ClientCustomerRefNo Referenznummer vom Gläubiger (d. h. deren Rechnungs- oder Kundennummer) type: string
maxLength: 40
constraint: optional		 example: "6910-2"
PartnerNo die von mediaFinanz für den Kooperationspartner vergebene Partner-ID type: integer
constraint: optional		 default: 0
AcceptanceDate Übernahmedatum der Forderung type: string
format: date-time
@deprecated		 example: "2024-03-17T12:15:00"
Stage Einstufung der Forderung in ein Aktenstadium (Status/Workflow) type: string
maxLength: 1
constraint: required		 "V" für vorgerichtlich
Debtor Schuldnerdaten type: object
constraint: required		 siehe collectDebtor
Claim Forderungsdaten type: object
constraint: required		 siehe collectClaim
Memo Interne Bemerkung zur Forderung für die mediaFinanz Sachbearbeitung type: string
maxLength: 200
constraint: optional		 example: "Nutzungsgebühr für den Monat Oktober 2022"

collectDebtor ⬆️

Feld Beschreibung Feldeigenschaften mögliche Werte
LegalForm Rechtsform, falls Schuldner Unternehmer type: string
constraint: optional		 "AG" = "Aktiengesellschaft"
"Einzelunternehmen" = "Einzelunternehmen"
"e.G." = "Eingetragene Genossenschaft"
"e.K." = "Eingetragener Kaufmann"
"e.V." = "Eingetragener Verein"
"GbR" = "Gesellschaft bürgerlichen Rechts"
"GmbH" = "Gesellschaft mit beschränkter Haftung"
"GmbH & Co KG" = "Gesellschaft mit beschränkter Haftung & Compagnie Kommanditgesellschaft"
"Inc." = Incorporated (us)"
"KG" = "Kommanditgesellschaft"
"KdöR" = "Körperschaft des öffentlichen Rechts"
"Ltd." = "Limited Company (britisch)"
"OHG" = "Offene Handelsgesellschaft"
"Stiftung" = "Stiftung"
"UG" = "Unternehmergesellschaft (haftungsbeschränkt)"
"UG & Co. KG" = "Unternehmergesellschaft (haftungsbeschränkt) & Compagnie Kommanditgesellschaft"
Company Name Unternehmen Schuldner type: string
maxLength: 60
constraint: required		 example: ""
PersonType Anredekategorie type: integer
constraint: Enum, required		 0 = "Unbekannt"
1 = "Herr"
2 = "Frau"
LastName Nachname Schuldner type: string
maxLength: 60
constraint: required		 example: "Mustermann"
FirstName Vorname Schuldner type: string
maxLength: 40
constraint: required		 example: "Max"
BirthDate Geburtsdatum Schuldner type: string
format: date [YYYY-mm-dd]
constraint: optional		 example: "2001-05-08"
PostalAddress Postalische Anschrift type: object
constraint: required		 siehe collectAddress
AlternateAddress Alternative Anschrift type: object
constraint: optional		 siehe collectAddress
Communications Kommunikationsmöglichkeiten wie Telefonummer oder Email-Adresse type: array of collectCommunication
constraint: required		 siehe collectCommunication

collectAddress [PostalAddress/AlternateAddress] ⬆️

Feld Beschreibung Feldeigenschaften mögliche Werte
Annex Zusatz/Anhang type: string
maxLength: 120
constraint: optional		 example: "bei Schmidt"
Street Straße und Hausnummer type: string
maxLength: 50
constraint: required		 example: "Weiße Breite 5"
PostalCode Postleitzahl type: string
maxLength: 10
constraint: required		 example: "49084"
City Ort type: string
maxLength: 50
constraint: required		 example: "Osnabrück"
CountryCode Länderkürzel nach ISO 3166-1 alpha-2 type: string
maxlength: 2
constraint: required		 Alle ISO 3166-1 alpha-2 Ländercodes (siehe www.iso.org, Stand: 2023-11-03)

Beispiele:

"DE" für Deutschland
"AT" für Österreich
Validity Gültigkeit der Adresse type: integer
constraint: required		 1 = 'gültig'
0 = 'ungültig'

collectCommunication ⬆️

Feld Beschreibung Feldeigenschaften mögliche Werte
Means Kommunikationsmittel type: integer
constraint: Enum, required		 1 = "E-Mail"
2 = "Telephone" *
3 = "Mobile Phone" *
4 = "Fax" *
5 = "Website"
* (Das entsprechende Feld Value muss führendes + oder 0 enthalten, darf keine Buchstaben enthalten)
Type Kommunikationstypen type: integer
constraint: Enum, required		 1 = "privat"
2 = "dienstlich"
Value Wert zu Kommunikationsweg type: string
maxLength: 60
constraint: required		 example: "0541 2029-100"
Validity Gültigkeit des Kommunikationsweges type: integer
constraint: required		 1 = 'gültig'
0 = 'ungültig'

collectClaim ⬆️

Feld Beschreibung Feldeigenschaften mögliche Werte
Amount Forderungs-Grundbetrag in EUR type: float
constraint: required		 example: 79.99
ContractDate Vertragsdatum bei laufenden Verträgen/wiederkehrenden Leistungen type: string
format: date [YYYY-mm-dd]
constraint: required		 example: "2022-01-06"
ContractualItemCatalogueNo Katalognummer Vertragsgegenstand
Sofern der Kataloggrund nicht eindeutig zutrifft, wählen Sie bitte "Dienstleistung" bzw. "Warenlieferung" aus. Bei Fragen hilft Ihnen gerne unsere Mandantenbetreuung weiter.		 type: string
constraint: Enum, required		 01 = “Anzeigen in Zeitungen u.a.“
02 = “Ärztliche oder zahnärztliche Leistung“
03 = “Bürgschaft“
04 = “Darlehensrückzahlung“
05 = “Dienstleistungsvertrag“
06 = “Frachtkosten“
07 = “Geschäftsbesorgung durch Selbständige“
08 = “Handwerkerleistung“
09 = “Heimunterbringung“
10 = “Hotelkosten“
11 = “Kaufvertrag“
12 = “Kontokorrentabrechnung“
13 = “Krankenhauskosten - Pflege/Behandlung -“
14 = “Lagerkosten“
15 = “Leasing/Mietkauf“
16 = “Lehrgangs-/Unterrichtskosten“
17 = “Miete für Geschäftsraum einschl. Nebenkosten“
18 = “Miete für Kraftfahrzeug“
19 = “Miete für Wohnraum einschl. Nebenkosten“
20 = “Mietnebenkosten - auch Renovierungskosten -“
21 = “Miete“
22 = “Mitgliedsbeitrag“
23 = “Pacht“
24 = “Rechtsanwalts-/Rechtsbeistandshonorar“
25 = “Rentenrückstände“
26 = “Reparaturleistung“
27 = “Rückgriff aus Versicherungsvertrag wegen Unfall/Vorfall“
28 = “Schadenersatz aus Vertrag“
29 = “Schadenersatz aus Unfall/Vorfall“
30 = “Scheck/Wechsel“
31 = “Scheck-/Wechselprovision (1/3 %)“
32 = “Scheck-/Wechselunkosten - Spesen/Protest -“
33 = “Schuldanerkenntnis“
34 = “Speditionskosten“
35 = “Tilgungs-/Zinsraten“
36 = “Überziehung des Bankkontos“
37 = “Ungerechtfertigte Bereicherung“
38 = “Unterhaltsrückstände“
39 = “Vergleich, außergerichtlicher“
40 = “Vermittlungs-/Maklerprovision“
41 = “Versicherungsprämie/-beitrag“
42 = “Versorgungsleistung - Strom, Wasser, Gas, Wärme -“
43 = “Warenlieferung/-en“
44 = “Werkvertrag/Werklieferungsvertrag“
45 = “Zeitungs-/Zeitschriftenbezug“
46 = “Zinsrückstände/Verzugszinsen“
47 = “Nicht eingehaltene Abnahmeverpflichtung/en“
48 = “Fahrgeld/erhöhtes Beförderungsentgelt für eine Fahrt ohne gültigen Fahrausweis“
49 = “Erhöhtes Beförderungsentgelt für eine Fahrt ohne gültigen Fahrausweis“
50 = “Inkassokosten für außergerichtlichen Vergleich/Abzahlungsvereinbarung“
53 = “Geschäftsgebühr gemäß § 40 VVG“
54 = “Rückzahlung von Handelsvertreterprovisionen“
55 = “Zahlung kassierter und nicht abgeführter Inkassogelder“
56 = “Unerlaubte Nutzung urheberrechtlich geschützter Werke aus dem Repertoire des Antragstellers“
57 = “Gesetzlicher Vergütungsanspruch nach § 27 UrhG“
58 = “Fällige Pauschale für die Einräumung urheberrechtlicher Nutzungsrechte“
59 = “Rückzahlung des Familiengründungsdarlehen“
60 = “Versorgungsleistung“
61 = “Wahlleistungen bei stationärer Behandlung“
62 = “Folgebeitrag zur Versicherung“
63 = “Zwischenbeitrag zur Versicherung“
64 = “Beitrag laut Versicherungsschein“
65 = “Nachtrag zur Versicherung“
66 = “Beitragsrückstand zur Versicherung“
67 = “Scheckrücklauf zur Versicherung“
68 = “Restforderung abzüglich Gutschriften“
69 = “Entgeltforderung gemäß Telekom-Rechnung“
70 = “Kindertagesstättenbeitrag“
71 = “Verzugsschaden (nicht anrechenbare RA-Kosten aus vorgerichtl. Tätigkeit)“
72 = “Rückzahlung aus grundpf. gesichertem Kreditvertrag/gleichgestelltem Darlehen n. Bausparkassengesetz“
73 = “Gesetzlicher Vergütungsanspruch nach § 54 UrhG“
74 = “Kreditkartenvertrag“
75 = “Reisevertrag“
76 = “Telekommunikationsleistungen“
77 = “Krankentransportkosten“
78 = “Tierärztliche Leistung“
79 = “Verpflegungskosten“
80 = “Rückgriff aus Bürgschaft oder Garantie“
81 = “Entschädigung des Sortenschutzinhabers für Nachbau“
82 = “Prämienzuschlag für Krankheitskostenversicherung wegen Nichtversicherung gemäß § 193 Abs. 4 VVG“
83 = “Prämienrückstand für Krankheitskostenversicherung gem. § 193 Abs. 6 VVG“
84 = “Säumniszuschlag für Prämienrückstand zur Krankheitskostenversicherung gem. § 193 Abs. 6 VVG“
90 = “Wohngeld/Hausgeld für Wohnungseigentümergemeinschaft“
95 = “Beiträge zur privaten Pflegeversicherung“
ContractualCondition Vertragliche Bedingung (Umstände des Vertragsschlusses) type: integer
constraint: Enum, required		 1 = "Forderungen über verkaufte Waren"
2 = "Forderung über erbrachte Leistungen"
3 = "Forderungen über per Vorkasse verkaufte Waren
OriginalCreatorName ursprünglicher Gläubiger (Firma, in dessen Namen die Forderung entstanden ist (bei Abtretung, Forderungsankauf); Firmenname type: string
maxLength: 100		 default: ""
Reason Forderungs-Leistungsbeschreibung (z.B. "1 x Siemens-Handy S55")
Wichtiger Hinweis: Hier sollte in Stichpunkten die tatsächlich erbrachte Leistung / verkaufte Ware aufgelistet werden		 type: string
maxLength: 200
constraint: required		 example: "Nutzungsgebühr für Auktionsportal"
PrincipalClaim Hauptforderung type: object
constraint: required		 siehe collectInvoice
Dunningcosts Mahnkosten type: object
constraint: required		 siehe collectInvoice

collectInvoice [PrincipalClaim/DunningCosts] ⬆️

Feld Beschreibung Feldeigenschaften mögliche Werte
Number Rechnungs- o. Kundennummer type: string
maxLength: 40
constraint: required		 example: "1086247"
Value Betrag in EUR type: float
constraint: required, PrincipalClaim.Value > 1.00		 example: 79.99
Date Datum, z.B. Rechnungs- o. Mahndatum type: string
format: date [YYYY-mm-dd]
constraint: required		 example: "2021-08-02"
Remark Bemerkung type: string
maxLength: 200
constraint: optional		 example: "Bemerkung zur Rechnung"