Ενσωμάτωση του Jinius με το BoxNow

Εύρος Εφαρμογής

Ο οδηγός περιγράφει τις προσαρμογές που απαιτούνται στην υπάρχουσα ενσωμάτωσή σας με το BoxNow για τη δημιουργία voucher αποστολής για παραγγελίες του Jinius Marketplace.

Προαπαιτούμενα

• Η δυνατότητα αποστολής παραγγελιών του Jinius Marketplace μέσω BoxNow είναι προς το παρόν διαθέσιμη μόνο σε επιχειρήσεις που εδρεύουν εκτός Κύπρου.
• Θα πρέπει να διαθέτετε ήδη λειτουργική ενσωμάτωση με το BoxNow. Ο παρών οδηγός καλύπτει τις πρόσθετες απαιτήσεις για την εξυπηρέτηση παραγγελιών του Jinius Marketplace.

• Το Jinius θα σας παρέχει διαπιστευτήρια API του BoxNow που συνδέονται με τον λογαριασμό του Jinius. Η χρήση αυτών των διαπιστευτηρίων είναι υποχρεωτική για τη δημιουργία αποστολών που αφορούν παραγγελίες του Jinius Marketplace.

Για τις γενικές απαιτήσεις και τις διαθέσιμες λειτουργίες του API, ανατρέξτε στην επίσημη τεκμηρίωση του BoxNow εδώ.

Απαιτήσεις Ενσωμάτωσης

Ανάκτηση της Παραγγελίας

Πριν δημιουργήσετε το voucher BoxNow για μια παραγγελία Jinius, θα χρειαστείτε ορισμένες πληροφορίες:

• Order ID
  Το ID παραγγελίας του Jinius Marketplace.
   
• shipping_pudo_id
  Το ID της θυρίδας BoxNow που επέλεξε ο πελάτης κατά την ολοκλήρωση της αγοράς.
  Αυτή η τιμή πρέπει να διαβιβαστεί στο BoxNow κατά τη δημιουργία της αποστολής. Μπορείτε να ανακτήσετε αυτήν την τιμή με έναν από τους ακόλουθους τρόπους:
  • Μέσω API: Ανακτήστε την παραγγελία χρησιμοποιώντας το αίτημα API OR11 του Mirakl.
    Για να ανακτήσετε συγκεκριμένα τις παραγγελίες BoxNow, χρησιμοποιήστε το shipping_type_code = BOXNOW-LOCKER ως φίλτρο.
  • Μέσω του περιβάλλοντος πωλητή του Jinius: Ανοίξτε τις λεπτομέρειες της παραγγελίας και εντοπίστε το πεδίο shipping_pudo_id.

Δημιουργία Αποστολής BoxNow

Για να δημιουργήσετε ένα voucher μέσω του API του BoxNow, χρησιμοποιήστε το POST /api/v1/delivery-requests:

• Χρησιμοποιήστε τα διαπιστευτήρια API του BoxNow που παρέχονται από το Jinius.

• Ορίστε τη θυρίδα προορισμού χρησιμοποιώντας την τιμή που λάβατε στο shipping_pudo_id.

• Συμπεριλάβετε τον αριθμό παραγγελίας Mirakl ως orderNumber στο POST /api/v1/delivery-requests.

• Ορίστε "paymentMode": "prepaid"

• Ορίστε για κάθε δέμα το weight: [weight of parcel]

• Ορίστε το "allowReturn": true για να επιτρέψετε στον πελάτη να ξεκινήσει επιστροφή χρησιμοποιώντας τον αρχικό αριθμό voucher.

• Συμπεριλάβετε τον αριθμό παραγγελίας Mirakl στο εκτυπωμένο voucher χρησιμοποιώντας την παράμετρο overwriteSenderShippingLabelInfo:
  "overwriteSenderShippingLabelInfo": { "row4": "string" }

Σημαντικό:
Ο αριθμός παραγγελίας του Jinius Marketplace πρέπει να χρησιμοποιείται κατά τη δημιουργία της αποστολής BoxNow. Είναι απαραίτητος για τη σύνδεση της αποστολής/του waybill BoxNow με την αντίστοιχη παραγγελία Jinius, για να διασφαλιστεί ότι ο αριθμός παραγγελίας εμφανίζεται στο εκτυπωμένο voucher και για να μπορούν τα εισερχόμενα webhooks να αναγνωρίζουν τη σωστή παραγγελία και να ενημερώνουν την κατάστασή της στο Mirakl.

Ενημέρωση των Πληροφοριών Παρακολούθησης στο Mirakl

Μόλις δημιουργηθεί επιτυχώς η αποστολή BoxNow:

1. Ανακτήστε τον αριθμό παρακολούθησης/waybill που δημιουργήθηκε από το BoxNow.

2. Ενημερώστε τις πληροφορίες παρακολούθησης για τη σχετική παραγγελία Mirakl χρησιμοποιώντας το αίτημα API OR23 του Mirakl ή απευθείας μέσω της διεπαφής χρήστη πωλητή Jinius.

3. Μετά την ενημέρωση, ο αριθμός παρακολούθησης θα είναι διαθέσιμος στον πελάτη μέσω της εμπειρίας παρακολούθησης παραγγελιών του Jinius Marketplace.

Σύνοψη ροής API