Unzer hat für viele Shop-Systeme eine fertige Erweiterung parat. Welche für dein Shop-System am besten geeignet ist, solltest du beim unzer Support erfragen.

Voraussetzung ist, dass das eingesetzte Shop-Modul die MGW - Schnittstelle von unzer unterstützt.

Die unzer App unterstützt zwei verschiedene Abarbeitungs-Prozesse.

Im Standard Modus prüft die App ob eine Bestellung bereits im Online-Shop eingezogen wurde. Sollte das nicht der Fall sein, führt die App den Capture nach dem Bestellimport in pixi aus, sobald die App die Bestellung zum ersten Mal abgeholt hat.

Im Erweiterten Modus, wird der Capture nach Versand/Rechnungsstellung in pixi ausgeführt. Allerdings gibt es weiterhin Zahlungsarten, wo der Capture bereits im Online-Shop stattfindet.

Bei einigen Shop-Modulen kann eingestellt werden, ob der Capture bereits im Online-Shop ausgelöst wird.

Die pixi API Konfiguration kann im Portal unter dem Menüpunkt pixi API unterhalb von Einstellungen vorgenommen werden. Das ist die wichtigste Konfiguration, auf der alle nachträglichen APP Konfigurationen basieren.

Falls die einzutragenden Daten nicht bekannt sind, können diese beim pixi Support angefragt werden.
Pro Organisation/Konto dürfen maximal zwei pixi API Konfigurationen eingetragen werden.

Mit einer hinterlegten E-Mail Konfiguration kann dich die APP über Fehler und Probleme benachrichtigen.
Dazu werden die SMTP Daten von einem E-Mail Postfach hinterlegt, welches dann den Versand übernimmt.
Wenn du mehrere Empfänger für die E-Mail Benachrichtigungen der APP hinterlegen möchtest, musst du eine E-Mail Weiterleitung bei dir anlegen. Im Regelfall kann eine Empfänger E-Mail Adresse automatisch als Weiterleitungs-Adresse definiert werden.
Wie das funktioniert solltest du mit deinem technischen Ansprechpartner klären, der für die Verwaltung deiner E-Mail Adressen zuständig ist.

Als nächstes kann die APP gebucht werden. Dafür musst du im Portal angemeldet sein, die pixi API und E-Mail Konfiguration hinterlegt haben.
Im Anschluss kann die APP gebucht werden. Standardmäßig buchen wir den monatlichen Betrag von deiner Kreditkarte ab. Wir bieten aber auch einen automatischen Lastschrifteinzug innerhalb Deutschland an. Allerdings müssen wir diesen vorher freischalten. Schreibe dazu einfach eine E-Mail an [email protected]. Bitte nenne uns den Namen der Organisation, der bei uns registriert ist.

Nach Buchung der APP kann mit der Konfiguration gestartet werden. Auf der linken Seite im Portal-Menü werden alle gebuchten APP's aufgelistet. Unter jeder APP gibt es einen Menüpunkt Konfiguration. Hier können neue Konfigurationen angelegt, bestehende bearbeitet oder Kopien erstellt werden.

Neue Konfiguration anlegen
Um eine neue Konfiguration anzulegen, muss zuerst die gewünschte pixi API ausgewählt werden, auf der gearbeitet werden soll.
Im nächsten Schritt wählt man einen pixi Mandaten aus, auf dem die gewünschte Zahlart konfiguriert werden kann.
Anschließend werden alle in pixi verfügbaren Zahlarten angezeigt. Hier muss die gewünschte Zahlart ausgewählt werden.
Zum Schluss können die Konfigurations-Felder angezeigt.

Konfiguration bearbeiten
Eine bestehende Konfiguration kann jederzeit überarbeitet werden. Dazu wählt man aus dem Dropdown Feld die entsprechende Konfiguration aus und bekommt die komplette Maske angezeigt.

Konfiguration kopieren
Eine bestehende Konfiguration kann auf eine neue Zahlart in pixi kopiert werden.
Im ersten Schritt wird die zu kopierende Konfiguration ausgewählt.
Anschliessend muss man im Bereich "Kopieren nach" die pixi API, den gewünschten pixi Mandanten und danach die pixi Zahlungsart auswählen.
Zum Schluss könne die Konfigurations-Felder bearbeitet werden. Das Speichern der Konfigurations-Felder ist notwendig!

