FAQ

Wenn ein aktuell gespeichertes Produkt nicht angezeigt wird, obwohl Sie eine Artikel ID bekommen haben, gab es einen Fehler bei der Speicherung.

Mögliche Ursache: Eine oder mehrere Optionen/Produktparameter wurden nicht korrekt übergeben.

Können Sie Ihre gespeicherten Produkte nicht mehr finden, kann es daran liegen, dass Sie mit dem DEV-Entwicklungsystem arbeiten.
Diese Testumgebung wird über Nacht immer mit dem Produktiv-System überschrieben.

Wenn Sie Testdaten oder Testbestellungen im Tetsystem anlegen, stehen diese nur am Tag der Anlage auf dem Testsystem zur Verfügung.

Im Produktkatalog werden alle für einen Kunden bestellbaren Produkte gepflegt.

Um ein Produkt bei UP bestellen zu können, muss dieses vorher über die Katalog-Schnittstelle angelegt werden.
Dazu werden alle Eigenschaften des Produkts festgelegt und unter einer Artikelnummer gespeichert.

Diese Artikelnummer kann später zur Auftragsanlage verwendet werden.

Bei der Produktanlage werden diese Produkteigenschaften angezeigt – hier dargestellt für das Beispielprodukt „Flyer“.

• Produkttyp
• Seitenanzahl
• Format
• Ausrichtung
• Papierstärke
• Papier
• Papiereigenschaft
• Druck
• Verarbeitung
• Veredelung
• Art der Veredelung
• Nutung
• Perforation
• Menge
• Lieferart

Wichtig
Die Auswahl der Eigenschaften muss von „oben“ nach „unten“ erfolgen, um so Kombinationen, welche nicht bestellt werden können, ausschließen zu können.
Die in der Hirarchie darüber liegenden Eigenschaften haben somit immer Einfluss darauf, welche Optionen in den Gruppen darunter ausgewählt werden können.

Zur Anlage eines Produkts rufen Sie das folgende Beispielskript auf.
http://interface.unitedprint.com/ws2/catalogue.php

Die einzelnen Produkteigenschaften werden angezeigt und können über Dropdownlisten gewählt werden.

Eine eindeutige Kombination aus allen zur Verfügung stehenden Optionen wird als „Produkt“ gespeichert.

Dieses „Produkt“ wird später bei der Auftragsanlage im Feld orderPositions[$pos] -> orderInformation -> customerProductId angesprochen.

Für die Auftragsanlage im Order Client sind folgende Pflichtfelder definiert.

• environment
• portalName
• countryCode
• languageCode
• partyGroupName
• accountInformation
• customerNumber
• password
• orderInformation
• customerProductId
• orderQuantity
• shippingType
• orderName
• dataSourceInformation
• dataSourceHost
• dataSourceUser
• dataSourcePassword
• dataSourcePort
• dataTransmission
• messageLevel

Bei der Auftragsanlage wird ein zuvor im Produktkatalog angelegtes Produkt zusammen mit den Auftragsdaten, Bestellmenge und Versandart an die Schnittstelle übergeben.

Bestellmenge und Versandart werden in den folgenden Feldern überschrieben:
$order->orderQuantity

$args->orderPositions[0]->orderInformation->orderQuantity
$args->orderPositions[0]->orderInformation->shippingType

Beispiel
http://interface.unitedprint.com/ws2/order.php

Im Beispiel kann der Parameter „validate“ gesetzt werden.
$args -> validate = ($_GET{‚validate‘} == ‚on‘ ? 1 : 0);
$erg = $client -> createOrder($args);

Über diesen Parameter lässt sich ein Auftrag überprüfen.
Bei „validate = 1“ wird kein Auftrag angelegt – es findet nur eine Überprüfung des Auftrags statt, ohne dass dieser bei UP gespeichert wird.

Bei erfolgreicher Prüfung werden das voraussichtliche Lieferdatum, Netto- und Bruttopreis sowie die Währung zurückgegeben.

