API para actualizar customer profile Oracle Cloud
En ocasiones necesitamos actualizar datos para muchos registros y para evitar hacer esto uno por uno, Oracle tiene disponibles herramientas como SOAP Web Services y REST API Services.
En esta publicación vamos hacer una actualización del valor de Credit Limit (Limite de Credit) para un cliente en el modulo de AR (Account Receivable o de Cuentas por Cobrar)
Primero vamos a la liga de documentacion https://docs.oracle.com/en/ y ahí buscamos en este caso la sección de finanzas
Luego seleccionamos Integrate
Seleccionamos Review SOAP Web Services
Dentro buscamos la sección de Customer Profile
Vamos a utilizar la URL que viene en esa pantalla
Service WSDL URL: https://servername/fscmService/ReceivablesCustomerProfileService?WSDL
Vamos a entrar a Postman y desde ahí vamos armar el xml , primero vamos agregar un request
Luego vamos a poner el tipo Post y vamos a poner la URL que vimos dos pasos atrás, solo tengan cuidado de cambiar el nombre de su servidor URL: https://servername/fscmService/ReceivablesCustomerProfileService?WSDL
Después vamos agregar nuestras credenciales de acceso a Oracle , en la sección de authorization , en la parte de Body vamos a marcar raw y XML.
Y en Body vamos a colocar el siguiente código de XML
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:typ="http://xmlns.oracle.com/apps/financials/receivables/customers/customerProfileService/types/" xmlns:cus="http://xmlns.oracle.com/apps/financials/receivables/customers/customerProfileService/" xmlns:cus1="http://xmlns.oracle.com/apps/financials/receivables/customerSetup/customerProfiles/model/flex/CustomerProfileDff/" xmlns:cus2="http://xmlns.oracle.com/apps/financials/receivables/customerSetup/customerProfiles/model/flex/CustomerProfileGdf/">
<soapenv:Header/>
<soapenv:Body>
<typ:updateCustomerProfile>
<typ:customerProfile>
<!--Optional:-->
<cus:AccountNumber>Micliente</cus:AccountNumber>
<!--Optional:-->
<cus:CustomerAccountId>512396440</cus:CustomerAccountId>
<!--Optional:-->
<cus:CreditLimit>210</cus:CreditLimit>
<!--Optional:-->
<cus:CreditCurrencyCode>MXN</cus:CreditCurrencyCode>
</typ:customerProfile>
</typ:updateCustomerProfile>
</soapenv:Body>
</soapenv:Envelope>
Los campos en negrita son los valores que deben cambiar
- Micliente , este valor corresponde al código de cuenta del cliente que queremos actualizar
- 512396440, este valor corresponde al id del código de cuenta de cliente
- 210,este valor corresponde al nuevo monto de limite de crédito que queremos colocar
- MXN,este valor corresponde a la moneda que queremos utilizar para el limite de crédito
NOTA: se crea un nuevo profile, el profile anterior lo cierra colocando fecha de fin el dia en que se ejecuta el proceso
Este Request lo podemos modificar para que podamos hacer una actualización masiva, para ver los pasos de como hacerlo, vean la liga de la entrada Como Actualizar DFF de recibos en CXC. De manera rapida lo que hay que hacer es ponerle un nombre de variable a los valores en negrita por ejemplo {{Micliente}} , {{Idcliente}}etcétera y estos valores colocarlos como encabezados en un archivo CSV y colocar los valores
de los registros que queremos actualizar.
EL XML se veria asi
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:typ="http://xmlns.oracle.com/apps/financials/receivables/customers/customerProfileService/types/" xmlns:cus="http://xmlns.oracle.com/apps/financials/receivables/customers/customerProfileService/" xmlns:cus1="http://xmlns.oracle.com/apps/financials/receivables/customerSetup/customerProfiles/model/flex/CustomerProfileDff/" xmlns:cus2="http://xmlns.oracle.com/apps/financials/receivables/customerSetup/customerProfiles/model/flex/CustomerProfileGdf/">
<soapenv:Header/>
<soapenv:Body>
<typ:updateCustomerProfile>
<typ:customerProfile>
<!--Optional:-->
<cus:AccountNumber>{{Micliente}}</cus:AccountNumber>
<!--Optional:-->
<cus:CustomerAccountId>{{Idcliente}}</cus:CustomerAccountId>
<!--Optional:-->
<cus:CreditLimit>{{LimiteCredito}}</cus:CreditLimit>
<!--Optional:-->
<cus:CreditCurrencyCode>{{Moneda}}</cus:CreditCurrencyCode>
</typ:customerProfile>
</typ:updateCustomerProfile>
</soapenv:Body>
</soapenv:Envelope>
Esperamos les sea de utilidad esta publicación y nos compartan
Comentarios
Publicar un comentario