Langsung ke konten

Bantuan

Integrasi API dan ERP

Bagaimana DGAssistant terintegrasi dengan ERP, WMS, atau platform pengiriman Anda.

Apakah DGAssistant dapat diintegrasikan dengan ERP saya — SAP, SAGE X3, Dynamics, Navision — atau dengan platform logistik saya?

Ya. API REST JSON DGAssistant dirancang untuk integrasi dengan sistem ERP dan platform logistik, dan dapat digunakan oleh sistem apa pun yang mampu menggunakan layanan web REST dengan JSON, yang saat ini mencakup hampir semua sistem. Para pelanggan telah mengintegrasikannya dengan SAP, SAGE X3, dan beberapa sistem lainnya. Integrasi itu sendiri dilakukan oleh tim TI Anda atau oleh mitra yang memelihara sistem Anda, dengan dukungan berkelanjutan dari tim DGAssistant selama tahap analisis, implementasi, dan peluncuran (go-live). Spesifikasi lengkap dipublikasikan dalam dokumentasi API barang berbahaya.

Apakah saya memerlukan modul khusus untuk menggunakan API?

Ya, API merupakan modul yang dilisensikan secara terpisah, sebagai tambahan atas lisensi standar Anda. Anda dapat menambahkannya ke langganan Anda ketika memutuskan untuk melakukan integrasi.

Bagaimana penggunaan API diukur dan ditetapkan harganya?

Penggunaan API DGAssistant diukur per lisensi: setiap lisensi mencakup 20.000 panggilan per tahun, dengan hingga 1.500 di antaranya untuk membuat kiriman, serta memungkinkan basis data menampung hingga 5.000 data induk: produk, pihak terkait, lokasi sendiri, kendaraan, kereta gandengan, dan kapal. Sesuai dengan ketentuan penggunaan, setiap kiriman mewakili satu pengangkutan nyata dengan dokumen pengangkutannya sendiri. Jika Anda memperkirakan volume yang lebih besar, Anda cukup menambahkan lisensi tambahan. Harga satuan yang pasti untuk modul API ditampilkan bersama katalog lainnya di toko kami dan dapat dicantumkan dalam penawaran harga khusus mana pun.

Apa dua cara menggunakan API: sekaligus (batch) atau interaktif?

Mode sekaligus (batch) menerima spesifikasi kiriman secara lengkap dalam satu panggilan layanan — ideal apabila ERP sudah mengetahui barang, pihak terkait, dan kuantitasnya. Mode interaktif memungkinkan Anda menyusun kiriman langkah demi langkah dan memvalidasi setiap barang saat ditambahkan; cara ini lebih mirip dengan cara kerja aplikasi web dan berguna apabila Anda memerlukan alur kerja yang digerakkan oleh pengguna di atas API.

Sebaiknya saya membuat produk dan pihak terkait terlebih dahulu, atau secara "seketika"?

Keduanya didukung. Pendekatan yang direkomendasikan adalah "data yang telah ditentukan": buat barang dan pihak terkait Anda satu kali di aplikasi web (atau impor), lalu rujuk dengan kodenya dalam panggilan API Anda. Pendekatan "seketika" memungkinkan Anda mengirimkan semua data dalam setiap panggilan, yang praktis apabila ERP Anda merupakan sumber induk data tersebut dan Anda tidak ingin memuatnya terlebih dahulu.

Bagaimana cara memperoleh PDF yang dihasilkan melalui API?

Ada dua pilihan. Anda dapat menerima dokumen dalam respons API sebagai PDF yang dikodekan dalam base64 (dokumen pengangkutan, deklarasi pengirim, daftar periksa, penandaan bungkusan, dan lain-lain), atau meminta platform mengirimkannya secara otomatis melalui surel ke alamat yang telah dikonfigurasi.

Apakah saya dapat mencetak dokumen yang dihasilkan API secara otomatis?

Ya. Ada dua pola yang efektif: (a) ERP Anda mengunduh PDF dari API dan mengirimkannya ke antrean cetaknya sendiri; (b) DGAssistant mengirimkan dokumen melalui surel ke kotak surat khusus, lalu utilitas cetak otomatis kecil di sisi Anda mencetaknya pada printer yang tepat. Banyak pelanggan menggunakan pola surel karena tidak memerlukan kode tambahan di sisi ERP.

Di mana spesifikasi API dapat ditemukan?

Spesifikasi OpenAPI lengkap dipublikasikan dalam dokumentasi API barang berbahaya. Kami juga menyediakan proyek SoapUI yang sudah dimuati panggilan uji yang realistis, sehingga para pengembang Anda dapat menjelajahi API dalam hitungan menit.

Apa itu requestGuid dan mengapa diperlukan?

Setiap panggilan API harus menyertakan requestGuid yang unik, yang mengidentifikasi permintaan tersebut dalam log kami dan memungkinkan tim dukungan kami menemukan transaksi yang tepat ketika Anda melaporkan suatu masalah. Nilai alfanumerik unik apa pun dapat diterima; kami menyarankan untuk membuat UUID/GUID standar di sisi klien.

Apa penyebab paling umum kegagalan panggilan API pada percobaan pertama?

Kredensial yang tidak diterima oleh layanan: header HTTP Basic Authorization yang tidak ada atau salah, atau, apabila panggilan diautentikasi dengan OAuth2, token akses yang tidak pernah diminta, yang berasal dari lingkungan lain, atau yang sudah kedaluwarsa. Tersedia URL dukungan khusus yang dapat Anda akses untuk memastikan bahwa API aktif dan kredensial Anda valid. Jika Anda mengalami kendala, kirimkan kepada kami permintaan dan respons HTTP secara lengkap (termasuk requestGuid) beserta uraian perilaku yang diharapkan — itulah cara tercepat untuk menyelesaikan masalah.

Kembali ke Bantuan

Untuk melihat betapa cepat dan mudahnya, Anda dapat mencobanya selama dua minggu tanpa kewajiban apa pun