Allegare un ordine di acquisto e completare i dettagli dell'ordine di acquisto

Articolo
03/08/2025

Ruoli appropriati: agente di amministrazione

I partner potrebbero essere tenuti a fornire informazioni relative all'ordine di acquisto del cliente e/o alla richiesta di proposta (RFP) per completare una transazione all'interno del Centro per i partner. Questo articolo descrive come i partner possono usare il Partner Center per allegare gli ordini di acquisto in modo programmatico.

Prerequisiti

Credenziali come descritto in Autenticazione del Partner Center. Questo scenario supporta l'autenticazione con le credenziali per app standalone e app+utente.

Sintassi della richiesta

metodo	URI della richiesta
POST	{baseURL}/v1/customers/{customerid}/orders/{orderid}/attachment

Parametro del corpo dell'URI

Usare i parametri corpo seguenti per restituire gli stati degli ordini di acquisto.

Nome	Digita	Obbligatorio	Descrizione
isPartofTender	Booleano	N	L'ordine fa parte di una gara d'appalto del cliente o di una richiesta di proposta (RFP)?
customerPrice	Decimal/string	Y
valuta	Stringa	Y
fxRate	Decimal/string	N
tenderLink	Stringa	S/N	Se isPartOfTender è true e non vengono forniti file di gara, è necessario, altrimenti non è necessario.
POfiles	File	Y
TenderFiles	File	Sì/No	Se isPartOfTender è true e non viene fornito alcun collegamento di gara, è necessario altrimenti non è obbligatorio.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Esempio di richiesta

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

Risposta REST

Se la transazione richiede un caricamento dell'ordine di acquisto al termine della creazione di un ordine o di un checkout da parte di un partner, verrà ricevuta la risposta seguente.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore.

Risposta di esempio

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"}}

Condividi tramite