...
Painel | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Painel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
...
Propiedad | Tipo de dato | Descripción | Requerido |
---|---|---|---|
code | String | Código del atributo del ítem | Si |
name | String | Descripción del atributo del ítem | Si |
dataType | String | Tipo de dato que puede tomar el atributo Los tipos posibles son: list, string, number, date, boolean | Sí |
editOpcionsFlag | Boolean | Un campo que NO es requerido, que permita habilitar/deshabilitar la opción de permitir editar opciones en el POS | No |
showInfo | Boolean | Indicador si se requiere mostrar o no la información de la opción del atributo (default si no se recibe: false) | No |
showRgb | Boolean | Indicador si se requiere mostrar o no el RGB asignado a la opción del atributo (default si no se recibe: false) | No |
disabled | Boolean | Indicador de atributo deshabilitado o no (default si no se recibe: false) | No |
options | List | Lista de opciones o valores que tendrá el atributo del ítem El tag debe agregarse aunque no sea del tipo lista el atributo. <options/> Requerido con todos los datos cuando el atributo es tipo "lista" | No |
La lista options debe contener entidades "option”, las cuales poseen la siguiente estructura:
...
Bloco de código |
---|
<?xml version="1.0" encoding="UTF-8"?> <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>itemAttribute</service> <!--Optional:--> <request><![CDATA[ <bridgeCoreRequest> <operation>createOrUpdate</operation> <params> <itemAttributes type="list"> <itemAttribute type="bean"> <code>PROCEDENCIA</code> <dataType>list</code>dataType> <name>Procedencia</name> <showInfo>true</showInfo> <showRgb>false</showRgb> <options type="list"> <option type="bean"> <value>NAC</value> <order>1</order> <info>hola</info> </option> </options> <options type="list"> <option type="bean"> <value>IMPORTADO</value> <order>2</order> <info>pepe</info> </option> </options> </itemAttribute> <itemAttribute type="bean"> <code>DISCONTINUADO</code> < <dataType>boolean</itemAttributes>dataType> </params> </bridgeCoreRequest>]]></request> <name>Discontinuado</name> <!--Optional:--><disabled>false</disabled> <store>0<<showInfo>true</store>showInfo> <showRgb>false</showRgb> </options> </itemAttributes> </params> </bridgeCoreRequest>]]></request> <!--Optional:--> <store>0</store> </ser:execute> </soapenv:Body> </soapenv:Envelope> |
...
Propiedad | Tipo de dato | Descripción | Requerido | Campo de importación |
---|---|---|---|---|
itemCode | String (25) | Código del artículo. | Si | |
description | String (50) | Descripción del artículo | Si | |
hierarchyGroupCode | String (10) | Código de la agrupación jerárquica de nivel más bajo al que pertenece el artículo. | No | |
price | Decimal(11,2) | Precio de venta por unidad. | Si | |
unitCostPrice | Decimal(11,2) | Costo de la unidad. | No | |
specialPrice | Decimal(11,2) | Precio especial de venta para clientes. | No | |
vatCode | String (3) | Código del tipo de IVA asociado al artículo. | Si | |
notForSaleFlag | Boolean | Flag que indica que el artículo no está a la venta. | No | |
notForDiscountsFlag | Boolean | Flag que indica que el artículo no admite descuentos. | No | |
priceRequiredFlag | Boolean | Flag que indica que el artículo requiere el ingreso del precio. | No | |
weightRequiredFlag | Boolean | Flag que indica que el artículo requiere el ingreso de peso. | No | |
quantityRequiredFlag | Boolean | Flag que indica que el artículo requiere el ingreso de una cantidad o magnitud. | No | |
quantityAllowedFlag | Boolean | Flag que indica que el artículo admite el ingreso de cantidad. | No | |
restrictedSaleFlag | Boolean | Flag de venta en horaio restringido | No | |
logExceptionFlag | Boolean | Flag que indica si debe registrarse en el log de excepciones. | No | |
authorizationRequiredFlag | Boolean | Flag que indica que el artículo requiere autorización del supervisor. | No | |
foodStampFlag | Boolean | Flag Food Stamp, indica si está asociado al medio de pago Food Stamp. | No | |
serialNumberRequiredFlag | Boolean | Flag que indica que el artículo requiere el ingreso de número de serie. | No | |
returnNotAllowedFlag | Boolean | Flag que indica que el artículo no admite ser devuelto. | No | |
supplierCode | String (100) | Código del proveedor del artículo. | No | |
brandCode | String (100) | Código de la marca del artículo. | No | |
itemType | String (25) | Código del tipo de artículo.
| Si | |
promotionalPrice | Decimal(11,2) | Precio promocional. | No | |
promotionalPriceDateFrom | DateTime | Fecha y hora de inicio de la vigencia del precio promocional | No | |
promotionalPriceDateTo | DateTime | Fecha de hora de finalización de la vigencia del precio promocional | No | |
uomCode | String (25) | Código de la unidad de medida para el artículo.
| Si | |
lastUpdateSaleUnitPrice | DateTime | Fecha y hora de la última actualización del precio de venta. | No | |
genericItemFlag | Boolean | Flag que indica que el artículo es genérico. | Si | |
kitComponentFlag | Boolean | Flag que indica que el artículo es un componente de un kit. | Si | |
inventoryLocationCode | Varchar (25) | Código del almacén o depósito | Si | |
commissionPercent | Decimal(6,2) | Porcentaje de comisión sobre el artículo que le corresponde al asociado. | No | |
disabled | Boolean | Flag que indica que el artículo está deshabilitado | Si | |
itemVATCategory | String (2) | Categoría de IVA del ítem. Los valores posibles son: C, E, F, o G: | ||
uom2Code | String (1) | Código de la segunda unidad de medida para el artículo. | No | |
uom2Units | Decimal(14,2) | Factor de conversión entre la primera y la segunda unidad de medida | No | |
uom2Operation | String (1) | Tipo de conversión. | No | |
stockReservationRequired | Boolean | Indicador de requiere reserva de stock. Default false. Modifica el flag "Requiere reserva de stock" (FL_STKRES_RQ)) | No | Si el parámetro store.setItemSerializedFlagWithReservationByService = true cuando en el servicio de importación el item venga con el campo serialNumberRequiredFlag = true, importar item.stockReservationRequired = true Si el parámetro store.setItemSerializedFlagWithReservationByService = false procede como actualmente (si viene el valor en este campo lo setea con ese valor sino importa el default: false) |
genericFieldString1 | String (50) | Campo para uso genérico | No | Importar en ITM_USR_DATA, campo USR_I_STRNG |
genericFieldString2 | String (50) | Campo para uso genérico | No | Importar USR_II_STRNG |
genericFieldString3 | String (50) | Campo para uso genérico | No | Importar USR_III_STRNG |
genericFieldString4 | String (50) | Campo para uso genérico | No | Importar USR_IV_STRNG |
genericFieldBoolean1 | Boolean | Campo para uso genérico | No | Importar en USR_I_FL |
genericFieldBoolean2 | Boolean | Campo para uso genérico | No | Importar en USR_II_FL |
genericFieldBoolean3 | Boolean | Campo para uso genérico | No | Importar en USR_III_FL |
genericFieldBoolean4 | Boolean | Campo para uso genérico | No | Importar en USR_IV_FL |
genericFieldDecimal1 | Decimal(8,2) | Campo para uso genérico | No | Importar en campo USR_I_INT |
genericFieldDecimal2 | Decimal(8,2) | Campo para uso genérico | No | Importar en campo USR_II_INT |
genericFieldDecimal3 | Decimal(8,2) | Campo para uso genérico | No | Importar en campo USR_III_INT |
genericFieldDecimal4 | Decimal(8,2) | Campo para uso genérico | No | Importar en campo USR_IV_INT |
importDocReq | Boolean | Indicador si requiere de documento de importación (para serializables) | No | |
sellerRequired | Boolean | Indicador si requiere el ingreso del vendedor | No | |
webDescription | Varchar (max) | Descripción ampliada del artículo para la web | No | |
extendedWebDescription | Varchar (max) | Descripción detallada del artículo para la web | No | |
internalTaxes | List | Lista de impuestos internos | No | |
itemPictures | List | Lista de imágenes asociadas | No | |
formRequiredFlag | boolean | Flag indicador de formulario requerido | No (opcional) | Default = false si no viene informado |
upc | String | Código Universal de Producto del Articulo | No | Es un dato que permite agrupar varios artículos para listas de precios por umbral y su acumulación de unidades |
manufacturer | string | Código del fabricante En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla manufacturer (campo code) (a partir de Bridge7.2) | No (opcional) | (a partir de Bridge 7.2) |
exemptFlag | boolean | Flag de item exento (a partir de Bridge7.2) | No (opcional) | Default = false si no viene informado (a partir de Bridge 7.2) |
otherUnitOfMeasure | list | Lista de unidades de medida complementarias otherUnitOfMeasure <uomCode>blister</uomCode> <conversionFactor>0.1</conversionFactor> | No (opcional) | (a partir de 7.2) |
printCommandsFlag | boolean | Flag de ítem para impresión de comanda | No (opcional) | Default = False si no viene informado. (a partir de Bridge 7.3) |
maxStock | Decimal(11,2) | Stock Máximo que la Tienda puede tener por Producto | No (opcional) | Default = 0 si no viene informado. (a partir de Bridge 7.3) |
securityStock | Decimal(11,2) | Stock de Seguridad Adicional al forecast | No (opcional) | Default = 0 si no viene informado. (a partir de Bridge 7.3) |
attributes | List | Atributos de un item | No (opcional) | <attributes type="list"> <attribute type="bean"> <code>PROCEDENCIA</code> <option>NAC</option> </attribute> </attributes> |
creditAllowed | boolean | Flag que indica si el articulo puede ser vendido con crédito propio | No (opcional, default=false) | (a partir de 7.4) |
blockedForIcd | boolean | Flag para Artículo bloqueado para Compras y Reposición: No permite reposición | No (opcional) | Default = false si no viene informado (a partir de Bridge 7.4) |
alcoholicBeverage | boolean | Flag que indica si el articulo debe ser validado como bebida alcohólica | No (opcional) default=false | (a partir de 7.5) |
affiliateBenefit | boolean | Flag que indica si el articulo tiene el beneficio de Afiliado | No (opcional, default=false) | (a partir de 7.4) |
serialFormat | string | Permite definir el tipo de formato admitido para el nro de serie | opcional | (a partir de 7.4) |
externalCode | number | Permite definir el código externo del item | No (opcional) | v1.17 (a partir de 7.5) |
minSalePrice | Decimal | Precio mínimo de venta (para cálculo de márgenes para pedidos si aplicara por configuración) | No | minSalePrice (a partir de 7.5.2) |
minStockForChannels | number | Cantidad de unidades definidas como stock mínimo para canales | No |
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.
Propiedad | Tipo de dato | Descripción | Requerido |
---|---|---|---|
internalTaxCode | String(25) | Código de impuesto interno | Si |
internalTaxAmount | Decimal | Monto del impuesto interno o porcentaje (sobreescribe el general del impuesto para el item en particular, si no se informa, toma el default del impuesto) | No |
Request de artículo
...
language | xml |
---|
...
La lista de atributos debe contener entidades "attribute", las cuales poseen la siguiente estructura:
Ejemplo
<attributes type="list">
<attribute type="bean">
<code>PROCEDENCIA</code>
<option>NAC</option>
</attribute>
<attribute type="bean">
<code>COLOR</code>
<option>AZUL</option>
</attribute>
<attribute type="bean">
<code>PREP Physical</code>
<option>true</option>
</attribute>
</attributes>
NOTA: si la opción o valor enviado pertenece a un atributo del tipo "list", se validará que la opción exista previamente. No se creará el item si este valor no existe para no generar inconsistencias de datos. (a partir de 7.5.1)
Propiedad | Tipo de dato | Descripción | Requerido |
---|---|---|---|
code | String(25) | Código de impuesto interno | Si |
option | String | Según el tipo de dato | Si |
Request de artículo
Bloco de código | ||
---|---|---|
| ||
<?xml version="1.0" encoding="UTF-8"?> <bridgeCoreRequest> <operation>createOrUpdate</operation> <params> <items type="list"> <item type="bean"> <itemCode>ABC999</itemCode> <description>ABC999 Producto con atributo</description> <description2>PROD</description2> <description3>PROD</description3> <price>7000.0000</price> <unitCostPrice>2000.0000</unitCostPrice> <vatCode>2</vatCode> <notForSaleFlag /> <notForDiscountsFlag /> <priceRequiredFlag /> <weightRequiredFlag /> <quantityRequiredFlag /> <quantityAllowedFlag>true</quantityAllowedFlag> <restrictedSaleFlag /> <logExceptionFlag /> <authorizationRequiredFlag /> <serialNumberRequiredFlag>false</serialNumberRequiredFlag> <returnNotAllowedFlag /> <supplierCode>MIRGOR2</supplierCode> <brandCode /> <itemType>NORM</itemType> <promotionalPrice /> <promotionalPriceDateFrom format="dd-MM-yyyy hh:mm:ss" /> <promotionalPriceDateTo format="dd-MM-yyyy hh:mm:ss" /> <uomCode>u</uomCode> <imageCode /> <lastUpdateSaleUnitPrice format="dd-MM-yyyy hh:mm:ss" /> <genericItemFlag>false</genericItemFlag> <kitComponentFlag>false</kitComponentFlag> <inventoryLocationCode>DEP1</inventoryLocationCode> <commissionPercent /> <disabled>false</disabled> <itemVATCategory>G</itemVATCategory> <uom2Code /> <uom2Units /> <uom2Operation /> <stockReservationRequired>true</stockReservationRequired> <importDocReq>true</importDocReq> <sellerRequired>false</sellerRequired> <amountRequiredFlag>true</amountRequiredFlag> <genericFieldBoolean1>false</genericFieldBoolean1> <genericFieldString1 /> <genericFieldDecimal1 /> <webDescription>PROD Seriado12</webDescription> <extendedWebDescription /> <itemPictures> <itemPicture /> </itemPictures> <sellerRequired>false</sellerRequired> <attributes type="list"> <amountRequiredFlag>true</amountRequiredFlag> <attribute type="bean"> <genericFieldBoolean1>false</genericFieldBoolean1> <code>PROCEDENCIA</code> <genericFieldString1 /> <genericFieldDecimal1 <option>NAC</>option> <webDescription>PROD Seriado12<</webDescription>attribute> <extendedWebDescription /<attribute type="bean"> <itemPictures> <code>COLOR</code> <itemPicture /> <option>AZUL</option> </itemPictures> </attribute> <attributes type="list"> <attribute type="bean"> <code>PROCEDENCIA<<code>PREPARADO</code> <option>NAC<<option>true</option> </attribute> </attributes> </item> </items> </params> </bridgeCoreRequest> |
...
Campo del servicio -- Propiedad -- | Tipo de dato | Requerido | Descripción | Campo en el cual importar en la tabla "itemInternalTax" | Default | |
---|---|---|---|---|---|---|
1 | item | string | si | Código del ítem | Se va a recibir el código del artículo, en la tabla se guardaría el ID del objeto ítem que coincida con el internalCode recibido (de la tabla item)
| |
2 | internalTaxType | string | si | Código del impuesto interno | Se va a recibir el código del impuesto interno (campo internalTaxType.code). Se debe buscar en la tabla internalTaxType y guardar el ID del objeto
| |
3 | amount | number | si | Monto del impuesto (este sobre escribe el del impuesto para el artículo) | amount | |
4 | effectiveDateTime | date | si | Fecha inicio de validez del impuesto | effectiveDateTime | |
5 | expirationDateTime | date | si | Fecha fin de validez del impuesto | expirationDateTime | |
6 | description | string | no | Descripción de la relación del impuesto-artículo | description | |
7 | disabled | boolean | si | Indicador de habilitado o no la relación del item-impuesto interno | disabled | false |
- Los campos updatedAt (si se actualiza o se crea el registro) y createdAt se importarán al momento de la creación del registro
...
Propiedad | Tipo de dato | Descripción | Requerido | ||||||||||||||||||||||||||||
partyRole id
| Varchar (15) | Identificador del rol. Este campo será utilizado para el envío a PROMO por tipo de cliente. Este listado es del tipo de roles que se crean por setup en la instalación. Puede ser unos de los siguientes valores: 1- (Cliente) 2- (Empleado) 3- (Posible cliente) 4- (Proveedor) 5- (Ejecutivo de ventas) 6- (Ejecutivo de compras)
| Si | ||||||||||||||||||||||||||||
Name | Varchar | Nombre del rol Se valida que corresponda al nombre del rol indicado en el campo partyRoleId (campo NM_RO_PRTY) Ej: “Cliente”, “Empleado” NOTA: este campo es caseSensitive, con lo cual debe enviarse tal cual se encuentra creado en el ABM de tipos de clientes (campo nombre) | Si | ||||||||||||||||||||||||||||
effectiveDate | Date | Fecha de inicio de vigencia del rol | Si | ||||||||||||||||||||||||||||
expirationDate | Date | Fecha de expiración del rol | Si | ||||||||||||||||||||||||||||
statusCode | Integer | Estado de la asignación del rol al party | No | ||||||||||||||||||||||||||||
contactMethods | List | Lista de métodos de contacto (L a estructura puede verse bajo el título "Metodos de contacto" , ver “ Metodos de contacto” ) | SI (al menos debe tener uno) |
...
Propiedad | Tipo de dato | Descripción | Requerido | Campo a importar en ItemStore |
---|---|---|---|---|
internalCode | String (25) | Código de artículo | Si |
|
storeCode | String | Código de tienda | Si |
|
notForSale | Integer | Item no a la venta. Valores posibles:
| No | "notForSale" |
disabled | Integer | Item deshabilitado Valores posibles:
| No | "disabled" |
blockedForIcd | Integer | Item Bloqueado para la compra (solo en órdenes de compra) Valores posibles:
| No | "blockedForIcd" |
ivaType | String (3) | Código del tipo de IVA asociado al artículo. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla VAT (campo code) | No |
|
brand | String (100) | Código de la marca del artículo. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla Brand (campo name) | No |
|
itemType | String (25) | Código del tipo de artículo. En este campo los valores admitidos son:
| No |
|
maxStock | Decimal(11,2) | Cantidad máxima de stock permitida utilizado únicamente para la funcionalidad de pedido sugerido | No | "maxStock" |
securityStock | Decimal(11,2) | Stock de seguridad utilizado únicamente para la funcionalidad de pedido sugerido | No | "securityStock" |
price | NumberDecimal("0.0000") | Precio de venta | No | "price" |
unitCost | NumberDecimal("0.0000") | Precio de costo - Si método de costeo = ppp, se actualizará en tienda, únicamente en la carga inicial. Cualquier costo posterior que se envíe, no pisará el costo de la tienda. | No | "unitCost" |
minSalePrice | Decimal | Precio mínimo de venta (para cálculo de margenes si aplicara por configuración) | No | minSalePrice |
minStockForChannels | Decimal | Cantidad de stock mínimo para canales por tienda | No | minStockForChannels |
Consideraciones de algunos campos no informados en el servicio:
...
Bloco de código |
---|
<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>itemStore</service> <!--Optional:--> <request> <![CDATA[ <bridgeCoreRequest> <operation>createOrUpdate</operation> <params> <itemStores type="list"> <itemStore><itemCode>2345<<itemStore><internalCode>2345</itemCode><storeCode>1<internalCode><storeCode>1</storeCode> <vatCode>2</vatCode> </itemStore> <itemStore><itemCode>2345<<itemStore><internalCode>2345</itemCode><storeCode>2<internalCode><storeCode>2</storeCode> <vatCode>1</vatCode> </itemStore> <itemStore> <itemCode>312<<internalCode>312</itemCode><storeCode>2<internalCode><storeCode>2</storeCode> <disabled>2</disabled></itemStore> </itemStores> </params> </bridgeCoreRequest> ]]> </request> <!--Optional:--> </ser:execute> </soapenv:Body> </soapenv:Envelope> |
...