Histórico da Página

...

Painel

borderColor	#E4E3E3
bgColor	#ffffff
titleColor	#ffffff
borderWidth	1px
titleBGColor	#704581
title	REVISIONES

Expandir

title	Expandir revisiones

Fecha	Versión	Descripción	Autor
31/10/2020		Se agregan campos opcionales de fechas de inscripción al servicio de padrones. Se agrega nota para el servicio ítem con el flag requiere reserva si por configuración se debe importar automáticamente	Andrea Veronica Asato
14/02/2022	2.0	Creación del documento basado en v7.0 actualizado a v7.1	Andrea Patricia Weimberg
25/03/2022	2.1	Se agregan servicios itemAttribute y atributos del item	Andrea Veronica Asato
30/08/2022	2.2	Se agrega anexo de recomendaciones y se actualizan con nuevos servicios	Andrea Veronica Asato
16/09/2022	2.3	Se agrega servicio transferDocument (para caso particular simulando tienda de abastecimiento store.erpFlag = true)	Andrea Veronica Asato
17/10/2022	2.4	Se agregan los tipos de identificación del customer para otros países	Andrea Veronica Asato
15/12/2022	2.5	Se agregan campos de crédito al servicio customer (a partir de v7.4) y al item el flag de creditAllowed	Andrea Veronica Asato
18/01/2023	2.6	Se agregan dos nuevos campos (a partir de v7.4) al servicio customer e item (affiliate y partyFiscalRegime). Al servicio ítem se agrega el campo serialFormat	Andrea Veronica Asato
09/03/2023	2.7	Se agrega el servicio de itemStore.	Manuel Santiago Repetto
10/03/2023	2.8	Se agrega dentro de la request de itemAttribute, un campo obligatorio "dataType"	Manuel Santiago Repetto
20/03/2023	2.9	Se ajustan campos del servicio customer (se elimina disabled dentro de party, se ajusta título partyData por party)	Andrea Veronica Asato
26/04/2023	3.0	Se agrega el servicio itemInternalTax.	Gustavo Javier Morales
30/05/2023	3.1	Se corrige el nombre de inventoryControlDocumentSerializedtLineItems y se agrega el externalCode en Item y unitOfMeasure	Manuel Santiago Repetto
30/05/2023	3.2	Se ajusta en el servicio itemSellingPrices (lista de precios) el envío de las tiendas y canales	Andrea Veronica Asato
29/06/2023	3.3	Se ajusta el servicio itemSellingPrices (lista de precios) con campos deprecados	Andrea Veronica Asato
08/09/2023	3.4	Se cambia la descripción del campo "order" a una mas representativa.
21/09/2023	3.5	Se agregan los campos minStockForChannels y minSalePrice al servicio item y a itemStore (disponible a partir de v7.5.2)	Andrea Veronica Asato
30/10/2023	3.6	Se agregan notas y ajustes al servicio de item (por atributos) y al servicio itemAttribute	Andrea Veronica Asato
29/02/2024	3.7	Se actualiza el campo serialFormId e inventoryControlDocumentState del servicio de "transferDocument"	Manuel Santiago Repetto
24/04/2024	3.8	Se actualiza el servicio de customer con el agregado de campos en el partyContactMethod	Andrea Veronica Asato
13/05/2024	3.9	Se actualiza el servicio itemStore con el agregado de los campos onConsignment, location y saleLocation	Andrea Veronica Asato
15/05/2024	4.0	Se agregan los servicios de consulta de Proveedores, Jerarquías y campos adicionales sobre el servicio existente de Item.	Manuel Santiago Repetto

Painel

borderColor	#E4E3E3
titleColor	#ffffff
borderWidth	1
titleBGColor	#704581
title	CONTENIDO

Expandir

title	Expandir contenido

Índice

...

Dica

title	Recomendaciones

Se sugieren algunos puntos a modo de recomendación para los envíos de información a través de los servicios de integración.

Se recomienda el envío de lotes de registros (siempre y cuando el tipo de servicio lo admita)
- Esto permitirá que el procesamiento sea más performante
- No enviar requerimientos de a un registro (ej: para la actualización del maestro de artículos, no se deberían enviar de a un articulo por request sino por lotes)
- Contemplar como cantidad máxima: 5000 registros/lote para la general de entidades, y de 3000 registros/lote para entidades grandes (Ej. Items, Productos).
- Máximo de peso de cada lote: 5MB

