発注書の添付と発注書の詳細の記入

[アーティクル]
09/28/2024

対象のロール: 管理エージェント

パートナーは、パートナーセンター内でトランザクションを完了するために、顧客の発注書や入札または提案要求 (RFP) 情報を提供する必要がある場合があります。この記事では、パートナーがパートナーセンターを使用してプログラムによって発注書を添付する方法について説明します。

前提条件

パートナーセンターの認証に関するページで説明している資格情報。このシナリオでは、スタンドアロンアプリとアプリ + ユーザーの両方の資格情報を使った認証がサポートされています。

要求の構文

認証方法	要求 URI
投稿	{baseURL}/v1/customers/{customerid}/orders/{orderid}/attachment

URI 本文パラメーター

発注書の状態を返すには、次の本文パラメーターを使用します。

名前	タイプ	Required	説明
isPartofTender	Boolean	N	顧客の入札または提案依頼 (RFP) の注文部分です。
customerPrice	Decimal/string	年
currency	String	年
fxRate	Decimal/string	N
tenderLink	String	Y/N	isPartOfTender が true で、入札ファイルが指定されていない場合は必須です。それ以外の場合は必須ではありません。
POfiles	ファイル	年
TenderFiles	ファイル	Y/N	isPartOfTender が true で、入札リンクが指定されていない場合は、これが必要です。それ以外の場合は必須ではありません。

要求ヘッダー

詳細については、「パートナーセンター REST ヘッダー」を参照してください。

要求の例

POST https://api.partnercenter.microsoft.com/v1/customers/<customerid>/orders/<orderid>/attachment
Authorization: Bearer <Token>
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryaLQBO4IgpABK3wdj
Accept: application/json

------WebKitFormBoundaryaLQBO4IgpABK3wdj
Content-Disposition: form-data; name="metadata"
{"isPartofTender":true,"customerPrice":"156.87","currency":"CAD","fxRate":"1.2","tenderLink":https://onedrive.com/ishdruiwiojfdhajhgdfgjhgj}
------WebKitFormBoundaryaLQBO4IgpABK3wdj
Content-Disposition: form-data; name="pofiles"; filename="PO_Part1.pdf"
Content-Type: application/pdf

REST 応答

パートナーが注文またはチェックアウトの作成を完了した後にトランザクションで発注書のアップロードが必要な場合は、次の応答が受信されます。

応答の成功とエラーのコード

各応答には、成功または失敗とより多くのデバッグ情報を示す HTTP 状態コードが付属しています。ネットワークトレースツールを使用して、このコード、エラーの種類、その他のパラメーターを読み取ります。完全な一覧については、エラーコードに関するページを参照してください。

応答の例

HTTP/1.1 201 Created
Content-Length: 393

{"totalCount":3,"items":[{"attachmentId":"ed64c99f750115","fileName":"PO_Part1.pdf","sizeInKB":2051,"attachmentType":"POAttachment"},{"attachmentId":"ef8fe74c39e264","fileName":"PO_Part2.pdf","sizeInKB":1313,"attachmentType":"POAttachment"},{"attachmentId":"32a312ca64567a","fileName":"Tender.pdf","sizeInKB":2223,"attachmentType":"TenderAttachment"}],"attributes":{"objectType":"Collection"}}

次の方法で共有