Import E-Origin

Beim E-Origin handelt es sich um webbasiert-erfasste Beglaubigungen, die die Kunden der Handelskammer eigenständig auf der Applikation von "Basel" vornehmen. Die Handelskammer (Bern) lädt periodisch die von "Basel" bereitgestellten Daten herunter und importiert sie in bossERP durch einen sog. Abgleich.

Fachliche Voraussetzungen

Folgende Voraussetzungen müssen zwingend erfüllt sein:

Auf E-Origin Datenbank

  • Die Adresse-Nr. auf der E-Origin-Datenbank muss der Adress-ID in bossERP
    entsprechen

  • Die Bezeichnung der Orschaft muss sowohl auf der E-Origin Datenbank als auch in bossERP identisch sein.

  • Die verwendeten Artikel müssen mit dem selben Kürzel auf der E-Origin-Datenbank erfasst sein. Im Moment sind dies die folgenden Artikel:

  • batt

  • bfra1

  • buz1

  • bfrauz

Bei den Artikel batt und bfrauz wird im Feld "Warenwert" standardmässig der Wert 1 geliefert. Bei der SOHK wird der Artikel bfrauz nicht verwendet.

In bossERP

  • Die Import-Schnittstelle muss freigeschalten sein
  • Für die erfassten Adressen muss ein Auftragsdossier mit der Bezeichnung "E-Origin" vorhanden sein.
  • Das Dossierdatum des "E-Origin"-Dossier muss im selben Jahr wie das Ausstellungsdatum im File liegen. D.h. entweder man macht für jedes Jahr ein neues "E-Origin" oder man ändert das Dossierdatum auf den 31.12.2009.
  • Analoges gilt für den Dossier-Endtermin: Er kann entweder fehlen (00.00.00) oder er muss nach dem Ausstellungsdatum sein. Beides ist irgendwie vernünftig. Es ist nun Sache von HIV, festzulegen, ob sie für jedes Jahr ein eigenes "E-Origin"-Dossier machen wollen, oder ob sie die Daten anpassen wollen.

Vorgehen Import E-Origin

  • Es handelt sich um einen Handelskammern-Prozess (Bestellungen von Beglaubigungen in Papierform), welcher
  • aufgrund des "Transfers in die Buchhaltung" und
  • nach der Wahl "Periode von - bis"
  • eine Text-Datei "CSVExportBuch_00.00.000.txt" erzeugt.
  • In bossERP: Dateien - Belege öffnen
  • Menüpunkt Datei - Import

  • und Wahl der Importdatei "CSVExportBuch_00.00.0000.txt".
  • Die Daten werden importiert und daraus Lieferscheine erzeugt.
  • Es ist zu beachten, dass die 4 E-Origin relevanten Artikel mit Folgeartikeln verbunden sind. Beim Import eines Artikels werden die Regeln der Folgeartikel überprüft und gemäss den Bedingungen werden Folgeartikel angehängt.
  • Ist der Import nicht möglich, werden Fehlermeldungen ausgegeben.