...

Propiedad	Tipo de dato	Descripción	Requerido
*name*	String(100)	Identificador de la marca comercial.	Si
*description*	String(200)	Nombre de la marca.	NoSi
*disabled*	Boolean	Flag que indica si la marca está habilitada en el sistema.	SiNo

Request de Marca

Bloco de código

<?xml version="1.0" encoding="UTF-8"?>
<bridgeCoreRequest>
   <operation>createOrUpdate</operation>
   <params>
      <brands type="list">
         <brand type="bean">
            <name>ELECX</name>
            <description>ELECTROLUX</description>
            <disabled>false</disabled>
         </brand>
         <brand type="bean">
            <name>ATM</name>
            <description>ATMA</description>
            <disabled>true</disabled>
         </brand>
      </brands>
   </params>
</bridgeCoreRequest>

...

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. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla MerchandiseHierarchy (code)	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. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla VAT (campo code) Los valores que vendrán dados de alta por defecto: Código – descripción 1 (IVA 0%, utilizado para artículos exentos) 2 (IVA 21%, utilizado para el gral de los artículos de consumo) 3 (IVA 10.5%, utilizado gralmente para los artículos frescos) 4 (IVA 27%, utilizado en servicios como LUZ, GAS, etc.)	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. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla Supplier (campo code)	No
*brandCode*	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: CONT (Envase) MISC(Miscelaneos) CHRG (Recargos) NORM (Normal) DEPT(Departamental) GRAL (Generico) WRTY (Garantias) SERV(Servicios) GFCD (GiftCard) FUEL(Combustible) ADJM (Ajuste de combustible) TAE(Tiempo Aire) EXTRACASH(Adelanto en efectivo)	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. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla Uom (campo LU_UOM) Ej: <uomCode>u<uomCode> – para unidad u (unidad) kg (kilo) g (gramo) l (litro) c3 (centímetros cúbicos) m (metro) cm (centímetro)	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 En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla Location (campo code, tabla LO_LCN_INV)	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: C: Exento a Consumidor Final E: Exento F: Fresco G: General
*uom2Code*	String (1)	Código de la segunda unidad de medida para el artículo. En este campo los valores admitidos deben encontrarse dados de alta dentro de la tabla Uom (campo code)	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. Posibles valores: M = Multiplicar D = Dividir	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 Todos los campos generic se importan en la tabla ITM_USR_DATA	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* *Se importará en el campo USR_V_FL de la tabla ITM_USR_DATA*
*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

...

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

La lista de atributos debe contener entidades "attribute", las cuales poseen la siguiente estructura:
Ejemplo

<code>PROCEDENCIA</code>

</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

...

Si

Request de artículo

...

language	xml

...


fullDescription	string	Descripcion ampliada	No (opcional)	v1.23 (a partir de 7.7)
stockItem	object	¿Es un artículo que maneja stock?	No (opcional)	v1.23 (a partir de 7.7)
itemDepth	NumberDecimal	Profundidad del ítem	No (opcional)	v1.23 (a partir de 7.7)
itemHeight	NumberDecimal	Altura del ítem	No (opcional)	v1.23 (a partir de 7.7)
itemNetWeight	NumberDecimal	Peso del ítem	No (opcional)	v1.23 (a partir de 7.7)
minStockForChannels	NumberDecimal	Stock Minimo para Canales	No (opcional)	v1.23 (a partir de 7.7)
itemGrossWeight	NumberDecimal	Peso bruto del ítem	No (opcional)	v1.23 (a partir de 7.7)
itemDiameter	NumberDecimal	Diámetro del ítem	No (opcional)	v1.23 (a partir de 7.7)
itemWidth	NumberDecimal	Ancho del ítem	No (opcional)	v1.23 (a partir de 7.7)
calculateCommission	boolean	Calcula comision	No (opcional)	v1.23 (a partir de 7.7)
relevance	integer	Relevancia	No (opcional)	v1.23 (a partir de 7.7)
published	boolean	Publicado	No (opcional)	v1.23 (a partir de 7.7)
detailedDescription	string	Descripcion detallada	No (opcional)	v1.23 (a partir de 7.7)
barcode	string	CodBarra	No (opcional)	v1.23 (a partir de 7.7)
requiresPrescriptionFlag	boolean	Requiere receta	No (opcional)	v1.23 (a partir de 7.7)
onConsignment	boolean	Consignado	No (opcional)	v1.23 (a partir de 7.7)
classification	string	Clasificacion	No (opcional)	v1.23 (a partir de 7.7)
daysToReturn	integer	Dias para devoluciones y cambios	No (opcional)	v1.23 (a partir de 7.7)
invoiceNotAllowed	boolean	No permite facturar	No (opcional)	v1.23 (a partir de 7.7)
notForSale	boolean	No admite otro artículo en la venta	No (opcional)	v1.23 (a partir de 7.7)
packQty	integer	Empaque Mínimo	No (opcional)	v1.23 (a partir de 7.7)
gtin	integer	Código GTIN	No (opcional)	v1.23 (a partir de 7.7)
requiresValidationExternalFlag	boolean	Requiere Validación Externa	No (opcional)	v1.23 (a partir de 7.7)

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

