Exercício 701 - Criar múltiplos Business Partner $batch

[fabiodezan]

API Reference

https://api.sap.com/api/OP_API_BUSINESS_PARTNER_SRV/overview

Contexto

Ao utilizar o parâmetro $batch você pode realizar mais de uma ação (POST, GET, PATCH) em uma solicitação.

Por exemplo, você pode criar DOIS Business Partner com apenas uma solicitação da API, ao invés de realizar duas requisições de POST.

Cuidado: como a API oData é síncrona, efetuar a criação de muitos objetos em uma única requisição pode sobrecarregar o sistema.

Dica

Ao realizar uma criação (POST) ou uma modificação (PATCH) utilizando o parâmetro $batch, é necessári separar cada bloco(request) por um changeset especifico.

No exemplo abaixo serão enviadas duas ações em uma requisição., uma com o changeset 01 e outra com o changeset02

--changeset01
Content-Type: multipart/mixed; boundary=changeset01

--changeset01--

--changeset02
Content-Type: multipart/mixed; boundary=changeset02

--changeset02--

Passo 01

Acesse a transação /N/IWFND/MAINT_SERVICE, selecione a coluna de serviços e clique no botão Filtro.

 Passo 02

Localize o serviço API API_BUSINESS_PARTNER_SRV

 Passo 03

Selecione o serviço e clique em SAP Gateway Client

 Passo 04

Clique em URI-Option

 Passo 05

Selecione o Parâmetro $batch

 Passo 06

Limpe (apague) os dados preenchidos automaticamente

 Passo 07

Certifique-se que o conteúdo da request está vazio

 Passo 08

Copie e cole o código abaixo na request (ver imagem abaixo)

--batch
Content-Type: multipart/mixed; boundary=changeset
–changeset

Content-Type: application/http

Content-Transfer-Encoding: binary
POST A_BusinessPartner HTTP/1.1

Content-Type: application/json
{

“BusinessPartnerCategory”: “2”,

“BusinessPartnerGrouping”: “BP02”,

“OrganizationBPName1”: “Business Partner API BATCH01”

}
–changeset–
–batch
Content-Type: multipart/mixed; boundary=changeset01
–changeset01

Content-Type: application/http

Content-Transfer-Encoding: binary
POST A_BusinessPartner HTTP/1.1

Content-Type: application/json
{

“BusinessPartnerCategory”: “2”,

“BusinessPartnerGrouping”: “BP02”,

“OrganizationBPName1”: “Business Partner API BATCH02”

}
–changeset01–
–batch–

Passo 09

Clique em Executar

 Passo 10

1 - Certifique-se que o código do status é 202.

2 - Localize o código do primeiro Business Partner na resposta da API. No exemplo abaixo foi gerado o código 1000092


3 - Desça a barra de rolagem para localizar o segundo Business partner

4 - Localize o código do segundo Business Partner na resposta da API. No exemplo abaixo foi gerado o código 1000093

Passo 11

Acesse a transação BP e consulte os business partner criados.