Manual de servicios de Integración - BRIDGE v4.1

Manual de USUARIO
Bridge - Servicios de integración

Revisión 3.2

Acerca del manual

Propósito y alcance

El presente manual de usuario tiene como finalidad la capacitación al usuario que desee utilizar los servicios provistos por Bridge para la integración con otros sistemas que provean de la información requerida de maestros y configuraciones generales para el funcionamiento de Bridge en su operatoria de tiendas con sus puntos de venta.
Se detallan los campos requeridos por cada entidad, los errores posibles y se proveen algunos escenarios de aplicación del servicio para las diferentes entidades.
En el presente documento se detallan las entidades de los maestros de Bridge que se podrán actualizar.

Bridge Core Server SOAP

Invocar un Servicio

Los servicios de BCore son expuestos via SOAP definiendo métodos genéricos que reciben el nombre de la interfaz que agrupa servicios relacionados, y un xml como parámetro, el cual tiene nombre de la operación y parámetros de la misma. Dicho servicio retorna un xml como respuesta. Este xml se recibe como un simple string.
Por ejemplo, para ejecutar los servicios de proveedor de item, se deberá invocar el método SOAP
String execute(String service, String request)
a la siguiente url:
~ /bridge/services/bridgeCoreSOAP?wsdl
Por ejemplo:
http://localhost:8180/bridge/services/bridgeCoreSOAP?wsdl
El parámetro service, es el nombre del servicio y el parámetro request será un xml con el nombre de la operación a ejecutar y sus parámetros. Dicho xml tiene la siguiente estructura básica:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
  <params>
    …
  </params>
</bridgeCoreRequest>

• operation: Nombre de la operación
• params: Parámetros de la operación.

Ejemplo de invocaciones a servicio:

El primer ejemplo muestra como invocar un servicio para crear o modificar uno o más proveedores:
service: supplier
request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
  <params>
    <suppliers type="list">
     <supplier type="bean">
    <code>PR1</code>
     <name>Proveedor1</name>
     <fantasyName>Proveedor1 Fantastico</fantasyName>
<address>Avda. Santa Fe 1234</address>
<phone>011-155669800</phone>
<fiscalId>3-55555555-66</fiscalId>
    <activeFlag>true</activeFlag>
     </supplier>
<supplier type="bean">
    <code>PR2</code>
     <name>Proveedor2</name>
     <fantasyName>Proveedor2 Fantastico</fantasyName>
<address>Avda. Garibaldi 9874</address>
<phone>011-1541878591</phone>
<fiscalId>3-44444444-66</fiscalId>
    <activeFlag>true</activeFlag>
     </supplier>
    </suppliers>
  </params>
</bridgeCoreRequest>
Donde operation es el nombre del método especifico a ejecutar para proveedores y params son los parámetros pasados a dicho método.
Cómo se puede ver en este ejemplo, se está pasando un listado de proveedores (suppliers). Dentro de este tag, hay un tag por cada proveedor (supplier) y dentro de este, los atributos propios del proveedor.
<supplier type="bean">
    <code>PR2</code>
     <name>Proveedor2</name>
     <fantasyName>Proveedor2 Fantastico</fantasyName>
<address>Avda. Garibaldi 9874</address>
<phone>011-1541878591</phone>
<fiscalId>3-44444444-66</fiscalId>
    <activeFlag>true</activeFlag>
     </supplier>
Este método devolverá un xml como el siguiente:
<?xml version="1.0" encoding="UTF-8" ?>
<bridgeCoreResponse>
  <ack>0</ack>
  <message></message>
</bridgeCoreResponse>
Donde ack es el código de error y message es el mensaje de dicho error. En el caso de ack sea 0, significa que el servicio se ejecutó sin errores.
En el siguiente ejemplo, para modificar un:
service: brand
request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
  <params>
<brands type="list">
<brand type="bean">
    <name>Marca Nueva</name>
    <activeFlag>true</activeFlag>
    <code>MNU</code>
</brand>
<brands>
  </params>
</bridgeCoreRequest>
Y la response en caso de éxito:
<?xml version="1.0" encoding="UTF-8" ?>
<bridgeCoreResponse>
  <ack>0</ack>
  <message></message>
</bridgeCoreResponse>

Request de referencia

Los mensajes de requerimiento tendrán la siguiente estructura.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.business.soap.bridge.synthesis.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:execute>
         <!-Optional:->
         <service>?</service> ** nombre del servicio a invocar **
         <!-Optional:->
         <request>?</request> ** request de BridgeCoreRequest según ejemplo de cada servicio (en punto 7 - apéndice) **
         <!-Optional:->
         <store>?</store> ** tiendas a ser enviado el requerimiento, puede ir vacío o con un 0 para todas las tiendas**
      </ser:execute>
   </soapenv:Body>
</soapenv:Envelope>

Ejemplo de request de marca (brand)

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.business.soap.bridge.synthesis.com/">
<soapenv:Header/>
<soapenv:Body>
<ser:execute>
<!-Optional:->
<service>brand</service>
<!-Optional:->
<request> <![CDATA[ <span style="color: #ff0000">** para el encapsulado de datos dentro del request **</span>
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<brands type="list">
<brand type="bean">
<name>INCA</name>
<description>INCA KOLA</description>
<disabled>false</disabled>
</brand>
<brand type="bean">
<name>COCA</name>
<description>COCA COLA</description>
<disabled>false</disabled>
</brand>
</brands>
</params>
</bridgeCoreRequest> ]]>
</request>
<!-Optional:->
<store>0</store>
</ser:execute>
</soapenv:Body>
</soapenv:Envelope>

Manejo de errores