La lista de atributos debe contener entidades "attribute", las cuales poseen la siguiente estructura:
Ejemplo

<code>PROCEDENCIA</code>

</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

language	xml

<?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>
            <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>PREPARADO</code>
                  <option>true</option>
               </attribute>
             </attributes>
         </item>
      </items>
   </params>
</bridgeCoreRequest>

...

Propiedad

Tipo de dato

Descripción

Requerido

item

String

Código de artículo

Si

itemTypeRelated

String

Código de la relación entre artículos (Valores posibles, los indicados en la columna "Código")

Código	Detalle
SI	Articulos similares
CI	Artículos complementarios
CS	Servicios complementarios
WRT	Garantías
SC	Similares por color
ST	Similares por talle
SS	Similares por tamaño

Si

itemRelated

String

Código del artículo relacionado

Si

nameRelated

String

Descripción del tipo de relación (texto opcional)

No

disabled

Boolean

Indicador de habilitado

No

Request de

...

Orden de compra

Mediante la importación de una interface, se genera una nueva orden de compra en la base de datos. No será necesaria la intervención del operador para que la orden de compra esté disponible en la administración de órdenes de compra. El estado con que se importa la orden de compra es Confirmada

Disponible a partir de Bridge 7.2

Nombre del Servicio: purchaseOrderDocument
Parámetros de entrada:

Entidad “ purchaseOrderDocument ", que posee la siguiente estructura:

Propiedad	Tipo de dato	Descripción	Requerido
destinationRetailStoreID	String (20)	Código de la tienda	Si
supplier	String (100)	Código del proveedor	Si
originatorNumber	Integer	Número de la orden de compra externo	No
createDateTimestamp	date	Fecha de creación	Si
orderDocumentType	Integer	1= Normal / 2=Especial	No (Si no se envía se asume 1)
frequency	Numeric(19,3)	Frecuencia en que se realizan las órdenes de compra para el proveedor.	No
inventoryControlDocumentLineItems	List	Lista de artículos del pedido	Si

Ejemplo:

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

Propiedad	Tipo de dato	Descripción	Requerido
item	String (25)	Código del artículo.	Si
unitCount	Numeric(19,3)	Cantidad del artículo	Si
uomUnits	Numeric(19,3)	Cantidad de unidades de la presentación DEFAULT: 1	No
InventoryControlDocumentLineItemOrder	Int	Orden de la línea dentro del documento ICD a efectos de ser visualizado	No

Request de Orden de compra

Bloco de código

<bridgeCoreRequest>
	<operation>createOrUpdate</operation>
	<params>
		<purchaseOrderDocument>
			<destinationRetailStoreID>1</destinationRetailStoreID>
			<supplier>3054668997</supplier>
			<originatorNumber>1</originatorNumber>
			<createDateTimestamp format="dd-MM-yyyyy"></customsDate>
                <aggregateCode></aggregateCode>
            </inventoryControlDocumentSerializedLineItem>
        </inventoryControlDocumentLineItem>
    </inventoryControlDocumentLineItems>
</advanceShipmentNotice>
>19-08-2019</createDateTimestamp>
			<inventoryControlDocumentLineItems>
				<inventoryControlDocumentLineItem>
					<item>7290</item>
					<unitCount>1</unitCount>
					<uomUnits>2</uomUnits>
				</inventoryControlDocumentLineItem>
			</inventoryControlDocumentLineItems>
		</purchaseOrderDocument>
	</params>
