SwissPost - AddressLabel_GenerateLabel
Ausführung: Cloud.Execute
 |
NotizZur einfacheren Handhabung können Sie diesen Service auch direkt aufrufen.
Informationen dazu finden Sie hier.
|
Beschreibung
Erstellt über das Digital Commerce API der Schweizerischen Post eine Addressetikette.
Der Service gibt als Antwort eine Etikette als Base64-codierte Grafik zurück. Sowohl
das Layout (A5/A6/A7) wie das Grafikformat (png, gif, ...) werden in den Eingabeparametern
spezifiziert. Die vollständige Spezfikation des zugrundeliegenden Services der Post
findet sich unter https://developer.post.ch/en/digital-commerce-api.
HINWEIS: Zur Verwendung dieses Services muss in der CIS-Konfiguration die Digital
Commerce API - User ID mit Passwort erfasst sein.
Argumente
|
Nr.
|
Argument
|
Datentyp
|
Format
|
Zwingend
|
Defaultvalue
|
Name
|
Beschreibung
|
|
1
|
AccountUserId
|
A
|
50
|
0
|
API-Account User ID
|
User ID zu einem Digital Commerce - Account der Schweizerischen Post. Muss in der
Konfiguration (OpaccStudio, BC98500) zusammen mit dem Passwort hinterlegt werden.
|
|
|
2
|
Language
|
A
|
2
|
0
|
EN
|
Sprache
|
Sprache in welcher der Service aufgerufen wird.
|
|
3
|
FrankingLicense
|
A
|
8
|
1
|
Frankierlizenz
|
Frankierlizenz
|
|
|
4
|
PpFranking
|
B
|
0
|
0
|
PP-Frankierung
|
Flag für PP-Frankierung (Siehe z.B. https://www.post.ch/de/briefe-versenden/frankieren-briefe/frankierloesungen-briefe/pp-frankierung)
|
|
|
5
|
SenderName
|
A
|
25
|
1
|
Absender Name
|
Absender Name
|
|
|
6
|
SenderLine2
|
A
|
25
|
0
|
Absender Zeile 2
|
Optionale 2. Adresszeile für Absender-Adresse
|
|
|
7
|
SenderStreet
|
A
|
25
|
1
|
Absender Strasse
|
Absender Strasse
|
|
|
8
|
SenderZip
|
A
|
6
|
1
|
Absender PLZ
|
Absender PLZ
|
|
|
9
|
SenderCity
|
A
|
25
|
1
|
Absender Ort
|
Absender Ort
|
|
|
10
|
SenderCountryCode
|
A
|
3
|
0
|
Absender Land
|
ISO-Ländercode des Absenders (zwei oder dreistellig)
|
|
|
11
|
SenderLogo
|
A
|
0
|
Absender-Logo
|
Absender-Logo, als Base64-codierter Byte-Array. Das Format des Logo muss GIF, PNG
oder JPG sein und darf maximal 50KB gross sein.
|
||
|
12
|
SenderLogoRotation
|
N
|
3.0
|
0
|
270
|
Absender-Logo Rotation
|
Drehung des Absender-Logos im Uhrzeigersinn.
|
|
13
|
SenderLogoAspectRatio
|
A
|
0
|
KEEP
|
Absender-Logo Seitenverhältnis
|
Seintenverhältnis (Breite zu Höhe) des Absender-Logos.
|
|
|
14
|
SenderLogoHorizontalAlign
|
A
|
0
|
WITH_CONTENT
|
Absender-Logo Horizontale Ausrichtung
|
Horizontale Ausrichtung des Absender-Logos.
|
|
|
15
|
SenderLogoVerticalAlign
|
A
|
0
|
MIDDLE
|
Absender-Logo Vertikale Ausrichtung
|
Vertikale Ausrichtung des Absender-Logos.
|
|
|
16
|
SenderDomicilePostOffice
|
A
|
35
|
0
|
Absender-Domizilpoststelle
|
Domizilpoststelle des Absenders
|
|
|
17
|
SenderPoBox
|
A
|
25
|
0
|
Absender Postfach
|
Absender Postfach
|
|
|
18
|
LabelLayout
|
A
|
2
|
1
|
Format der Etikette
|
Format der Etikette (A5, A6, ...)
|
|
|
19
|
AddressesToPrint
|
A
|
0
|
RECIPIENT_AND_CUSTOMER
|
Adressen drucken
|
Welche Adressen (Absender und/oder Empfänger-Adresse) sollen gedruckt werden.
|
|
|
20
|
LabelImageFileType
|
A
|
1
|
File-Typ der Etikette
|
File-Typ der Etikette (EPS, GIF, JPG, ...)
|
||
|
21
|
LabelImageResolution
|
N
|
3.0
|
0
|
300
|
Bildauflösung der Etikette
|
Bildauflösung der Etikette, in DPI gemäss Code-Tabelle AddressLabel_ImageResolution.
|
|
22
|
PrintPreview
|
B
|
0
|
0
|
Test-Druck
|
Test-Druck - Generiert keine Barcode und fügt "Specimen-Aufrduck hinzu".
|
|
|
23
|
ItemNumber
|
N
|
8.0
|
0
|
Sendungsnummer
|
Optionale Sendungsnummer. Falls leer, wird die Nummer automatisch von der Post vergeben.
8-stellige fortlaufende Nummer (die letzten 8 Stellen des Sendungscodes) zur eindeutigen
Identifikation einer Sendung. Darf sich bei Paketen innerhalb von 30 Tagen nicht wiederholen.
|
|
|
24
|
RecipientTitle
|
A
|
35
|
0
|
Empfänger Anrede
|
Empfänger Anrede
|
|
|
25
|
RecipientName
|
A
|
35
|
1
|
Empfänger Name
|
Name und Vorname oder Firmenname des Empfängers
|
|
|
26
|
RecipientLine2
|
A
|
35
|
0
|
Empfänger Zeile 2
|
Empfänger Zeile 2
|
|
|
27
|
RecipientLine3
|
A
|
35
|
0
|
Empfänger Zeile 3
|
Empfänger Zeile 3
|
|
|
28
|
RecipientStreet
|
A
|
35
|
0
|
Empfänger Strasse
|
Empfänger Strasse
|
|
|
29
|
RecipientHouseNo
|
A
|
10
|
0
|
Empfänger Haus-Nr.
|
Empfänger Haus-Nr.
|
|
|
30
|
RecipientPoBox
|
A
|
35
|
0
|
Empfänger Postfach
|
Empfänger Postfach
|
|
|
31
|
RecipientFloorNo
|
A
|
5
|
0
|
Empfänger Stockwerkbezeichnung
|
Empfänger Stockwerkbezeichnung
|
|
|
32
|
RecipientMailboxNo
|
N
|
10.0
|
0
|
Empfänger Briefkastennummer
|
Empfänger Briefkastennummer
|
|
|
33
|
RecipientZip
|
A
|
10
|
1
|
Empfänger Postleitzahl
|
Empfänger Postleitzahl
|
|
|
34
|
RecipientCity
|
A
|
35
|
1
|
Empfänger Ort
|
Empfänger Ort
|
|
|
35
|
RecipientCountryCode
|
A
|
3
|
0
|
Empfänger Land
|
ISO-Ländercode des Empfänger (zwei oder dreistellig)
|
|
|
36
|
RecipientPhone
|
A
|
20
|
0
|
Empfänger Telefonnummer
|
Telefonnummer (für Zustellanweisung 3213)
|
|
|
37
|
RecipientMobile
|
A
|
20
|
0
|
Empfänger Mobiletelefonnummer
|
Mobiletelefonnummer (für Zustellanweisung 3213)
|
|
|
38
|
RecipientEMail
|
A
|
160
|
0
|
Empfänger E-Mail-Adresse
|
Empfänger E-Mail-Adresse
|
|
|
39
|
ServiceCodes
|
A
|
50
|
1
|
Dienstleistungscodes (DLC)
|
Komma-getrennte Liste der Dienstleistungscodes (DLC) welche die Art der Sendung spezfizieren
(PostPac Priority, Signature, ...). Die verfügbaren Codes (Basis- und Zusatzleistungen)
sind in der Code-Tabelle (Delivery_ServiceCode) aufgelistet.
|
|
|
40
|
DeliveryDate
|
D
|
0
|
Lieferdatum
|
Lieferdatum für Zustellanweisung 3217
|
||
|
41
|
ParcelNo
|
N
|
2.0
|
0
|
Paket-Nummer
|
Paket-Nummer von Total (für Zustellanweisung 3218)
|
|
|
42
|
ParcelTotal
|
N
|
2.0
|
0
|
Anzahl Pakete
|
Anzahl Pakete (für Zustellanweisung 3218)
|
|
|
43
|
Weight
|
N
|
5.0
|
0
|
Gewicht (g)
|
Gewicht in Gramm
|
|
|
44
|
UnNumbers
|
A
|
0
|
UN-Nummern
|
Komma-getrennte Liste von UN-Nummern. Die UN-Nummern geben beim Zusatzservice LQ-Gefahrengut
an, um welche Art von Gefahrengut es sich handelt. Die UN-Nummern können maximal vierstellig
sein (0-9999).
|
||
|
45
|
CodAmount
|
N
|
5.2
|
0
|
Nachnahmebetrag (BLN)
|
Nachnahmebetrag für Diensleistung 'Beleglose Nachname (BLN)'.
|
|
|
46
|
CodQrReference
|
A
|
32
|
0
|
QR/ESR-Referenz (BLN)
|
QR-Referenz (ehem. ESR-Referenznummer) für Dienstleitung 'Beleglose Nachname (BLN)'.
|
Rückgabewerte
|
Nr.
|
Spalte
|
Datentyp
|
Format
|
OnDemand
|
Name
|
Beschreibung
|
|
1
|
IdentCode
|
A
|
50
|
0
|
Sendungs-Barcode
|
Sendungs-Barcode
|
|
2
|
ColorPrintRequired
|
B
|
0
|
Farbdruck
|
Zeigt an, ob generierter Adressträger schwarz-weiss oder
mehrfarbig ausgedruckt werden muss
|
|
|
3
|
WarningCode
|
A
|
5
|
0
|
Warnungscode
|
Warnungscode
|
|
4
|
WarningMessage
|
A
|
500
|
0
|
Warnung
|
Warnungsbeschreibung in der Sprache verfasst, in welcher die Anfrage ausgeführt wurde.
|
|
5
|
Label
|
A
|
0
|
Adressetikette
|
Adressetikette als Base64-codierte Grafik
|
|
|
6
|
LabelFileExtension
|
A
|
0
|
File Extension
|
Die dem Dateityp der Grafik entsprechende Dateiendung (*.jpg, *.png, ...).
|