Im folgenden werden die einzelnen Konfigurations-Felder erklärt.

Im Dashboard sind alle Bestellungen aufgelistet, die von der App verarbeitet wurden. Über die vorhandenen Filter können Problembestellungen schnell und einfach gefunden werden.
In der Übersicht der Bestellungen sind Fehler mit einem gekennzeichnet.
Wenn das Zeichen zu sehen ist, handelt es sich um einen Hinweis. Ein Eingreifen ist (noch) nicht notwendig.

Die Fehler-Seite ist eine weitere Hilfsmöglichkeit um Problem-Bestellungen wahrzunehmen. Der Link zur Fehler-Seite kann in einem Internet-Browser aufgerufen werden, ohne dass ein Login im Portal notwendig ist. Die Fehler-Seite aktualisiert sich jede Minute neu und holt die Daten über die iungo-API verschlüsselt ab.

Die unzer Payment ID muss aus dem Shop in pixi importiert werden. Die unzer Payment ID muss in das Feld KK-ID im pixi Kundenservice importiert werden.

Die Zahlungsarten der Bestellungen aus dem Shop, müssen mit den Zahlungsarten in pixi verknüpft werden.
In der Regel sind die bestehenden APP's auf der pixi Plattform mit unseren APP's nicht kompatibel.
Daher empfehlen wir bei einer Migration die Neuanlage der Zahlungsarten.

Ob die Anlage von einer oder mehreren Zahlungsart(en) notwendig ist, hängt von verschiedenen Faktoren ab.
Zum einen gibt es APP's bei der eine Zuordnung der pixi Zalungsart zur Zahlungsart des Anbieters notwendig ist. Nur so kann die APP die richtigen Prozess im Hintergrund ausführen.
Zum anderen muss man für sich selbst entscheiden ob eine Trennung, z.B. aus Gründen der Übersicht oder Buchhaltung, sinnvoll ist.
Beides hat Vor- und Nachteile.

• Bestellungen mit Status "HOLD/HAL" importiert werden
• Bei Erstellung einer Rechnung/Gutschrift darf kein automatischer Abgleich stattfinden oder das "Bezahlt Kennzeichen" gesetzt werden
• Die Zahlungsart darf sich nicht wie eine "Kreditkarten-Zahlungsart" im pixi System verhalten (Direct-CHARGE deaktivieren)

Achtung: Dies ist nur ein Beispielbild, wie die Konfigurationsmaske in pixi aussieht. Die einzelnen Konfigurationspunkte können bei jedem anders sein und sollten in Absprache mit dem pixi-Support gesetzt werden.

In pixi müssen manuelle Buchungs-Events angelegt werden, falls noch keine existieren. Die Portal-Konfiguration erlaubt es, falls gewünscht, für jede Zahlungsart unterschiedliche Buchungs-Events einzutragen. In der Regel erstellt diese Buchungs-Events der pixi-Support.

• Zahlungseingang muss positiv sein
• Rückerstattung muss negativ sein

Im Regelfall werden die Rechnungen an deine Kunden aus pixi heraus verschickt. Achte bitte darauf, dass die Rechnungen alle notwendigen Informationen bereitstellen. Ebenso ist es wichtig, dass der Kunde nicht ausversehen den Betrag zusätzlich überweist und somit doppelt abgezogen bekommt.

Für einige APP's gibt es bereits Vorlagen oder der Anbieter hat bereits mit pixi abgesprochen wie diese aussehen sollen.
Solltest du hierzu Fragen haben, kontaktiere bitte hierzu den pixi-Support.

Bitte beachte auch, dass die Rechnungen pro Zahlungsart unterschiedlich aussehen können.
Zum Beispiel muss eine Rechnung bei der klassischen Vorkasse anders aussehen als beim abgesicherten Rechnungskauf.

Für den Betrieb der Erweiterungen müssen folgende SOAP API-Calls auf der Datenbank installiert sein.

• pixiPayGetOrdersToAuthorize
• pixiPayGetInvoicesToCapture
• pixiGetOrderline
• pixiGetInvoice
• pixiGetInvoiceLines
• pixiGetChangedOrders
• pixiImportFindXML
• pixiCACreateManualBooking
• pixiPaySetInvoiceCapture
• pixiPaySetAuthorizationStatus
• pixiGetOrderTotals
• pixiGetOrderHeader
• pixiAddCustomerComment
• pixiGetAddress
• pixiSetShippingLock
• pixiCreateOrderComment
• pixiSetOrderShippingLock
• pixiCanChangeAddress
• pixiGetItemInfo
• pixiGetCreditCardInfo