</bridgeCoreRequest>

...

Pedido de

...

transferencia

Este servicio permite enviar desde un sistema externo un pedido de transferencia hacia una tienda que se podrá visualizar luego desde el menú Inventario/Transferencias.

Disponible a partir de Bridge 7.2

Nombre del Servicio: purchaseOrderDocument transferOrderDocument

Parámetros de entrada:

Entidad “ purchaseOrderDocument ", que posee la siguiente estructura:

Propiedad	Tipo de dato	Descripción	Requerido

destinationRetailStoreID

sourceRetailStore

String

(20)

Código de la tienda origen

Si

supplier

destinationRetailStoreID

String

(100)

Código

del proveedor

de la tienda destino	Si
originatorNumber

Integer

String

Número de la orden de

compra

transferencia externo	No
createDateTimestamp

date

Date

Fecha de creación

Si

orderDocumentType

Propiedad

Tipo de dato

Descripción

Requerido

item

String (25)

Código del artículo.

Si

unitCount

Numeric(19,3)

expectedDeliveryDate

Integer

1= Normal / 2=Especial

No (Si no se envía se asume 1)

frequency

Numeric(19,3)

Frecuencia en que se realizan las órdenes de compra para el proveedor.

No

inventoryControlDocumentLineItems

List

Lista de artículos del pedido

Si

Ejemplo:

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

Date	Fecha esperada de entrega	No
serialFormID	Number	Código de la orden de transferencia	Si
inventoryControlDocumentState	Number	Estado de la transferencia	Si
inventoryControlDocumentLineItem	List	Lista de artículos de la transferencia	Si=SerialFormID No=sin SerialFormID
item	String	Codigo del artículo	Si
unitCount	Decimal	Cantidad del artículo	Si

uomUnits

Numeric(19,3)

Cantidad de unidades de la presentación
DEFAULT: 1

No

InventoryControlDocumentLineItemOrder

Int

Orden de la línea dentro del documento ICD a efectos de ser visualizado

No

Request de Orden de compra

...

Request de pedido de transferencia

Bloco de código

<?xml version="1.0" encoding="UTF-8"?>
<bridgeCoreRequest>
   <operation>createOrUpdate</operation>
   <params>
      <transferDocument type="bean">
         <sourceRetailStore>1</sourceRetailStore>
         <destinationRetailStoreID>2</destinationRetailStoreID>
         <originatorNumber />
         <createDateTimestamp format="yyyy-MM-dd">2019-08-19</createDateTimestamp>
         <expectedDeliveryDate format="yyyy-MM-dd">2019-08-19</expectedDeliveryDate>
         <serialFormID />
         <inventoryControlDocumentState />
         <inventoryControlDocumentLineItems type="list">
            <inventoryControlDocumentLineItem>
               <item>1234</item>
               <unitCount>1</unitCount>
            </inventoryControlDocumentLineItem>
         </inventoryControlDocumentLineItems>
      </transferDocument>
   </params>
</bridgeCoreRequest>

...

Transferencia

Este servicio permite enviar desde un sistema externo un pedido de una transferencia hacia una tienda que se podrá visualizar luego desde el menú Inventario/Transferencias. Este es un caso particular donde la tienda origen es una tienda que debe encontrarse configurada como erpFlag=true (emulando ser un centro de distribución) Solo se mostrará en BMC y en la tienda destino. Esta transferencia ingresa en estado confirmada

Disponible a partir de Bridge 7.2

Nombre del Servicio: transferOrderDocumenttransferDocument

Parámetros de entrada:

Entidad “transferDocument", que posee la siguiente estructura:

Propiedad	Tipo de dato	Descripción	Requerido
sourceRetailStore	String (20)	Código de la tienda origen	Si
destinationRetailStoreID	String (20)	Código de la tienda destino	Si
originatorNumber

String

Integer

Número de la

orden de

transferencia externo

NocreateDateTimestampDateFecha de creaciónSiexpectedDeliveryDateDateFecha esperada de entrega

No

