Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Umpan data acara penagihan
Umpan data ini memberikan informasi tentang peristiwa penagihan, termasuk faktur dan pencairan.
Misalnya, Anda dapat menggunakan umpan data ini untuk mempelajari kapan dan apa yang ditagih oleh pembeli. Anda juga dapat menggunakan contoh SQL kueri untuk menganalisis data dari umpan data ini.
Umpan data ini berisi informasi yang terkait dengan peristiwa penagihan di mana Anda adalah penjual catatan. Untuk perjanjian yang dibuat melalui mitra saluran, umpan data ini berisi informasi tentang peristiwa penagihan antara produsen dan penjual rekaman.
Umpan data acara penagihan diperbarui setiap 24 jam, sehingga data baru tersedia setiap hari.
Data acara penagihan tidak dapat diubah.
Tabel berikut menjelaskan nama dan deskripsi kolom umpan data.
Nama kolom | Deskripsi |
---|---|
billing_event_id | Pengenal untuk acara penagihan. ID ini unik di lingkungan penjual. |
dari_account_id |
Akun yang memulai acara penagihan. Jika Dapat digunakan untuk bergabung ke umpan |
to_account_id | Akun yang menerima jumlah transaksi untuk produk. Ini adalah kunci asing untuk umpan data akun. Dapat digunakan untuk bergabung ke umpan |
end_user_account_id | Akun yang menggunakan produk. Akun ini mungkin berbeda dari akun pembeli dan pembayar. Dapat digunakan untuk bergabung ke umpan |
product_id | Pengidentifikasi produk. Ini adalah kunci asing untuk umpan data produk. Dapat digunakan untuk bergabung ke umpan |
tindakan |
Jenis tindakan untuk acara ini. Kemungkinan nilainya adalah sebagai berikut:
|
transaction_type |
Jenis transaksi. Sebagai contoh, lihat Skenario perpajakan. Kemungkinan nilainya adalah sebagai berikut:
|
parent_billing_event_id |
Ketika nilai dari Ketika nilai dari
Ketika nilai
Ketika nilai dari |
disbursement_billing_event_id |
Pencairan terkait ketika nilai
Dalam semua skenario lainnya, nilai ini adalah nol. |
jumlah | Jumlah acara penagihan. |
mata uang | Kode mata uang ISO 639. |
balance_impacting | Apakah jumlah tersebut diperhitungkan dalam menghitung pencairan penjual. Nilai 0 menunjukkan jumlah ditampilkan untuk tujuan informasi dan tidak berpengaruh pada saldo. Nilai 1 menunjukkan bahwa jumlah ini diperhitungkan dalam menentukan pencairan penjual. |
invoice_date | Tanggal faktur dibuat. |
pembayaran_due_date |
Ketika nilainya |
usage_period_start_date | Tanggal mulai untuk periode dalam catatan. |
usage_period_end_date | Tanggal akhir untuk periode dalam catatan. |
invoice_id |
ID AWS faktur. |
billing_address_id | Referensi alamat penagihan pembayar di umpan data alamat. Dapat digunakan untuk bergabung ke umpan |
transaction_reference_id |
Pengidentifikasi yang memungkinkan Anda mereferensikan data silang dari laporan berikut: |
bank_trace_id |
Untuk transaksi pencairan ( |
broker_id |
Pengenal entitas bisnis yang memfasilitasi transaksi. Kemungkinan nilainya adalah sebagai berikut:
|
buyer_transaction_reference_id |
Pengidentifikasi yang mengelompokkan semua catatan terkait dalam umpan penagihan bersama-sama menggunakan |
Skenario perpajakan
Model perpajakan yang berlaku untuk negara dan negara bagian pembeli dan penjual menentukan bagaimana pajak dikumpulkan dan dikirimkan. Berikut ini adalah skenario yang mungkin:
-
Pajak dikumpulkan dan disetorkan oleh AWS. Dalam kasus ini,
transaction_type
adalahAWS_TAX_SHARE
. -
Pajak dikumpulkan oleh AWS, dicairkan kepada penjual, dan dikirimkan oleh penjual ke otoritas pajak. Dalam kasus ini,
transaction_type
adalahSELLER_TAX_SHARE
. -
Pajak tidak dipungut oleh AWS. Penjual harus menghitung pajak dan mengirimkannya ke otoritas pajak. Dalam kasus ini, AWS Marketplace tidak melakukan perhitungan pajak atau menerima informasi pajak. Penjual membayar pajak dari bagian pendapatan.
Contoh umpan data peristiwa penagihan
Bagian ini menunjukkan contoh periode data peristiwa penagihan pada saat faktur dan satu bulan kemudian. Perhatikan hal berikut untuk semua tabel di bagian ini:
-
Dalam umpan data,
billing_event_id
nilainya adalah string alfanumerik 40 karakter. Mereka ditampilkan di sini sebagai string dua karakter untuk keterbacaan. -
Dalam umpan data, informasi ini disajikan dalam satu tabel. Untuk keterbacaan, data ditampilkan dalam beberapa tabel di sini, dan semua kolom tidak ditampilkan.
Untuk contoh di bagian ini, asumsikan yang berikut:
-
Arnav adalah pembeli.
-
ID akunnya adalah
737399998888
. -
Dia berlokasi di Prancis, yang tunduk pada undang-undang fasilitator pasar. Untuk informasi selengkapnya, lihat Bantuan Pajak Layanan Web Amazon
. -
Dia membeli
prod-o4grxfafcxxxx
dan ditagih $120,60 untuk penggunaan bulanannya atas produk itu. -
Dia membayar faktur dalam sebulan.
-
-
Jane adalah pabrikannya.
-
ID akunnya adalah
111122223333
.
-
-
Paulo adalah penjual rekaman.
-
ID akunnya adalah
777788889999
. -
Dia tinggal di Kansas, yang tidak tunduk pada undang-undang fasilitator pasar.
-
Umpan data acara penagihan untuk penjual catatan
Sebagai penjual catatan, Paulo menagih pembeli, Arnav.
Tabel berikut menunjukkan informasi yang relevan dalam umpan data Paulo ketika dia menagih Arnav.
billing_event_id | dari_account_id | to_account_id | end_user_account_id | product_id | tindakan | transaction_type |
---|---|---|---|---|---|---|
I0 | 737399998888 | 777788889999 | 737399998888 | prod-o4grxfafcxxxx | INVOICED | SELLER_REV_SHARE |
I1 | 737399998888 | AWS | 737399998888 | prod-o4grxfafcxxxx | INVOICED | AWS_TAX_SHARE |
I2 | 777788889999 | 111122223333 | 737399998888 | prod-o4grxfafcxxxx | INVOICED | SELLER_REV_SHARE |
I3 | 777788889999 | AWS | 737399998888 | prod-o4grxfafcxxxx | INVOICED | AWS_REV_SHARE |
parent_billing_event_id | disbursement_billing_event_id | jumlah | mata uang | invoice_date | invoice_id |
---|---|---|---|---|---|
100 | USD | 2018-12-31T 00:00:00 Z | 781216640 | ||
20.6 | USD | 2018-12-31T 00:00:00 Z | 781216640 | ||
-80 | USD | 2018-12-31T 00:04:07 Z | 788576665 | ||
-0,2 | USD | 2018-12-31T 00:04:07 Z | 788576665 |
Tabel berikut menunjukkan informasi yang relevan dalam umpan data Paulo pada akhir bulan, setelah Arnav membayar faktur.
billing_event_id | dari_account_id | to_account_id | end_user_account_id | product_id | tindakan | transaction_type |
---|---|---|---|---|---|---|
I10 | 737399998888 | 777788889999 | 737399998888 | DISBURSED | SELLER_REV_SHARE | |
I12 | 777788889999 | 111122223333 | 737399998888 | DISBURSED | SELLER_REV_SHARE | |
I13 | 777788889999 | AWS | 737399998888 | prod-o4grxfafcxxxx | DISBURSED | AWS_REV_SHARE |
I14 | AWS | 777788889999 | DISBURSED | DISBURSEMENT |
parent_billing_event_id | disbursement_billing_event_id | jumlah | mata uang | invoice_date | invoice_id |
---|---|---|---|---|---|
I0 | I14 | -100 | USD | 2018-12-31T 00:00:00 Z | 781216640 |
I2 | I14 | 80 | USD | 2018-12-31T 00:04:07 Z | 788576665 |
I3 | I14 | 0,2 | USD | 2018-12-31T 00:04:07 Z | 788576665 |
19.8 | USD |
Umpan data acara penagihan untuk produsen
Tabel berikut menunjukkan informasi yang relevan dalam umpan data Jane ketika Paulo menagih Arnav.
billing_event_id | dari_account_id | to_account_id | end_user_account_id | product_id | tindakan | transaction_type |
---|---|---|---|---|---|---|
I5 | 777788889999 | 111122223333 | prod-o4grxfafcxxxx | INVOICED | SELLER_REV_SHARE | |
I6 | 777788889999 | 111122223333 | prod-o4grxfafcxxxx | INVOICED | SELLER_TAX_SHARE | |
I7 | 111122223333 | AWS | prod-o4grxfafcxxxx | INVOICED | AWS_REV_SHARE |
parent_billing_event_id | disbursement_billing_event_id | jumlah | mata uang | invoice_date | invoice_id |
---|---|---|---|---|---|
73.5 | 2018-12-31T 00:04:07 Z | 788576665 | |||
6.5 | 2018-12-31T 00:04:07 Z | 788576665 | |||
-7,35 | 2018-12-31T 00:04:07 Z | 788576665 |
Tabel berikut menunjukkan informasi yang relevan dalam umpan data Jane pada akhir bulan, setelah faktur dibayar.
billing_event_id | dari_account_id | to_account_id | end_user_account_id | product_id | tindakan | transaction_type |
---|---|---|---|---|---|---|
I30 | 777788889999 | 111122223333 | prod-o4grxfafcxxxx | DISBURSED | SELLER_REV_SHARE | |
I31 | 777788889999 | 111122223333 | prod-o4grxfafcxxxx | DISBURSED | SELLER_TAX_SHARE | |
I32 | 111122223333 | AWS | prod-o4grxfafcxxxx | DISBURSED | AWS_REV_SHARE | |
I33 | AWS | 111122223333 | DISBURSED | DISBURSEMENT |
parent_billing_event_id | disbursement_billing_event_id | jumlah | mata uang | invoice_date | invoice_id |
---|---|---|---|---|---|
I5 | I33 | -73,5 | USD | ||
I6 | I33 | -6,5 | USD | ||
I7 | I33 | 7.35 | USD | ||
72,65 | USD |
Kueri contoh
Seperti dijelaskan dalamMengumpulkan dan menganalisis data dengan umpan data, Anda dapat menggunakan Athena untuk menjalankan kueri pada data yang dikumpulkan dan disimpan sebagai umpan data di bucket Amazon S3 terkelola. Bagian ini memberikan beberapa contoh cara umum yang mungkin Anda lakukan ini. Semua contoh berasumsi bahwa satu mata uang digunakan.
Contoh 1: Jumlah yang ditagih, termasuk pajak
Untuk mengetahui berapa banyak pembeli yang ditagih, termasuk pajak, Anda dapat menjalankan kueri seperti yang ditunjukkan pada contoh berikut.
SELECT sum(amount) FROM billing_event WHERE action = 'INVOICED' AND ( (transaction_type in ('SELLER_REV_SHARE', 'SELLER_TAX_SHARE') -- to discard SELLER_REV_SHARE from Manufacturer to Channel Partner, aka cost of goods AND to_account_id='
seller-account-id
' ) OR transaction_type= 'AWS_TAX_SHARE' );
Contoh 2: Jumlah yang ditagih kepada pembeli atas nama penjual
Untuk mengetahui berapa banyak pembeli yang ditagih atas nama penjual, Anda dapat menjalankan kueri seperti yang ditunjukkan pada contoh berikut.
SELECT sum(amount) FROM billing_event WHERE action = 'INVOICED' AND transaction_type in ('SELLER_REV_SHARE', 'SELLER_TAX_SHARE') AND to_account_id='
seller-account-id
' ;
Contoh 3: Jumlah AWS dapat dikumpulkan atas nama penjual
Untuk mengetahui berapa banyak yang AWS dapat dikumpulkan atas nama penjual, dikurangi pengembalian uang, kredit, dan akun yang dimaafkan, Anda dapat menjalankan kueri seperti yang ditunjukkan pada contoh berikut.
SELECT sum(amount) FROM billing_event WHERE -- what is invoiced on behalf of SELLER, incl. refunds/ credits and cost of goods transaction_type like 'SELLER_%' -- FORGIVEN action records will "negate" related INVOICED and action in ('INVOICED','FORGIVEN') ;
Contoh 4: Jumlah penjual dapat mengumpulkan
Untuk mengetahui berapa banyak penjual dapat mengumpulkan, Anda dapat menjalankan kueri seperti yang ditunjukkan pada contoh berikut. Contoh ini menghapus biaya listing dan pajak yang AWS mengumpulkan, dan menambahkan penyesuaian saldo yang luar biasa.
SELECT sum(amount) FROM billing_event WHERE (transaction_type like 'SELLER_%' -- what is invoiced on behalf of SELLER or transaction_type like 'AWS_REV_%' -- what is owed to AWS or transaction_type = 'BALANCE_ADJUSTMENT' -- exceptionnal case ) and action in ('INVOICED','FORGIVEN') ;
Anda juga dapat menggunakan query berikut untuk mengumpulkan informasi yang sama, seperti yang ditunjukkan pada contoh berikut.
SELECT sum(amount) FROM billing_event WHERE balance_impacting = 1 and action in ('INVOICED','FORGIVEN') ;
Contoh berikut menunjukkan informasi yang sama, tetapi dibatasi untuk transaksi 2018 dan mengasumsikan semua pembeli membayar faktur mereka.
SELECT sum(amount) FROM billing_event WHERE invoice_date between '2018-01-01' and '2018-12-31' and balance_impacting = 1 and action in ('INVOICED','FORGIVEN') ;
Contoh 5: Jumlah pencairan
Untuk mengetahui jumlah yang telah dicairkan, Anda dapat menjalankan kueri seperti yang ditunjukkan pada contoh berikut.
select sum(amount) FROM billing_event WHERE action ='DISBURSED' and transaction_type like 'DISBURSEMENT%' ;
Contoh 6: Jumlah pencairan yang tertunda
Untuk mengetahui jumlah pembayaran yang tertunda, Anda dapat menjalankan kueri seperti yang ditunjukkan pada contoh berikut. Kueri ini menghapus jumlah yang telah dicairkan.
SELECT sum(amount) FROM billing_event targeted WHERE (transaction_type like 'SELLER_%' -- what is invoiced on behalf of SELLER or transaction_type like 'AWS_REV_%' -- what is owed to AWS or transaction_type = 'BALANCE_ADJUSTMENT' -- exceptionnal case ) -- DISBURSEMENT action records will "negate" 'INVOICED' -- but do not take into account failed disbursements AND (not exists (select 1 from billing_event disbursement join billing_event failed_disbursement on disbursement.billing_event_id=failed_disbursement.parent_billing_event_id where disbursement.transaction_type='DISBURSEMENT' and failed_disbursement.transaction_type='DISBURSEMENT_FAILURE' and targeted.disbursement_billing_event_id=disbursement.billing_event_id ) ) ;
Cara lain untuk mendapatkan informasi yang sama adalah dengan menjalankan kueri untuk mendapatkan saldo penjual, seperti yang ditunjukkan pada contoh berikut.
SELECT sum(amount) FROM billing_event WHERE balance_impacting = 1 ;
Kueri berikut memperluas contoh kita. Ini membatasi hasil untuk transaksi 2018 dan mengembalikan rincian tambahan tentang transaksi.
select sum(residual_amount_per_transaction) from (SELECT max(billed_invoices.amount) invoiced_amount, sum(nvl(disbursed_invoices.amount,0)) disbursed_amount, -- Exercise left to the reader: -- use transaction_type to distinguish listing fee vs seller-owed money -- still pending collection max(transaction_type) transaction_type, max(billed_invoices.amount) + sum(nvl(disbursed_invoices.amount,0)) residual_amount_per_transaction FROM billing_event billed_invoices -- find related disbursements left join billing_event disbursed_invoices on disbursed_invoices.action='DISBURSED' and disbursed_invoices.parent_billing_event_id=billed_invoices.billing_event_id WHERE billed_invoices.invoice_date between '2018-01-01' and '2018-12-31' and billed_invoices.transaction_type like 'SELLER_%' -- invoiced on behalf of SELLER and billed_invoices.action in ('INVOICED','FORGIVEN') -- do not take into account failed disbursements AND not exists (select 1 from billing_event failed_disbursement where disbursed_invoices.disbursement_billing_event_id = failed_disbursement.parent_billing_event_id ) GROUP BY billed_invoices.billing_event_id );
Contoh 7: Saldo set faktur
Untuk mempelajari jumlah sekumpulan faktur, Anda dapat menjalankan kueri seperti yang ditunjukkan pada contoh berikut.
SELECT invoice_id, sum(amount) FROM billing_event targeted WHERE -- invoice_id is only not null for invoiced records AND disbursed records -- linking them to related disbursement -> no need to filter more precisely invoice_id in ('XXX','YYY') -- filter out failed disbursements AND not exists (select 1 from billing_event disbursement join billing_event failed_disbursement on disbursement.billing_event_id=failed_disbursement.parent_billing_event_id where disbursement.transaction_type='DISBURSEMENT' and failed_disbursement.transaction_type='DISBURSEMENT_FAILURE' and targeted.disbursement_billing_event_id=disbursement.billing_event_id ) group by invoice_id;