Cuando en la ejecución de BridgeCore ocurre un error, en la propiedad ack de la response se devuelve el código del mismo y en la propiedad message, el mensaje de dicho error.
Por ejemplo, el siguiente error es retornado cuando se intenta ejecutar algo, y la sesión de la terminal ha expirado:
<bridgeCoreResponse>
<ack>-1</ack>
<message>'000000000100265919ST' no existe. </message>
</bridgeCoreResponse>

Servicio de actualización

A continuación se detallan los diferentes maestros que se podrán popular.

Servicios de actualización de maestros de artículos

A continuación se describen los servicios que se ofrecen para la actualización de maestros de artículos, y sus entidades relacionadas. Cada uno de los servicios permite crear o actualizar las entidades mediante la operación "createOrUpdate".
Para no repetir para cada servicio los valores de retorno en caso de éxito, se describirá aquí los campos relevantes que sirven para todos los casos, y cualquier particularidad será descripta en el punto correspondiente.
Los valores de retorno relevantes son:

Ejemplos de requerimientos para cada servicio pueden encontrarse en el apéndice.

Proveedores

Nombre del Servicio: supplier
Parámetros de entrada:

La lista suppliers debe contener entidades "supplier", las cuales poseen la siguiente estructura:

Marca del artículo

Nombre del Servicio: brand
Parámetros de entrada:

La lista brands debe contener entidades "brand", las cuales poseen la siguiente estructura:

Niveles de Jerarquía de los artículos

Nombre del Servicio: merchandiseHierarchy
Parámetros de entrada:

La lista merchHierarchyLevels debe contener entidades "hierarchyLevel", las cuales poseen la siguiente estructura:

La lista merchHierarchyGroups debe contener entidades "hierarchyGroup", las cuales poseen la siguiente estructura:

Unidades de medida

Nombre del Servicio: uom
Parámetros de entrada:

La lista uoms debe contener entidades "uom", las cuales poseen la siguiente estructura:

Impuesto IVA de los artículos

Nombre del Servicio: vat
Parámetros de entrada:

La lista vats debe contener entidades "vat", las cuales poseen la siguiente estructura:

Depósitos

Los depósitos son los lugares físicos donde el retailer guarda mercadería, no incluye contenedores, barcos, o camiones que están en tránsito.
Nombre del Servicio: location
Parámetros de entrada:

La lista inventoryLocations debe contener entidades "inventoryLocation", las cuales poseen la siguiente estructura:

Maestro de artículos

Este servicio tiene dependencias de otros maestros (marca, proveedores, niveles de jerarquía, unidades de medida, impuesto IVA, depósitos, taxCategory) En caso de que se envíen artículos con datos de los maestros mencionados como dependencias, se debe considerar que esas referencias se hayan informado previamente a Bridge.
Nombre del Servicio: item
Parámetros de entrada:

La lista items debe contener entidades "item", las cuales poseen la siguiente estructura:

La lista internalTaxes debe contener entidades "internalTax", las cuales poseen la siguiente estructura:

Códigos de barras – alias

Este servicio tiene dependencia de otro maestro (items) En caso de que se envíen códigos de barras asociados a artículos, los mismos se deben haber informado previamente a Bridge.
Nombre del Servicio: alias
Parámetros de entrada:

La lista aliases debe contener entidades "alias", las cuales poseen la siguiente estructura:

Artículos de tipo Stock

Este servicio tiene dependencia de otro maestro (items) En caso de que se envíen artículos para ser definidos del tipo stock, los artículos se deben haber informado previamente a Bridge.
Nombre del Servicio: stockItem
Parámetros de entrada:

La lista stockItems debe contener entidades "stockItem", las cuales poseen la siguiente estructura:

Lista de precios de artículos

Este servicio tiene dependencia de otro maestro (items) En caso de que se envíen listas de precios, los artículos se deben haber informado previamente a Bridge.
Nombre del Servicio: itemSellingPrices
Parámetros de entrada:

La lista itemSellingPrices debe contener entidades "itemSellingPrice", las cuales poseen la siguiente estructura:

La lista items debe contener entidades "item", las cuales poseen la siguiente estructura:

Artículos enlazados

Este servicio tiene dependencia de otro maestro (items) En caso de que se envíen artículos para ser enlazados, los artículos se deben haber informado previamente a Bridge.
Nombre del Servicio: linkedItem
Parámetros de entrada:

La lista linkedItems debe contener entidades "linkedItem", las cuales poseen la siguiente estructura:

Artículos del tipo servicio

Este servicio tiene dependencia de otro maestro (items) En caso de que se envíen artículos para ser definidos como servicios, los artículos se deben haber informado previamente a Bridge.
Nombre del Servicio: serviceItem
Parámetros de entrada:

La lista serviceItems debe contener entidades "serviceItem", las cuales poseen la siguiente estructura:

Stock por depósito

Este servicio tiene dependencias de otros maestros (ítems y depósitos) En caso de que se envíen las unidades en stock, los artículos y depósitos ya se deben haber informado previamente a Bridge.
Nombre del Servicio: stock
Parámetros de entrada:

La lista stocks debe contener entidades "stock", las cuales poseen la siguiente estructura:

Items del depósito

La lista ítems debe contener entidades "item", las cuales poseen la siguiente estructura:

Servicios de actualización maestros de medios de pagos

A continuación se describen los servicios que se ofrecen para la actualización de medios de pago, y sus entidades relacionadas. Cada uno de los servicios permite crear o actualizar las entidades mediante la operación "createOrUpdate".
Para no repetir para cada servicio los valores de retorno en caso de éxito, se describirá aquí los campos relevantes que sirven para todos los casos, y cualquier particularidad será descripta en el punto correspondiente.
Los valores de retorno relevantes son:

Ejemplos de requerimientos para cada servicio pueden encontrarse en el apéndice.

