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

Articolo
09/27/2024

Ruoli appropriati: agente di amministrazione

Per completare una transazione all'interno del Centro per i partner, potrebbero essere necessari partner per fornire informazioni su ordine di acquisto cliente e/o richiesta di proposta (RFP). Questo articolo descrive come i partner possono usare il Centro per i partner per allegare gli ordini di acquisto a livello di codice.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome 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	Parte dell'ordine di una gara cliente o richiesta di proposta (RFP).
customerPrice	Decimal/string	Y
currency	Stringa	Y
fxRate	Decimal/string	N
tenderLink	String	S/N	Se isPartOfTender è true e non vengono forniti file di gara, è necessario, altrimenti non è necessario.
POfile	File	Y
TenderFiles	File	S/N	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