Post PLC WebService

Die Post-PLC-WebService Schnittstelle ist eine Versandschnittstelle zur österreichischen Post.

Die Abwicklung der Versendung erfolgt über das TaskCenter im Fenster "Verpackung & Versand".

Zusatzmodul erforderlich

Es wird das Modul "POLLEX-LC POST Schnittstelle (LC-POST)" benötigt.

Inhalt

Voraussetzungen

Das POLLEX-LC-Modul "POLLEX-LC POST Schnittstelle (LC-POST)" - Dieses wird über den TaskCenter-Lizenzschlüssel bereitgestellt.
TaskCenter ab Version 4.81.0.0
Ein Login des Kunden zum Postlabel Center. (PLC)

Fenster/Tabelle Versandarten

Damit der PostPLC-Service genutzt wird, muss der Typ "PostPLC" ausgewählt werden
Bei FTP-Server wird dir URL zum PLC-WebService eingetragen. Die Standard-Adresse ist: https://plc.post.at/Post.Webservice/ShippingService.svc/secure (wenn keine angegeben wurde, wird diese verwendet).
Die URL zum Test-Service ist: https://abn-plc.post.at/DataService/Post.Webservice/ShippingService.svc/secure.
FTP-Benutzer sowie FTP-Passwort sind erforderlich. Diese sind die selben Login Daten wie für die Anmeldung im Post Label Center.
Druckmethode "WebService" bedeutet, dass das vom WebService zurückgelieferte PDF gedruckt wird, andernfalls wird das eigene Etikett gedruckt, entweder über "Active Reports" oder Bartender.
Für die Generierung der Trackinglinks muss in der Spalte "Tracking-Link" der Wert "https://www.post.at/sv/sendungsdetails?snr=<Paketnummer>" eingetragen werden.
sPOST PLC Kontaktmailadresse: plc@post.at

Feld Export File - Eintrag z.B. 31;10;10;LAND_ISO;0

Das Feld Export File wird mit folgenden Werten befüllt:
- Wert 1: interner Steuerungscode und muss für POST PLC mit 31 hinterlegt werden.
- Wert 2: Produktcode der Post für die Versendung . Hier gibt es z.B. 10 Paket Österreich, 45 Paket Premium International, 01 EMS Österreich, 46 EMS International usw.
- Wert 3: Produktcode der Post für die Rücksendung. Selbe Codes wie oben möglich
- Wert 4: hier wird die Übersetzung der Ländercodes eingegeben, ist der Wert leer, dann wird der Ländercode aus dem Lieferschein verwendet, bei Eintrag "LAND_ISO" wird der ISO-Ländercode verwendet. Da auch die Post die ISO-Codes verwendet wird der Eintrag "LAND_ISO" empfohlen.
- Wert 5: steuert ob ein Rücksendelabel mitgedruckt wird oder nicht. Bei "1" wir dien Rücksendelabel erstellt, bei "0" nicht.

Versender

Die Daten des Versenders werden über die Kundennummer der OE des Dokuments (Lieferscheins) selektiert.
Über die Kundenprofilierung sind hier einige Vorgabewerte einzustellen.
Die benötigten Informationen sind im PostLabel Center abrufbar.

Schlüssel	Beschreibung	Beispiel
POST.AT AUFTRAGGEBER	Client ID = Debitorennummer	1000000001
POST.AT KUNDEN ID	orgUnitID = AbteilungsID = steht für eine KundenID	1393074 => 10012
POST.AT KUNDEN GUID	orgUnitGuid = Eindeutige GUID zur KundenID	8E822346-564D-4DB8-A377-4E1043DF064F
POST.AT PRODUKTCODE	DeliveryServiceThirdPartyID = Post ProduktCode (siehe Liste) Dies kann hier standardmäßig vorgegeben werden, kann aber je Sendung übersteuert werden	10
POST.AT ZUSATZCODE	Für Nachnahme wird der Featurecode aus der Kundenprofilierung ausgelesen. Wenn kein Featurecode vorgegeben wurde, wird "006" verwendet (=Nachnahme Österreich)	022

Beispiel

Lieferschein 4711 mit OE 10 → OE 10 hat die Kundennummer 21234 zugeordnet → Beim Kunden 21234 sind Adress- sowie Bankdaten hinterlegt.

Post Produkt Codes

ID	Bezeichnung	Anmerkung
28	Retourpaket	Nur mit Vertrag nutzbar
63	Retourpaket International	Nur mit Vertrag nutzbar
14	Premium light	Nur mit Vertrag nutzbar
30	Premium Select	Nur mit Vertrag nutzbar
12	Kleinpaket	Nur noch mit laufendem Vertrag nutzbar
65	Next Day	Nur mit Vertrag nutzbar
10	Paket Österreich
45	Paket Premium International
47	Combi-freight Österreich	Nur mit Vertrag nutzbar
49	Combi-freight International	Nur mit Vertrag nutzbar
31	Paket Premium Österreich B2B
01	Post Express Österreich
46	Post Express International
78	Päckchen M mit Sendungsverfolgung
70	Paket Plus Int. Outbound
69	Paket Light Int. non boxable Outbound
66	Retourpaket International Standard	Nur mit Vertrag nutzbar