Medios de Pago

Nombre del Servicio: tender
Parámetros de entrada:

La lista tenders debe contener entidades "tender", las cuales poseen la siguiente estructura:

Configuración de Prefijos de tarjetas

Permite actualizar la información de los prefijos asociados a un medio de pago del tipo tarjeta, importando sus datos en la tabla CF_CARD_PREFIXES.
Nombre del Servicio: cardPrefix
Parámetros de entrada:

La lista prefixes debe contener entidades "prefix", las cuales poseen la siguiente estructura:

Notas:

• El <store> al ir en 0 va para todas las tiendas. Si tuvieran configuración específica de rango de tarjetas por tienda, aquí debería venir el Código de tienda. Por defecto envíen 0.
• Este servicio permite recibir una lista de prefijos de tarjetas, donde dentro de la lista, pueden venir N <prefix type="bean">

            <prefixes type="list">
                        <prefix type="bean">

Configuración de Prefijos de cupones

Permite actualizar la información de los prefijos de cupones, importando sus datos en la tabla CF_COUPON.
Nombre del Servicio: CouponConfiguration
Parámetros de entrada:

Notas:

• El <store> al ir en 0 va para todas las tiendas. Si tuvieran configuración específica de rango de cupones por tienda, aquí debería venir el Código de tienda. Por defecto envíen 0.
• Este servicio permite recibir una lista de prefijos de cupones, donde dentro de la lista, pueden venir N <coupon type="bean">

            <coupons type="list">
                        <coupon type="bean">

Servicios de actualización maestros de Impuestos

A continuación se describen los servicios que se ofrecen para la actualización de impuestos, y sus entidades relacionadas. Cada uno de los servicios permite crear o actualizar las entidades mediante la operación "createOrUpdate".
Para no repetir para cada servicio los valores de retorno en caso de éxito, se describirá aquí los campos relevantes que sirven para todos los casos, y cualquier particularidad será descripta en el punto correspondiente.
Los valores de retorno relevantes son:

Ejemplos de requerimientos para cada servicio pueden encontrarse en el apéndice.

Categorías de Items para los impuestos

Nombre del Servicio: TaxCategory
Parámetros de entrada:

La lista TaxCategories debe contener entidades "TaxCategory", las cuales poseen la siguiente estructura:

Regiones impositivas para tiendas

Nombre del Servicio: storeTaxCategory
Parámetros de entrada:

La lista storeTaxCategories debe contener entidades "storeTaxCategory", las cuales poseen la siguiente estructura:

Servicios de actualización de Usuarios y Vendedores.

A continuación se describen los servicios que se ofrecen para la actualización de usuarios y vendedores, y sus entidades relacionadas. Para la creación y edición de usuarios, se creo una operación "createOrUpdate", para la actualización de grupos "updateUserGroups" y para la actualización de roles "updateUserRoles".
Para no repetir para cada servicio los valores de retorno en caso de éxito, se describirá aquí los campos relevantes que sirven para todos los casos, y cualquier particularidad será descripta en el punto correspondiente.
Los valores de retorno relevantes son:

Ejemplos de requerimientos para cada servicio pueden encontrarse en el apéndice.

Actualizacion de Usuarios

Nombre del Servicio: user
Operación: createOrUpdate.
Parámetros de entrada:

La lista users debe contener entidades "user", las cuales poseen la siguiente estructura:

Grupos de permisos

La lista roleGroups debe contener entidades "roleGroup", las cuales poseen la siguiente estructura:

Ejemplos de requerimientos para cada servicio pueden encontrarse en el apéndice.

Servicios de actualización de Clientes

A continuación se describen los servicios que se ofrecen para la actualización de clientes, y sus entidades relacionadas. Cada uno de los servicios permite crear o actualizar las entidades mediante la operación "createOrUpdate".
Para no repetir para cada servicio los valores de retorno en caso de éxito, se describirá aquí los campos relevantes que sirven para todos los casos, y cualquier particularidad será descripta en el punto correspondiente.
Los valores de retorno relevantes son:

Cliente

Este servicio permitirá informar la lista de clientes con sus datos tanto personales (nombre, apellido, etc), de contacto (domicilio, teléfono, mail) como los fiscales (tipo de categoría impositiva, CUIT, IIBB, etc)
Dependiendo del tipo de cliente podrá ser persona u organización.
Opcional es la asociación de cuentas con tarjetas que pudiera tener un cliente.
Nombre del Servicio: customer
Parámetros de entrada:

La lista customers debe contener entidades "customer", las cuales poseen la siguiente estructura:

Participantes

Se informa detalle sobre el cliente, el cual dependiendo de si es persona física u organización se requieren de algunos datos puntuales:

• Persona física: firstName, lastName, genderType, type, birthday, month year
• Organización: name, type, taxesRegistrations
  • • Ambos: identifications, roleAssignments

La entidad partyData posee la siguiente estructura:

Rol del participante

Los roles de un participante permiten definir que tipo de relación mantiene el participante con el retailer, pudiendo ser su cliente, empleado, etc.
La asignación de rol para el participante es requerida. La lista no puede venir vacía. El tipo de rol del cliente, es el dato que el POS utilizará para su envío a PROMO para cálculo de promociones por tipo de cliente.
La lista roleAssignments debe contener entidades "roleAssignment", las cuales poseen la siguiente estructura:

Metodos de contacto del cliente

Un cliente puede tener más de un medio de contacto con el retailer. Por cada método de contacto del cliente (ej: laboral, particular) se podrá recibir una dirección, un teléfono, un mail
La lista contactMethods debe contener entidades "contactMethod", las cuales poseen la siguiente estructura:

Domicilio