Mit „validate = 0”
$args -> validate = 0
$erg = $client -> createOrder($args);
wird der Auftrag ins UP-System geschrieben und die Auftragsnummer zurückgegeben.

// begin processing
$args->accountInformation->password = ‚passwort‘;
$args->accountInformation->customerNumber = 1234567;
$args->accountInformation->portalName = ‚print24‘;
$args->accountInformation->languageCode = ‚de‘;
$args->accountInformation->countryCode = ‚DE‘;

Wenn Sie ein Produkt im Katalog ausgewählt haben, können Sie es speichern, um ein bestellbares Produkt zu erstellen. Verwenden Sie für Ihre Bestellung den Namen dieses neu erstellten Produkts.

Für jede Bestellanfrage ist ein Benutzerkonto erforderlich. Das Bestellskript erfordert einen Produktnamen, eine Menge und mindestens eine Lieferadresse. Die Menge und die Versandart können von Ihrem gespeicherten Produkt abweichen. Sie können jede im Katalog vorhandene Menge bestellen.
Das Bestell-Demo-Skript unterstützt nur eine Lieferadresse. Sie können mehrere Lieferadressen verwenden.

Verwenden Sie das Validierungskennzeichen, um Ihre Bestellung zu validieren. Sie können es auch für Preisanfragen verwenden.

Downlaod
order_demo.php

Hier werden die gespeicherten Produkte des Katalogs zusammen mit deren Gruppenzuordnung aufgelistet.

Beispiel
http://interface.unitedprint.com/ws2/catalogueList.php

Über die Funktion getCustomProduct() kann die „internalId“ eines gespeicherten Artikels abgefragt werden. Mit der „internalId“ kann im Anschluss ein gespeicherter Artikel gelöscht werden.

Beispiel
$deletearticle = ‚articletodelete‘;

try {
$getItemArgs = new getCustomProductRequestType();
$getItemArgs->environment = $environment;
$getItemArgs->messageLevel = $messageLevel;
$selection = new catalogueSelectionType();
$getItemArgs->selection = $selection;
$getItemArgs->selection->itemIdentifier = $deletearticle;
$product = $client->getCustomProduct($getItemArgs);
$internalId = $product->product->internalId;

} catch(Exception $e) {
echo „Error on request getCustomProduct: “ . $e->getMessage();
}

try {
$changeArgs->writeMode = ‚deactivate‘;
$changeArgs->product = new selectedType();
$changeArgs->product->internalId = $internalId;

$erg = $client->setCustomProduct($changeArgs);
} catch(Exception $e) {
echo „Error on request setCustomerProduct: “ . $e->getMessage();
}

Dieses Beispielskript zeigt, wie Sie mit dem Katalog  auf Ihre gespeicherten Produkte zugreifen können.

Damit ist es möglich, detaillierte Informationen für gespeicherte Produkte wie Preis- und Lieferinformationen zu erhalten.

Dieses Skript verwendet die Katalogfunktionen getCatalogueList und getCustomProduct.
Es ist eine schnellere Alternative zu getCustomCatalogue.

Download
catalogueList_demo.php

Sie können mit Ihren eigenen Kundendaten auf den UP Produktkatalog zugreifen.

Laden Sie dazu das nachstehende Beispielskript sowie ein Zertifikat herunter und starten Sie sofort Ihre Kataloganfragen, um Preis- und Lieferinformationen zu erhalten.

Das Skript demonstriert die Katalogfunktion „getCustomCatalogue“.
Das Beispiel-Zertifikat ermöglicht Ihnen dabei nur den Zugriff auf unsere Testumgebung.

Beispiel-Code

Zur Anzeige bzw. Bearbeitung Ihrer gespeicherten Artikel nutzen Sie dieses Beispielskript.
http://interface.unitedprint.com/ws2/catalogueList.php

Dabei werden die von Ihnen gespeicherten Produkte des Katalogs mit der jeweiligen Gruppenzuordnung aufgelistet dargestellt und können weiter bearbeitet werden.