serialFormIDNumberCódigo de la orden de transferenciaSiinventoryControlDocumentStateNumberEstado de la transferenciaSiinventoryControlDocumentLineItemListLista de artículos de la transferenciaSi=SerialFormID
No=sin SerialFormIDitemStringCodigo del artículoSiunitCountDecimalCantidad del artículoSi

Request de pedido de transferencia

Bloco de código

<?xml version="1.0" encoding="UTF-8"?>
<bridgeCoreRequest>
   <operation>createOrUpdate</operation>
   <params>
      <transferDocument type="bean">
         <sourceRetailStore>1</sourceRetailStore>
         <destinationRetailStoreID>2</destinationRetailStoreID>
         <originatorNumber />
         <createDateTimestamp format="yyyy-MM-dd">2019-08-19</createDateTimestamp>
         <expectedDeliveryDate format="yyyy-MM-dd">2019-08-19</expectedDeliveryDate>
         <serialFormID />
         <inventoryControlDocumentState />
         <inventoryControlDocumentLineItems type="list">
            <inventoryControlDocumentLineItem>
               <item>1234</item>
               <unitCount>1</unitCount>
            </inventoryControlDocumentLineItem>
         </inventoryControlDocumentLineItems>
      </transferDocument>
   </params>
</bridgeCoreRequest>

Transferencia

Este servicio permite enviar desde un sistema externo una transferencia hacia una tienda que se podrá visualizar luego desde el menú Inventario/Transferencias. Este es un caso particular donde la tienda origen es una tienda que debe encontrarse configurada como erpFlag=true (emulando ser un centro de distribución) Solo se mostrará en BMC y en la tienda destino. Esta transferencia ingresa en estado confirmada

Disponible a partir de Bridge 7.2

Nombre del Servicio: transferDocument

Parámetros de entrada:

Entidad “transferDocument", que posee la siguiente estructura:

Propiedad

Tipo de dato

Descripción

Requerido

sourceRetailStore

String (20)

Código de la tienda origen

Si

destinationRetailStoreID

String (20)

Código de la tienda destino

Si

originatorNumber

Integer

Número de la transferencia externo

No

createDateTimestamp

date

Fecha de creación

Si

ExpectedDeliveryDate

date

Fecha esperada de entrega

No

serialFormID

Integer

Código de la transferencia

No cuando estado 2

Si cuando estado 4 o 5

inventoryControlDocumentState

String

"CONFIRMADA" (2) -> Nueva transferencia

"CERRADA" 4 -> Recepción

"CANCELADA" 5 -> Recepción Cancelada

No

(si no se envía se asume que es CONFIRMADA)

createDateTimestamp

date

Fecha de creación

Si

ExpectedDeliveryDate

date

Fecha esperada de entrega

No

serialFormID

Integer

Código de la transferencia

Ver apartado 3.7 por modificación del 29/02/2024 del campo inventoryControlDocumentState.

inventoryControlDocumentState

String

"CONFIRMADA" (2) -> Nueva transferencia

"CERRADA" 4 -> Recepción

"CANCELADA" 5 -> Recepción Cancelada

Sí

Ver apartado 3.7 por modificación del 29/02/2024

Expandir

title	Apartado:

Informações

title	Condiciones:

Configuraciones:

Tienda → "store.erpFlag = true"
Tienda → "disabled = false"
Parámetro → "disabled = false"

Tienda es ERP → el mismo servicio genera los registros en la journal.

Tienda NO es ERP → el servicio no genera registros en la journal. Si se tratara de una tienda Bridge, los registros de la journal los generará el BM al procesar la InventoryControlDocument. El registro de la InventoryControlDocument replica a Tienda cuando Destino NO es ERP

---->>>>>PASO 1 : Validación de estados:

En código se valida que el estado enviado dependiendo de la tienda origen y destino sea el correcto.

Si no se envía estado, el estado por defecto es Cerrado

1) Transferencia de ERP a ERP

Confirmado: error
Cerrado: ok
Cancelado: error
serialFormID -> vacío

2) Transferencia de ERP a Tienda

Confirmado: ok
Cerrado: error
Cancelado: error
serialFormID -> vacío

3) Transferencia Tienda a ERP

Confirmado: error
Cerrado: ok
Cancelado: ok
serialFormID: debe existir

4) Transferencia Tienda a Tienda

Confirmado: error
Cerrado: error
Cancelado: error