Permite dar de alta la dirección de un cliente para un determinado tipo de contacto con el mismo. Es requerido contar con la primera línea de la dirección, su ciudad.
La entidad adress posee la siguiente estructura:

Ciudad

La entidad ciudad posee la siguiente estructura:

País

La entidad país posee la siguiente estructura:

Estado

La entidad estado posee la siguiente estructura:

Correo electrónico

La entidad emailAdress posee la siguiente estructura:

Telefono

La entidad telephone posee la siguiente estructura:

Identificaciones

Las identificaciones asociadas al cliente permitiendo registrar su documento, pasaporte o CUIT. Si un cliente es del tipo persona tendrá su DNI o pasaporte. Un cliente del tipo organización su CUIT.

• La lista de identificaciones no puede estar vacía. En caso de que el cliente no sea consumidor final, se valida que la primera identificación sea tipo CUIT (Requisito de la impresora fiscal)

La lista "identifications" debe contener entidades "partyIdentification", las cuales poseen la siguiente estructura:

Impuestos

La lista de impuestos asociadas al cliente, permiten tener su información fiscal dependiendo sea un participante del tipo persona u organización (CUIT e IIBB)
Es opcional si es del tipo persona, pero requerido para una organización.
La lista taxRegistrations debe contener entidades "taxRegistration", las cuales poseen la siguiente estructura:

Tipos de impuestos

Se informarán todos los datos impositivos del cliente referidos a certificado de eximición (si los tuviera) y los datos de alícuota del mismo (si tuviera una diferencial por padrón)
La lista taxTypes debe contener entidades "taxRegistrationTaxType", las cuales poseen la siguiente estructura:

Certificados

Es una lista opcional. Su fin es informar los certificados de eximición de IIBB con su vigencia y su porcentaje de eximición del cliente. Estos certificados deben estar relacionados con la jurisdicción en la cual el cliente se encuentre registrado.
Si no tiene certificados asociados la lista irá vacía. <certificates type="list"></certificates>
La lista certificates debe contener entidades "certificate", las cuales poseen la siguiente estructura:

Clase de impuesto

La entidad clase de impuesto posee la siguiente estructura:

Tipo de jurisdicción e impuesto

Permiti definir cuál es el tipo de impuesto, la categoría del cliente ante ese impuesto y la jurisdicción

Jurisdicción

Categoría de impuesto

Impuesto

Cuenta del cliente

Las cuentas pueden ser del tipo de lealtad o crédito (es una lista adicional que puede tener un cliente asociado, la cual es opcional. Se utiliza para asociar cuentas y sus tarjetas) Si no se enviará esta información se podrá enviar la lista vacía: <accounts type="list"></accounts>
La lista accounts debe contener entidades "account", las cuales poseen la siguiente estructura:

Tarjetas asociadas a la cuenta

En esta lista se podrán informar aquellas tarjetas que se encuentran asociadas a una determinada cuenta que tenga el cliente. Esta lista viene asociada a una cuenta específica del cliente.
La lista cards debe contener entidades "card", las cuales poseen la siguiente estructura:

Eliminacion de Clientes

Nombre del Servicio: customer
Operación: deleteCustomer.
Parámetros de entrada:

La lista customerCode debe contener entidades "String", las cuales poseen la siguiente estructura:

Errores

Al producirse alguna falla durante la ejecución de Bridge Core Client o al informarse algún error por parte del Servidor de Reglas, se lanza una excepción. Esta tiene encapsulada el código de error y la descripción que identifican unívocamente el tipo de error producido.
Cuando en la ejecución de BridgeCore ocurre un error, en la propiedad ack de la response se devuelve el código del mismo y en la propiedad message, el mensaje de dicho error.
Por ejemplo, el siguiente error es retornado cuando se intenta ejecutar algo, y la sesión de la terminal ha expirado:
<bridgeCoreResponse>
<ack>-1</ack>
<message>'000000000100265919ST' no existe. </message>
</bridgeCoreResponse>

Monitoreo de los registros recibidos a través de servicios

Para poder verificar el estado de los registros que fueron enviados desde el ERP a través de los servicios de Bridge, se podrá visualizar dentro de los monitores de Bridge Manager Central por entidad.
Para obtener mayor detalle de la funcionalidad de monitoreo, referenciar el documento Manual de Usuario - Bridge Manager (punto 3.8.5 Monitor de Importación)
A continuación se resume esta operatoria:

• Desde el monitor de importación se podrán ver los registros recibidos según la entidad (y por estado). Una vez obtenido del listado de registros, se podrá chequear el contenido y detalle de cualquiera de los registros en particular.

• Desde el monitor de importación se pueden ver los registros recibidos según la entidad (y por estado). Luego se puede visualizar tanto el detalle como el mensaje recibido (mediante el uso de las Acciones)

Acción/contenido
Se podrá visualizar el contenido del envío realizado para esa entidad.

Acción/detalle (detalle de la importación)
Con resultado (procesado/error). En caso de error se detalla porque motivo.

En un escenario donde se envía un lote con varios artículos, si alguno de los artículos tiene un error en su proceso de importación, se reportará con error y el resto se procesaran quedando registrados en la base de datos de Bridge.
Siempre que se puede procesar el registro recibido del ERP, se importa en Bridge Manager y luego se replica a tiendas. En caso de error se mostrará en el listado con el estado error notificando el motivo.
Reproceso
Si se envía un lote de 10 artículos y entre ellos hay erróneos, estos se registran con el resultado de la importación como "Error"; los que están correctos se procesan (los registros correspondientes se importan y se replican). En este caso, el monitor de importación informará al registro con el estado "Parcial" del lote de ítems que enviado, si se selecciona la opción "Detalle", dentro  del menú "Acciones", en dicho  registro, se informarán los items que fueron procesados y los que tuvieron error, pero no se podrán reprocesar nuevamente (cada ítem, de manera individual).
En caso enviar un sólo ítem, y éste se procesa con estado "Error", se podrá seleccionar la opción "Reprocesar", en el menú "Acciones", para volver a  reprocesarlo.

