Partner payouts - Create a new transaction history export request

Başvuru

Hizmet:: Partner Center Rest

API Sürümü:: 1.0

Bu API, yeni bir işlem geçmişi dışarı aktarma isteği oluşturmanızı sağlar. Her istek için $filter param kullanmanızı öneririz. Filtrelerin kullanımına ve dışarı aktarma sayfası arabiriminde (UX) bulunan tüm filtrelere bu API aracılığıyla da ulaşabilirsiniz ve bu da verileri filtrelemede esneklik ve tutarlılık sağlar.

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

İsteğe bağlı parametrelerle:

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}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
version	path	True	string
$filter	query		string	$filter sorgu parametresi, dışarı aktarma işlemi oluşturmak için isteğe bağlı bir parametredir. Ancak, dışarı aktarma raporunun daha iyi performans ve daha hızlı kullanılabilirliği için $filter kullanmanızı kesinlikle öneririz. Aşağıda, dışarı aktarma işleminin bir parçası olarak kullanılabilecek bazı anahtar öznitelik filtreleri yer almaktadır
earningAmount	query		double	Dışarı aktarma isteği için kazanç tutarı filtresi. Kullanım: {baseUrl}/payouts/transactionhistory?$filter=earningAmount ge 2000 ve earningAmount le 5000
earningForDate	query		string	Dışarı aktarma isteği için kazanç dönemi tarih filtresi. Kullanım: {baseUrl}/payouts/transactionhistory?$filter=earningForDate ge 2023-03-01 ve earningForDate le 2023-04-12
engagementName	query		string	Dışarı aktarma isteği için görevlendirme adı filtresi. Kullanım: {baseUrl}/payouts/transactionhistory?$filter=engagementName='Azure CSP hareket teşvikleri'
enrollmentParticipantId	query		int	Dışarı aktarma isteği için kayıtlı MPN Kimliği filtresi. Kullanım: {baseUrl}/payouts/transactionhistory?$filter=enrollmentParticipantId=12345
Multiple filters	query		string	Birden çok filtreyle dışarı aktarma isteği oluşturmak için örnek bir sorgu aşağıda verilmiştir. Kullanım: {baseUrl}/payouts/transactionhistory?$filter=earningForDate ge 2023-01-01 ve earningForDate le 2023-05-31 ve (enrollmentParticipantId eq 'XXXXXXX') and (programName eq 'Microsoft Commerce Incentives') ve (payableSubType eq 'REBATE') ve (paymentId eq 'xxxxxxxx') ve (engagementName eq 'Azure Enterprise and Self-Service Incentive' veya engagementName eq 'Azure CSP motion incentives - Indirect Provider')"
transactionAmount	query		double	Dışarı aktarma isteği için işlem tutarı filtresi. Kullanım: {baseUrl}/payouts/transactionhistory?$filter=transactionAmount ge 2000 ve transactionAmount le 5000

İstek Başlığı

Name	Gerekli	Tür	Description
Authorization	True	string	Yetkilendirme Taşıyıcı belirteci
Client-Request-ID		string	Kullanıcı tarafından sağlanan isteğin kimliği

Yanıtlar

Name	Tür	Description
202 Accepted	Microsoft.Partner.Service.PartnerPayout.Contracts.V1.Export	İstek işlenmek üzere başarıyla kabul edildi. Üst Bilgiler Request-ID: string
400 Bad Request		Eksik veya geçersiz bir giriş vardı. Yanıt gövdesi hata ayrıntılarını sağlar.
401 Unauthorized		İsteğin kimliği doğrulanmamış. İstemcinin önce iş ortağı API hizmetiyle kimlik doğrulaması yapması gerekir.
403 Forbidden		İsteğin kimliği doğrulandı, ancak çağıranın çağırma hakkı olmadığından reddedildi.
404 Not Found		Kaynak bulunamadı.
429 Too Many Requests		Çok fazla istek var.
500 Internal Server Error		İş ortağı API hizmeti veya bağımlılıklarından biri isteği yerine getiremedi. Arayanlar bunu yeniden deneyebilir.

Tanımlar

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

Name	Tür	Description
blobLocation	string
processingStartDateTime	string
requestDateTime	string
requestId	string
requestPath	string
requestQueryString	string
status	enum: Completed Failed Processing Queued

Aracılığıyla paylaş