Gambaran Umum Data Penagihan #
Resource Penagihan menyediakan akses untuk mendownload faktur dan data penagihan dari ~.Dimensions.~.
/{VERSION}/billingdata
Skema Detail Faktur #
Pelanggan mewakili penyewa pada sistem yang dapat ditetapkan oleh Pengguna akhir melalui API.
| Kunci | Deskripsi | Jenis | Ketersediaan |
|---|---|---|---|
| penyewa | ID untuk akun reseller induk | tali | Semua |
| ID Faktur | Nomor unik untuk mengidentifikasi faktur tertentu | tali | Semua |
| nomor faktur | Nomor faktur yang ditampilkan pada PDF faktur | tali | Semua |
| nama akun | Nama perusahaan untuk akun reseller induk | tali | Semua |
| BillingPeriodStart | Tanggal periode penagihan dimulai | tali | Semua |
| penagihanperiode akhir | Tanggal periode penagihan berakhir | tali | Semua |
| nilai faktur | Nilai total faktur | dobel | Semua |
| item faktur | Kumpulan item faktur | array (Item Faktur | Dapatkan Detail Faktur Hanya |
Skema Item Faktur #
Setiap entri dalam data penagihan menyediakan parameter yang tercantum di bawah ini.
| Kunci | Deskripsi | Jenis |
|---|---|---|
| Id | ID untuk akun reseller induk | tali |
| jumlah | Kuantitas yang digunakan | dobel |
| nilai | Biaya barang | dobel |
| Tanggal | Tanggal dari mana item ditagih | tali |
| hingga saat ini | Tanggal dari mana item ditagih ke | tali |
| Urutan perhitungan | Nomor berurutan yang menunjukkan urutan di mana Item Faktur harus diproses | Int |
| Pengguna Digunakan | Menunjukkan bagaimana nilai Item Faktur diterapkan ke faktur | Operator Item Faktur |
| operatorvalueused | Menunjukkan nilai operator ADJUSTPERCENTAGE | dobel |
| Nama Tag Produk | Nama fitur/produk untuk Item Faktur. Ini akan dalam format '{PRODUCT_NAME} #{PART_NUMBER}' | tali |
| billingoutputtags | Indikasi apakah Item Faktur untuk pembelian atau merupakan bidang ringkasan | array (string) |
| stringvalues | Memberikan informasi tentang pelanggan dan pengguna akhir yang ditujukan pembelian | KeyValuePair< string, string> |
| nilai numerik, | Memberikan informasi tentang pelanggan dan pengguna akhir yang ditujukan pembelian | KeyValuePair< string, ganda> |
Operator Item Faktur #
Operator untuk setiap item menunjukkan bagaimana item diterapkan ke tagihan. Hasil Pembelian akan memiliki HARGA untuk mengidentifikasi biaya barang. Item dengan tag keluaran lain akan menunjukkan apakah mereka menjumlahkan nilai tagihan atau menerapkan nilai persentase ke item sebelumnya seperti pajak penjualan.
| Item | Deskripsi |
|---|---|
| HARGA | Menunjukkan Item Faktur menunjukkan harga satuan suatu barang |
| JUMLAH | Menunjukkan Item Faktur menampilkan total beberapa item |
| PERSENTASE PENYESUAIAN | Menunjukkan Item Faktur menunjukkan penyesuaian persentase ke SUM, ini biasanya menunjukkan PPN sedang diterapkan |
Item Tag Output Penagihan #
Tag output penagihan digunakan untuk menunjukkan apakah entri data terkait dengan pembelian atau merupakan entri ringkasan yang memberikan informasi tentang seluruh faktur.
| Item | Deskripsi |
|---|---|
| Hasil Pembelian | Menunjukkan Item Faktur adalah pembelian yang dikenakan biaya |
| Ringkasan | Menunjukkan Item Faktur adalah ringkasan pembelian, memberikan informasi tentang total faktur. Ketika sendiri tanpa tag 'TotalVAT' atau 'TotalInclVAT' maka itu menunjukkan total tagihan sebelum PPN ditambahkan. |
| Totaltermasuk PPN | Menunjukkan Item Faktur menampilkan total faktur termasuk PPN yang berlaku |
| TotalPPN | Menunjukkan Item Faktur menunjukkan total PPN yang berlaku untuk faktur |
Item Nilai String #
Item nilai string memberikan informasi khusus untuk pelanggan dan pengguna akhir dari item yang dibeli.
| Kunci | Deskripsi | |
|---|---|---|
| Kode Penyewa1 | ID penyewa pelanggan | |
| TenantCodeext1 | Referensi reseller untuk pelanggan | |
| Nama Penyewa1 | Nama pelanggan | tali |
| Kode Reseller | ID penyewa reseller | |
| ResellerCodeExt2 | Referensi yang diperluas untuk pengecer | |
| Nama Reseller | Nama pengecer | |
| ID pengguna | ID pengguna | |
| Nama pengguna | Nama pengguna pengguna | |
| peranan | Kunci peran untuk item yang ditagih |
Item Nilai Numerik #
Item nilai numerik memberikan informasi khusus untuk pelanggan dan pengguna akhir dari barang yang dibeli.
| Kunci | Deskripsi |
|---|---|
| customer_licence_count | Jumlah total lisensi yang dimiliki pelanggan |
Antarmuka yang Tersedia #
| Antarmuka | Deskripsi |
|---|---|
| Dapatkan Semua | Mengembalikan kumpulan semua faktur. |
| Dapatkan Faktur | Mengembalikan detail faktur tertentu. |
| Dapatkan Detail Faktur | Mengembalikan JSON & CSV output data faktur tertentu dalam file ZIP. |
| Dapatkan Ringkasan Faktur | Mengembalikan PDF output data dari faktur tertentu. |
-
Bidang 'TenantCode', 'TenantCodeExt', dan 'TenantName' diisi dengan informasi tentang akun pelanggan. ↩︎
-
ResellerCodeExt akan diisi dengan nomor Referensi yang telah dikonfigurasi terhadap reseller. Ini dapat diperbarui sesuai kebutuhan melalui Portal Perusahaan atau melalui Pelanggan API, untuk memungkinkan penautan catatan reseller ke sistem eksternal. ↩︎