Δημιουργία Γέφυρας Softone-Opencart

Προετοιμασία Opencart:

• Εγκαθιστούμε το Opencart API από το gitlab opencart/opencart-tp-api branch:v3c_manhattan με απλό upload στο Opencart.

Βήμα 1. Βασικές ρυθμίσεις γέφυρας:

• Προσθέτουμε μία νέα γραμμή στον πίνακα customer  αντιγράφοντας την γραμμή dev που έχουμε για τον πελάτη.
• Αφαιρούμε την επισήμανση dev από τις στήλες customer_name και username .
• Αν θέλουμε να αλλάξουμε το password , πρέπει να το εισάγουμε και να το κωδικοποιήσουμε με md5.
• Σημειώνουμε το customer_id που δημιουργήθηκε γιατί θα το χρειαστούμε στα επόμενα βήματα.

Βήμα 2. Ρυθμίσεις Opencart:

• Προσθέτουμε μία νέα γραμμή στον πίνακα opencart  αντιγράφοντας τη γραμμή dev που έχουμε για το customer_id του dev.
• Αλλάζουμε το customer_id με αυτό που δημιουργήσαμε στο Βήμα 1.
• Αλλάζουμε τη στήλη oc_server με το url του live site.
• Δημιουργούμε έναν χρήστη API παρέχοντας πρόσβαση στην IP 49.12.67.133 και τοποθετούμε το Όνομα API στη στήλη oc_user και το Κλειδί API στη στήλη oc_api_key .
• Ελέγχουμε αν τα ID των γλωσσών στο Opencart συμφωνούν με τα ID που έχουμε στις στήλες langs και basic_lang .

Βήμα 3. Ρυθμίσεις Softone:

• Προσθέτουμε μία νέα γραμμή στον πίνακα softone  αντιγράφοντας τη γραμμή dev που έχουμε για το customer_id του dev.
• Αλλάζουμε το customer_id με αυτό που δημιουργήσαμε στο Βήμα 1.
• Αλλάζουμε τη στήλη s1_server με το url του live softone.
• Διορθώνουμε τις στήλες s1_user, s1_pass, s1_appid, s1_company, s1_branch, s1_module, s1_refid  αν υπάρχουν αλλαγές.
• Βάζουμε null στις στήλες clientId και clientId_timestamp .

Βήμα 4. Δημιουργία access token για τη γέφυρα:

• Ανοίγουμε το https://bridge.techplace.gr/token/
• Επιλέγουμε την έκδοση της Γέφυρας που έχουμε ορίσει στη στήλη bridge_version του πίνακα customer .
• Εισάγουμε το customer_id που δημιουργήσαμε στο βήμα 1 στο πεδίο Customer ID της φόρμας.
• Εισάγουμε το username και password που ορίσαμε στο βήμα 1 στα αντίστοιχα πεδία της φόρμας και πατάμε “Create Token”.
• Αν τα παραπάνω στοιχεία είναι σωστά θα δημιουργηθεί ένα JWT token που μπορεί να χρησιμοποιηθεί για την αποστολή request προς τη γέφυρα για το συγκεκριμένο customer_id .

Βήμα 5. Δημιουργία Update Now:

• Δημιουργούμε μία νέα γραμμή στον πίνακα upd_now .
• Στη στήλη key εισάγουμε ένα μοναδικό τυχαίο αλφαριθμητικό 64 χαρακτήρων.
• Στη στήλη customer εισάγουμε το όνομα του πελάτη.
• Στη στήλη customer_id εισάγουμε το customer_id που δημιουργήσαμε στο Βήμα 1.
• Στη στήλη url εισάγουμε το πρώτο κομμάτι από το API url του softone. (Π.χ. αν το API url του softone είναι demo.oncloud.gr εμείς εισάγουμε demo)
• Στη στήλη app_id εισάγουμε το app_id που θα χρησιμοποιείται στα request.
• Δημιουργούμε ένα clientId για το Softone και το εισάγουμε στη στήλη client_id .
• Στη στήλη cron ορίζουμε ανά πόσα λεπτά θα αποστέλλεται request μέσω του cronjob. Αν ορίσουμε μηδέν, το cron θα είναι απενεργοποιημένο.

