INVOICE READER Header-Konfiguration
Merve Yurdakul
Übersicht
Alle headerspezifischen Einrichtungen sind hier aufgelistet. Die ValuePattern-Einstellungen sind elementare Regelwerke für die Kopfdatenfindung.
Header-Basiskonfiguration
/clarc/Resources/xControl/Reader/Invoice/Header/Configuration/[Default|Custom]
| Parameter | Datentyp | Beschreibung |
|---|---|---|
| AddressFieldSource | String | AdressFieldSource und AdressFieldTarget werden für die Debitorenerkennung eingesetzt. Über AdressFieldSource wird bestimmt, welches Element der Adressdaten gegebenenfalls über AdressFieldTarget entsprechend ersetzt wird. Dazu ein Beispiel: Angenommen für einen Debitor ist die Hermann-Müller-Straße eingepflegt. Auf dem Beleg hingegen wird die Hermann-Müller-Str. ausgewiesen. Die auf dem Beleg befindlichen Adressdaten werden mit den Stammdaten aus der Datenbank abgeglichen und gegebenenfalls normalisiert, d.h. Wörter wie „Straße“ werden entfernt, und über die im AdressFieldTarget definierten Zeichen ersetzt. Eine sprachspezifische Anpassung ist möglich. |
| AdressFieldTarget | String | Im AdressFieldTarget werden Zeichen wie z.B. Leerzeichen gespeichert, die nachher als Replacer für die Debitorenerkennung eingesetzt werden. |
| AmountTolerance | Double | Für den Netto- und Bruttoendbetrag kann ein gewisser Toleranzbetrag für Rundungsdifferenzen festgelegt werden. Bitte nicht mehr als 0,01 € angeben, da ansonsten Fehler bei der Berechnung auftreten können. |
ContentToSignReplacer | String | ContentToSignReplacer wird von dem Skript ChangeContentToSign verwendet, und fügt in das verknüpfte Feld das Zeichen „X“ ein, sobald ein gesondertes Lieferdatum wie z.B. Lieferdatum = Rechnungsdatum im Dokument erfasst wird. |
| CreditorIDMaxLengthLeadingZeros | Integer | Das ist ein Ganzzahlwert für die maximale Anzahl an führenden Nullen bei der Kreditor-ID. Das Feld wird für die interne Bearbeitung, Sortierung und dem Vergleich im System sowie in der Datenbank eingesetzt. Dazu ein Beispiel: Angenommen der Wert ist 5 und die ID des Kreditors ist eine „12“, dann wird die Kreditor-ID so in der Datenbank dargestellt „0000012“. CreditorIDMaxLengthLeadingZeros wird nur eingesetzt, wenn in der Datenbank auch führende Nullen angewendet werden. Die maximale Anzahl an führenden Nullen im System muss mit der Datenbank übereinstimmen. |
| CurrencyFieldReplacer | String | In CurrencyFieldReplacer sind Ersetzer definiert, welche den vollständigen Währungsnamen in die Kurzschreibweise umwandeln. Im Währungfeld steht dann ein dreistelliger Code wie z.B. CHF für Schweizer Franken. |
| DefaultCurrency | String | Im System kann eine feste Währung eingetragen werden, die verwendet wird falls die Standardlogik kein Ergebnis liefert. |
| DefaultTaxValue[1|2|3] | Double | Im Auslieferungszustand werden die Steuersätze (19 %, 7 %, 0 %) berücksichtigt. Individuelle Anpassungen sind jederzeit möglich. |
| FillTaxamount | Boolean | Die Steuerbetragsrechnung wird automatisch ausgeführt, wenn die Nettobeträge den Positionen eindeutig zugeordnet werden können und der Steuersatz erfasst wurde. |
| UseFindDebitorAboutSalesTaxIds | Boolean | Wenn der Wert von UseFindDebitorAboutSalesTaxIds auf True gesetzt, dann werden die Umsatzsteuer-Identifikationsnummer für die Debitorenerkennung herangezogen. |
| UseCountryCodeForTaxCheck | Boolean | Aus den Länderkürzeln werden die zugehörigen Steuerermittlungsregeln zugeordnet, wenn z.B. der Ländercode vom Kreditor und Debitor unterschiedlich ist. |
| UseCreditorSalesTaxIdDBCheck | Boolean | Um sicherzustellen, dass die aufgezeichnete Umsatz-Identifikationsnummer mit dem gesuchten Kreditor übereinstimmt, wird sie nochmals gegen die Datenbank geprüft, da auf einem Beleg mehrere Umsatzsteuer-Identifikationsnummer ausgewiesen werden können. |
| UseFirstDefaultTaxForNettoSumCheck | Boolean | Die Variante versucht den Nettobetrag anhand des gefundenen Bruttobetrags und der gefundenen Steuerschlüssel zu ermitteln. Ist UseFirstDefaultTaxForNettoSumCheck = True, wird bei der Endbetragsberechnung auch der erste Default-Parameter (TaxDefaultValue1 19%) dazu genommen, ansonsten werden ausschließlich die tatsächlich auf dem Beleg ermittelten Steuersätze herangezogen. |
| UseHeaderOrderNumberForDBMatching | Boolean | Die erfassten Bestellnummern des Debitors werden nochmals gegen die Datenbank geprüft. Der in der Datenbank hinterlegte Wert hat in so einem Fall Vorrang. |
| UseIBANDBCheck | Boolean | Die erfasste IBAN wird gegen die Datenbank geprüft. |
| UseZeroWhenTaxIsEmpty | Boolean | Falls kein Steuersatz gefunden wurde, wird der Steuerschlüssel1 auf 0 und der Steuerbetrag1 auf 0 anstatt auf "leer" gesetzt. |
Schlüsselwörter
/clarc/Resources/xControl/Reader/Invoice/Header/KeyWords/[Default|Custom]
| Parameter | Datentyp | Beschreibung |
|---|---|---|
| H_creditorsalestaxid | String | Schlüsselwörter für Umsatzsteuer-Identifikationsnummer des Kreditors wie zum Beispiel: Umsatzsteuer-ID, Tax Identification No, VAT-ID, Ust-IDNr. |
| H_creditortaxid | String | Schlüsselwörter für Steuernummern des Kreditors wie zum Beispiel: Steuernummer, Steuer Nr., StNr. |
| H_deldate | String | Schlüsselwörter für das Lieferdatum wie zum Beispiel: Einlief-Datum, Liefertermin, Performance Period, Ausführungszeit. |
| H_deldate_Sentences | String | Schlüsselwörter für das gesonderte Lieferdatum wie zum Beispiel Leistungsdatum = Lieferdatum |
| H_documentdate | String | Schlüsselwörter für das Rechnungsdatum wie zum Beispiel: Ausstellungsdatum, Invoice-Date, Belegdatum, Re-Datum |
| H_documenttype_Invoice | String | Schlüsselwörter für die Rechnungstyperkennung. |
| H_esr | String | Im ESR sind spezielle Begriffe hinterlegt, die auf ein ESR-Beleg hinweisen. Die ESR-Belege enthalten Zahlungsanweisungen, die ausschließlich für die Schweiz relevant sind. |
| H_grossamount | String | Schlüsselwörter für die Bruttobeträge wie zum Beispiel: Gesamtbetrag, Bruttosumme, Bruttobetrag, Zahlbetrag. |
| H_invoicenumber | String | Schlüsselwörter für die Rechnungsnummer wie zum Beispiel: Belegnummer, Rechnungsnummer, RE-NR, Gutschrift-Nr., Invoice Number. |
| H_invoivenumber_Begin | String | Beinhaltet beginnende Fragmente für Rechnungsnummern wie z.B. 45 |
| H_netamount | String | Schlüsselwörter für die Nettobeträge wie zum Beispiel: Rechnungsbetrag Netto, Betrag Netto, Gesamtwert ohne MwSt. |
| H_ordermumber | String | Schlüsselwörter für die Bestellnummer wie zum Beispiel: Bestell-Nr., Order No., Bestellanforderungs-Nr. |
| H_sinfo_recharge | String | Schlüsselwörter, die mit einem „X“ ersetzt werden, sofern diese auf dem Beleg auftreten. |
| H_taxrate | String | Schlüsselwörter für die Logik zur Erfassung von Steuerbeträgen. |
| H_taxrate_TopAddWords | String | Schlüsselwörter für Steuersatzerkennung. Wenn die Logik ein Schlüsselwort aufzeichnet, dann wird zusätzlich noch der Begriff ermittelt der eine Zeile darüber steht. Beispiel: MwSt % 19 In so einem Fall würde die Logik das Prozentzeichen und das Schlüsselwort "MwSt" berücksichtigen. |
| H_taxrate_IgnoreCase | Boolean | Berücksichtigt keine Groß- und Kleinschreibung bei den Steuerbetragsbegriffen, wenn der Wert auf True ist. |
| H_termsandconditionspages_Hidden | String | Enthält Begriffsdefinitionen für die Erfassung von Allgemeinen Geschäftsbedingungen. |
Stoppwörter
/clarc/Resources/xControl/Reader/Invoice/Header/StopWords/[Default|Custom]
| Parameter | Datentyp | Beschreibung |
|---|---|---|
| H_deldate | String | Stoppwörter für das Lieferdatum. |
| H_documentdate | String | Stoppwörter für das Rechnungsdatum. |
| H_documentdate_2ndRun | String | Ergäzende Stoppwörter für das Rechnungsdatum. Wenn die Logik im ersten Durchlauf kein Rechnungsdatum erfassen kann, dann wählt das System das neuste Datum in der Vergangenheit als Rechnungsdatum aus. |
| H_grossamount | String | Stoppwörter für die Bruttobeträge zum Beispiel: Nettobetrag |
| H_invoicenumber | String | Stoppwörter für die Rechnungsnummer zum Beispiel: Steuernummer |
| H_netamount | String | Stoppwörter für die Nettobeträge zum Beispiel: Bruttobetrag |
| H_ordernumber | String | Stoppwörter für die Bestellnummer zum Beispiel: Telefonnummer |
Patterns
/clarc/Resources/xControl/Reader/Invoice/Header/ValuePattern/[Default|Custom]
| Parameter | Datentyp | Beschreibung |
|---|---|---|
| H_creditoriban_Lang | String | Beginnfragmente der IBAN wie z.B. DE für Deutschland |
| H_currency1 | String | Pattern für die Erkennung der Währungszeichen |
| H_documenttype_CreditMemo | String | CreditMemo beinhaltet Definitionen, die sich auf die Erkennung von Gutschriften beziehen. |
| H_documenttype_Invoice | String | Enthält das Suchmuster für die Rechnungstypen. |
| H_taxrate | String | Enthält das Suchmuster für die Steuersätze. |
| H_taxrate_ElementNo | Integer | Festgesetztes internes Feld für die Zonenfindung im Suchmuster |
| H_email_ValidDomains | String | E-Mail Domains die eingefügt werden, sofern die E-Mail-Adressen im System gepflegt sind. |
| H_web_ParameterFragment | String | Fragmente für Parameter |
| H_web_ServerFragment | String | Fragmente für einer URL |
| H_web_ServerPortFragment | String | Fragmente für den Port |
| H_web_ValidEndsFragment | String | Fragmente für das Ende einer URL wie z.B. .com |