Technische Voraussetzungen

  • Grundsätzlich sind immer alle 34 Felder zu liefern, auch wenn sie leer bzw. fakultativ sind, d.h. das gelieferte Dokument enthält immer genau 34 Spalten.
  • Die Kopfzeile muss mitgeliefert werden (die Spalten- bzw. Feldtitel).
  • Identifizierung des Kunden / des Bestellers: Die erste Spalte (Feld "Kunden-ID") dient der Identifikation des HIV-Kunden (Bestellers).
  • Datensatztrenner CR/LF Ascii = 13/10
  • Feldtrenner Tab Ascii = 9
  • Datentypen:
  • Longint Ganzzahl (+/- 2'000'000'000)
  • Date Datum in der Form TT.MM.JJJJ (oder TT.MM.JJ)
  • Real reelle Zahl
  • Boolean, j, ja, w, wahr, true, 1 (=wahr; alle anderen Werte = falsch)
  • Text Text mit maximal 32'000 Zeichen
  • Das Datenfile heisst: "CSVExportBuch_00.00.000.txt", wobei 00.00.0000 das Tagesdatum des Files ist.

Feldspezifikation

Stand: September 2018

Spalte Feld Typ Bemerkungen
1 Kunden-ID longint zwingend Kunde = Besteller (Adress-ID in bossERP) Aus der gelieferten ID kann bossERP automatisch die Zuordnung zur Adresse und in ein bereits vorhandenes e-Origin-Dossier vornehmen.
2 Anrede (z.B. Frau, Herr) 20 zwingend Falls es sich um eine Personenadresse (sozusagen privat) handelt oder um eine Firmenadresse mit Kontaktperson.
3 Titel 20
4 Vorname 40
5 Nachname 40 zwingend
6 Briefanrede 80
7 Firma 1 50 zwingen Falls es sich um eine Firmenadresse handelt.
8 Firma 2 50
9 Adresszusatz 40
10 Strasse 40 Alle Angaben fakultativ; Strasse oder Postfach aber sehr sinnvoll.
11 Postfach 40
12 PLZ 15 faktultativ aber sinnvoll
13 Ort 50 zwingend
14 LKZ 10 entweder / oder z.B. CH, D usw.
15 Land 50
16 Sprache (ISO) 3 faktultativ Wenn nichts geliefert, gilt die Sprache auf der Kundenadresse.
17 Währung (ISO) 3 faktultativ z.B. CHF, USD (falls nichts geliefert -> CHF) Interne Bemerkungen (ERP)
18 Ausstellungsdatum date zwingend Zeilendatum
19 Beglaubigungs-Nr. 30 zwingend Der Beglaubigungsnummer wird ein Präfix angefügt:
Für die Handelskammer Bern: "BE/aktuelles Jahr/"
Für die Handelskammer Solothurn: kein Präfix		 Freies Feld 1
20 Beglaubigungsart 80 zwingend (Eindeutige Identifikation der Beglaubigungsart resp. Artikelkürzel) Zeilentext
21 Warenwert real zwingend Freie Zahl 22 = Menge
22 Bestimmungsort 80 faktultativ Freies Feld 2
23 Bestimmungsland 80 faktultativ Freies Feld 3
24 UZ-Online boolean faktultativ Als Standard wird der Wert 0 geliefert. Freies Boolsches Feld 61
25 Express boolean faktultativ Freies Boolsches Feld 65
26 E-Origin boolean faktultativ Als Standard wird der Wert 1 geliefert. Freies Boolsches Feld 62
27 Ursprungsländer text faktultativ Mehrere Länder getrennt mit "///" (drei Slashes) Freier Text 1
28 Anzahl Zusatzexempl. real faktultativ Bei der Handelskammer Solothurn immer 0 (null). Freie Zahl 21
29 Nachweis vorhanden boolean faktultativ Freies Boolsches Feld 64
30 Off. Bemerkung text faktultativ Allfällige Absätze getrennt mit "///" (drei Slashes) Freier Text 2
31 Bruttogewicht text faktultativ Artikelgewicht
32 Kundenreferenz text faktultativ Freies Feld 14
33 Antragsnummer text fakultativ Wenn diese Spalte unmittelbar aufeinander folgend denselben (nicht leeren) Inhalt hat, werden diese Beglaubigungen in denselben Beleg (Lieferschein) übernommen.
34 Porto boolean faktultativ Als Standard wird der Wert 0 geliefert. 0 = Kein Porto, 1 = Porto.

Beispiel

Besonderheiten

Falls die Spalte 33 (Auftragsnummer) im Importfile unmittelbar aufeinander folgend denselben (nicht leeren) Inhalt hat, werden diese Beglaubigungen in denselben Lieferschein übernommen.