Wrapp Partner Portal: πώς ξεκινάς ως partner και πώς προσκαλείς τους πελάτες σου
Τον partner σου τον δημιουργείς μόνος σου, σε ένα λεπτό, και στο wrapp.ai και στο staging. Από εκεί ανοίγεις λογαριασμούς Wrapp για τους πελάτες σου με δύο τρόπους: με ένα κουμπί στο Partner Portal, χωρίς γραμμή κώδικα, ή από την εφαρμογή σου με το Partners API.
Φτιάχνεις λογισμικό, POS, ERP ή πλατφόρμα, και θέλεις οι πελάτες σου να εκδίδουν παραστατικά myDATA μέσα από τη δική σου εφαρμογή. Στο Wrapp αυτό γίνεται με έναν partner: έναν λογαριασμό συνεργάτη από τον οποίο ανοίγεις λογαριασμούς Wrapp για τους πελάτες σου και τους βλέπεις όλους σε ένα σημείο, το Partner Portal.
Τον partner τον δημιουργείς μόνος σου, και στο wrapp.ai και στο staging. Δεν χρειάζεται να μας ζητήσεις τίποτα: κάνεις δωρεάν εγγραφή, δίνεις ένα όνομα, και το Partner API key σου εμφανίζεται αμέσως.
Βήμα 1: Δημιούργησε τον partner σου
- Κάνε δωρεάν εγγραφή στο wrapp.ai με το ΑΦΜ της εταιρείας σου.
- Από το μενού, πάτα Συνδέσεις → «Partner Portal». Ανοίγει και όσο η ρύθμιση του λογαριασμού σου είναι ακόμη σε εξέλιξη.
- Στη σελίδα «Γίνε Wrapp Partner» γράψε το όνομα partner και πάτα «Δημιουργία partner».
Βλέπεις το μήνυμα «Ο partner σου δημιουργήθηκε» και ανοίγει μόνο του το παράθυρο «Partner API key»: το όνομα του partner, το key, το header όπου το στέλνεις (X-PARTNER-API-KEY), τη διεύθυνση του API και τα πρώτα βήματα. Κράτα το key μόνο στον server σου, ποτέ σε κώδικα browser ή εφαρμογής κινητού. Το ξαναβρίσκεις όποτε θέλεις από το κουμπί «Partner API key» του Partner Portal. Στο wrapp.ai σου στέλνουμε και email καλωσορίσματος με τα επόμενα βήματα.
Διάλεξε το όνομα με προσοχή: το βλέπουν οι πελάτες σου. Το email της πρόσκλησης που παίρνουν έχει θέμα «Αυτόματα παραστατικά myDATA μέσα από το» και το όνομα του partner σου.
Βήμα 2: Πρόσκληση πελάτη, χωρίς γραμμή κώδικα
Στο Partner Portal πάτα «Πρόσκληση πελάτη» και συμπλήρωσε:
| Πεδίο | Τι βάζεις |
|---|---|
| Email (υποχρεωτικό) | Εκεί στέλνουμε την πρόσκληση, και γίνεται το email εισόδου του πελάτη στο Wrapp |
| Partner user id (υποχρεωτικό) | Το αναγνωριστικό του πελάτη στο δικό σου σύστημα, μοναδικό για τον partner σου |
| Τηλέφωνο (υποχρεωτικό) | Το τηλέφωνο του πελάτη |
| Στοιχεία εταιρείας | Προαιρετικά: ΑΦΜ, επωνυμία, διεύθυνση, νόμιμος εκπρόσωπος, δραστηριότητα, στοιχεία λογιστή. Η εταιρεία δημιουργείται μαζί με τον πελάτη |
| Webhook URL | Προαιρετικό. Εκεί σου στέλνουμε το API key του πελάτη και μετά τα υπόλοιπα webhooks του |
Πάτα «Αποστολή πρόσκλησης». Από εκεί και πέρα γίνονται τέσσερα πράγματα:
- Ο λογαριασμός Wrapp του πελάτη σου ανοίγει αμέσως και τον βλέπεις στη λίστα σου.
- Ο πελάτης σου παίρνει email από το Wrapp με σύνδεσμο εισόδου. Ο σύνδεσμος ισχύει 12 ώρες.
- Αν έχεις webhook, σου στέλνουμε εκεί αμέσως το API key του πελάτη. Στέλνεται μία φορά μόνο, γι' αυτό αποθήκευσέ το.
- Ο πελάτης βλέπει το ίδιο key στο τελευταίο βήμα της δικής του ρύθμισης. Αν δεν έχεις webhook, από εκεί σου το δίνει.
Το γενικό webhook
Με το κουμπί «Webhook» του Partner Portal ορίζεις ένα γενικό webhook. Κάθε νέος πελάτης, από το Portal ή από το API, ξεκινά με αυτό, εκτός αν του δώσεις δικό του, και στη φόρμα της πρόσκλησης συμπληρώνεται αυτόματα. Οι πελάτες που υπάρχουν ήδη κρατούν το δικό τους. Το webhook ενός πελάτη το αλλάζεις από τη λίστα σου, και η αλλαγή δεν ξαναστέλνει το API key του.
Το ίδιο, από την εφαρμογή σου με το Partners API
Όταν θέλεις η εφαρμογή σου να ανοίγει λογαριασμούς μόνη της, χρησιμοποιείς το Partners API. Το αποτέλεσμα είναι ακριβώς το ίδιο με την πρόσκληση από το Portal: ίδιος λογαριασμός, ίδιο email στον πελάτη, ίδιο webhook.
- Στέλνεις το Partner API key σε κάθε κλήση, στο header
X-PARTNER-API-KEY. - Ελέγχεις αν ο πελάτης σου έχει ήδη λογαριασμό με το
embedded_check_user. - Ανοίγεις λογαριασμό και τον συνδέεις με το
external_login, με τα ίδια email, partner user id και τηλέφωνο. Τον βλέπεις αμέσως στη λίστα σου στο Partner Portal.
Τα πεδία, οι απαντήσεις και τα webhooks είναι στην τεκμηρίωση του Partners API. Για την έκδοση παραστατικών εκ μέρους του πελάτη σου χρησιμοποιείς το δικό του API key με το REST API.
Δοκίμασε πρώτα στο staging
Τα ίδια βήματα γίνονται και στο δοκιμαστικό περιβάλλον. Μέσα στον δοκιμαστικό σου λογαριασμό δημιουργείς δοκιμαστικό partner, με δικό του key που δουλεύει μόνο στο staging.wrapp.ai, και προσκαλείς δοκιμαστικούς πελάτες χωρίς φορολογική ισχύ. Πώς ανοίγεις τον δοκιμαστικό λογαριασμό, ανάλογα με το πού βρίσκεσαι στον δικό σου, το δείχνει ο οδηγός για το δοκιμαστικό API key. Στο wrapp.ai δημιουργείς ξεχωριστό partner για την παραγωγή.
Αν κάτι δεν δουλεύει
| Τι βλέπεις | Γιατί | Τι κάνεις |
|---|---|---|
| «Ο πελάτης υπάρχει ήδη», με το email | Το email χρησιμοποιείται ήδη κάπου στο Wrapp | Χρησιμοποίησε άλλο email για τον πελάτη |
| «Ο πελάτης υπάρχει ήδη», με το partner user id | Έχεις ήδη πελάτη με αυτό το id | Βρες τον στη λίστα σου, ή δώσε το σωστό id |
| «Το webhook πρέπει να είναι έγκυρο http ή https URL» | Η διεύθυνση δεν είναι πλήρες URL | Γράψε την ολόκληρη, με https:// |
| «Υπάρχει ήδη partner με αυτό το όνομα» | Το όνομα το έχει πάρει άλλος partner | Διάλεξε άλλο όνομα |
| «Τον partner τον δημιουργεί ένας διαχειριστής του λογαριασμού σου» | Είσαι επιπλέον χρήστης σε λογαριασμό που έχει ήδη άλλον διαχειριστή | Ζήτα από τον διαχειριστή να πατήσει «Δημιουργία partner» |
| Δεν αποθήκευσες το API key του πελάτη από το webhook | Στέλνεται μία φορά μόνο | Ο πελάτης το βλέπει στο τελευταίο βήμα της ρύθμισής του |
Τι σημαίνει να συνεργαστείς με το Wrapp ως partner, και με ποιους όρους, το βρίσκεις στη σελίδα Γίνε Συνεργάτης. Για να ξεκινήσεις, κάνε δωρεάν εγγραφή.
Συχνές ερωτήσεις
Χρειάζεται να μας ζητήσεις να σε κάνουμε partner;
Όχι. Ο partner δημιουργείται μόνος του, και στο wrapp.ai και στο staging: κάνεις δωρεάν εγγραφή, ανοίγεις Συνδέσεις → «Partner Portal», δίνεις ένα όνομα και πατάς «Δημιουργία partner». Το Partner API key εμφανίζεται αμέσως.
Πρέπει να έχω ολοκληρώσει πρώτα την ενεργοποίηση του λογαριασμού μου;
Όχι. Το Partner Portal ανοίγει και όσο η ρύθμιση του λογαριασμού σου είναι ακόμη σε εξέλιξη, από το ίδιο μενού: Συνδέσεις → «Partner Portal».
Πώς προσκαλώ έναν πελάτη χωρίς να γράψω κώδικα;
Στο Partner Portal πατάς «Πρόσκληση πελάτη», συμπληρώνεις email, partner user id και τηλέφωνο και πατάς «Αποστολή πρόσκλησης». Ο λογαριασμός του πελάτη ανοίγει αμέσως και ο πελάτης παίρνει email με σύνδεσμο εισόδου.
Πόσο ισχύει ο σύνδεσμος που παίρνει ο πελάτης μου;
12 ώρες. Ο σύνδεσμος έρχεται στο email της πρόσκλησης, που έχει θέμα «Αυτόματα παραστατικά myDATA μέσα από το» και το όνομα του partner σου.
Πώς παίρνω το API key του πελάτη μου;
Αν έχεις webhook, σου το στέλνουμε εκεί μόλις ανοίξει ο λογαριασμός. Στέλνεται μία φορά μόνο, γι' αυτό αποθήκευσέ το. Ο πελάτης βλέπει το ίδιο key στο τελευταίο βήμα της δικής του ρύθμισης, οπότε χωρίς webhook σου το δίνει εκείνος.
Τι είναι το partner user id;
Το αναγνωριστικό του πελάτη στο δικό σου σύστημα. Με αυτό αντιστοιχίζεις τον λογαριασμό Wrapp με τον χρήστη σου, και πρέπει να είναι μοναδικό για τον partner σου.
Ποια η διαφορά ανάμεσα στην πρόσκληση από το Portal και το Partners API;
Καμία στο αποτέλεσμα: και οι δύο δρόμοι ανοίγουν τον ίδιο ακριβώς λογαριασμό. Το Portal είναι για όταν προσκαλείς πελάτες έναν έναν. Το API, με το external_login, είναι για όταν η εφαρμογή σου ανοίγει λογαριασμούς μόνη της.
Γιατί η πρόσκληση λέει ότι ο πελάτης υπάρχει ήδη;
Γιατί το email χρησιμοποιείται ήδη κάπου στο Wrapp, ή γιατί έχεις ήδη πελάτη με το ίδιο partner user id. Το μήνυμα σου λέει ποιο από τα δύο.
Μπορώ να δοκιμάσω πρώτα στο staging;
Ναι. Μέσα στον δοκιμαστικό σου λογαριασμό δημιουργείς δοκιμαστικό partner, με δικό του key, και προσκαλείς δοκιμαστικούς πελάτες χωρίς φορολογική ισχύ. Στο wrapp.ai δημιουργείς ξεχωριστό partner για την παραγωγή.
Χρειάζεσαι βοήθεια;
Αν έχεις απορία για αυτό το θέμα ή θέλεις να σιγουρευτείς ότι όλα ρυθμίστηκαν σωστά, επικοινώνησε μαζί μας και θα το δούμε μαζί.