Einschränkungen bei der Entwicklung von Gläubigersoftware für eschkg Development Restrictions for Creditors

Transkript

1 Einschränkungen bei der Entwicklung von Gläubigersoftware für eschkg Development Restrictions for Creditors Edition: June 12, 2012 Zweck Dieses Dokument richtet sich an Entwickler von Gläubigersoftware für eschkg Ver. 1.1 Nach der Einführung von eschkg 1.1 bei über 550 Betreibungsämtern wurden gelegentlich Probleme bei der Entgegennahme oder Verarbeitung der von Gläubigern angelieferten Daten festgestellt. Dies, obwohl die Daten unter Einhaltung der eschkg Spezifikation erstellt worden waren. Wie sich herausgestellt hat, sind gewisse Vorgaben in der eschkg Spezifikation nicht in allen Ämtern (und nicht bei allen SW-Produkten, die dort eingesetzt werden) vollumfänglich mit der gelebten Betreibungspraxis verträglich. Die nachfolgende Liste enthält Angaben zu den Einschränkungen, die ein Gläubiger bei der Entwicklung von eschkg Software berücksichtigen sollte. Die Einschränkungen ersparen dem Gläubiger und den Ämtern eine Menge Zeit und Ärger bei der Fehlersuche. Purpose This document is addressed to the developers of eschkg-aware creditor applications (version 1.1). After the introduction of eschkg, a number of issues have popped up related to the processing of eschkg data that creditors have sent, even if the was fully compliant with the standards. As the analysis shows, a number of prescriptions and rules made in the specifications are incompatible with either the software installation or the daily business at the office. If you are a developer of creditor applications, you will find the following list of restrictions useful when writing your software. If you take them seriously into account, it will certainly save you a lot of worries. 1

2 Personen und Adressen / Particulars and Addresses ID 1-1 persontype/lastname persontype/firstnames maxlen=45 Namensfelder sind auf 45 Zeichen zu beschränken. Names must not exceed 45 characters. ID 1-2 addresstype/street1 addresstype/street2 addresstype/city maxlen=30 Strassen- und Ortsnamen sind auf 30 Zeichen zu beschränken. Street names and city names must not exceed 30 characters. Betreibungs- und Finanzdaten / Collection and Payment ID 2-1 paymenttype/bank/name maxlen=60 Die Bezeichnung der Bank ist auf 60 Zeichen zu beschränken. The name of the bank must not exceed 60 characters. ID 2-2 paymenttype/bank/bc ["0" "1" "2" "3" "4" "5" "6" "7" "8" "9"]* (numeric string) Die Clearingnummer der Bank muss in einen Integer umgewandelt werden können, daher sind keine Zeichen ausser Ziffern erlaubt The clearing number string must be composed of numbers only, as it will be converted into an int. 2

3 ID Die Identifikationsnummern für Schuldner und Mitbetriebene, die vom Gläubiger angeliefert werden, müssen eindeutig sein, d.h. es dürfen keine gleichen Nummern für verschiedene Personen verwendet werden. The identifiers of the debtor and associates as provided by the creditor must be unique, i.e. different persons must always be assigned different identifiers. ID 2-4 paymenttype/bank/iban paymenttype/bank/account paymenttype/post/iban maxlen=35 Kontoangaben sind auf 35 Zeichen zu beschränken Account numbers must not exceed 35 characters ID 2-5 paymenttype/bank/esr paymenttype/post/esr maxlen=27 Die ESR-Referenznummer ist auf 27 Zeichen zu beschränken The ESR number must not exceed 27 characters ID 2-6 requesttype/claims/claim minocc=1, maxocc=unbounded minocc=1, maxocc=5 In der Praxis dürfen nicht mehr als 5 Forderungen pro Begehren eingegeben werden. Viele Ämter sind nicht in der Lage, mehr als 5 Forderungen auf dem Zahlungsbefehl zu drucken. Einige Ämter verwehren darum die Bearbeitung. Do not provide more than 5 claims per request. Most offices are unable to print summon documents with more than 5 claims. Some of the offices would even reject the creditor's request. 3

4 ID 2-7 claimtype/reason 1. Instanz von claimtype/reason: maxlen= bis 5. Instanz von claimtype/reason: maxlen=80 ( 45 is recommended) Der 1. Forderungsgrund darf 340 Zeichen lang sein (LEERSCHLÄGE eingeschlossen). Der 2. bis 5. darf 80 Zeichen keinesfalls überschreiten. Noch besser ist, wenn 45 Zeichen nicht überschritten werden, weil dann definitiv alle Ämter damit zurecht kommen. The reason text of the first claim instance must not exceed 340 characters, including space. The text of the other claims, second to fifth, must not exceed 80 characters; 45 characters is even better, as this means that any office can handle the data. ID 2-8 Alle Elemente des Typs xs:date xs:date ohne Einschränkung im Schema / without restriction in the schema Nur Datumsangaben ohne Zeitzonenzusatz / date must not contain the time zone Die Angabe einer Zeitzone ist nicht zugelassen. Providing time zone information is not allowed. <anydate> z</anydate> WRONG <anydate> :00</anydate> WRONG <anydate> </anydate> CORRECT Identifikationen und Referenznummern / Identifers and Reference Numbers ID 3-1 ["0" "1" "2" "3" "4" "5" "6" "7" "8" "9"]* (numeric string) maxlen=10 Die Beschränkung stammt aus früheren elektronischen Schnittstellen zwischen Gläubigern und Betreibungsämtern. Viele Ämter können noch nicht mit Personen-IDs umgehen, die nicht rein numerisch und länger als 10 Zeichen sind. Some offices have used electronic interfaces with creditors before. Because of the interface technology, identifiers must not exceed 10 digits and they must be purely numeric. ID 3-2 document/messages/../senderrefdata maxlen=30 Die Fallreferenz des Gläubigers darf 30 Zeichen nicht überschreiten. senderrefdata must not exceed 30 characters. 4

5 ID 3-3 minocc=0, maxocc=1 minocc=1, maxocc=1 Die Identifikationsnummer des Schuldners und ggf. von Mitbetriebenen angeliefert werden. The debtor's identification number (as well as the associate's) SHALL be provided. ID document/messages/sr/casenumber casenumber erst verwenden, wenn das Betreibungsamt senderrefdata kennt. Do not use casenumber unless the office is aware of the appropriate senderrefdata. Die SR Meldung darf nicht die erste eschkg Meldung in einem Betreibungsfall sein. Man muss zuvor die CR Nachricht verwendet haben. Do not use SR as the first eschkg message to the office. You MUST have used CR before. 5