Partner payouts - Create a new transaction history export request

Referensi

Service:: Partner Center Rest

API Version:: 1.0

API ini memungkinkan untuk membuat permintaan ekspor riwayat transaksi baru. Sebaiknya gunakan $filter param untuk setiap permintaan. Silakan lihat di bawah ini tentang penggunaan filter dan semua filter yang tersedia di antarmuka halaman ekspor (UX) juga tersedia melalui API ini, memberikan fleksibilitas dan konsistensi dalam memfilter data.

POST https://api.partnercenter.microsoft.com/v{version}/payouts/transactionhistory

With optional parameters:

POST https://api.partnercenter.microsoft.com/v{version}/payouts/transactionhistory?$filter={$filter}&enrollmentParticipantId={enrollmentParticipantId}&earningForDate={earningForDate}&transactionAmount={transactionAmount}&earningAmount={earningAmount}&engagementName={engagementName}&Multiple filters={Multiple filters}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
version	path	True	string
$filter	query		string	Param kueri $filter adalah parameter opsional untuk membuat operasi ekspor. Namun, kami sangat menyarankan untuk menggunakan $filter untuk performa yang lebih baik dan ketersediaan laporan ekspor yang lebih cepat. Di bawah ini adalah beberapa filter atribut utama yang dapat digunakan sebagai bagian dari operasi ekspor
earningAmount	query		double	Mendapatkan filter jumlah untuk permintaan ekspor. Penggunaan: {baseUrl}/payouts/transactionhistory?$filter=earningAmount ge 2000 dan earningAmount le 5000
earningForDate	query		string	Filter tanggal periode penghasilan untuk permintaan ekspor. Penggunaan: {baseUrl}/pembayaran/transactionhistory?$filter=earningForDate ge 2023-03-01 dan earningForDate le 2023-04-12
engagementName	query		string	Filter nama keterlibatan untuk permintaan ekspor. Penggunaan: {baseUrl}/pembayaran/transactionhistory?$filter=engagementName='Insentif gerakan Azure CSP'
enrollmentParticipantId	query		int	Filter Id MPN terdaftar untuk permintaan ekspor. Penggunaan: {baseUrl}/payouts/transactionhistory?$filter=enrollmentParticipantId=12345
Multiple filters	query		string	Berikut adalah contoh kueri untuk membuat permintaan ekspor dengan beberapa filter. Penggunaan: {baseUrl}/payouts/transactionhistory?$filter=earningForDate ge 2023-01-01 dan earningForDate le 2023-05-31 dan (enrollmentParticipantId eq 'XXXXXXX') dan (programName eq 'Microsoft Commerce Incentives') dan (payableSubType eq 'REBATE') dan (paymentId eq 'xxxxxxx') dan (engagementName eq 'Azure Enterprise and Self-Service Incentive' atau engagementName eq 'Insentif gerakan Azure CSP - Penyedia Tidak Langsung')"
transactionAmount	query		double	Filter jumlah transaksi untuk permintaan ekspor. Penggunaan: {baseUrl}/pembayaran/transactionhistory?$filter=transactionAmount ge 2000 dan transactionAmount le 5000

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
Authorization	True	string	Token Pembawa Otorisasi
Client-Request-ID		string	ID permintaan yang disediakan oleh pengguna

Respons

Nama	Jenis	Deskripsi
202 Accepted	Microsoft.Partner.Service.PartnerPayout.Contracts.V1.Export	Permintaan berhasil diterima untuk diproses. Headers Request-ID: string
400 Bad Request		Ada input yang hilang atau tidak valid. Isi respons akan memberikan detail kesalahan.
401 Unauthorized		Permintaan tidak diautentikasi. Klien perlu mengautentikasi dengan layanan API mitra terlebih dahulu.
403 Forbidden		Permintaan diautentikasi tetapi ditolak karena pemanggil tidak memiliki hak untuk memanggilnya.
404 Not Found		Sumber daya tidak ditemukan.
429 Too Many Requests		Terlalu banyak permintaan.
500 Internal Server Error		Layanan API mitra atau salah satu dependensinya gagal memenuhi permintaan. Penelepon dapat mencoba kembali ini.

Definisi

Microsoft.Partner.Service.PartnerPayout.Contracts.V1.Export

Nama	Jenis	Deskripsi
blobLocation	string
processingStartDateTime	string
requestDateTime	string
requestId	string
requestPath	string
requestQueryString	string
status	enum: Completed Failed Processing Queued

Bagikan melalui