ICDReference

Integer

Número de la orden de transferencia

No

inventoryControlDocumentLineItems

List

Lista de artículos de la transferencia

Si cuando serialFormID no informado.

No cuando el serialFormID informado

...

Propiedad	Tipo de dato	Descripción	Requerido
*purposeType id*	Integer	Id del tipo de propósito del contacto. El listado de los valores ya precargados por setup son los siguientes valores: 1 – Emergencia 2 – Consulta (default)	Si
*methodType id*	Integer	Id del tipo de método de contacto. Estos valores vienen configurados en el setup o podrán ser ajustados por BM. Puede ser unos de los siguientes valores: 1 – Particular 2 – Laboral Side los siguientes valores: 1 – Particular 2 – Laboral	Si
*name*	String	Nombre del método de contacto (ej: personal, laboral)	No
externalSellerID	String	Opcional ID del vendedor externo	No
externalSellerName	String	Opcional Nombre del vendedor externo `Ejemplo` `<partyContactMethod type="bean">` `<purposeType id="2"` `/>` `<methodType id="2"` `/>` `<effectiveDate format="dd-MM-yyyy">01-01-2000</effectiveDate>` `<expirationDate format="dd-MM-yyyy">31-12-2050</expirationDate>` `<externalSellerID>123</externalSellerID>` `<externalSellerName>Juan Perez</externalSellerName>` `</partyContactMethod>` `</contactMethods>`	No
*effectiveDate*	Date	Fecha de inicio vigencia	Si
*expirationDate*	Date	Fecha expiración del contacto	Si
*address*	Bean	Domicilio (L a estructura puede verse bajo el título "Domicilio", ver “Domicilio” )	No
*emailAddress*	Bean	Correo Electronico(L a estructura puede verse bajo el título "Correo electrónico", ver “Correo electrónico” )	No
*telephone*	Bean	Telefono(L a estructura puede verse bajo el título "Telefono" , ver “Telefono” )	No

...

Bloco de código

<bridgeCoreRequest>
	<operation>createOrUpdate</operation><params>
		<customers type="list">
			<customer type="bean"><code>920180</code>
			<store>1</store><party type="bean">
				<name>PINTURERIA ORO SA</name>
				<typeCode>OGN</typeCode>
				<roleAssignments type="list"><partyRoleAssignment type="bean">
				<contactMethods type="list">
					<partyContactMethod type="bean">
						<purposeType id="2"/><methodType id="1"/>
 						<name>Laboral</name> 
                        <effectiveDate>2017-01-20T16:12:17</effectiveDate>
						<expirationDate>2200-12-30 00:00:00.000</expirationDate>
						<address type="bean">
							<city type="bean">
								<code>10859</code>
								</city><country type="bean">
								<code>ARG</code></country>
								<state type="bean">
									<code>AR-B</code></state>
									<firstLine>CASA 60 SAN JOSE LA HERAS</firstLine>
									<postalCode>9017</postalCode>
									</address><emailAddress type="bean">
									<name>[email protected]</name>
									</emailAddress>
									</partyContactMethod>
									</contactMethods>
									<sequenceNumber>1</sequenceNumber>
       <partyRole id="1">
          <name>Cliente</name>
       </partyRole>

									<effectiveDate format="dd-MM-yyyy">20-01-2017</effectiveDate>
									<expirationDate format="dd-MM-yyyy">30-12-2200</expirationDate>
									</partyRoleAssignment></roleAssignments>
									<identifications type="list"><partyIdentification type="bean">
									<identificationType id="3"/><identifierValue>20225939420</identifierValue>
									</partyIdentification></identifications><taxRegistrations>
									<taxRegistration type="bean">
										<name>PINTURERIA ORO SA</name>
										<number>20225939420</number>  
										<taxTypes type="list">
											<taxRegistrationTaxType type="bean">
												<inscEffectiveDate>2017-01-20T16:12:17</inscEffectiveDate>
												<inscExpirationDate>2155-01-20T16:12:17</inscExpirationDate>
												<jurisdictionNType type="list">
													<jurisdiction type="bean">
														<taxJurisdictionCode>ARG</taxJurisdictionCode> -- en caso del IVA siempre es ARG porque 
														</jurisdiction><taxCategory type="bean">
														<code>RI</code>
														</taxCategory><type type="bean">
														<code>IVA</code></type>
														</jurisdictionNType>
														</taxRegistrationTaxType>
														</taxTypes>
														</taxRegistration>
														<taxRegistration type="bean">
															<name>PINTURERIA ORO SA</name>
															<number>20225939420</number>
															<taxTypes type="list">
																<taxRegistrationTaxType type="bean">
																	<inscEffectiveDate>2017-01-20T16:12:17</inscEffectiveDate>
																	<inscExpirationDate>2155-01-20T16:12:17</inscExpirationDate><certificates type="list"/>
																	<jurisdictionNType type="list">
																		<jurisdiction type="bean">
																			<taxJurisdictionCode>BA</taxJurisdictionCode>
																			</jurisdiction>
																			<taxCategory type="bean">
																				<code>L</code>
																			</taxCategory><type type="bean">
																			<code>IB</code></type>
																			</jurisdictionNType>
																			</taxRegistrationTaxType>
																			</taxTypes>
																</taxRegistration>
													</taxRegistrations>
						</party>
				</customer>
		</customers>
		</params>
	<replicationStore>0</replicationStore>
