Anexar uma ordem de compra e concluir os detalhes da ordem de compra

Artigo
03/08/2025

Funções apropriadas: Agente de administração

Os parceiros podem ser obrigados a fornecer informações sobre a Ordem de Compra do Cliente e/ou Solicitação de Proposta para concluir uma transação no Partner Center. Este artigo descreve como os parceiros podem usar o Partner Center para anexar ordens de compra programaticamente.

Pré-requisitos

Credenciais conforme descrito em <a href="partner-center-authentication" data-linktype="relative-path">autenticação do Partner Center. Este cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.

Sintaxe da solicitação

Método	URI do pedido
POST	{baseURL}/v1/customers/{customerid}/orders/{orderid}/attachment

Parâmetro de corpo de URI

Use os seguintes parâmetros de corpo para retornar os status da ordem de compra.

Nome	Tipo	Obrigatório	Descrição
isPartofTender	Booleano	N	O pedido faz parte de um Concurso ou Solicitação de Proposta (SP) do cliente.
clientePreço	Decimal/cadeia de caracteres	Y
moeda	String	Y
taxa de câmbio	Decimal/sequência de caracteres	N
tenderLink	Corda	S/N	Se isPartOfTender for true e nenhum arquivo de proposta for fornecido, isso será necessário, caso contrário, não será necessário.
POfiles	Ficheiros	Y
TenderFiles	Ficheiros	S/N	Se isPartOfTender é verdadeiro e nenhum link de concurso for fornecido, isto é obrigatório, caso contrário, não é obrigatório.

Cabeçalhos de pedido

Para mais informações, consulte os cabeçalhos REST do Partner Center.

Exemplo de solicitação

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

Resposta do REST

Se a transação exigir o upload de uma ordem de compra assim que um parceiro concluir a criação de um pedido ou checkout, a seguinte resposta será recebida.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e mais informações de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e mais parâmetros. Para obter a lista completa, consulte Códigos de erro.

Exemplo de resposta

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

Partilhar via