Dołączanie zamówienia zakupu i kończenie szczegółów zamówienia zakupu
Odpowiednie role: Agent administracyjny
Partnerzy mogą być zobowiązani do dostarczenia informacji dotyczących zamówienia zakupu klienta i/lub oferty lub żądania propozycji (RFP) w celu ukończenia transakcji w Centrum partnerskim. W tym artykule opisano, jak partnerzy mogą używać Centrum partnerskiego do programowego dołączania zamówień zakupu.
Wymagania wstępne
- Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
Składnia żądania
| Method | Identyfikator URI żądania |
|---|---|
| POST | {baseURL}/v1/customers/{customerid}/orders/{orderid}/attachment |
Parametr treści identyfikatora URI
Użyj następujących parametrów treści, aby zwrócić stany zamówień zakupu.
| Nazwisko | Type | Wymagania | opis |
|---|---|---|---|
| isPartofTender | Wartość logiczna | N | Jest częścią zamówienia oferty klienta lub wniosku o propozycję (RFP). |
| customerPrice | Liczba dziesiętna/ciąg | Y | |
| waluta | String | Y | |
| fxRate | Liczba dziesiętna/ciąg | N | |
| tenderLink | String | Tak/Nie | Jeśli parametr isPartOfTender ma wartość true i nie podano żadnych plików przetargowych, jest to wymagane, w przeciwnym razie nie jest to wymagane. |
| Pliki POfile | Pliki | Y | |
| TenderFiles | Pliki | Tak/Nie | Jeśli parametr isPartOfTender ma wartość true i nie podano żadnego linku przetargowego, jest to wymagane w przeciwnym razie nie jest to wymagane. |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.
Przykład żądania
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
Odpowiedź REST
Jeśli transakcja wymaga przekazania zamówienia zakupu po zakończeniu tworzenia zamówienia lub wyewidencjonowania przez partnera, zostanie odebrana następująca odpowiedź.
Kody powodzenia i błędów odpowiedzi
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i więcej informacji o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, zobacz Kody błędów.
Przykład odpowiedzi
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"}}