Adjuntar un pedido de compra y completar los detalles del pedido de compra
Roles adecuados: Agente de administración
Es posible que los partners necesiten proporcionar información de pedido de compra de cliente o de licitación o solicitud de propuesta (RFP) para completar una transacción en el Centro de partners. En este artículo se describe cómo los partners pueden usar el Centro de partners para adjuntar pedidos de compra mediante programación.
Requisitos previos
- Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con credenciales de aplicación independiente y app+usuario.
Sintaxis de la solicitud
| Método | URI de solicitud |
|---|---|
| POST | {baseURL}/v1/customers/{customerid}/orders/{orderid}/attachment |
Parámetro del cuerpo del URI
Use los siguientes parámetros de cuerpo para devolver los estados del pedido de compra.
| Nombre | Type | Obligatorio | Descripción |
|---|---|---|---|
| isPartofTender | Boolean | N | Es la parte del pedido de una oferta de cliente o solicitud de propuesta (RFP). |
| customerPrice | Decimal/string | Y | |
| currency | Cadena | Y | |
| fxRate | Decimal/string | N | |
| tenderLink | Cadena | S/N | Si isPartOfTender es true y no se proporciona ningún archivo de licitación, se requiere; de lo contrario, no es necesario. |
| POfiles | Archivos | Y | |
| TenderFiles | Archivos | S/N | Si isPartOfTender es true y no se proporciona ningún vínculo de licitación, se requiere de lo contrario, no es necesario. |
Encabezados de solicitud
Para obtener más información, consulta Encabezados REST del Centro de partners.
Ejemplo de solicitud
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
Respuesta REST
Si la transacción requiere una carga de pedido de compra una vez que un asociado complete la creación de un pedido o una compra, se recibirá la siguiente respuesta.
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica éxito o error y más información de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y más parámetros. Para obtener la lista completa, consulte Códigos de error.
Ejemplo de respuesta
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"}}