</bridgeCoreRequest>

...

Propiedad	Tipo de dato	Descripción	Requerido
*name*	String (50)	Nombre o número de legajo del usuario	Si	*userName*o número de legajo del usuario	Si
*userName*	String (50)	Nombre de usuario	*Si para nuevo usuario* *No para usuario existente*
*password*	String (50)	Contraseña encriptada	No *Validaciones:* Usuarios Nuevos: sino se informa, se guarda la contraseña encriptada "changeme" y el flag "mustChangePassword = true", independientemente del valor que haya recibido en el campo "mustChangePassword" Si se envía la contraseña encriptada, se guarda como tal. Si se informa este campo y no passwordSalt, se asume que la contraseña está en texto plano. Esto va a provocar que se encripte la contraseña y se guarden tanto el password como el passwordSalt.
*passwordSalt*	String (50)	Nombre Contraseña de usuarioSi para nuevo usuario	No para usuario existente
*password*	String (50)	Contraseña encriptada	*Si para nuevo usuario* *No para usuario existente*
*passwordSalt*	String (50)	Contraseña de usuario	*Si para nuevo usuario* *No para usuario existente* Validaciones: Usuarios Nuevos: sino se informa, se guarda la contraseña encriptada "changeme" y el flag "mustChangePassword = true", independientemente del valor que haya recibido en el campo "mustChangePassword" Si se envía la contraseña encriptada, se guarda como tal. Si se informa password y no passwordSalt, se asume que la contraseña está en texto plano. Esto va a provocar que se encripte la contraseña y se guarden tanto el password como el passwordSalt.
*codeStore*	Integer (20)	Código de identificación de la tienda	No
*email*	String (100)	Dirección email del usuario	No
*roleGroups*	List	Lista de roles para los usuarios Se debe informar la relación grupo-tienda *No, en caso de no enviar se asume que va a toda tienda* <roleGroups type="list"> <roleGroup type="bean"> <group>Cajero</group> <store>10</store> </roleGroup> <roleGroup type="bean"> <group>Vendedor</group> <store>10</store> </roleGroup>usuarios Se debe informar la relación grupo-tienda	No Validaciones: Si roleGroup.store tiene valor, se asigna el grupo a esa tienda. Si roleGroup.store no tiene valor y el store base es distinto de cero, se usa esa tienda. Si roleGroup.store no tiene valor y el store base es igual a cero, el grupo queda asignado para central (store = null)
*disabled*	Boolean	Indicador si está habilitado o no el usuario	*No (default si no se recibe = false)*
*mustChangePassword*	Boolean	Tiene que cambiar la contraseña cuando la misma caduque o cuando pase los XX días de inactividad.	*No. Es opcional. Se tomará por defecto que deba cambiar la contraseña.*
*blocksOnUserNoActivity*	Boolean	Después de XX cantidad de días de inactividad, se pide cambio de contraseña.	*No. Es opcional. Por defecto el usuario se bloquea después de los XX días de inactividad.*
*accountLocked*	Boolean	Determina si la cuenta está bloqueada (30 mins en central y hasta que se modifique la password en tienda por haber ingresado mas de XX veces mal la contraseña).	*No, es opcional. Por defecto el usuario se encuentra desbloqueado.*
*passwordExpire*	Boolean	Determina si la contraseña expira o no. Si expira, pasados los XX días del último cambio de contraseña, se pide cambio de contraseña.	*No, es opcional. Por defecto la contraseña expira.*
*Alternative_user_code*	Varchar (25)	Código de usuario alternativo	*No, opcional (en proyectos se podrá utilizar como código de usuario del ERP)*

