Bolehkah Saya Mendapatkan Pesanan GoFood, GrabFood dan ShopeeFood ke Dalam POS Saya Sendiri melalui API, Tanpa Menukar POS?
Jawapan ringkas: ya. Anda mengekalkan POS, ERP atau sistem dapur anda sendiri. Aplikasi penghantaran bersambung ke klikit, dan sistem anda bersambung ke klikit melalui API Rakan Kongsi klikit: webhook memberitahu sistem anda sebaik sahaja pesanan dibuat, berubah status atau itemnya berubah, dan sistem anda boleh membaca pesanan penuh melalui REST. Anda membina dan menguji menggunakan kotak pasir percuma. Akses pengeluaran disemak oleh klikit. Anda tidak perlu membeli pakej klikit di atasnya: yuran API Rakan Kongsi meliputinya, dengan harga indikatif bermula dari AS$49 setiap cawangan sebulan untuk 1–10 cawangan.
Untuk Siapa Ini
- Kumpulan restoran yang mempunyai POS atau ERP sendiri yang mahu pesanan penghantaran masuk ke dalam sistem yang telah mereka jalankan, bersama stok dan pelaporan mereka sendiri.
- Vendor POS dan ERP yang pelanggannya meminta pesanan GoFood, GrabFood dan ShopeeFood di dalam produk vendor tersebut.
- Integrator dan agensi yang membina sambungan ini untuk seorang peniaga.
Sekiranya anda lebih suka menggunakan POS dan skrin pesanan klikit sendiri, anda tidak memerlukan API: add-on Omni menyambungkan aplikasi penghantaran secara terus. Lihat pakej.
Cara Ia Berfungsi
- Aplikasi penghantaran bersambung ke klikit. Cawangan anda disediakan di klikit, dan GoFood, GrabFood, ShopeeFood serta aplikasi lain yang anda jual di situ disambungkan. Setiap pesanan daripada setiap aplikasi tiba di klikit dalam satu format.
- klikit menolak setiap acara pesanan ke sistem anda. Anda memberikan klikit URL penerima dan melanggan tiga acara:
klikit.order.created.v2: pesanan baharu.klikit.order.status.updated: pesanan bergerak ke peringkat seterusnya, termasuk pembatalan.klikit.order.cart.updated: item atau kuantiti dalam pesanan berubah.
- Sistem anda membaca butiran. Titik akhir REST mengembalikan pesanan penuh (butiran troli, pelanggan, pembayaran dan pemenuhan), senarai pesanan yang ditapis mengikut jenama, cawangan, status dan tarikh, serta menu setiap kedai dengan penggantian yang dikenakan.
- Sistem anda menulis semula (pada API Rakan Kongsi penuh): gerakkan pesanan melalui diterima, sedia dan diambil, atau tolak atau batalkannya dengan kod sebab, dan tandakan item menu sebagai ada atau tiada stok, satu demi satu atau secara pukal.
Setiap kelayakan diskopkan kepada satu perniagaan, jadi kunci hanya boleh melihat jenama dan cawangan perniagaan tersebut. Pengesahan adalah HTTP Basic dengan kunci rakan kongsi dan rahsia.
Kotak Pasir dan Pengujian
Ya, terdapat kotak pasir, dan ia percuma. Persekitaran pembangunan klikit adalah kotak pasir: ia mempunyai data realistik dalam bentuk yang sama seperti pengeluaran, dan kelayakan berasingan, jadi apa-apa yang anda lakukan di sana tidak menyentuh pesanan langsung. Log masuk ke Portal Rakan Kongsi dengan e-mel kerja anda, baca trek Getting Started dan Playbook Integrasi, dan mohon kunci kotak pasir. Playbook membawa anda daripada panggilan pertama kepada pesanan ujian yang boleh anda terima, tandakan sedia dan tandakan diambil.
Mendapatkan Akses Pengeluaran
Kunci pengeluaran bukan layan diri. Anda memohon dari portal dengan peniaga yang anda integrasikan, entiti undang-undang anda dan kes penggunaan anda, dan pasukan klikit mengesahkan peniaga serta skop sebelum anda boleh menjana kunci pengeluaran. Kunci pengeluaran ditunjukkan sekali dan boleh dibatalkan pada bila-bila masa.
Kosnya
Yuran API Rakan Kongsi adalah keseluruhan kos: anda tidak memerlukan pakej POS klikit (Core atau Omni) juga. Harga indikatif, dalam dolar AS. Harga muktamad disahkan semasa kelulusan pengeluaran, berdasarkan cawangan aktif dan volum pesanan.
| Tier | Cawangan | Harga | Termasuk |
|---|---|---|---|
| Sandbox | Mana-mana | Percuma, sentiasa | Persekitaran pembangunan |
| Starter | 1–10 | AS$49 / cawangan / bulan | Webhook sahaja, acara pesanan dan menu, sokongan standard |
| Growth | 11–50 | AS$39 / cawangan / bulan | Webhook sahaja, acara pesanan dan menu, sokongan keutamaan |
| Scale | 51–200 | AS$29 / cawangan / bulan + yuran binaan tersuai | API Rakan Kongsi penuh, Inventori dan Disbursement, ketua integrasi yang dinamakan |
| Enterprise | 200+ | Tersuai + yuran binaan | Semua dalam Scale, harga volum, SLA tersuai |
Jadi, kumpulan 24 cawangan termasuk dalam Growth, pada indikatif AS$39 setiap cawangan sebulan. Jika anda perlu menulis status pesanan atau stok kembali ke klikit pada saiz itu, nyatakan semasa anda memohon: API Rakan Kongsi penuh disenaraikan dari tier Scale.
Soalan Lazim
Bolehkah saya melanggan integrasi aplikasi penghantaran sahaja, tanpa menggunakan POS klikit?
Ya. Kakitangan anda terus menggunakan POS anda sendiri. Cawangan anda masih disediakan di klikit, kerana di situlah aplikasi penghantaran bersambung, dan POS anda mengambil pesanan daripada klikit melalui API Rakan Kongsi. Anda tidak membayar untuk pakej POS klikit juga: yuran API Rakan Kongsi meliputinya.
Adakah terdapat webhook untuk pesanan baharu GoFood, GrabFood dan ShopeeFood?
Ya. klikit.order.created.v2 dicetuskan untuk pesanan baharu daripada setiap aplikasi penghantaran yang disambungkan, jadi anda menulis satu penerima dan bukannya satu untuk setiap aplikasi. Perubahan status (termasuk pembatalan) dan perubahan item atau kuantiti mempunyai acara tersendiri.
Adakah anda mengenakan caj setiap pesanan?
Harga indikatif API Rakan Kongsi adalah setiap cawangan sebulan. Harga muktamad disahkan semasa kelulusan pengeluaran dan mengambil kira cawangan aktif serta volum pesanan.
Berapa lama masa yang diambil?
Kunci kotak pasir adalah laluan pantas sebaik sahaja anda log masuk dan memohon. Playbook Integrasi ditulis sebagai pelan berfasa, daripada panggilan pertama melalui webhook kepada senarai semak pengeluaran. Tempoh pembinaan bergantung pada sistem anda; akses pengeluaran menyusul selepas semakan peniaga dan skop oleh pasukan klikit.
Adakah terdapat portal pembangun awam atau kunci API layan diri?
Dokumentasi dan permohonan kotak pasir terdapat di Portal Rakan Kongsi. Kelayakan pengeluaran hanya dikeluarkan selepas pasukan klikit meluluskan permohonan; anda tidak boleh menjananya dari dalam klikit Cloud.
Kami sudah menggunakan integrasi GrabFood atau GoFood klikit. Adakah itu termasuk akses API?
Tidak. Integrasi aplikasi penghantaran membawa pesanan ke dalam klikit untuk peniaga. Akses API ke klikit untuk sistem anda sendiri adalah API Rakan Kongsi, yang merupakan permohonan berasingan. Lihat Adakah klikit mempunyai API untuk pembangun atau rakan kongsi?
Langkah Seterusnya
Baca gambaran keseluruhan API Rakan Kongsi, muat turun primer dari Portal Rakan Kongsi, dan mohon kunci kotak pasir. Jika anda adalah kumpulan restoran dan bukan pembangun, hubungi kami dan beritahu kami cawangan anda, aplikasi yang anda jual dan POS atau ERP yang anda jalankan.