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

Artigo
09/28/2024

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

Os parceiros podem ser obrigados a fornecer informações de Ordem de Compra do Cliente e/ou Proposta ou Solicitação de Proposta (RFP) 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 na 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 do corpo do URI

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

Nome	Type	Obrigatório	Description
isPartofTender	Booleano	N	O pedido faz parte de uma Proposta ou Solicitação de Proposta (RFP) do cliente.
clientePreço	Decimal/string	Y
moeda	String	Y
taxa de câmbio	Decimal/string	N
tenderLink	String	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 for true e nenhum link de tender for fornecido, isso será necessário, caso contrário, não será necessário.

Cabeçalhos do pedido

Para obter mais informações, consulte 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