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

Artigo
09/28/2024

Funções apropriadas: Agente administrativo

Os parceiros podem ser solicitados 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 em Autenticação do Partner Center. Esse cenário dá suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.

Sintaxe da solicitação

Método	URI da solicitação
POST	{baseURL}/v1/customers/{customerid}/orders/{orderid}/attachment

Parâmetro do corpo do URI

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

Nome	Digitar	Obrigatória	Descrição
éParte do concurso	Booliano	N	É a parte do pedido de uma Oferta ou Solicitação de Proposta (RFP) do cliente.
preço do cliente	Decimal/string	Y
Moeda	String	Y
fxRate	Decimal/string	N
concursoLink	String	S/N	Se isPartOfTender for true e nenhum arquivo de licitação for fornecido, isso será necessário, caso contrário, não será necessário.
Arquivos PO	Arquivos	Y
Arquivos de concurso	Arquivos	S/N	Se isPartOfTender for true e nenhum link de licitação for fornecido, isso será necessário, caso contrário, não será necessário.

Cabeçalhos da solicitação

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

Se a transação exigir o upload de um pedido de compra assim que um parceiro concluir a criação de um pedido ou check-out, a resposta a seguir será recebida.

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito 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, confira 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"}}

Compartilhar via