Eine Bestellung kann bei unzer noch den Status "PENDING" haben, währen diese zu pixi importiert wird. Es ist darauf zu achten, dass solche Bestellungen erst zu pixi importiert werden, wenn der Status nicht mehr "PENDING" ist.

Nachdem die Bestellung mit Status HOLD in pixi importiert wurde, muss zur weiteren Bearbeitung die unzer App diese freigeben. Es wird geprüft, ob die Bestellung von unzer angenommen wurde. Sollte ein Fehler vorligen, wir die Bestellung freigegeben, aber mit einer Versandsperre versehen.

Ist die Bestellung erfolgreich geprüft, wird diese freigegeben.

Standard-Modus
Wenn die Bestellung im Shop noch nicht gecaptured wurde, versucht die App vor Freigabe der Bestellung, das Capture durchzuführen.

Unzer Prepayment
Die APP prüft beim Import ob der Zahlungseingang von unzer an die APP übermittelt wurde. Solange das nicht geschehen ist, wird die Bestellung in pixi vom Status HOLD auf OPEN gesetzt. Parallel wird die Versandsperre der Bestellung aktiviert.
Kommt das Ereignis für den Zahlungseingang nach dem Import der Bestellung, gibt die APP die Bestellung frei. Dazu wird die Versandsperre wieder deaktiviert.

Beim Versand in pixi, versucht die unzer App den entsprechenden Betrag zu aktivieren/capturen und den Versand zu melden.

Wenn der Betrag erfolgreich aktiviert wurde, setzt die unzer App auch das Buchungs-Event, sodass im Kundenportal ein Ausgleich sattfindet.

Standard-Modus
Da der Capture vorher stattgefunden hat, prüft die App ob der Rechnungsbetrag aller pixi Rechnungen der Bestellung nicht höher als der Bestellbetrag ist.

Experten-Modus
An dieser Stelle findet das capturen der Rechnung statt. Wenn der Capture fehlschlägt, informiert dich die unzer App bei einem Fehler.

Unzer Prepayment
Wird der Versand der Ware ohne den erfolgreichen Zahlungseingang angestossen, führt die APP keinen Ausgleich im pixi Kundenkonto aus. Das muss dann manuell nachgeholt werden.

Sobald eine Bestellung in pixi storniert wurde, alle Bestellpositionen haben den Status STO oder NLB, wird das an unzer übermittelt. Bei Fehlern wird eine Fehler E-Mail versendet.

Standard-Modus
Da der Capture vorher stattgefunden hat, führt die unzer App an dieser Stelle eine Rückbuchung aus. Technisch passiert das gleiche wie bei einer Retoure.

Experten-Modus
Es muss nichts zurückgebucht werden.

Werden nur einzelne Bestellpositionen storniert, arbeitet die unzer App je nach gewählten Modus unterschiedlich.

Standard-Modus
Da der Capture schon vorher stattgefunden hat, führt die unzer App an dieser Stelle eine Rückbuchung aus. Technisch passiert das gleiche wie bei einer Retoure.
In der Regel wir der Betrag erst an Unzer übertragen, wenn der Bestell-Status "CLOSED" in Pixi ist.

Experten-Modus
Mit dem Versand der letzten Teil-/Lieferung schließt die unzer App die Bestellung bei unzer. Somit kann der stornierte Betrag nicht mehr eingezogen/gecaptured werden.

Bei einer Retoure meldet die unzer App den Betrag der Gutschrift an unzer und setzt bei Erfolg das Buchungs-Event für Gutschriften in pixi.

Manuelle- und Umtausch-Bestellungen können mit einer Zahlungsart erstellt werden, die im Portal konfiguriert ist. Die APP ignoriert solche Bestellungen. Jedoch muss drauf geachtet werden, das die Rechnungen/Gutschriften einer solchen Bestellung ebenfalls im pixi Kundenkonto ausgeglichen werden um weitere Probleme auszuschliessen.

• Vertrag mit unzer
• Unzer Integration im Shop (MGW Schnittstelle)
• pixi ERP oder pixi Fulfillment ab Version LOU Official - Update 46 (Für Basis Funktionalität)
• Shopconnector zwischen pixi und Shop
• Optional: Komplette Teststrecke (Shop, pixi, unzer)

