/collect/claim/new/
Übergabe einer offenen Forderung an das mediaFinanz Inkassosystem
Request Datentypen
- collectRequest
- collectDebtor
- collectAddress [PostalAddress/AlternateAddress]
- collectCommunication
- collectClaim
- collectInvoice [PrincipalClaim/DunningCosts]
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 minLength: 3 maxLength: 50 constraint: required |
example: "Weiße Breite 5" |
PostalCode | Postleitzahl | type: string minLength: 3 maxLength: 10 constraint: required |
example: "49084" |
City | Ort | type: string minLength: 3 maxLength: 50 constraint: required |
example: "Osnabrück" |
CountryCode | Länderkürzel nach ISO 3166-1 alpha-2 | type: string minLength: 2 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“ 98 = "Warenlieferung per Vorkasse" |
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" |