Umpan data acara penagihan - AWS Marketplace

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 transaction_type yaSELLER_REV_SHARE, itu adalah akun pembayar pembeli. Ini adalah kunci asing untuk umpan data akun.

Dapat digunakan untuk bergabung ke umpan Account data di account_id lapangan.

to_account_id Akun yang menerima jumlah transaksi untuk produk. Ini adalah kunci asing untuk umpan data akun.

Dapat digunakan untuk bergabung ke umpan Account data di account_id lapangan.

end_user_account_id Akun yang menggunakan produk. Akun ini mungkin berbeda dari akun pembeli dan pembayar.

Dapat digunakan untuk bergabung ke umpan Account data di account_id lapangan.

product_id Pengidentifikasi produk. Ini adalah kunci asing untuk umpan data produk.

Dapat digunakan untuk bergabung ke umpan Product data di product_id lapangan.

tindakan

Jenis tindakan untuk acara ini. Kemungkinan nilainya adalah sebagai berikut:

  • INVOICED- Pembeli ditagih untuk jumlah tersebut.

  • FORGIVEN— Pembeli ditagih untuk jumlah tersebut, dan AWS mengembalikan tagihan.

  • DISBURSED— Penjual dibayar jumlah ini. Ini dapat mencakup satu bulan faktur, atau menjadi pencairan sesuai permintaan.

transaction_type

Jenis transaksi. Sebagai contoh, lihat Skenario perpajakan. Kemungkinan nilainya adalah sebagai berikut:

  • SELLER_REV_SHARE— Jumlah positif; ini adalah harga yang ditetapkan penjual dalam perjanjian dengan pembeli.

  • SELLER_TAX_SHARE— Jumlah positif; ini adalah jumlah yang ditambahkan SELLER_REV_SHARE untuk menutupi pajak yang berutang penjual.

  • AWS_REV_SHARE— Jumlah negatif; ini adalah biaya daftar.

  • AWS_TAX_SHARE— Jumlah positif; ini adalah jumlah pajak yang AWS dikumpulkan di sampingSELLER_REV_SHARE. Jumlah ini tidak mempengaruhi saldo penjual. Jumlah ini tidak dicairkan dan disediakan untuk kesadaran penjual tentang pajak yang ditagih kepada pembeli dan dikirimkan ke pihak berwenang atas nama penjual.

  • transaction_type_REFUND— Jumlah pengembalian dana yang diminta oleh pembeli.

  • transaction_type_CREDIT— Jumlah AWS kredit pembeli.

  • BALANCE_ADJUSTMENT— Penyesuaian yang dilakukan oleh AWS untuk menyelesaikan masalah faktur.

  • DISBURSEMENT— Jika nilai action is DISBURSED dan nilainya balance_impacting adalah1, ini adalah jumlah yang dibayarkan kepada penjual. Jika nilainya action adalahINVOICED, catatan ini meniadakan parent_billing_event_id catatan baik secara penuh atau sebagian. Dalam hal ini, pencairan terkait ditampilkan dan nilainya disbursement_billing_event_id adalah. balance_impacting 0

  • DISBURSEMENT_FAILURE— Menegasikan transaksi.

parent_billing_event_id

Ketika nilai dari broker_id isAWS_INC, nilai action is DISBURSED atauFORGIVEN, dan nilai transaction_type isDISBURSEMENT, parent_billing_event_id mengacu pada aslinya billing_event_id yang memulai acara penagihan ini. Jika action memiliki nilai lain, bidang ini adalah nol.

Ketika nilai dari broker_id isAWS_EUROPE, parent_billing_event_id mengacu pada aslinya billing_event_id yang memulai acara penagihan ini untuk skenario berikut:

  • Nilai action is FORGIVEN atau INVOICED dan nilai transaction_type adalah AWS_REV_SHARE,AWS_REV_SHARE_REFUND, atauSELLER_REV_SHARE_REFUND.

  • Nilai action is DISBURSED dan nilai transaction_type is ANY (tidak termasukDISBURSEMENT_FAILURE).

  • Nilai transaction_type adalahAWS_TAX_SHARE,, AWS_TAX_SHARE_REFUNDSELLER_TAX_SHARE, atau SELLER_TAX_SHARE_REFUND.

  • Nilai action is DISBURSED dan nilai transaction_type isDISBURSEMENT_FAILURE.

Ketika nilai broker_id adalahAWS_EUROPE, parent_billing_event_id mengacu pada asli billing_event_id dari peristiwa penagihan pencairan yang berhasil sebelumnya untuk skenario berikut:

  • Nilai action is DISBURSED dan nilai transaction_type isDISBURSEMENT_FAILURE.

Ketika nilai dari broker_id isAWS_EUROPE, bidang ini adalah null untuk semua skenario yang tersisa.

disbursement_billing_event_id

Pencairan terkait ketika nilai action is DISBURSED dan salah satu dari berikut ini benar:

  • transaction_type like ('SELLER%')

  • transaction_type like ('AWS%')

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 nilainyaINVOICED, tanggal jatuh tempo untuk faktur. action

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 Address data di address_id lapangan.

transaction_reference_id

Pengidentifikasi yang memungkinkan Anda mereferensikan data silang dari laporan berikut:

bank_trace_id

Untuk transaksi pencairan (transaction_type=is DISBURSEMENT dan action isDISBURSED), trace ID yang ditetapkan oleh bank. Trace ID dapat digunakan untuk berkorelasi dengan laporan yang disediakan bank dari bank penjual.

broker_id

Pengenal entitas bisnis yang memfasilitasi transaksi. Kemungkinan nilainya adalah sebagai berikut:

  • AWS_INC

    — Pengenal untuk AWS, Inc. (berbasis di Amerika Serikat).

  • AWS_EUROPE

    — Pengidentifikasi untuk Amazon Web Services EMEA SARL (berbasis di Luksemburg).

  • NULL

    — Transaksi sebelumnya tanpa eksplisit broker_id difasilitasi oleh. AWS_INC

buyer_transaction_reference_id

Pengidentifikasi yang mengelompokkan semua catatan terkait dalam umpan penagihan bersama-sama menggunakan GROUP BY atau fungsi jendela dibangun. SQL Catatan terkait ini dapat berisi faktur pembeli, faktur penjual, dan pajak pertambahan nilai (VATs) pada biaya listing.

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 adalah737399998888.

    • 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 adalah111122223333.

  • Paulo adalah penjual rekaman.

    • ID akunnya adalah777788889999.

    • 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 dalamMenggunakan 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;