Feature Codes

Nummer	Zusatzleistung	Value 1	Value 1 Datentyp	Value 2	Value 2 Datentyp	Value 3	Value 3 Datentyp	Value 4	Value 4 Datentyp
004	Zerbrechlich
006	Nachnahme	Betrag	Dezimalfeld	Währung (ISOCode, zB: EUR)	Text	Konto (IBAN, BIC und Holder mit Pipe getrennt)	Text	Zahlungsreferenz	Text
007	24-Stundenpaket
009	Post Rückschein (nicht mehr aktiv)
011	Wertsendung	Betrag	Dezimalfeld	Währung (ISOCode, zB: EUR)	Text
019	Zustellung bis 10 Uhr
022	Nachnahme international	Betrag	Dezimalfeld	Währung (ISOCode, zB: EUR)	Text	Konto (IBAN, BIC und Holder mit Pipe getrennt)	Text	Zahlungsreferenz	Text
024	Zerbrechlich international
027	Samstagszustellung
029	Post frei Verwendungsstelle
045	Persönlich
052	Wunsch-Postfiliale	Wunschfiliale	Zahlenfeld (FilialNummer) Branchkey*
053	Wunsch-Abholstation	Wunsch-Abholstation	Zahlenfeld (Abholstationsnummer) Branchkey*
054	Post Absenderinfo	E-Mail Adresse oder Telefonnummer	Text
061	Keine Teillieferung
062	Palette
063	Höherversicherung	Betrag	Dezimalfeld	Währung (ISOCode, zB: EUR)	Text
065	Postlagernd	Postfiliale	Zahlenfeld (FilialNummer) Branchkey*
066	Postfach	Wunschfiliale	Zahlenfeld (FilialNummer) Branchkey*	Postfach	Text
071	Paket international schnell
072	Post Lagerfrist kurz
074	Gefahrgut begrenzte Menge
081	Mehrwegbox klein
082	Mehrwegbox mittel
083	Mehrwegbox groß
116	Fresh
117	Spätzustellung
122	Wunsch-Nachbar	Name	Text	Straße & Hausnummer	Text
123	Wunsch-Abstellung	Abstellort	Text
142	Sofortretoure

Methode: Create Shipment

XML

Beispiel

XML

	<ShipmentRow>
		<ClientID>-1</ClientID>
		<ColloList>
			<ColloRow>
				<Weight>17</Weight>
			</ColloRow>
			<ColloRow>
				<Weight>5</Weight>
			</ColloRow>
		</ColloList>
		<CustomDataBit1>false</CustomDataBit1>
		<DeliveryServiceThirdPartyID>10</DeliveryServiceThirdPartyID>
		<OURecipientAddress>
			<AddressLine1>Teststrasse</AddressLine1>
			<AddressLine2/>
			<City>Wien</City>
			<CountryID>AT</CountryID>
			<Email/>
			<HouseNumber>1</HouseNumber>
			<Name1>Test Recipient</Name1>
			<PostalCode>1030</PostalCode>
		</OURecipientAddress>
		<OUShipperAddress>
			<AddressLine1>Mustergasse</AddressLine1>
			<City>Wien</City>
			<CountryID>AT</CountryID>
			<Name1>test & test</Name1>
			<Name2/>
			<PostalCode>1010</PostalCode>
		</OUShipperAddress>
		<OrgUnitGuid>cd96848d-6552-4653-a992-f0f411710fb4</OrgUnitGuid>
		<OrgUnitID>1461448</OrgUnitID>
		<PrinterObject>
			<LabelFormatID>100x200</LabelFormatID>
			<LanguageID>pdf</LanguageID>
			<PaperLayoutID>2xA5inA4</PaperLayoutID>
		</PrinterObject>
	</ShipmentRow>

XML