...

Propiedad	Tipo de dato	Descripción	Requerido	Campo a importar en ItemStore
internalCode	String (25)	Código de artículo	Si	"internalCode" "item": se importa el ObjectID que corresponda al código del item enviado item.internalCode) Si no existe informar error
storeCode	String	Código de tienda	Si	"storeCode" = código de tienda recibido "store": se importa el ObjectID que corresponda al código de la tienda enviado store.code) Si no existe informar error
notForSale	Integer	Item no a la venta. Valores posibles: 0 = sin cambios 1 = SI 2 = NO	No	"notForSale"
disabled	Integer	Item deshabilitado Valores posibles: 0 = sin cambios 1 = SI 2 = NO	No	"disabled"
blockedForIcd	Integer	Item Bloqueado para la compra (solo en órdenes de compra) Valores posibles: 0 = sin cambios 1 = SI 2 = NO	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	"ivaType" (ObjectID que corresponda al código de la marca enviado itemIvaType.code) Si no existe informar error
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	"brand" (ObjectID que corresponda al código de la marca enviado brand.name) Si no existe informar error
itemType	String (25)	Código del tipo de artículo. En este campo los valores admitidos son: CONT (Envase) MISC (Miscelaneos) CHRG (Recargos) NORM (Normal) DEPT (Departamental) GRAL (Generico) WRTY (Garantias) SERV (Servicios) GFCD (GiftCard) FUEL (Combustible) ADJM (Ajuste de combustible) TAE (Tiempo Aire) EXTRACASH (Adelanto en efectivo)	No	"itemType" (ObjectID que corresponda al código de la marca enviado itemIvaType.code) Si no existe informar error
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
location	Varchar(25)	Código del almacén o depósito por default.	No	"location"
saleLocation	Varchar(25)	Código del almacén o depósito para la venta.	No	"saleLocation"
onConsignment	Integer	Item en consignación Valores posibles: 0 = sin cambios 1 = SI 2 = NO	No	"onConsignment"

Consideraciones de algunos campos no informados en el servicio:

internalCode	itemStore.item → item.internalCode	Con el código del ítem recibido, se obtiene el ID del ítem
description	itemStore.item → item.description	Con el ID del item se obtiene el item.description
storeCode	itemStore.store → store.code	Con el código de la tienda recibido, se obtiene el ID del store
processed	por defecto false
notForSale	Si no es informado, por defecto deben ser 0
disabled	Si no es informado, por defecto deben ser 0
blockedForIcd	Si no es informado, por defecto deben ser 0
createdAt	Si es un nuevo registro importar la fecha actual, sino no se modifica
updatedAt	Actualizar con la fecha actual
hierarchyGroup
processed	Importar con valor false (para que luego lo tome el job de API que los procesa)
onConsignment	Si no es informado, por defecto debe ser 0

Request de itemStore

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><internalCode>2345</internalCode><storeCode>1</storeCode> <vatCode>2</vatCode>  </itemStore>

      <itemStore><internalCode>2345</internalCode><storeCode>2</storeCode> <vatCode>1</vatCode>  </itemStore>

       <itemStore> <internalCode>312</internalCode><storeCode>2</storeCode> <disabled>2</disabled></itemStore>


      </itemStores>
   </params>
</bridgeCoreRequest>

  ]]> 

         </request>
         <!--Optional:-->
      </ser:execute>
   </soapenv:Body>
</soapenv:Envelope>

...

Árvore de páginas

Versões comparadas

Versão antiga 15

Nova versão Atual

Chave

Request de Marca

Request de artículo

Request de artículo

Request de

artículos relacionados

Orden de compra

Request de Orden de compra

Pedido de

transferencia

Request de Orden de compra

Request de pedido de transferencia

Transferencia

Request de pedido de transferencia

Transferencia

Request de itemStore