Apéndice

Se detallan ejemplos de los request para la actualización de los catálogos mencionados en el presente documento.

Servicio de Usuarios

Actualizacion de usuario

Request:
<bridgeCoreRequest>
  <operation>createOrUpdate</operation>
  <params>
       <users type="list">
<user type="bean">
<name>prueba27</name>
<userName>gonxa8</userName>
<password>4AA101DDC5DC18B1B632E6540805722C</password>
<passwordSalt>A057F651CDA66D6B8C6986D94E91FF7B550CCEA92FC3E7AED2B70B3A66D4B61E</passwordSalt>
<enabled>true</enabled>
<mustChangePassword>true</mustChangePassword>
<blocksOnUserNoActivity>true</blocksOnUserNoActivity>
<accountLocked>true</accountLocked>
<lockTime>16/03/2017</lockTime>
<passwordExpire>true</passwordExpire>
<roleGroups type="list">
<roleGroup type="bean">
<group>Cajero</group>
</roleGroup>
<roleGroup type="bean">
<group>Vendedor</group>
</roleGroup>
</roleGroups>
</user>            
<user type="bean">
                       <name>Gonzalo8</name>
<userName>gonxa8</userName>                   
<password>4AA101DDC5DC18B1B632E6540805722C</password>                                     
<passwordSalt>A057F651CDA66D6B8C6986D94E91FF7B550CCEA92FC3E7AED2B70B3A66D4B61E</passwordSalt>  
<enabled>true</enabled>
<mustChangePassword>true</mustChangePassword>
<blocksOnUserNoActivity>true</blocksOnUserNoActivity>
<accountLocked>true</accountLocked>
<lockTime>16/03/2017</lockTime>
<passwordExpire>true</passwordExpire>
    <roleGroups type="list">  
                           <roleGroup type="bean">
                                  <group>Cajero</group>
                           </roleGroup>
                           <roleGroup type="bean">
                                  <group>Vendedor</group>
                           </roleGroup>
                    </roleGroups>   
             </user>
       </users>
  </params>
</bridgeCoreRequest>

Servicios de actualización de maestros de artículos

El formato general de la Response será genérico, y tendrá dos formatos posibles, dependiendo si la misma se ejecutó correctamente o no.
En caso de que la ejecución del servicio sea correcta, esto no implica que todas las entidades informadas hayan sido procesadas exitosamente. Es responsabilidad del sistema que invoca al servicio, proveer un servicio al cual se le informarán los errores propios del procesamiento de la cada una de las entidades.




Response de ejecución correcta:
<bridgeCoreResponse>
<ack>0</ack>
<message></message>
</bridgeCoreResponse>

Response de ejecución con error:
<bridgeCoreResponse>
<ack>-1</ack>
<message> Excepción no definida.</message>
</bridgeCoreResponse>

Marca del Artículo

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<brands type="list">
<brand type="bean">
<name>BR1</name>
<description>Marca BR1</description>
<disabled>false</disabled>
</brand>
<brand type="bean">
<name>BR2</name>
<description>Marca BR2</description>
<disabled>true</disabled>
</brand>
</brands>
</params>
</bridgeCoreRequest>

Proveedores

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<suppliers type="list">
<supplier type="bean">
<code>PR1</code>
<name>Proveedor1</name>
<fantasyName>Proveedor de Fantasía</fantasyName>
<address>Avda. Santa Fe 1234</address>
<phone></phone>
<email>[email protected]</email>
<fiscalId></fiscalId>
<activeFlag>false</activeFlag>
</supplier>
<supplier type="bean">
<code>PR4</code>
<name>Proveedor Nuevo</name>
<fantasyName></fantasyName>
<address></address>
<phone>0341 15555555</phone>
<email>[email protected]</email>
<fiscalId>20-21948886-7</fiscalId>
<activeFlag>true</activeFlag>
</supplier>
</suppliers>
</params>
</bridgeCoreRequest>

Niveles de jerarquía de los Artículos

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<merchHierarchyLevels type="list">
<hierarchyLevel type="bean">
<code>DPT1</code>
<description>Nivel 1 </description>
<level>1</level>
<active>true</active>
</hierarchyLevel>
<hierarchyLevel type="bean">
<code>FLY</code>
<description>Nivel 2</description>
<level>2</level>
<active>true</active>
</hierarchyLevel>
</merchHierarchyLevels>
<merchHierarchyGroups type="list">
<hierarchyGroup type="bean">
<code>GRP1</code>
<description>Grupo 1</description>
<level>1</level>
<parentGroup></parentGroup>
<departamentalItemCode>MHG1</departamentalItemCode>
<disabled>true</disabled>
</hierarchyGroup>
<hierarchyGroup type="bean">
<code>GRP2</code>
<description>Grupo 2</description>
<level>2</level>
<parentGroup>GRP1</parentGroup>
<departamentalItemCode>MHG1</departamentalItemCode>
<disabled>true</disabled>
</hierarchyGroup>
</merchHierarchyGroups>
</params>
</bridgeCoreRequest>

Unidades de Medida

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<uoms type="list">
<uom type="bean">
<code>UOM1</code>
<name>Metro</name>
<decQty>1</decQty>
<disabled>false</disabled>
</uom>
<uom type="bean">
<name>UOM2</name>
<name>Centimetro</name>
<decQty>2</decQty>
<disabled>true</disabled>
</uom>
</uoms>
</params>
</bridgeCoreRequest>

