Checkliste pixi* Support für die Einrichtung von Fremdapps Anpassung Schnittstelle: ja/nein (wenn ja was genau. Felder in der Shop-‐DB, Felder in pixi*) Ja, XML Anpassung notwendig. Siehe Dokument-‐Ende. Anpassung Templates: ja/nein (wenn ja, was genau) Nein Zahlarten einrichten: ja/nein (wenn ja, welche Parameter müssen wie gesetzt sein) Ja, folgende Parameter müssen gesetzt werden. Code: A
Name: Amazon Payments
Bestell-Status: HAL
XML Tag: ;;;;;amazon;
CA EreignisID bei automatischem Erstellen: AMA
Bestellungen nicht automatisch zusammenfassen: deaktiviert
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Auto Box Lock: deaktiviert
Auto Address Lock: deaktiviert
Automatischer Bestellvorschlag auch für HAL-‐Bestellungen: aktiviert
Rechnung automatisch aus-‐scannen: aktiviert
Rechnung automatisch auf bezahlt setzen: deaktiviert
HAL-‐Bestellungen nach X Tagen stornieren: 0
CA Bei Erstattung von offenen Bestellungen abziehen: aktiviert
Bestellungen nicht automatisch zusammenfassen: deaktiviert
CA Automatischer Abgleich: deaktiviert
CA Automatisch Zahlung erstellen: deaktiviert
CA kein ShipOut, wenn nicht bezahlt: deaktiviert
Abgleich zu Rechnungen: deaktiviert
Abgleich zu Bestellungen: deaktiviert
Adresse von Bankzeile aktualisieren: aktiviert
Welche automatischen Events müssen gesetzt sein? Neues CA-‐Ereignis, default „AMA“ wenn nicht schon vergeben.
Neues manuelles Buchungskonto muss angelegt werden. Für Rückerstat-‐
tung das Ereignis „AMR“ (negativ) erstellen und in der App zuweisen. Sie können beide Ereignisse auch beliebig benennen, wichtig ist, dass in der App die gleichen Ereignisse mit korrekter Schreibweise eingetragen werden. Muss ein Zahlungsevent angelegt sein? Ein Ereignis „AMA“ muss für Zahlungen und ein Ereignis „AMR“ für Erstattungen (negativ) angelegt werden. Welches Feld wird für die Transaction genutzt? ccPayId Änderungen an den Stammdaten in pixi*: ja/nein (wenn ja, was genau (SI-‐Felder z.B.)) Nein Benötigte API-‐Calls: Folgende API Calls werden benötigt Production •
•
•
•
•
•
•
•
•
•
•
pixiPayGetOrdersToAuthorize pixiPayGetInvoicesToCapture pixiGetInvoice pixiCAGetEvents pixiPaySetAuthorizationStatus pixiPaySetInvoiceCapture pixiSetInvoicePaid pixiCACreateManualBooking pixiGetOrderHeader pixiGetInvoice pixiGetOrderHeader Sandbox •
•
•
pixiImportGetChannels pixiImportAddXML pixiSysGetCallInfo Verwendete Parameter für API-‐Calls: Standard-‐Parameter Benötigte Zusatzmodule: ja/nein (wenn ja, welche) nein pixi* Import 2.0 Erweiterung für die Amazon Payments App
Allgemeines
Die Import 2.0 CodeIgniter Schnittstelle beim Kunden benötigt eine XML Erweiterung,
um folgende Amazon Payments IDs vom Shop an Pixi zu übertragen:
1. orderreferenceid
Wir immer benötigt. Amazon Payments kann nicht über die Bestellnummer im Shop
mappen, deswegen wird die Order Reference ID von Amazon Payments benötigt.
2. authorizeid
3. captureid
je nach Szenario im Shop (ERP Mode) sind diese beiden IDs bereits vom Shop befüllt
oder nicht. (null) Es ist auch möglich, nur die Autorisierung im Shop zu befüllen. Die
Amazon Payments pixi* App führt dann nur noch die Zahlung zu der Autorisierung und
ggf. anfallende Erstattungen aus.
Hinweise zum Workflow
Wenn authorizeid und captureid bereits vom Shop gefüllt worden sind, geht die Amazon Payments App davon aus, dass diese beiden Punkte nicht mehr zu erledigen sind
und kümmert sich lediglich um Rückbuchungen. (Refunds)
Wenn die beiden Werte leer sind bedeutet dass, dass die Amazon Payments App neben den Refunds auch das Polling für die Reservierungen und Zahlungen übernimmt.
Voraussetzung dafür ist, dass das Polling für Reservierungen und Zahlungen aktiviert ist.
Anpassung der Schnittstelle
Configuration items
Die Konfiguration Items müssen um folgenden Eintrag ergänzt werden:
Type: pixi
Action: pix_order
Attribute Name: id=jagamazon|name=payment|shiplock=N
Attribute Value: amazon
Export Type Definition
In den Import / Export Type Definitions muss folgenden Eintrag um die Referenz-IDs von
Amazon Payments erweitert werden.
Type: pixi
Action: pix_order
Identifier: payment_all
Nachfolgend ein Code-Beispiel für das oxid eSales CE Modul der Firma Jankowski
AG
if ($row['payment'] == 'amazon') {
$order_info = $this->db->query('SELECT JAGAMAZONORDERREFERENCEID as
card_authorization, JAGAMAZONORDERREFERENCEID as orderreferenceid,
JAGAMAZONAUTHORIZATIONID as authorizationid, JAGAMAZONCAPTUREID as
captureid FROM oxorder WHERE oxorder.oxid = ?', array($iid['iid']));
if ($order_info->num_rows() > 0) {
$order_info = $order_info->result_array();
$row = array_merge($row, $order_info[0]);
}
}
Bitte folgendes beachten: Die Amazon Order Reference ID muss in das Feld ccPayId. Die Amazon Order Reference Id darf nicht als externe Bestellnummer in pixi* gespeichert werden. Dort soll weiterhin die normal Shop Bestellnummer reinlaufen.