Koneksi API ERP ke pihak ketiga
ERP ke pihak ketiga: CRM, logistik, pajak, dan identitas
Koneksi REST, SOAP, webhook, dan iPaaS antara ERP Anda dan layanan di sekitarnya, dengan percobaan ulang dan peringatan.
Blueprint
Gulir ke samping untuk melihat seluruh gambar.
ERP ke pihak ketiga: satu platform, banyak mitra
Peristiwa bisnis keluar dari ERP satu kali, lalu platform integrasi menyampaikannya ke setiap mitra dalam format yang diharapkan. Callback kembali melalui jalur yang sama. Pesan yang tetap gagal setelah percobaan ulang masuk ke antrean pesan gagal dan memicu peringatan dengan payload terlampir.
- Alur utama
- Asinkron
- Jalur pengecualian
Alur dalam 9 langkah
Alur, langkah demi langkah
- Dari ERP ke Platform integrasi: Peristiwa bisnis, melalui REST · OData · webhook (alur utama).
- Dari Platform integrasi ke CRM: Pelanggan dan pesanan, melalui REST/JSON (alur utama).
- Dari Platform integrasi ke Logistik dan pengangkut: Pengiriman yang dipesan, melalui REST/JSON (alur utama).
- Dari Logistik dan pengangkut ke Platform integrasi: Peristiwa pelacakan, melalui webhook (asinkron).
- Dari Platform integrasi ke Platform e-faktur dan pajak: Faktur untuk pengesahan, melalui SOAP/XML · REST (alur utama).
- Dari Platform integrasi ke KYC dan penyedia identitas: Pemeriksaan identitas, melalui REST/JSON (alur utama).
- Dari KYC dan penyedia identitas ke Platform integrasi: Hasil pemeriksaan, melalui webhook (asinkron).
- Dari Platform integrasi ke Antrean pesan gagal dan peringatan: Gagal setelah percobaan ulang, masuk ke antrean pesan gagal (jalur pengecualian).
- Dari Antrean pesan gagal dan peringatan ke Tim dukungan: Peringatan dengan payload dan kesalahan (jalur pengecualian).
Ikhtisar
Inilah alur antara ERP Anda dan layanan di sekitarnya: CRM, pengangkut dan penyedia logistik, platform e-faktur dan pajak, serta penyedia identitas dan KYC. Setiap mitra memiliki API, format, dan kegagalannya sendiri, dan masing-masing biasanya muncul sebagai proyek terpisah.
Rancangan acuan mengirim peristiwa bisnis keluar dari ERP satu kali, ke platform integrasi yang meneruskannya ke setiap mitra dalam format yang diharapkan, melalui REST, SOAP, webhook, atau EDI melalui AS2 bila mitra dagang mensyaratkannya. Callback, seperti peristiwa pelacakan atau hasil pemeriksaan, kembali melalui platform yang sama.
Mitra yang tidak tersedia adalah hal normal, bukan keadaan darurat. Kegagalan sementara dicoba ulang. Pesan yang tetap gagal setelah percobaan ulangnya masuk ke antrean pesan gagal, dan peringatan sampai ke tim dukungan beserta payload dan kesalahannya, sehingga dapat diperbaiki dan dikirim ulang.
Cara alur bekerja
ERP menerbitkan peristiwa
Saat pelanggan, pesanan, atau faktur berubah, ERP menerbitkan satu peristiwa bisnis ke platform integrasi, melalui API, layanan OData, atau webhook.
CRM tetap diperbarui
Platform memperbarui akun, kontak, dan pesanan di CRM, sehingga tim penjualan dan layanan melihat apa yang diketahui ERP.
Pengiriman dipesan
Pesanan yang siap dikirim dipesan ke pengangkut atau penyedia logistik melalui API-nya, dan label serta referensi kembali.
Pelacakan kembali
Pengangkut mengirim peristiwa pelacakan dan bukti pengiriman melalui webhook, dan platform memperbarui pesanan di ERP.
Faktur disahkan
Faktur dikirim ke platform e-faktur atau pajak dalam format yang disyaratkan otoritas, dan status pengesahan disimpan bersama faktur.
Identitas diperiksa
Pelanggan atau pemasok baru dikirim ke penyedia KYC atau identitas, dan hasilnya kembali melalui webhook sebelum akun diaktifkan.
Saat terjadi kegagalan
Mitra untuk sementara tidak tersedia
Panggilan dicoba ulang dengan jeda yang meningkat. Kunci idempotensi pada setiap penulisan memastikan percobaan ulang tidak pernah membuat pengiriman atau faktur kedua.
Pesan tetap gagal setelah percobaan ulangnya
Pesan masuk ke antrean pesan gagal bersama payload dan kesalahan dari mitra, dan tim dukungan diberi peringatan. Setelah diperbaiki, pesan dikirim ulang dari antrean.
Mitra mengubah API-nya
Uji kontrak dijalankan terhadap lingkungan pengujian setiap mitra dan menangkap perubahan tersebut. Perubahan yang diumumkan dijadwalkan dan diuji sebelum tenggat mitra.
Data ditolak
Mitra yang menolak data karena alasan bisnis, misalnya nomor pajak tidak ada, mengirimkan kesalahan kembali ke catatan ERP, tempat pemiliknya dapat memperbaikinya.
Standar dan sistem
- Integrasi
- REST
- SOAP
- Webhooks
- OpenAPI
- EDI (EDIFACT, ANSI X12)
- AS2
- MuleSoft
- Boomi
- Azure Logic Apps
- Identitas dan akses
- OAuth 2.0
Pertanyaan dan jawaban
Layanan pihak ketiga apa yang dapat Anda hubungkan?
Layanan apa pun yang memiliki API atau antarmuka berkas yang terdokumentasi. Contoh umumnya adalah platform CRM, pengangkut dan penyedia logistik, marketplace, platform e-faktur dan pajak, penggajian, penyedia KYC dan identitas, serta mitra dagang yang bertukar dokumen EDI melalui AS2. Kami menelaah API, batas pemakaian, dan lingkungan pengujian setiap mitra sebelum berkomitmen pada sebuah rencana.
Apakah Anda memerlukan platform integrasi untuk ini?
Setelah beberapa mitra terhubung ke satu ERP, platform seperti MuleSoft, Boomi, atau Azure Logic Apps, atau sekumpulan layanan kustom yang dibangun di atas antrean pesan, menjaga pemetaan, percobaan ulang, dan pemantauan di satu tempat. Dengan satu atau dua mitra, koneksi langsung bisa cukup. Kami menjabarkan pertimbangan untung-ruginya, termasuk biaya lisensi, untuk kasus Anda.
Dapatkah Anda menghubungkan kami ke platform e-faktur dan pengesahan pajak?
Ya. Banyak negara kini mewajibkan faktur diterbitkan atau disahkan melalui platform pemerintah atau platform terakreditasi dalam format tertentu. Kami mengintegrasikan ERP dengan platform yang diwajibkan di negara Anda atau dengan penyedia terakreditasi, menyimpan status pengesahan dan pengenal bersama setiap faktur, dan menangani penolakan. Penasihat pajak Anda memastikan aturan yang berlaku bagi Anda.
Bagaimana Anda mengamankan webhook yang masuk?
Setiap webhook yang masuk diverifikasi sebelum diproses: melalui tanda tangan bila mitra menandatangani pesannya, dan melalui pemeriksaan token, sumber, serta stempel waktu bila tidak. Payload divalidasi terhadap kontrak, dan peristiwa diproses satu kali meskipun mitra mengirimnya lebih dari sekali.
Apa yang terjadi bila mitra mengalami gangguan?
Alur lainnya tetap berjalan. Pesan untuk mitra tersebut dicoba ulang lalu masuk antrean, tim dukungan diberi peringatan, dan tidak ada yang hilang. Saat mitra pulih, pesan dalam antrean dikirim ulang sesuai urutan. Dasbor menunjukkan mitra mana yang terdampak dan berapa pesan yang menunggu.
Siapa yang memiliki konektor yang Anda bangun?
Kekayaan intelektual atas pekerjaan yang kami bangun untuk Anda menjadi milik Anda sejak commit pertama — tanpa langkah pengalihan di akhir. Konektor diserahkan bersama kode sumber, pengujian, dan dokumentasinya, sehingga tim Anda atau pemasok lain dapat memeliharanya. Alat XSIS apa pun yang sudah ada sebelumnya tetap milik kami dan dilisensikan kepada Anda. API mitra dan lisensi platform integrasi tetap tunduk pada ketentuan vendor masing-masing.
Mulai dengan percakapan, bukan kontrak.
Sampaikan apa yang perlu Anda bangun, hubungkan atau amankan. Arsitek kami membahasnya bersama Anda, lalu menyarankan titik awal.
Yang terjadi selanjutnya
Menyepakati waktu
Tim kami mengirim email kepada Anda untuk menyepakati waktu sesi.
Sesi pra-konsultasi
sesi pra-konsultasi online gratis selama 30 menit: kami membahas sasaran, sistem, dan kendala Anda.
Tinjauan kesiapan
Dalam tinjauan kesiapan gratis selama 48 jam, Arsitek Utama memeriksa proyek Anda terhadap definisi siap 6 poin dan merekomendasikan jalur yang sesuai.
Memilih jalur
Proyek yang lingkupnya sudah siap menerima proposal yang mengikat dalam 3–5 hari kerja. Proyek pada tahap konsep dimulai di Blueprint Studio. Sistem yang sedang berjalan tetapi gagal, tidak terdokumentasi, atau perlu integrasi dimulai dengan diagnostik senilai 1–2 minggu. Blueprint Studio dan diagnostik masing-masing memiliki biaya tetap yang dicantumkan dalam proposal.