Impuesto IVA de los artículos

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<vats type="list">
<vat type="bean">
<code>2</code>
<description>IVA 21%</description>
<percentage>21</percentage>
<activeFlag>false</activeFlag>
</vat>
<vat type="bean">
<code>5</code>
<description>IVA 10,5%</description>
<percentage>10.5</percentage>
<activeFlag>true</activeFlag>
</vat>
</vats>
</params>
</bridgeCoreRequest>

Depósitos

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<inventoryLocations type="list">
<inventoryLocation type="bean">
<code>LOC1</code>
<name>Deposito 1</name>
</inventoryLocation>
<inventoryLocation type="bean">
<code>LOC2</code>
<name>Deposito 2</name>
</inventoryLocation>
</inventoryLocations>
</params>
</bridgeCoreRequest>

Maestro de Artículos

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<items type="list">
<item type="bean">
<itemCode>3255</itemCode>
<description>Caramelos SUGUS x kg</description>
<hierarchyGroupCode>ALMA</hierarchyGroupCode>
<price>45</price>
<unitCostPrice>40</unitCostPrice>
<vatCode>2</vatCode>
<notForSaleFlag>false</notForSaleFlag>
<notForDiscountsFlag>false</notForDiscountsFlag>
<priceRequiredFlag>false</priceRequiredFlag>
<weightRequiredFlag>true</weightRequiredFlag>
<quantityRequiredFlag>false</quantityRequiredFlag>
<quantityAllowedFlag>false</quantityAllowedFlag>
<restrictedSaleFlag>false</restrictedSaleFlag>
<logExceptionFlag>false</logExceptionFlag>
<authorizationRequiredFlag>false</authorizationRequiredFlag>
<serialNumberRequiredFlag>false</serialNumberRequiredFlag>
<returnNotAllowedFlag>false</returnNotAllowedFlag>
<supplierCode></supplierCode>
<brandCode>Sugus</brandCode>
<itemType>NORM</itemType>
<promotionalPrice></promotionalPrice>
<promotionalPriceDateFrom format="dd-MM-yyyy hh:mm:ss"></promotionalPriceDateFrom>
<promotionalPriceDateTo format="dd-MM-yyyy hh:mm:ss"></promotionalPriceDateTo>
<uomCode></uomCode>
<imageCode></imageCode>
<lastUpdateSaleUnitPrice format="dd-MM-yyyy hh:mm:ss"></lastUpdateSaleUnitPrice>
<genericItemFlag>false</genericItemFlag>
<kitComponentFlag>false</kitComponentFlag>
<inventoryLocationCode>DEP1</inventoryLocationCode>
<commissionPercent></commissionPercent>
<disabled>false</disabled>
<itemVATCategory>G</itemVATCategory>
<uom2Code>B2KG</uom2Code>
<uom2Units>2</uom2Units>
<uom2Operation>D</uom2Operation>
<retiredDiscountAllowedFlag>true</retiredDiscountAllowedFlag>
<reservationAllowedFlag>true</reservationAllowedFlag>
<tecla></tecla>
<promoFlag1></promoFlag1>
<promoFlag2></promoFlag2>
<promoFlag3></promoFlag3>
<genericField1></genericField1>
<genericField2></genericField2>
<genericField3></genericField3>
<genericField4></genericField4>
<genericField5></genericField5>
<importDocReq>false</importDocReq>
<sellerRequired>false</sellerRequired>
<internalTaxes>
<internalTax>
<internalTaxCode>1</internalTaxCode>
<internalTaxAmount>1.58</internalTaxAmount>
</internalTax>
<internalTax>
<internalTaxCode>2</internalTaxCode>
<internalTaxAmount>2.00</internalTaxAmount>
</internalTax>
</internalTaxes>
<webDescription> Caramelos SUGUS x kg surtido de sabores </webDescription>
<extendedWebDescription> Caramelos SUGUS x kg, surtido de sabores, con gusto anana, menta, frutilla, manzana, naranja. En bolsas de nylon con logo de la marca</<extendedWebDescription>
</item>
</items>
</params>
</bridgeCoreRequest>

Códigos de Barras - Alias

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<aliases type="list">
<alias type="bean">
<itemCode>ACA</itemCode>
<barcode>998226397189</barcode>
<description>Codigo de Barras unitario</description>
<units></units>
<storeCode></storeCode>
</alias>
<alias type="bean">
<itemCode>ACA</itemCode>
<barcode>998226397190</barcode>
<description>Codigo de Barras caja por 10 unidades</description>
<units>10</units>
<storeCode></storeCode>
</alias>
</aliases>
</params>
</bridgeCoreRequest>

Artículos de Tipo Stock

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<stockItems type="list">
<stockItem type="bean">
<itemCode>ACA</itemCode>
<styleCode>STY1</styleCode>
<colorCode>CO1</colorCode>
<sizeCode>SZ1</sizeCode>
<containerCode>CN2</containerCode>
<type>ShelfItem</type>
<saleWeightOrUnitCountCode>W</saleWeightOrUnitCountCode>
<customerPickupTypeCode>LOC1</customerPickupTypeCode>
<unitPriceFactor>1.67</unitPriceFactor>
<availableForSaleDate format="dd-MM-yyyy hh:mm:ss">31-01-2014 00:00:00</availableForSaleDate>
<inventoryAccountingMethodCode>MS</inventoryAccountingMethodCode>
<sellUnitLastReceivedBaseCostAmount></sellUnitLastReceivedBaseCostAmount>
<sellUnitLastReceivedNetCostAmount>65.23</sellUnitLastReceivedNetCostAmount>
<sellUnitLandedCostAmount></sellUnitLandedCostAmount>
<sellUnitLastReceivedCostsEstablishedDate format="dd-MM-yyyy hh:mm:ss">01-12-2013 14:23:10</sellUnitLastReceivedCostsEstablishedDate>
<shrinkFlag>false</shrinkFlag>
<swellFlag>false</swellFlag>
<model></model>
<depth>10.52</depth>
<width>25</width>
<height>14.2</height>
<diameter></diameter>
<grossWeight></grossWeight>
<netWeight></netWeight>
<drainedWeight></drainedWeight>
<sizeUomCode></sizeUomCode>
<weightUomCode>kg</weightUomCode>
<stockUnitQuantity>120</stockUnitQuantity>
</stockItem>
</stockItems>
</params>
</bridgeCoreRequest>

