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.