Βήμα 6. Ρυθμίσεις παραγγελιών:

• Δημιουργούμε μία νέα γραμμή στον πίνακα orders με customer_id από το το Βήμα 1.
• Οι στήλες prefix χρησιμοποιούνται κατά τη δημιουργία του πελάτη ως πρόθεμα στο κωδικό πελάτη.
• Στη στήλη series εισάγουμε τις ρυθμίσεις για τις σειρές παραστατικών σε μορφή JSON στην παρακάτω μορφή:
  
  { "default": 1112, // Default σειρά παραστατικού που θα χρησιμοποιηθεί σε περίπτωση που δεν προκύψει από τα υπόλοιπα στοιχεία "field": "payment_custom_field", // πεδίο του Opencart order από το οποίο προκύπτει η σειρά παραστατικού "payment_custom_field": { // το πεδίο που ορίσαμε στο πεδίο field "5": { // custom field ID του παραστατικού "4":1112, // custom field value ID του παραστατικού και το αντίστοιχό του στο Softone "3":1111 // custom field value ID του παραστατικού και το αντίστοιχό του στο Softone } } }

  1 2 3 4 5 6 7 8 9 10 11 12

  {     "default": 1112, // Default σειρά παραστατικού που θα χρησιμοποιηθεί σε περίπτωση που δεν προκύψει από τα υπόλοιπα στοιχεία     "field": "payment_custom_field", // πεδίο του Opencart order από το οποίο προκύπτει η σειρά παραστατικού     "payment_custom_field": { // το πεδίο που ορίσαμε στο πεδίο field         "5": { // custom field ID του παραστατικού             "4":1112, // custom field value ID του παραστατικού και το αντίστοιχό του στο Softone             "3":1111  // custom field value ID του παραστατικού και το αντίστοιχό του στο Softone         }     } }

• Στη στήλη series_lian ορίζουμε τη σειρά για παραστατικά λιανικής και στη στήλη series_xond στη σειρά παραστατικών χονδρικής.
• Στη στήλη xond_with_lian ορίζουμε αν το παραστατικό χονδρικής στο Softone δέχεται τις τιμές των προϊόντων μαζί με το ΦΠΑ.
• Στη στήλη code_shipping εισάγουμε τις ρυθμίσεις για τους τρόπους αποστολής σε μορφή JSON στην παρακάτω μορφή:
  
  { "field": "shipping_code", // πεδίο του order json το οποίο θα χρησιμοποιήσουμε για να αντιστοιχίσουμε τους τρόπους αποστολής "shipping_code": { // το πεδίο που ορίσαμε στο πεδίο field // παρακάτω εισάγουμε την κάθε τιμή που μπορεί να πάρει το πεδίο και δίπλα την αντίστοιχη τιμή που πρέπει να αποσταλεί στο Softone "formula_based.formula_based_0_c1": 107, "pickup.pickup": 101 } }

  1 2 3 4 5 6 7 8 9 10

  {     "field": "shipping_code", // πεδίο του order json το οποίο θα χρησιμοποιήσουμε για να αντιστοιχίσουμε τους τρόπους αποστολής     "shipping_code": { // το πεδίο που ορίσαμε στο πεδίο field         // παρακάτω εισάγουμε την κάθε τιμή που μπορεί να πάρει το πεδίο και δίπλα την αντίστοιχη τιμή που πρέπει να αποσταλεί στο Softone         "formula_based.formula_based_0_c1": 107,         "pickup.pickup": 101     } }

• Η στήλη code_carrier έχει την ίδια μορφή με τη στήλη code_shipping. Το μόνο που αλλάζει είναι οι κωδικοί softone για τους μεταφορείς.
• Στη στήλη code_payment εισάγουμε τις ρυθμίσεις για τους τρόπους πληρωμής σε μορφή JSON στην παρακάτω μορφή, όπου κάθε γραμμή αντιστοιχεί σε ένα payment_code από το Opencart και σε ένα κωδικό τρόπου πληρωμής από το Softone:
  
  { "cod": 2009, "cop": 1017, "cardlink": 1003, "bankext-26": 2000, "bankext-30": 2008, "bankext-31": 2002, "bankext-25": 2001, "cardlink": 1003, "pp_standard": 1010 }

  1 2 3 4 5 6 7 8 9 10 11 12 13

  {     "cod": 2009,     "cop": 1017,     "cardlink": 1003,     "bankext-26": 2000,     "bankext-30": 2008,     "bankext-31": 2002,     "bankext-25": 2001,     "cardlink": 1003,     "pp_standard": 1010 }

• Αν η γέφυρα έχει υλοποιημένη την αντιστοίχιση πολλαπλών κατηγοριών χρέωσης τότε εισάγουμε τις αντιστοιχίες των χρεώσεων στη στήλη code_charges σε μορφή JSON (στην ίδια μορφή στης στήλης payment_code ) όπου σαν key βάζουμε το code από τα totals του Opencart και δεξιά το ID του EXPN από το Softone. Αλλιώς, εισάγουμε τα code από τα totals του Opencart χωρισμένα με κόμμα στη στήλη charges και η γέφυρα θα στέλνει το άθροισμά τους στο ID=104 του EXPN της κάθε παραγγελίας.
• Στη στήλη product_prices_include_tax ορίζουμε αν οι τιμές των προϊόντων του Opencart συμπεριλαμβάνουν τον ΦΠΑ.
• Στη στήλη charges_include_tax ορίζουμε αν οι τιμές των χρεώσεων (μεταφορικά, αντικαταβολή κλπ.) του Opencart συμπεριλαμβάνουν τον ΦΠΑ.
• Στις στήλες afm, doy, drastiriotita ορίζουμε από ποιο custom field του Opencart θα λαμβάνουμε το κάθε πεδίο στην παρακάτω μορφή
  
  custom_field|custom_field_id

  1 2 3

  custom_field|custom_field_id

• Στη στήλη comments ορίζουμε τη μορφή των σχολίων της κάθε παραγγελίας. Κάθε πεδίο εντός {}  θα αντικατασταθεί με αυτό που θα βρεθεί στο order του Opencart.
• Στις στήλες trdcat_lian και trdcat_xond ορίζουμε τα TRDCATEGORY που θα αποστέλλονται κατά τη δημιουργία πελάτη σύμφωνα με το είδος του παραστατικού.
• Στη στήλη order_status_id μπορούμε να ορίσουμε το αρχικό FINSTATES του παραστατικού παραγγελίας.
• Στη στήλη quantity_field ορίζουμε από ποιο πεδίο του προϊόντος αντλούμε την ποσότητα του είδους (είναι υλοποιημένο μόνο στη γέφυρα Softone/Woocommerce).

Εγκατάσταση Opencart module για αυτόματη αποστολή παραγγελιών στη γέφυρα:

• Κατεβάζουμε το zip από το https://gitlab.techplace.gr/opencart/opencart-tpbridge/-/releases/3.1.1.ocmod
• Διορθώνουμε τη δομή των φακέλων μέσα στο zip ώστε τα αρχεία να είναι μέσα στον φάκελο upload και το xml να είναι στο root του zip.
• Κάνουμε εγκατάσταση του module μέσω του Extensions > Install.
• Κάνουμε Refresh Modifications.
• Εγκαθιστούμε το module από το Extensions > Extensions > Modules > tpBridge
• Ανοίγουμε τις ρυθμίσεις του module και εισάγουμε τα παρακάτω:
  • Έκδοση: η έκδοση της γέφυρας π.χ. v3c
  • Token: Δημιουργούμε ένα access token ακολουθώντας τις οδηγίες του βήματος 4.
  • Κλειδί Cron: Εισάγουμε ένα τυχαίο αλφαριθμητικό το οποίο θα χρησιμοποιηθεί ώστε να προστατεύει την κακόβουλη εκτέλεση του cron παραγγελιών.
  • Κατάσταση: Ενεργοποιημένο.
  • Για την αυτόματη αποστολή των παραγγελιών μέσω cron job πρέπει να δημιουργήσουμε ένα cron job που θα καλεί το παρακάτω URL: https://leptokaropoulos.gr/index.php?route=extension/module/tpbridge&secret={cron-key} αντικαθιστώντας το {cron-key} με το Κλειδί Cron που έχουμε εισάγει προηγουμένως.