<ShipmentRow>
    <!--Optional:alternative Rücksendeadresse-->
    <AlternativeReturnOrgUnitAddress>
        <!--Optional:-->
        <AddressLine1>?</AddressLine1>
        <!--Optional:-->
        <AddressLine2>?</AddressLine2>
        <!--Optional:-->
        <City>?</City>
        <!--Optional:-->
        <CountryID>?</CountryID>
        <!--Optional:-->
        <EORINumber>?</EORINumber>
        <!--Optional:-->
        <Email>?</Email>
        <!--Optional:-->
        <Fax>?</Fax>
        <!--Optional:-->
        <Homepage>?</Homepage>
        <!--Optional:-->
        <HouseNumber>?</HouseNumber>
        <!--Optional:-->
        <Name1>?</Name1>
        <!--Optional:-->
        <Name2>?</Name2>
        <!--Optional:-->
        <Name3>?</Name3>
        <!--Optional:-->
        <Name4>?</Name4>
        <!--Optional:-->
        <PersonalTaxNumber>?</PersonalTaxNumber>
        <!--Optional:-->
        <PostalCode>?</PostalCode>
        <!--Optional:-->
        <ProvinceCode>?</ProvinceCode>
        <!--Optional:-->
        <Tel1>?</Tel1>
        <!--Optional:-->
        <Tel2>?</Tel2>
        <!--Optional:-->
        <ThirdPartyID>?</ThirdPartyID>
        <!--Optional:-->
        <VATID>?</VATID>
    </AlternativeReturnOrgUnitAddress>
    <!--Optional:Dokumentenarten die vom Absender angefordert werden zb bei Zollinformationen-->
    <BusinessDocumentEntryList>
        <!--Zero or more repetitions:-->
        <arr:string>?</arr:string>
    </BusinessDocumentEntryList>
    <!--Optional:-->
    <ClientID>?</ClientID>
    <!--Optional:-->
    <ColloList>
        <!--Zero or more repetitions:-->
        <ColloRow>
            <!--Optional:-->
            <ColloArticleList>
                <!--Zero or more repetitions:-->
                <ColloArticleRow>
                    <!--Optional:-->
                    <ArticleName>?</ArticleName>
                    <!--Optional:-->
                    <ArticleNumber>?</ArticleNumber>
                    <!--Optional:-->
                    <ConsumerUnitNetWeight>?</ConsumerUnitNetWeight>
                    <!--Optional:-->
                    <CountryOfOriginID>?</CountryOfOriginID>
                    <!--Optional:-->
                    <CurrencyID>?</CurrencyID>
                    <!--Optional:-->
                    <CustomsOptionID>?</CustomsOptionID>
                    <!--Optional:-->
                    <HSTariffNumber>?</HSTariffNumber>
                    <!--Optional:-->
                    <Quantity>?</Quantity>
                    <!--Optional:-->
                    <UnitID>?</UnitID>
                    <!--Optional:-->
                    <ValueOfGoodsPerUnit>?</ValueOfGoodsPerUnit>
                </ColloArticleRow>
            </ColloArticleList>
            <!--Optional:-->
            <ColloCodeList>
                <!--Zero or more repetitions:-->
                <ColloCodeRow>
                    <!--Optional:-->
                    <Code>?</Code>
                    <!--Optional:-->
                    <NumberTypeID>?</NumberTypeID>
                    <!--Optional:-->
                    <OUCarrierThirdPartyID>?</OUCarrierThirdPartyID>
                </ColloCodeRow>
            </ColloCodeList>
            <!--Optional:-->
            <Height>?</Height>
            <!--Optional:-->
            <Length>?</Length>
            <!--Optional:-->
            <Weight>?</Weight>
            <!--Optional:-->
            <Width>?</Width>
        </ColloRow>
    </ColloList>
    <!--Optional:-->
    <CostCenterThirdPartyID>?</CostCenterThirdPartyID>
    <!--Optional:-->
    <CustomDataBit1>?</CustomDataBit1>
    <!--Optional:-->
    <CustomDataBit2>?</CustomDataBit2>
    <!--Optional:-->
    <CustomsDescription>?</CustomsDescription>
    <!--Optional:-->
    <DeliveryInstruction>?</DeliveryInstruction>
    <!--Optional:-->
    <DeliveryServiceThirdPartyID>?</DeliveryServiceThirdPartyID>
    <!--Optional:-->
    <FeatureList>
        <!--Zero or more repetitions:-->
        <AdditionalInformationRow>
            <!--Optional:-->
            <ThirdPartyID>?</ThirdPartyID>
            <!--Optional:-->
            <Value1>?</Value1>
            <!--Optional:-->
            <Value2>?</Value2>
            <!--Optional:-->
            <Value3>?</Value3>
            <!--Optional:-->
            <Value4>?</Value4>
        </AdditionalInformationRow>
    </FeatureList>
    <!--Optional:-->
    <MovementReferenceNumber>?</MovementReferenceNumber>
    <!--Optional:-->
    <Number>?</Number>
    <!--Optional:Empfängeradresse-->
    <OURecipientAddress>
        <!--Optional:-->
        <AddressLine1>?</AddressLine1>
        <!--Optional:-->
        <AddressLine2>?</AddressLine2>
        <!--Optional:-->
        <City>?</City>
        <!--Optional:-->
        <CountryID>?</CountryID>
        <!--Optional:-->
        <EORINumber>?</EORINumber>
        <!--Optional:-->
        <Email>?</Email>
        <!--Optional:-->
        <Fax>?</Fax>
        <!--Optional:-->
        <Homepage>?</Homepage>
        <!--Optional:-->
        <HouseNumber>?</HouseNumber>
        <!--Optional:-->
        <Name1>?</Name1>
        <!--Optional:-->
        <Name2>?</Name2>
        <!--Optional:-->
        <Name3>?</Name3>
        <!--Optional:-->
        <Name4>?</Name4>
        <!--Optional:-->
        <PersonalTaxNumber>?</PersonalTaxNumber>
        <!--Optional:-->
        <PostalCode>?</PostalCode>
        <!--Optional:-->
        <ProvinceCode>?</ProvinceCode>
        <!--Optional:-->
        <Tel1>?</Tel1>
        <!--Optional:-->
        <Tel2>?</Tel2>
        <!--Optional:-->
        <ThirdPartyID>?</ThirdPartyID>
        <!--Optional:-->
        <VATID>?</VATID>
    </OURecipientAddress>
    <!--Optional:Absenderadresse-->
    <OUShipperAddress>
        <!--Optional:-->
        <AddressLine1>?</AddressLine1>
        <!--Optional:-->
        <AddressLine2>?</AddressLine2>
        <!--Optional:-->
        <City>?</City>
        <!--Optional:-->
        <CountryID>?</CountryID>
        <!--Optional:-->
        <EORINumber>?</EORINumber>
        <!--Optional:-->
        <Email>?</Email>
        <!--Optional:-->
        <Fax>?</Fax>
        <!--Optional:-->
        <Homepage>?</Homepage>
        <!--Optional:-->
        <HouseNumber>?</HouseNumber>
        <!--Optional:-->
        <Name1>?</Name1>
        <!--Optional:-->
        <Name2>?</Name2>
        <!--Optional:-->
        <Name3>?</Name3>
        <!--Optional:-->
        <Name4>?</Name4>
        <!--Optional:-->
        <PersonalTaxNumber>?</PersonalTaxNumber>
        <!--Optional:-->
        <PostalCode>?</PostalCode>
        <!--Optional:-->
        <ProvinceCode>?</ProvinceCode>
        <!--Optional:-->
        <Tel1>?</Tel1>
        <!--Optional:-->
        <Tel2>?</Tel2>
        <!--Optional:-->
        <ThirdPartyID>?</ThirdPartyID>
        <!--Optional:-->
        <VATID>?</VATID>
    </OUShipperAddress>
    <!--Optional:-->
    <OUShipperReference1>?</OUShipperReference1>
    <!--Optional:-->
    <OUShipperReference2>?</OUShipperReference2>
    <!--Optional:-->
    <OrgUnitGuid>?</OrgUnitGuid>
    <!--Optional:-->
    <OrgUnitID>?</OrgUnitID>
    <!--Optional:Druckereinstellungen-->
    <PrinterObject>
        <!--Optional:encoding für zpl2-druck: UTF-8 (standard) oder WINDOWS-1252-->
        <Encoding>?</Encoding>
        <!--Optional:Etikettengröße 100x150 oder 100x200-->
        <LabelFormatID>?</LabelFormatID>
        <!--Optional:PDF oder ZPL2-->
        <LanguageID>?</LanguageID>
        <!--Optional:papierlayout für pdf-druck: 2xA5inA4 oder 4xA6inA4 oder A4"-->
        <PaperLayoutID>?</PaperLayoutID>
    </PrinterObject>
    <!--Optional:-->
    <ReturnDays>?</ReturnDays>
    <!--Optional:-->
    <ReturnModeID>?</ReturnModeID>
    <!--Optional:-->
    <ReturnOptionID>?</ReturnOptionID>
    <!--Optional:-->
    <ShipmentDocumentEntryList>
        <!--Zero or more repetitions:Dokumente die der Sendung beiliegen zB eine Rechnung-->
        <core:ShipmentDocumentEntry ser:Id="?" ser:Ref="?">
            <!--Optional:-->
            <core:DocumentID>?</core:DocumentID>
            <!--Optional:-->
            <core:ID>?</core:ID>
            <!--Optional:-->
            <core:Number>?</core:Number>
            <!--Optional:-->
            <core:Quantity>?</core:Quantity>
            <!--Optional:-->
            <core:ShipmentID>?</core:ShipmentID>
        </core:ShipmentDocumentEntry>
    </ShipmentDocumentEntryList>
    <!--Optional:-->
    <ShippingDateTimeFrom>?</ShippingDateTimeFrom>
    <!--Optional:-->
    <ShippingDateTimeTo>?</ShippingDateTimeTo>
</ShipmentRow>