Llegeix en anglès

Comparteix a través de

Adjuntar un pedido de compra y completar los detalles del pedido de compra

  • Article

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

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