Import von Papier- und Preisinformationen

Die Grundlage jeder Kalkulation sind korrekte Informationen insbesondere zu Verbrauchsmaterialen wie Papier. Da es zwischenzeitlich mehr Papiersorten als Käse in Frankreich gibt, kommt ein manueller Import dieser Daten nicht mehr in Frage. Aus diesem Grund haben wir ein Dateiformat entworfen, welches Papierinformationen und Preise enthält, die in Keyline importiert werden können.

Dateiformat

Für einen automatischen Import erwartet Keyline eine CSV Datei mit einem Aufbau wie im Folgenden beschrieben.

Der Datenaustausch durch den Import von Dateien ist eine Notlösung und entspricht nicht dem technischen Stand des 21. Jahrhunderts. Mittelfristig soll der Datenimport durch unsere REST-Schnittstellen erfolgen. Wenn Sie sich als Papierlieferant oder -hersteller für unsere API interessieren, nehmen Sie bitte Kontakt mit uns auf.

Aufbau der Tabelle

Jede Zeile der Tabelle ist in zwei Teile gegliedert:

  • Spalten die Informationen zum Papier enthalten (1 bis 14)
  • Spalten die Informationen zur Bestellung enthalten (Bestellnummer, Verkaufsmenger, Preis, Vorschnitt)

Bitte wiederholen Sie das gleiche Papier in mehreren Zeilen, wenn es das Papier in verschiedenen Verkaufsmengen gibt.

Wird ein Papier beispielsweise ungeriest geliefert (Verkaufsmenge 1), aber auch im 1000-Bogen Ries (Verkaufsmenge 1000), so gibt es für das Papier zwei Zeilen.
Die Spalten 1 bis 14 werden für beide Zeilen mit den identischen Papierdaten befüllt, während Spalten 15 bis 18 (Bestellnummer, Menge, Preis, Vorschnitt) dann für jede Verkaufsmenge jeweils unterschiedlich eingetragen wird. Wenn sich die Bestellnummern für die verschiedenen Mengen nicht unterscheiden, tragen Sie bitte die gleiche Bestellnummer wiederholt ein.

Dateiformat

Wie bereits erwähnt verarbeitet Keyline ausschließlich CSV Dateien (comma-separated values).

Beispiel CSV Datei herunterladen

Darüber hinaus gelten die folgenden Anforderungen an das Format der CSV Datei:

  • Die Datei muss mit Zeichensatz UTF-8 gespeichert werden.
  • Die Datei muss eine Headerzeile enthalten. Die genauen Spaltenbezeichnungen werden von Keyline jedoch nicht vorgegeben.
  • Als Spaltentrennzeichen müssen Semikolon (;) verwendet werden.
  • Ist in der untenstehenden Beschreibung für eine Spalte der Typ Fließkommazahl angegeben, so müssen die Werte dieser Spalte als Dezimaltrennzeichen einen Punkt (.) verwenden. Komma sind in diesen Spalten weder als Dezimaltrennzeichen noch als Tausendertrennzeichen erlaubt.
  • Ist in der untenstehenden Beschreibung für eine Spalte der Typ Ganzzahl angegeben, so dürfen die Werte dieser Spalte keinerlei Dezimaltrennzeichen oder Tausendertrennzeichen enthalten, sondern müssen ausschließlich Zahlen enthalten.
  • Ist eine Spalte in der untenstehenden Beschreibung als optional deklariert, so bedeutet das, dass diese Spalte leere Werte enthalten darf. Als optional markierte Spalten müssen aber dennoch in jedem Fall in der zu importierenden Datei enthalten sein.
    D.h. eine zu importierende Datei muss immer und in jedem Fall mindestens 17 Spalten enthalten.

Semantische Korrektheit

Keyline benötigt als Grundlage der Automatisierung eine solide Datenbasis. Diese Datenbasis muss semantisch sein, das heißt es muss technisch greifbar sein, welche Daten welche Bedeutung haben. Aus diesem Grund benötigen wir alle Informationen sauber und getrennt. Größen und Grammatur beispielsweise müssen in eigenen Spalten sein, Informationen die im Papiernamen enthalten sind können wir nicht extrahieren und sind hinderlich, da dadurch eine Filterung nach reinem Papiernamen unmöglich gemacht wird.

Spaltendefinition

Spaltenindex
1 Substratform Text Form des bedruckbaren Stoffes Erlaubte Werte: "sheet", "roll", "envelope", "piece"
2 Substratart Text Art des bedruckbaren Stoffes Erlaubte Werte: "paper", "carton", "plastic", "foil", "metal", "wood", "cloth"
3 Papiername Text Der Name des Papieres ohne weitere Informationen Beispiel: "MultiArt Silk"
4 Kategorie Text Die Produktkategorie des Papieres Beispiele: "Fotopapier", "Hochglanzpapier", "Matt"
5 Breite in mm Ganzzahl [mm] Die Breite des Papieres, bei Änderungen der Laufrichtung nicht (!) mit der Höhe tauschen Beispiel: 1000
6 Höhe in mm Ganzzahl [mm] Die Höhe des Papieres, bei Änderungen der Laufrichtung nicht (!) mit der Breite tauschen Beispiel: 700
7 Papierdicke in µm Ganzzahl [µm] Die Dicke des Papieres in Micrometern Beispiel: 150
8 Grammatur in g/m² Ganzzahl [g/m²] Die Grammatur des Papiers in Gramm pro Quadratmeter Beispiel: 150
9 Laufrichtung Text Die Laufrichtung des Papiers Erlaubte Werte: "Breitbahn", "Schmalbahn", "short", "long"
10 Oberflächenfarbe Text Die Farbe der Papieroberfläche Beispiele: "weiß", "elfenbein"
11 Oberflächenbeschaffenheit Text Die Art der Papieroberfläche Beispiele: "matt", "gestrichen", "glänzend", "elephantenhaut"
12 Umweltzertifizierung Text Die Art der Umweltzertifizierung des Papieres Erlaubte Werte: "FSC 30%", "FSC 50%", "FSC 70%", "FSC 80%", "FSC 100%", "FSC Mix Credit", "FSC Mix 30%", "FSC Mix 50%", "FSC Mix 70%", "FSC Mix 80%", "FSC Recycled Credit", "FSC Recycled 30%", "FSC Recycled 50%", "FSC Recycled 70%", "FSC Recycled 80%", "FSC Recycled 100%", "PEFC 70%", "PEFC 100%" oder leer
13 Farbsättigung Fließkommazahl [0..1] Die Farbsättigung als Prozentwert zwischen 0 und 1 Beispiel: 0.24 (für 24%)
14 Beschichtet Boolean Ja, wenn das Papier beschichtet ist Erlaubte Werte: j, y, n, 0, 1, coated, uncoated
15 Bestellnummer Text Die Bestellnummer des Papieres/der Verkaufseinheit Beispiel: "ABD938832"
16 Verkaufsmenge Ganzzahl Die Verkaufsmenge auf die sich die Preisangabe dieser Zeile bezieht Beispiele: 1, 1000
17 Preis der Verkaufsmenge Fließkommazahl Der Preis der Verkaufsmenge der vorangestellten Spalte in der Währung der Druckerei Beispiele: 0.3232, 1932.21
18 Vorgeschnitten Boolean Ja wenn das Papier bereits vor der Lieferung vorgeschnitten wird, ansonsten Nein Erlaubte Werte: j, y, n, 0, 1

Stand 80f073032d5c5b84c1f6977a54c05d6b823d7a85