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?

Ya. API REST JSON DGAssistant dirancang untuk integrasi dengan ERP dan sistem logistik. Para pelanggan telah mengintegrasikannya dengan SAP, SAGE X3, dan beberapa sistem lainnya. Integrasi itu sendiri dilakukan oleh tim TI Anda atau oleh mitra ERP Anda, dengan dukungan berkelanjutan dari tim DGAssistant selama tahap analisis, implementasi, dan peluncuran (go-live).

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 diukur per lisensi: setiap lisensi mencakup 1.500 kiriman dan 10.000 panggilan layanan per tahun, serta memungkinkan basis data menampung hingga 5.000 objek selain kiriman, seperti produk dan pihak terkait (penerima, pemasok, pengemudi, dan lainnya). 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