Manual de Servicios de Integración - BRIDGE v4.2

Manual de USUARIO
Bridge - Servicios de integración

Revisión 7.7

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, String store)

• String store: este parámetro opcional (el cual permite definir que el envío se realiza a una tienda específica, de no definirse o encontrarse con el valor 0 será para todas las tiendas)

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:

NOTA:
Para el servicio suppplier al validar el email se utiliza una librería de Apache, que se encarga de determinar si un mail es válido o no (https://commons.apache.org/proper/commons-validator/)
El email "[email protected]" para la librería es inválido.

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: unitOfMeasure
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: vatType
Parámetros de entrada:

La lista vatTypes debe contener entidades "vatType", las cuales poseen la siguiente estructura:

Impuestos internos de los artículos

Nombre del Servicio: internalTax
Parámetros de entrada:

La lista internalTaxes debe contener entidades "internalTax", 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 locations debe contener entidades "location", 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:
Nota: cuando la nueva property "store.internalTaxInformedWithItem" esté en false, no considerar el tag internalTaxes al importar ya que se usará el servicio de relación de artículos con impuestos internos.
Cuando la property esté en true, se mantiene la lógica actual: con cada importación del servicio "ítem" se borran los impuestos internos asociados al ítem en el modelo y se crean las relaciones incluidas en el servicio.

La lista itemPictures debe contener entidades "itemPicture", la cual posee la siguiente estructura:

Consideraciones del servicio para las imágenes:

• En el servicio siempre se añaden nuevas imágenes. No sirve ni para editar ni para eliminar imágenes existentes. En caso de querer llevar a cabo dichas acciones, se deberá realizar desde el BM.
• Notas sobre configuración miniatura, base y template
  • En caso de ya existir una imagen configurada como miniatura o template, y en el servicio se especifica una nueva imagen como tal, se utilizará la nueva imagen para miniatura o template.
  • Si no se especifica ninguna imagen como miniatura o template, se tomará la primera como tal.
  • Si se especifica más de una, también se tomará la primera.
• (*) *Notas sobre prioridad de las imágenes
  • Al ser un campo opcional, si viene una prioridad indicada para la imagen, se prioriza esa.
    •  En caso de existir una lista de imágenes ya asociadas al ítem que tenían la misma prioridad esta se pisa y queda priorizada la indicada en los últimos artículos recibidos por el servicio.
  • Si no viniera indicada la prioridad en la importación, se le da la prioridad siguiente a la que tenía la última imagen de ese ítem.

    • Ej: articulo 123 (imágenes nuevas C y D)

      Imagen	Prioridad en BD	Nuevo recibido por WS	Prioridad con la cual queda en BD al importarse
      A	1		3
      B	2		4
      C		1	1
      D		2	2

      
      Imágenes nuevas C y D sin indicar prioridad

      Imagen	Prioridad en BD	Nuevo recibido por WS	Prioridad con la cual queda en BD al importarse
      A	1		1
      B	2		2
      C			3
      D			4

      
      El servicio actual de ítems se extiende con algunos datos adicionales como el producto (si viene informado lo asocia, sino lo crea para tener compatibilidad hacia atrás), los atributos, el displayOrder y atributos.
      Se extienden los sig campos:

      Propiedad	Tipo de dato	Descripción	Requerido	Observaciones
      CommissionFlag	Boolean	Flag de admite comisión	No	Se setea el campo FL_CMN de AS_ITM
      peProfit	Decimal (16,4)	Porcentaje de margen o ganancia	No	Se setea el campo PE_PROFIT de AS_ITM
      relevance	Int	Relevancia o importancia	No	Se setea el campo RELEVANCE de AS_ITM
      oldPrice	Decimal (16,4)	Precio anterior	No	Se setea el campo OLD_PRICE de AS_ITM
      published	Boolean	Flag de ítem publicado	No	Se setea el campo PUBLISHED de de AS_ITM
      productAttributeValues	List	Lista de atributos del producto	No

      La lista productAttributeValues debe contener entidades "productAttributeValue", las cuales poseen la siguiente estructura:

      Propiedad	Tipo de dato	Descripción	Requerido	Observaciones
      productCode	varchar (50)	Código del producto	Si	Se genera un registro en la tabla PRODUCT_ATTR_VALUE con el PRODUCT_ATTR_ID (se asigna el ID del productCode recibido) y el PROD_ATTR_OPTION_ID
      isDefaultItem	Boolean	Descripción de la agrupación.	Si	Se setea el campo DEFAULT_ITEM_ID de la tabla PRODUCT
      attributeCode	Varchar (50)	Código del atributo	Si	Se setea el campo PROD_ATTR_ID de la PRODUCT_ATTR_VALUE con el ID del registro que corresponda al campo CODE de la PRODUCT_ATTR
      attributeOptionCode	Varchar (max)	Código de la opción del atributo	Si	Se setea el campo PROD_ATTR_OPTION_ID de la tabla PRODUCT_ATTR_VALUE con el ID del registro que corresponda al campo NAME de la PRODUCT_ATTR_OPTION
      isPreSelected	Boolean	Indicador si es una opción de atributo preseleccionada o no	Si	Se setea el campo IS_PRE_SELECTED de la tabla PRODUCT_ATTR_VALUE
      displayOrder	Int	Orden en el que se muestra/informa dentro de la lista	No	Se setea el campo DISPLAY_ORDER de PRODUCT_ATTR_VALUE. Si el "displayOrder" no viene informado se le asigne el siguiente al último.
      isDisabled	Boolean	Indicador si está o no habilitado	Si	Se setea el campo IS_DISABLED de la tabla PRODUCT_ATTR_VALUE

      Relación de artículos con impuestos internos

      Nombre del Servicio: itemInternalTax
      Parámetros de entrada:

      Propiedad	Tipo de dato	Descripción	Requerido
      itemInternalTaxes	List	Lista de impuestos internos a crear o actualizar	Si

      La lista itemInternalTaxes debe contener entidades "itemInternalTax", las cuales poseen la siguiente estructura:

      Propiedad	Tipo de dato	Descripción	Requerido
      item	String(25)	Código interno del ítem	Si
      internalTax	String(25)	Código del impuesto interno.	Si
      amountInternalTax	Decimal(8,2)	Monto del impuesto interno	No
      disabled	Boolean	Indica si la relación ítem / internalTax se debe eliminar	No

      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:

      Propiedad	Tipo de dato	Descripción	Requerido
      aliases	List	Lista de códigos de barra a crear o actualizar.	Si

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

      Propiedad	Tipo de dato	Descripción	Requerido
      itemCode	String (25)	Código del artículo para el que se agregará o acutalizará el código de barras. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla Item (campo ItemCode)	Si
      barcode	String (25)	Código de barras.	Si
      description	String (255)	Descripción del código de barras.	No
      units	Integer	Unidades.	No
      storeCode	Varchar (20)	Tienda (se guarda luego el ID de tienda en CD_STR_RT)	No
      disabled	Boolean	Si el mismo se encuentra activo o no. Default false	No

      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: stockItems
      Parámetros de entrada:

      Propiedad	Tipo de dato	Descripción	Requerido
      stockItems	List	Lista de artículos de tipo stock a crear o actualizar.	Si

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

      Propiedad	Tipo de dato	Descripción	Requerido
      itemCode	String (25)	Código del artículo de tipo stock que se agregará o acutalizará.	Si
      styleCode	String (25)	Código de estilo. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla Style (campo code. Servicio a implementar)	No
      colorCode	String (25)	Código de color. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla Color (campo code. Servicio a implementar)	No
      sizeCode	String (25)	Código de tamaño. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla Size (campo code. Servicio a implementar)	No
      containerCode	String (25)	Código de envase. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla Container (campo code. Servicio a implementar)	No
      Type	String (2)	Código de tipo de stock ítem.	No
      saleWeightOrUnitCountCode	String	Código identificador de venta por peso o por unidad. Indica si se vende por peso o como una unidad.	No
      pickupCode	String(2)	Código de retiro. Define dónde y cómo un cliente puede retirar este artículo.	No
      unitPriceFactor	Decimal(10,4)	Número de unidades de medida por unidad de venta. Se utiliza como divisor en el cálculo del precio de venta de la unidad del artículo común, por ejemplo, 1,67 dólares por libra o $ 2,59 por 32 floz.	No
      availableForSaleDate	DateTime	Fecha de disponibilidad para la venta. Por ejemplo, ciertos libros tienen fechas de publicación específicos, fechas de lanzamiento de entretenimiento de música.	No
      inventoryAccountingMethodCode	String (2)	Código que define el método de contabilidad del artículo. Ej. Venta al por menor, etc.	No
      sellUnitLastReceivedBaseCostAmount	Money	Costo base de la unidad. Excluye subsidios, descuentos, cargos y otros importes que pueden cambiar el costo del artículo.	No
      sellUnitLastReceivedNetCostAmount	Money	Costo neto de la unidad. Incluye subsidios, descuentos, cargos y demás sumas que pueden cambiar el costo del artículo. Donde no hay subsidios, etc el costo neto será igual al costo base para un artículo.	No
      sellUnitLandedCostAmount	Money	Costo del artículo más servicios. El costo del artículo más el seguro, acarreo, transporte, entrega, seguros, derechos de aduana, etc, que se suman al costo total de entrega de un artículo importado a la tienda.	No
      sellUnitLastReceivedCostsEstablishedDate	DateTime	Fecha en que se establecieron los últimos costos recibidos (neto y de base).	No
      shrinkFlag	Boolean	Flag que indica que el artículo NO estará disponible en las funcionalidades de conteo y ajuste de stock (se aplicaria al caso de items padre de kits donde el stock sólo se lleva por hijos y no por padre)	No
      swellFlag	Boolean	Flag por aumento de peso. Para indicar que el artículo podría aumentar peso desde el momento del pedido hasta el momento de su recepción.	No
      model	String	Número o nombre de modelo asignado por el fabricante del artículo.	No
      depth	Decimal (15,4)	Medida de la profundidad del artículo.	No
      width	Decimal (15,4)	Medida del ancho del artículo.	No
      height	Decimal (15,4)	Medida del alto del artículo.	No
      diameter	Decimal (15,4)	Medida del diámetro del artículo.	No
      grossWeight	Decimal (15,4)	Peso bruto del artículo.	No
      netWeight	Decimal (15,4)	Peso neto del artículo.	No
      drainedWeight	Decimal (15,4)	Peso drenado del líquido.	No
      sizeUomCode	String (25)	Código de unidad de medida utilizada para indicar el tamaño del artículo. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla Uom (campo code)	No
      weightUomCode	String (25)	Código de unidad de medida utilizada para indicar el peso del artículo. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla Uom (campo code)	No
      repositionPoint	Decimal (15,4)	Refiere al umbral de reposición necesario para el cálculo del pedido sugerido	No

      Relación de artículos con proveedores

      Este servicio permite tener por proveedor la lista de artículos que el mismo puede entregar a la tienda. Será utilizada para la generación de órdenes de compra.
      Nombre del Servicio: itemSupplierItem
      Parámetros de entrada:

      Propiedad	Tipo de dato	Descripción	Requerido
      itemSupplierItems	List	Lista de relación entre artículos y proveedores a crear o actualizar.	Si

      La lista itemSupplierItems debe contener entidades "itemSupplierItem", las cuales poseen la siguiente estructura:

      Propiedad	Tipo de dato	Descripción	Requerido
      item	String(25)	Código del artículo.	Si
      supplier	String (100)	Identificador del proveedor.	Si
      barcode	String (25)	Código de barras para identificar la presentación del artículo	No
      lastReceiptSaleByUnitCount	Decimal (19,3)	Ultima cantidad recibida	No
      lastReceiptSaleUnitBaseCost	Decimal (19,3)	Costo base por unidad	No
      countMinOrder	Decimal (19,3)	Cantidad mínina por pedido	No
      countMaxOrder	Decimal (19,3)	Cantidad máxima por pedido	No
      disabled	boolean	Indica si la relación está deshabilitada (Def=false)	No

      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.
      El lote de registros debería pertenecer a la misma tienda. Por tal motivo en el request a enviar, el campo <store>codigoTienda</store> debería venir informado el código de la tienda a la cual pertenecen los registros informados dentro del mismo lote. No se debería enviar <store>0</store>. Esto es para evitar que todas las tiendas reciban registros que no son de esa tienda.
      Nombre del Servicio: itemSellingPrices
      Parámetros de entrada:

      Propiedad	Tipo de dato	Descripción	Requerido
      itemSellingPrices	List	Lista de listas de precios	Si

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

      Propiedad	Tipo de dato	Descripción	Requerido
      itemSellingPriceNumber	Integer	Número de lista de precios	Si
      storeCode	Varchar (20)	Código de tienda (BSNGP_ITM_HEADER.PA_STR_RTL_HEADER la referencia a la tienda)	No
      effectiveDateTime	Date	Fecha de inicio de vigencia.	Si
      expirationDateTime	Date	Fecha de expiración de la vigencia.	Si
      Ítems	List	Lista de precios de artículos a crear o actualizar.	Si

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

      Propiedad	Tipo de dato	Descripción	Requerido
      itemCode	Varchar (25)	Código de producto	Si
      Barcode	Varchar (25)	Código de alias	No
      currentSaleUnitRetailPriceAmount	float	Precio actual.	Si
      currentSaleUnitRetailPriceEffectiveDate	Date	Fecha de vigencia desde para el precio actual	Si
      currentSaleUnitRetailPriceExpirationDate	Date	Fecha de vigencia hasta para el precio actual	Si
      permanentSaleUnitRetailPriceAmount	Float	Precio permanente.	Si
      PermanentSaleUnitRetailPriceEffectiveDate	Date	Fecha de vigencia desde para el precio permanente	Si
      currentSaleUnitRetailPriceTypeCode	Varchar (50)	Tipo de precio representado por el precio actual (current). Default 'pr1'	No
      manufacturerSaleUnitRecommendedRetailPriceAmount	Money	Precio de venta recomendado por el proveedor.	Si

      Articulos de tipo Kits

      En este servicio se registran los kits. Contiene un id interno de la tabla y luego la lista de todos los kits que se hayan definido.
      Nombre del Servicio: aggregateItem
      La lista aggregateItems debe contener entidades "aggregateItem", las cuales poseen la siguiente estructura:

      Propiedad	Tipo de dato	Descripción	Requerido
      aggregateItems	List	Lista de artículos de tipo kit a crear o actualizar.	Si

      
      La lista aggregateItems debe contener entidades "aggregateItem", las cuales poseen la siguiente estructura:

      Propiedad	Tipo de dato	Descripción	Requerido
      typeCode	String(10)	Tipo de artículo kit. Enviar "kit"	Si
      item	String (25)	Código del artículo padre	Si

      Artículos enlazados o linkeados

      Este servicio tiene dependencia de otro maestro (items) En caso de que se envíen artículos para ser enlazados o linkeados , los artículos se deben haber informado previamente a Bridge.
      Este servicio definen las relaciones de artículos linkeados. Al venderse el código de ítem del campo ID_ITM (padre del kit) automáticamente se vende el artículo del código ID_ITM_MBR (hijos componentes) con la cantidad que se haya definido
      Nombre del Servicio: linkedItem
      Parámetros de entrada:

      Propiedad	Tipo de dato	Descripción	Requerido
      linkedItems	List	Lista de asociaciones entre artículos y sus linkeados que se desea crear o actualizar.	Si

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

      Propiedad	Tipo de dato	Descripción	Requerido
      itemCode	String(25)	Código de un artículo.	Si
      linkedItemCode	String (25)	Código del artículo enlazado al artículo cuyo código es itemCode.	Si
      quantity	Decimal	Cantidad de unidades presentes en la relación. Por default 1.	No
      memberItemPrice	Real	Precio del artículo enlazado	No

      Relación entre artículos

      Este servicio tiene dependencia de otro maestro (items). En caso de que se envíen artículos para ser relacionados, los artículos se deben haber informado previamente a Bridge.
      La entidad permite definir relaciones entre artículos (complementarios, sustitutos..)
      Nombre del Servicio: itemRelated
      Parámetros de entrada:

      Propiedad	Tipo de dato	Descripción	Requerido
      itemsRelated	List	Lista de asociaciones entre artículos y sus linkeados que se desea crear o actualizar.	Si

      La lista itemsRelated debe contener entidades "itemRelated", las cuales poseen la siguiente estructura:

      Propiedad	Tipo de dato	Descripción	Requerido
      item	String(25)	Código de un artículo.	Si
      itemTypeRelated	String(25)	Código de la relación CI: artículos complementarios SI: Artículos similares WRT: Garantías	Si
      itemRelated	String(25)	Código del artículo relacionado.	Si
      nameRelated	String(100)	Descripción	si

      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:

      Propiedad	Tipo de dato	Descripción	Requerido
      serviceItems	List	Lista de artículos de tipo servicio a crear o actualizar.	Si

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

      Propiedad	Tipo de dato	Descripción	Requerido
      itemCode	String (25)	Código del artículo de tipo servicio que se agregará o actualizará.	Si
      type	Varchar (25)	Código del tipo de servicio. En este campo los valores admitidos son:

• ASSM (Armado)
• SHIP (Flete)

• PCKG (Empaquetado)
  WRTY (Garantía)|Si|

  baseCostAmount	Decimal (15,4)	Costo base del servicio. Este costo no incluye todos los descuentos promocionales.	No
  netCostAmount	Decimal (15,4)	Costo neto del servicio. Este costo incluye todos los descuentos promocionales.	No
  costsEstablishedDate	DateTime	Fecha de vigencia del precio actual de costos para el elemento del servicio.	No

  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:

  Propiedad	Tipo de dato	Descripción	Requerido
  stocks	List	Lista de artículos con su respectivo stock para un depósito en particular	Si

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

  Propiedad	Tipo de dato	Descripción	Requerido
  storeCode	Varchar (20)	Código de la tienda	Si
  locationCode	String (25)	Código del depósito	Si
  itemInventoryState	String (25)	Estado del depósito. La lista de valores disponibles es: 'IISD' (Estado de item de inventario por default) 'onSale' (ítems a la venta) 'OnLayaway' (Items apartados) 'TransitIn' (Items en tránsito de entrada) 'TransitOut' (Items en tránsito de salida)	Si
  revenueCenter	String (50)	Código identificador del Centro de Costo al que está asociado por default el depósito (enviar el valor RCD)	Si
  items	List	Lista de artículos en el depósito junto con su cantidad de unidades en stock	Si

  Items del depósito

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

  Propiedad	Tipo de dato	Descripción	Requerido
  itemCode	String (25)	Código del artículo	Si
  stockUnits	Decimal (7)	Cantidad de unidades en stock (default 0)	Si

  Actualización de stock por movimientos de abastecimiento externos a Bridge

  Actualización de stock por abastecimiento

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.
Este servicio permitirá agregar un registro en la ItemInventoryJournalEntry a través de su importación, de modo tal que se pueda informar un movimiento de un ítem en particular para las operaciones de recepción de ordenes de compra, transferencias de mercadería entre tiendas y depósitos, ajustes y devoluciones a proveedor.
El lote de registros debería pertenecer a la misma tienda. Por tal motivo en el request a enviar, el campo <store>codigoTienda</store> debería venir informado el código de la tienda a la cual pertenecen los registros informados dentro del mismo lote. No se debería enviar <store>0</store>. Esto es para evitar que todas las tiendas reciban registros que no son de esa tienda.
Nombre del Servicio: stockInventory
Parámetros de entrada:

La lista stockInventories debe contener entidades "stockInventory", las cuales poseen la siguiente estructura:

NOTA: TIPO DE DOC

En base a lo recibido en el campo del request del servicio, se debería considerar tener la siguiente lógica por default para los campos itemInventoryState y substractFlag. 

Servicios de actualización maestros de producto y atributos

Producto

Esta entidad agrupa los diferentes ítems cuando comparten atributos. La relación con Ítem (AS_ITM) es uno a mucho, siendo obligatorio al menos un ítem por cada producto.
No es requerido el uso de la entidad "producto" si no se utilizarán atributos y/o atributos de especificación. De ser utilizados los mismos, se requiere un orden en el envío de los datos.
Para el envío de entidades a través de los servicios de integración, se debe considerar el orden de envío de las entidades:

• • Alta de atributos y atributos de especificaciones (ambos casos opcionales).
  • Alta del producto con sus atributos y especificaciones (deben ya existir en Bridge)
    • Enviar el producto con la lista de atributos y especificaciones que se deseen relacionar al mismo.
  • Enviar el o los ítems asociados al producto.
  • En aquellos casos en los cuales no se requiera el alta de productos, sólo se enviará al ítem (sin atributos, especificaciones ni producto asociado).
    • Sólo en este caso cuando Bridge recibe por servicio al ítem, genera durante el proceso de importación el registro correspondiente al producto.
    • Para BridgePOS tanto para la venta como para el manejo de stock es por medio del ítem.
    • El producto sólo permite/facilita el agrupamiento y detalle de atributos para búsquedas y para Bridge WEB.

Nombre del Servicio: product
Parámetros de entrada:

La lista products debe contener entidades "product", las cuales poseen la siguiente estructura:

La lista categories debe contener entidades "category", las cuales poseen la siguiente estructura:

La lista specificationAttributes debe contener entidades "specificationAttribute", las cuales poseen la siguiente estructura:

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

Múltiples categorías por producto

Esta información se encuentra incluida dentro del servicio de producto

Atributos en las categorías

Permite asociar atributos de producto a una categoría, puede ser enviada una lista de categorías con sus atributos
Nombre del Servicio: productAttributeCategory
Parámetros de entrada:

La lista productAttributeCategories debe contener entidades "productAttributeCategory", las cuales poseen la siguiente estructura:

Atributos de especificación en las categorías

Permite asociar atributos de especificación de un producto a una categoría, puede ser enviada una lista de categorías con sus atributos
Nombre del Servicio: specificationAttributeCategory
Parámetros de entrada:

La lista specificationAttributeCategories debe contener entidades "specificationAttributeCategory", las cuales poseen la siguiente estructura:

Atributos de producto

Permite crear o actualizar atributos de producto.
Nombre del Servicio: productAttribute
Parámetros de entrada:

La lista productAttributes debe contener entidades "productAttribute", las cuales poseen la siguiente estructura:

La lista productAttributeOptions debe contener entidades "productAttributeOption", las cuales poseen la siguiente estructura:

Atributos de especificación

Permite crear o actualizar atributos de especificación de producto.
Nombre del Servicio: specificationAttribute
Parámetros de entrada:

La lista specificationAttributes debe contener entidades "specificationAttribute", las cuales poseen la siguiente estructura:

La lista specificationAttributeOptions debe contener entidades "specificationAttributeOption", las cuales poseen la siguiente estructura: