Data Penagihan JSON

Data Penagihan JSON #

Informasi di bawah ini memberikan rincian JSON data yang diberikan saat mengunduh data untuk faktur tertentu. JSON Data memberikan tingkat informasi yang paling terperinci, termasuk entri untuk setiap lisensi pengguna yang digunakan dan entri ringkasan yang memberikan informasi tentang total faktur dan pajak yang berlaku.

Skema Detail Faktur #

Yang utama JSON Entri memberikan detail tentang nomor faktur, periode dan tanggal. Ini juga berisi array item faktur individu yang berhubungan dengan setiap lisensi yang ditagih.

Kunci Deskripsi Jenis
penyewa ID untuk akun reseller induk tali
ID Faktur Nomor unik untuk mengidentifikasi faktur tertentu tali
nomor faktur Nomor faktur yang ditampilkan pada PDF faktur tali
nama akun Nama perusahaan untuk akun reseller induk tali
BillingPeriodStart Tanggal periode penagihan dimulai tali
penagihanperiode akhir Tanggal periode penagihan berakhir tali
nilai faktur Nilai total faktur dobel
item faktur Kumpulan item faktur array (Item Faktur)

JSON Skema Item Faktur #

Setiap entri item faktur di JSON Data penagihan menyediakan parameter yang tercantum di bawah ini. Mereka mengacu pada penggunaan individu oleh pengguna dengan rentang tanggal yang berlaku.

Kunci Deskripsi Jenis
Id ID unik untuk pembelian individu tali
kuantitas1 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 Penyewa2 ID penyewa reseller
TenantCodeext2 Referensi reseller untuk reseller
Nama Penyewa2 Nama reseller tali
Kode Reseller ID penyewa reseller
ResellerCodeExt 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

Contoh JSON Hasil #

