Desvendando a Customer API do Oracle EBS: como usar

O cadastro de clientes do Oracle EBS não é simples, por isso vamos desvendando a Customer API do Oracle EBS para automatizar o cadastro.

Desvendando a Customer API do Oracle EBS: como usar
Desvendando a Customer API do Oracle EBS: como usar

Se você já precisou automatizar o cadastro de clientes no Oracle EBS sabe do que estou falando, por isso vamos desvendando a Customer API do Oracle EBS.

E para quem acredita que é algo difícil de ser utilizado é trivial que surja a necessidade de implementar algum tipo de automação para o cadastro de clientes.

Principalmente quando precisamos criar API’s de integração com o Oracle ORDS.

Desvendando a Customer API do Oracle EBS: conhecendo todas as API’s

Para quem já trabalhou com o cadastro de clientes sabe o quanto ele é fragmentado.

Desta forma não existe uma única API para cria-lo, são várias, cada uma responsável por uma etapa e interagindo com a anterior.

O primeiro passo então é conhecer todas as API’s envolvidas no processo de cadastro de customers do início ao fim.

1. Responsável por criar o Organization Party:
HZ_PARTY_V2PUB.create_organization

2. Responsável por criar o Customer Account, utiliza o PARTY_ID criado no step 1:
HZ_CUST_ACCOUNT_V2PUB.create_cust_account

3. Responsável por criar o Account Site Location:
HZ_LOCATION_V2PUB.create_location

4. Responsável por criar o Party Site, utiliza o PARTY_ID criado no step 1 e o LOCATION_ID criado no step 3:
HZ_PARTY_SITE_V2PUB.create_party_site

5. Responsável por criar o Customer Account Site, utiliza o CUST_ACCOUNT_ID criado no step 2 e o PARTY_SITE_ID criado no step 4:
HZ_CUST_ACCOUNT_SITE_V2PUB.create_cust_acct_site

6. Responsável por criar o Account Site Usage (por exemplo o SHIP_TO, BILL_TO, etc), utiliza o CUST_ACCT_SITE_ID criado no step 5:
HZ_CUST_ACCOUNT_SITE_V2PUB.create_cust_site_use

7. Responsável por criar o Customer Account Profile, utiliza o CUST_ACCOUNT_ID criado no step 2 e o CUST_ACCT_SITE_USE_ID criado no step 6:
HZ_CUSTOMER_PROFILE_V2PUB.create_customer_profile

8. Responsável por criar o Customer Account Profile Amount, utiliza o CUST_ACCOUNT_ID criado no step 2, o CUST_ACCT_SITE_USE_ID criado no step 6 e o CUST_ACCOUNT_PROFILE_ID criado no step 7:
HZ_CUSTOMER_PROFILE_V2PUB.create_cust_profile_amt

9. Responsável por criar o Customer Account Site Contact, utiliza o PARTY_ID criado no step 1, o CUST_ACCOUNT_ID criado no step 2 e o CUST_ACCT_SITE_ID criado no step 5:
HZ_PARTY_V2PUB.create_person (Para criar o Person Party)
HZ_PARTY_CONTACT_V2PUB.create_org_contact (Para ligar a pessoa de contato a organização)

10. Responsável por criar o Contact Address:
HZ_LOCATION_V2PUB.create_location

11. Responsável por criar o Contact Site, utiliza o PARTY_REL_PARTY_ID criado no step 9 e o LOCATION_ID criado no step 10:
HZ_PARTY_SITE_V2PUB.create_party_site

12. Responsável por criar o Customer Account Contact Role, utiliza o CUST_ACCOUNT_ID criado no step 2, o CUST_ACCT_SITE_ID criado no step 5 e o PARTY_REL_PARTY_ID criado no step 9:
HZ_CUST_ACCOUNT_ROLE_V2PUB.create_cust_account_role

13. Responsável por criar o Contact Points, utiliza o PARTY_SITE_ID criado no step 4:
HZ_CONTACT_POINT_V2PUB.create_contact_point

14. Responsável por criar o Role responsibility, utiliza o CUST_ACCOUNT_ROLE criado no step 12:
HZ_CUST_ACCOUNT_ROLE_V2PUB.create_role_responsibility

Como é possível observar o cadastro de clientes do Oracle EBS não é linear e pode ter várias ramificações, podem inclusive existir pontas completamente soltas se não tomarmos cuidado.

A seguir vamos mostrar como ir utilizando detalhadamente cada uma das API’s que listamos aqui.

Petter Rafael

Desenvolvedor Web atua com as tecnologias Java e PHP apoiadas pelos bancos de dados Oracle e MySQL. Além dos ambientes de desenvolvimento acima possuiu amplo conhecimento em servidores Apache/Tomcat, Photoshop, Arte & Foto, Flash e mais uma dezena de ferramentas e tecnologias emergentes. Atualmente colabora com o Viablog escrevendo sobre programação e tecnologia.