Lista de precios de artículos

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<itemSellingPrices type="list">
<itemSellingPrice type="bean">
<itemSellingPriceNumber>1234</itemSellingPriceNumber>
<storeCode>1</storeCode>
<effectiveDateTime format="dd-MM-yyyy">01-01-2016</effectiveDateTime>
<expirationDateTime format="dd-MM-yyyy">01-01-2017</expirationDateTime>
<items type="list">
<item type="bean">
<itemCode>1</itemCode>
<barcode>7792850000066</barcode>
<currentSaleUnitRetailPriceAmount>450.00</currentSaleUnitRetailPriceAmount>
<currentSaleUnitRetailPriceEffectiveDate format="dd-MM-yyyy">01-01-2016</currentSaleUnitRetailPriceEffectiveDate>
<currentSaleUnitRetailPriceExpirationDate format="dd-MM-yyyy">01-01-2017</currentSaleUnitRetailPriceExpirationDate>
<currentSaleUnitRetailPriceTypeCode>pr1</currentSaleUnitRetailPriceTypeCode>
<permanentSaleUnitRetailPriceAmount>500.00</permanentSaleUnitRetailPriceAmount>
<permanentSaleUnitRetailPriceEffectiveDate format="dd-MM-yyyy">12-05-2013</permanentSaleUnitRetailPriceEffectiveDate>
<manufacturerSaleUnitRecommendedRetailPriceAmount>700.00</manufacturerSaleUnitRecommendedRetailPriceAmount>
</item>
</items>
             </itemSellingPrice>
             </itemSellingPrices>
       </params>
</bridgeCoreRequest>

Artículos enlazados

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<linkedItems type="list">
<linkedItem type="bean">
<itemCode>ACA</itemCode>
<linkedItemCode>38078577</linkedItemCode>
<quantity>2</quantity>
<memberItemPrice>50,00</memberItemPrice>
</linkedItem>
<linkedItem type="bean">
<itemCode>89001</itemCode>
<linkedItemCode>90001</linkedItemCode>
<quantity>1</quantity>
<memberItemPrice>40,00</memberItemPrice>
</linkedItem>
</linkedItems>
</params>
</bridgeCoreRequest>

Artículos del tipo servicio

<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<serviceItems type="list">
<serviceItem type="bean">
<itemCode>1234</itemCode>
<type>wrty</type>
<baseCostAmount>50.5</baseCostAmount>
<netCostAmount>88.00</netCostAmount>
<costsEstablishedDate format="dd-MM-yyyy">12-10-2015</costsEstablishedDate>
</serviceItem>
<serviceItem type="bean">
<itemCode>1111</itemCode>
<type>wrty</type>
<baseCostAmount>60.00</baseCostAmount>
<netCostAmount>78.00</netCostAmount>
<costsEstablishedDate format="dd-MM-yyyy">12-10-2015</costsEstablishedDate>
</serviceItem>
</serviceItems>
</params>
</bridgeCoreRequest>

Stock por depósito e items del depósito

<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<stocks type="list">
<stock type="bean">
<storeCode>1</storeCode>
<locationCode>1</locationCode>
<revenueCenter>1</revenueCenter>
<itemInventoryState>onSale</itemInventoryState>
<items type="list">
<item type="bean">
<itemCode>1234</itemCode>
<stockUnits>450.00</stockUnits>
</item>
<item type="bean">
<itemCode>1111</itemCode>
<stockUnits>150.00</stockUnits>
</item>
</items>
</stock>
</stocks>
</params>
</bridgeCoreRequest>

Servicios de actualización de medios de pago

Medios de Pago

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<tenders type="list">
<tender type="bean">
<tenderCode>CASH</tenderCode>
<descriptor>Medio de Pago CASH</descriptor>
<type>1</type>
<disabled>false</disabled>
</tender>
<tender type="bean">
<tenderCode>CARD</tenderCode>
<descriptor>Medio de Pago CARD</descriptor>
<type>2</type>
<disabled>true</disabled>
</tender>
</tenders>
</params>
</bridgeCoreRequest>

Prefijos de tarjetas