{
	"tenantId": "00000000-0000-0000-0000-123456789123",
	"invoiceId": "00000000000000000000000a",
	"invoiceNumber": "9000004",
	"accountName": "Contoh Penyewa 1",
	"billingPeriodStart": "2020-04-01T00:00:00.0000000",
	"billingPeriodEnd": "2020-04-30T23:59:59.0000000",
	"invoiceDate": "2020-04-09T00:00:00.0000000",
	"invoiceValue": 17.50,
	"invoiceItems": \[
		{
			"id": "000000000000000000000001",
			"kuantitas": 1.0,
			"nilai": 1,25,
			"fromDate": "2020-04-01T00:00:00.000+00:00",
			"toDate": "2020-04-30T23:59:59.000+00:00",
			"calculationOrder": 1,
			"operatorUsed": "HARGA",
			"operatorValueUsed": 1.25,
			"productTagName": "Pengguna Penting #XDM00001",
			"billingOutputTags": ["Hasil Pembelian"][ "PurchaseResult" ],
			"stringValues": [
				{
					"name": "Peran",
					"value": "pelanggan.pengguna.pbx"
				},
				{
					"name": "Kode Reseller",
					"nilai": "00000000-0000-0000-0000-0000000000222"
				},
				{
					"name": "ResellerCodeExt",
					"value": "reseller ref 1"
				},
				{
					"name": "ResellerName",
					"value": "Reseller ABC"
				},
				{
					"name": "Kode Penyewa",
					"nilai": "00000000-0000-0000-0000-000000000111"
				},
				{
					"name": "TenantCodeExt",
					"value": "referensi kustom 1"
				},
				{
					"name": "TenantName",
					"value": "Contoh Pelanggan 1"
				},
				{
					"name": "UserId",
					"nilai": "00000000-0000-0000-00000-000000000001"
				},
				{
					"name": "UserName",
					"value": "[email protected]"
				}
			][
				{
					"name": "Role",
					"value": "customer.user.pbx"
				},
				{
					"name": "ResellerCode",
					"value": "00000000-0000-0000-0000-000000000222"
				},
				{
					"name": "ResellerCodeExt",
					"value": "reseller ref 1"
				},
				{
					"name": "ResellerName",
					"value": "ABC Reseller"
				},
				{
					"name": "TenantCode",
					"value": "00000000-0000-0000-0000-000000000111"
				},
				{
					"name": "TenantCodeExt",
					"value": "custom ref 1"
				},
				{
					"name": "TenantName",
					"value": "Example Customer 1"
				},
				{
					"name": "UserId",
					"value": "00000000-0000-0000-0000-000000000001"
				},
				{
					"name": "UserName",
					"value": "[email protected]"
				}
			],
			"numericValues": [
				{
					"nama": "customer_licence_count",
					"nilai": 1
				}
			][
				{
					"name": "customer_licence_count",
					"value": 1
				}
			]
		},
		{
			"id": "000000000000000000000003",
			"kuantitas": 1.0,
			"nilai": 15.0,
			"fromDate": "2020-04-01T00:00:00.000+00:00",
			"toDate": "2020-04-30T23:59:59.000+00:00",
			"calculationOrder": 3,
			"operatorUsed": "HARGA",
			"operatorValueUsed": 15.00,
			"productTagName": "Supervisor Real-Time #XDM00010",
			"billingOutputTags": ["Hasil Pembelian"][ "PurchaseResult" ],
			"stringValues": [
				{
					"name": "Peran",
					"value": "pelanggan.pengguna.supervisorl2"
				},
				{
					"name": "Kode Reseller",
					"nilai": "00000000-0000-0000-0000-0000000000222"
				},
				{
					"name": "ResellerCodeExt",
					"value": "reseller ref 1"
				},
				{
					"name": "ResellerName",
					"value": "Reseller ABC"
				},
				{
					"name": "Kode Penyewa",
					"nilai": "00000000-0000-0000-0000-000000000111"
				},
				{
					"name": "TenantCodeExt",
					"value": "referensi kustom 1"
				},
				{
					"name": "TenantName",
					"value": "Contoh Pelanggan 1"
				},
				{
					"name": "UserId",
					"nilai": "00000000-0000-0000-00000-000000000001"
				},
				{
					"name": "UserName",
					"value": "[email protected]"
				}
			][
				{
					"name": "Role",
					"value": "customer.user.supervisorl2"
				},
				{
					"name": "ResellerCode",
					"value": "00000000-0000-0000-0000-000000000222"
				},
				{
					"name": "ResellerCodeExt",
					"value": "reseller ref 1"
				},
				{
					"name": "ResellerName",
					"value": "ABC Reseller"
				},
				{
					"name": "TenantCode",
					"value": "00000000-0000-0000-0000-000000000111"
				},
				{
					"name": "TenantCodeExt",
					"value": "custom ref 1"
				},
				{
					"name": "TenantName",
					"value": "Example Customer 1"
				},
				{
					"name": "UserId",
					"value": "00000000-0000-0000-0000-000000000001"
				},
				{
					"name": "UserName",
					"value": "[email protected]"
				}
			],
			"numericValues": [
				{
					"nama": "customer_licence_count",
					"nilai": 1
				}
			][
				{
					"name": "customer_licence_count",
					"value": 1
				}
			]
		},
		{
			"id": "000000000000000000000004",
			"kuantitas": 3.0,
			"nilai": 17,50,
			"fromDate": "2020-04-01T00:00:00.000+00:00",
			"toDate": "2020-04-30T23:59:59.000+00:00",
			"calculationOrder": 4,
			"operatorUsed": "SUM",
			"operatorValueUsed": 0.0,
			"productTagName": "Semua Produk",
			"billingOutputTags": ["Ringkasan", "Total", "GL", "GL_Entry:0000; kredit;"][ "Summary", "Total", "GL", "GL_Entry:0000;credit;" ],
			"stringValues": [][ ]
		},
		{
			"id": "000000000000000000000005",
			"kuantitas": 3.0,
			"nilai": 17,50,
			"fromDate": "2020-04-01T00:00:00.000+00:00",
			"toDate": "2020-04-30T23:59:59.000+00:00",
			"calculationOrder": 5,
			"operatorUsed": "ADJUSTPERCENTAGE",
			"operatorValueUsed": 0.0,
			"productTagName": "Semua Produk",
			"billingOutputTags": ["TotalInclVAT", "Ringkasan", "GL_Balance", "GL_Entry:2222; debit; Debitur"][ "TotalInclVAT", "Summary", "GL_Balance", "GL_Entry:2222;debit;Debtors" ],
			"stringValues": [][ ]
		},
		{
			"id": "000000000000000000000006",
			"kuantitas": 345.0,
			"nilai": 0,0,
			"fromDate": "2020-04-01T00:00:00.000+00:00",
			"toDate": "2020-04-30T23:59:59.000+00:00",
			"calculationOrder": 6,
			"operatorUsed": "ADJUSTPERCENTAGE",
			"operatorValueUsed": 0.0,
			"productTagName": "Semua Produk",
			"billingOutputTags": ["TotalVAT", "Ringkasan", "GL_VAT", "PPN:S", "GL_Entry:1111; kredit; PPN"][ "TotalVAT", "Summary", "GL_VAT", "VAT:S", "GL_Entry:1111;credit;VAT" ],
			"stringValues": [][ ]
		}
	],
	"invoiceType": 0
}

  1. Jika entri faktur adalah kredit, kuantitasnya akan menjadi angka negatif. ↩︎

  2. Bidang 'TenantCode', 'TenantCodeExt', dan 'TenantName' diisi dengan informasi tentang akun pelanggan. ↩︎