Een inkooporder bijvoegen en de details van de inkooporder voltooien

Artikel
09/27/2024

Juiste rollen: Beheerdersagent

Partners kunnen verplicht zijn om klantaankooporder en/of offerte- of aanvraaginformatie (RFP) te verstrekken om een transactie in partnercentrum te voltooien. In dit artikel wordt beschreven hoe partners partnercentrum kunnen gebruiken om inkooporders programmatisch te koppelen.

Vereisten

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

Aanvraagsyntaxis

Wijze	Aanvraag-URI
POST	{baseURL}/v1/customers/{customerid}/orders/{orderid}/attachment

Parameter voor URI-hoofdtekst

Gebruik de volgende hoofdtekstparameters om statussen van inkooporders te retourneren.

Name	Type	Vereist	Beschrijving
isPartofTender	Booleaanse waarde	N	Is het ordergedeelte van een offerte of aanvraag voor voorstel (RFP) van een klant.
customerPrice	Decimaal/tekenreeks	J
valuta	String	J
fxRate	Decimaal/tekenreeks	N
tenderLink	String	J/N	Als isPartOfTender waar is en er geen aanbestedingsbestanden worden verstrekt, is dit vereist, anders niet vereist.
POfiles	Bestanden	J
TenderFiles	Bestanden	J/N	Als isPartOfTender waar is en er geen aanbestedingskoppeling is opgegeven, is dit vereist, anders is dit niet vereist.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagvoorbeeld

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-antwoord

Als voor de transactie een upload van een inkooporder is vereist zodra een partner een bestelling heeft gemaakt of uitchecken is voltooid, wordt het volgende antwoord ontvangen.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het succes of de fout optreedt en meer informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en meer parameters te lezen. Zie Foutcodes voor de volledige lijst.

Responsvoorbeeld

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

Delen via