Request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.business.soap.bridge.synthesis.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:execute>
         <!-Optional:->
         <service>cardprefix</service>
         <!-Optional:->
         <request><![CDATA[
<bridgeCoreRequest>
       <operation>createOrUpdate</operation>
       <params>
             <prefixes type="list">
                    <prefix type="bean">
                           <storeTenderCode>Mon</storeTenderCode>
                           <prefixIdentifier>1</prefixIdentifier>
                           <rangeFrom>85</rangeFrom>
                           <rangeTo>85</rangeTo>
                           <prefixLength>2</prefixLength>
                           <cardLength>16</cardLength>
                           <enabled>true</enabled>
                           <type>4</type>
                    </prefix>
             </prefixes>
       </params>
</bridgeCoreRequest>
</request>
      <!-Optional:->
         <store>0</store>
      </ser:execute>
   </soapenv:Body>
</soapenv:Envelope>

Prefijos de cupones

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.business.soap.bridge.synthesis.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ser:execute>
         <!-Optional:->
         <service>couponConfiguration</service>
         <!-Optional:->
         <request><![CDATA[
<bridgeCoreRequest>
  <operation>createOrUpdate</operation>
  <params>
            <coupons type="list">
                        <coupon type="bean">
                                   <identifier>1234</identifier>
                                   <couponType>Promo</couponType>
                                   <description>Promo Description</description>
                                   <couponLength>50</couponLength>
                                   <fromPrefix>111</fromPrefix>
                                   <toPrefix>222</toPrefix>
                                   <prefixLength>3</prefixLength>
                                   <amount>100</amount>
                                   <couponFormatID>EAN13</couponFormatID>
                        </coupon>
            </coupons>
  </params>
</bridgeCoreRequest>
]]>
</request>
         <!-Optional:->
         <store>0</store>
      </ser:execute>
   </soapenv:Body>
</soapenv:Envelope>

Servicios de actualización maestros de Impuestos

Categorías de Items para los Impuestos

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<taxCategories type="list">
<taxCategory type="bean">
<code>1</code>
<name>frescos</name>
</taxCategory>
<taxCategory type="bean">
<code>2</code>
<name>general</name>
</taxCategory>
</taxCategories>
</params>
</bridgeCoreRequest>

Categorías de Regiones impositivas para las tiendas

Request:
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<storeTaxCategories type="list">
<storeTaxCategory type="bean">
<storeTaxCategoryCode>RE1</storeTaxCategoryCode>
<storeTaxCategoryName>Region 1</storeTaxCategoryName>
</storeTaxCategory>
<storeTaxCategory type="bean">
<storeTaxCategoryCode>RE2</storeTaxCategoryCode>
<storeTaxCategoryName>Region 2</storeTaxCategoryName>
</storeTaxCategory>
</storeTaxCategories>
</params>
</bridgeCoreRequest>

Servicios de actualización de Usuarios

Actualización de Usuarios

Request:
Ejemplo de dos usuarios con sus grupos de permisos.
<bridgeCoreRequest>
  <operation>createOrUpdate</operation>
  <params>
       <users type="list">
             <user type="bean">
                       <name>Gonzalo7</name>
<userName>gonxa7</userName>                   
<password>4AA101DDC5DC18B1B632E6540805722C</password>                                     
<passwordSalt>A057F651CDA66D6B8C6986D94E91FF7B550CCEA92FC3E7AED2B70B3A66D4B61E</passwordSalt>     
                    <roleGroups type="list">  
                           <roleGroup type="bean">
                                  <group>Cajero</group>
                           </roleGroup>
                           <roleGroup type="bean">
                                  <group>Vendedor</group>
                           </roleGroup>
                    </roleGroups>      
             </user>
             <user type="bean">
                       <name>Gonzalo8</name>
<userName>gonxa8</userName>                   
<password>4AA101DDC5DC18B1B632E6540805722C</password>                                     
<passwordSalt>A057F651CDA66D6B8C6986D94E91FF7B550CCEA92FC3E7AED2B70B3A66D4B61E</passwordSalt>     
                    <roleGroups type="list">  
                           <roleGroup type="bean">
                                  <group>Cajero</group>
                           </roleGroup>
                           <roleGroup type="bean">
                                  <group>Vendedor</group>
                           </roleGroup>
                    </roleGroups>      
             </user>
       </users>
  </params>
</bridgeCoreRequest>

Servicios de actualización de Clientes

Creacion o actualización de clientes

Se insertan dos xml ejemplo con mensajes de requerimiento para poder dar de alta un cliente del tipo organización (con datos impositivos asociados) y uno del tipo persona (consumidor final)

Cliente Persona

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.business.soap.bridge.synthesis.com/">
<soapenv:Header/>
<soapenv:Body>
<ser:execute>
<!-Optional:->
<service>customer</service>
<request>
<![CDATA[
<bridgeCoreRequest>
<operation>createOrUpdate</operation>
<params>
<customers type="list">
<customer type="bean">
<code>962289</code>
<email>[email protected]</email>
<store>35</store>
<party type="bean">
<firstName>WALLINGRE</firstName>
<lastName>ELADIO ANIBAL</lastName>
<genderType>M</genderType>
<typeCode>PRS</typeCode>
<birthCountryCode>PER</birthCountryCode>
<roleAssignments type="list">
<partyRoleAssignment type="bean">
<contactMethods type="list">
<partyContactMethod type="bean">
<purposeType id="2"/>
<methodType id="1"/>
<effectiveDate>2017-08-23T16:32:37.947</effectiveDate>
<expirationDate>2200-12-30 00:00:00.000</expirationDate>
<address type="bean">
<city type="bean">
<code>7346</code>
</city>
<country type="bean">
<code>PER</code>
</country>
<state type="bean">
<code>7</code>
</state>
<firstLine>AVDA SAN MARTIN 486</firstLine>
<postalCode>3206</postalCode>
</address>
<emailAddress type="bean">
<name/>
</emailAddress>
</partyContactMethod>
</contactMethods>
<sequenceNumber>1</sequenceNumber>
<partyRole id="1"/>
<effectiveDate format="dd-MM-yyyy">23-08-2017</effectiveDate>
<expirationDate format="dd-MM-yyyy">30-12-2200</expirationDate>
</partyRoleAssignment>
</roleAssignments>
<identifications type="list">
<partyIdentification type="bean">
<identificationType id="4"/>
<identifierValue>00962289</identifierValue>
</partyIdentification>
</identifications>
</party>
</customer>
</customers>
</params>
</bridgeCoreRequest>
]]>
</request>
<!-Optional:->
<store>0</store>
</ser:execute>
</soapenv:Body>
</soapenv:Envelope>