SAP RFC: Executar uma Função

Vantagens de utilizar o conector SAP RFC – Executar Função

1. Integração com qualquer função RFC do SAP Permite executar funções SAP padrão (como BAPIs) ou customizadas, com suporte a parâmetros simples, objetos estruturados e tabelas.

2. Extrema flexibilidade e compatibilidade com diversos cenários de negócio Adequado para criação, alteração ou consulta de dados no SAP — como alterar endereço, criar parceiros de negócios, registrar pedidos, entre outros.

3. Uso simplificado através do conector A chamada da função é configurada por JSON estruturado, facilitando a implementação e reduzindo o risco de erro humano.

4. Acesso controlado por autorização configurada Utiliza conexões SAP pré-configuradas com controle de acesso e segurança centralizada.

5. Execução síncrona e previsível Permite processar a resposta imediatamente após a execução da função, garantindo consistência no fluxo.

---

Exemplo de Cenário

Objetivo: Atualizar os dados de endereço de um parceiro de negócios no SAP utilizando a função BAPI_BUPA_ADDRESS_CHANGE.

---

Exemplo de Configuração

Função: BAPI_BUPA_ADDRESS_CHANGE

Import Parameters:

{
  "BUSINESSPARTNER": "0000000003"
}

Object Parameters:

{
  "ADDRESSDATA": {
    "CITY": "Barueri",
    "COUNTRY": "BR"
  },
  "ADDRESSDATA_X": {
    "CITY": "X",
    "COUNTRY": "X"
  }
}

Table Parameters:

{
  "BAPIADTEL": [
    {
      "COUNTRY": "BR",
      "TELEPHONE": "1133334444",
      "TEL_NO": "001"
    }
  ]
}

---

Estrutura do Fluxo

---

Explicação do Fluxo

1. Trigger REST O fluxo é iniciado por uma chamada externa contendo os dados que devem ser enviados ao SAP.

2. SAP RFC – Executar Função Executa uma função SAP (ex: BAPI_BUPA_ADDRESS_CHANGE) passando os parâmetros de forma estruturada via JSON.

3. Validação O retorno da função (ex: RETURN.TYPE, RETURN.MESSAGE) é analisado para garantir sucesso ou identificar falhas.

4. Enviar Mensagem (AMS) Com base na resposta, envia uma mensagem para uma fila configurada previamente no AMS com o retorno.

---

Exemplo de output do step Executar Função SAP

{
  "RETURN": [
    {
      "TYPE": "S",
      "ID": "BUPA",
      "NUMBER": "123",
      "MESSAGE": "Endereço alterado com sucesso"
    }
  ]
}

✅ O campo RETURN contém mensagens da execução da função no SAP. O tipo "S" indica sucesso, "E" indica erro.

---

Observações Técnicas

• Use a transação SE37 no SAP para consultar os parâmetros da função desejada.

• Para modificar campos estruturados, sempre envie o objeto _X correspondente (ex: ADDRESSDATA_X) com os campos marcados com "X".

• Table parameters devem ser enviados como arrays de objetos.

• Funções como BAPI_TRANSACTION_COMMIT podem ser necessárias após alterações.

---

Requisitos

• Autorização SAP configurada no ambiente.

• Permissões no SAP para executar a função RFC desejada.

• Conhecimento dos parâmetros esperados pela função, obtidos via SAP GUI.