Bitte informiere dich vorab beim unzer Support ob dein Shop-Modul die MGW Schnittstelle unterstützt.

Welche Daten brauche ich von unzer?

• Unzer API Zugangsdaten
  Benötigt werden Public und Private API Key

Was muss von pixi angepasst werden?

• Konfiguration der Zahlungsarten
  Ob eine oder mehrere Zahlungsarten angelegt werden müssen, entscheidet der Kunde. Die App kann die Zahlungsarten unterscheiden, sodass auch eine Konfiguration mit einer Zahlungsart in pixi möglich ist.
• Schnittstelle
  Falls die Schnittstelle von pixi verwaltet wird
  Eine Bestellung kann bei unzer noch einen schwebenden Status haben, währen diese zu pixi importiert wird. Es ist darauf zu achten, dass solche Bestellungen erst zu pixi importiert werden, wenn dieser Status nicht mehr vorhanden ist.
• Buchungs-Events
  Für Rechnungen und Gutschriften
• Rechnungstemplates
  Die Rechnungen müssen auf die eingesetzte Zahlungsart abgestimmt sein.
  Bitte beachte, dass die Überweisungsdaten für die Zahlungsarten unzer Invoice und unzer Invoice Secured in den folgenden pixi Feldern zu finden sind.
  • Kontoinhaber = Empfänger
  • IBAN = IBAN
  • BIC = BIC
  • Bank = Zahlungsreferenz

  Für die Zahlungsart unzer Paylater Invoice versendet unzer eine Rechnung an deinen Kunden. Es muss nicht zwingend eine Rechnung aus pixi heraus versendet werden. Wenn du Fragen zur Rechnung von unzer hast, konkatiere bitte den unzer Support.

Welche Daten brauche ich von pixi?

• pixi API Zugangsdaten Live/Test
• Konfigurierte Zahlart(en) + XML Tag(s)
• Konfigurierte Buchungs-Events

Sobald die Kommunikation zwischen Shop und pixi funktioniert, kann die Integration bei iungo beginnen. Zuerst muss die Erweiterung gebucht werden. Es gibt einen Testzeitraum, den man zum Testen nutzen sollte. Nach Ablauf des Testzeitraums wird der Betrag jeden Monat automatisch abgebucht.

Nutzt du bereits die Heidelpay App bei pixi?
Falls ja, dann ist ein Parallel-Betrieb der alten und neuen App notwendig.

Bitte lese diese Dokumentation ausführlich und kontaktiere uns bei Fragen.

Kontaktiere pixi um die nächsten Schritte einzuleiten. Dazu gehören, das Anpassen der pixi Shop Schnittstelle, das Anlegen einer neuen Zahlungsart und Buchungs-Events, sowie das Anpassen der Rechnungs-Templates.

Beide App's laufen parallel, bis pixi die alte Heidelpay App deaktiviert.

• Per E-Mail an [email protected]
• Im Betreff sollten folgende Infos stehen:
  - Organisationsname mit dem du dich im iungo CP registriert hast
  - Kurze Fehlerbeschreibung
• Beschreibe in der E-Mail das Problem so gut es geht. Prüfe vorher deine Konfigurationen und ob etwas im Shop oder pixi umgestellt wurde.
• Wenn du eine Fehler E-Mail oder eine Fehlernummer hast, teile uns diese in der E-Mail mit.
  Bitte leite solche E-Mails nicht kommentarlos weiter. Hänge am besten die Fehler E-Mail als Anhang an und teile uns deine Fragen oder dein Problem mit.
• Wenn es mehrere Support-Fälle gibt, schreibe bitte pro Fall eine E-Mail
• Wir prüfen jeden Fall und unterbreiten dir, falls notwendig, ein Angebot für den Support

Jede Nacht zwischen 00:00 und 04:00 Uhr schickt unsere Plattform keine Anfragen an pixi. Damit wird sichergestellt, dass pixi deine Datenbank sichern kann und dafür alle notwendigen Resourcen bekommt.
Es ist technisch leider nicht möglich zu erkennen, ob deine Datensicherung bei pixi gerade läuft oder bereits abgeschlossen ist. Daher ist eine individuelle Anpassung zur Zeit ausgeschlossen.