Revisiones

Fecha	Versión	Descripción	Autor
	1.0	Creación del documento	Usuário desconhecido (martin.malievac)
17/03/2022	1.1	Se ajusta el método a POST en lugar de GET y el default resultado a 3000	Andrea Veronica Asato
28/03/2023	1.2	Se actualiza servicio ítem y de precios vigentes	Andrea Veronica Asato

Índice

Este documento detalla la importación de todos los maestros desde Bridge API

...

Si se envía la fecha, la respuesta será de aquellos ítems cuya fecha de última actualización sea mayor o igual a la recibida en la consulta.

{

"date": "12-8-2020"

}

...

La unidad de peso: “kg”

...

Se agrega un nuevo parámetro para obtener más información del ítem. Si no se envía el parámetro o se envía = false, solo se informarán los primeros campos del item (internalCode, description y datos de dimensión del item)

Disponible a partir de v7.4

{
"moreDetail": true
}

Campo	Tipo	Descripción	Ejemplo
internalCode	String	Código SKU del ítem	"internalCode": "C123456",
description	String	Descripción del ítem	"description": "Articulo C123456",
itemDepth	Decimal	Longitud del ítem	"itemDepth": "0",
itemWidth	Decimal	Ancho del ítem	"itemWidth": "0",
itemHeight	Decimal	Altura del ítem	"itemHeight": "0",
itemGrossWeight	Decimal	Peso bruto del ítem	"itemGrossWeight": "0",
disabled	Boolean	Indica si se encuentra deshabilitado	"disabled": false,
notForSale	Boolean	Indicador de si está disponible para la venta	"notForSale": false,
discountsNotAllowed	Boolean	Indicador si permite recibir descuentos	"discountsNotAllowed": false,
priceRequired	Boolean	Indicador si requiere el ingreso de precio al ser vendido	"priceRequired": false,
sellerRequired	Boolean	Indicador si requiere el ingreso del vendedor	"sellerRequired": false,
magnitudeRequired	Boolean	Indicador si requiere el ingreso de la magnitud/peso	"magnitudeRequired": false,
quantityRequired	Boolean	Indicador si requiere el ingreso de la cantidad a vender	"quantityRequired": false,
quantityAllowed	Boolean	Indicador si permite la venta por cantidad	"quantityAllowed": true,
restrictedSalesHour	Boolean	Indicador si no se permite su venta en horario restringido	"restrictedSalesHour": true,
recordInExceptionLog	Boolean	Indica si se guarda su venta en el log de excepciones	"recordInExceptionLog": false,
authorizationRequired	Boolean	Indica si su venta requiere de autorización del supervisor	"authorizationRequired": false,
foodStampTender	Boolean	Indica si aplica para pago con cupones de alimento	"foodStampTender": false,
serialNumberRequired	Boolean	Indica si requiere del nro de serie	"serialNumberRequired": false,
refundNotAllowed	Boolean	Indica si permite su devolución	"refundNotAllowed": false,
genericItem	Boolean	Indica si es un item del tipo genérico (solo utilizado para items de recargo)	"genericItem": false,
fullDescription	String	Descripción extendida	"fullDescription": "Articulo C123456 con atributos",
kitComponent	Boolean	Indica si es un componente de un kit (hijo)	"kitComponent": false,
stockReservationRequired	Boolean	Indica si requeire reserva de stock (para validar si tiene stock teórico para su venta y deja registro de su reserva)	"stockReservationRequired": false,
importDocReq	Boolean	Indica si requiere lote o despacho
price	numberDecimal	Precio de venta del maestro	"price": "525.0000",
promotionalPrice	numberDecimal	Precio promocional	"promotionalPrice": "0.0000",
promotionalPriceStart	date	Vigencia inicio de precio promocional	"promotionalPriceStart": "1969-12-31T00:00:00",
promotionalPriceEnd	date	Vigencia fin de precio promocional	"promotionalPriceEnd": "1969-12-31T00:00:00",
unitCost	numberDecimal	Precio de costo	"unitCost": "230.0000",
updatedAt	date	Fecha de ultima actualización	"updatedAt": "2023-03-30T14:47:55",
ivaType	String	Código del tipo de iva	"ivaType": "2",
itemType
calculateCommision	Boolean	Indicador si calcula comisión	"calculateCommission": false,
detailedDescription	String	Descripción detallada	"detailedDescription": "Articulo C123456 con atributos",
unitOfMeasure	String	Código de la unidad de medida	"unitOfMeasure": "u",
location	String	Código del depósito	"location": "DEP1",
taxCategory	String	Código de categoría de impuestos (para percepciones de IVA o IB en Argentina)	"taxCategory": "G",
hierarchyGroup	String	Código de la categoría departamental	"hierarchyGroup": "ALMA",
brand	String	Código de la marca	"brand": "MERCEDES",
relevance	Number	Relevancia (para el ordenamiento en búsquedas)	"relevance": 1,
supplier	String	Código del proveedor	"supplier": "37719221",
manufacturer	String	Código del fabricante	"manufacturer": "FAB1"
published	Boolean	Indica si se publica o no (no está en uso)	"published": true,
upc	String	Código universal de producto (utilizado para agrupar artículos que suman para la lista de precios mayoristas)	"upc": "C123",
exemptFlag	Boolean	Indica si es un item exento de impuestos	"exemptFlag": false,
maxStock	Number	Cantidad máxima de stock (para pedido sugerido)	"maxStock": "100",
securituStock	Number	Cantidad de stock de seguridad (para pedido sugerido)	"securityStock": "5",
blockedForIcd	Boolean	Indica si se encuentra bloqueado para compras en docs de inventario	"blockedForIcd": true,
requiresPrescriptionFlag	Boolean	Indica si requiere receta (vertical farmacia)	"requiresPrescriptionFlag": false,
stockItem	Lista	Indica si es un ítem que maneja stock y sus características	"stockItem": { "looseWeight": "false", "itemDepth": "0", "itemHeight": "0", "itemNetWeight": "0", "itemCost": "0", "gainWeight": "false", "baseCost": "0", "unitsPerSellingUnit": "0", "itemGrossWeight": "0", "itemDiameter": "0", "itemDrainedWeight": "0", "itemWidth": "0", "netCost": "0", "availableDate": "Tue Mar 28 2023 19:12:34 GMT-0300 (hora estándar de Argentina)" }
attributes: [ ],	Lista	Lista de atributos conteniendo por cada uno: código del atributo nombre del atributo flag si puede ser editado en el POS opción o valor del atributo para el artículo	"attributes": [ { "code": "23001", "name": "Envase de plástico", "editOptionsFlag": true, "option": "true" }, { "code": "Rec", "name": "Receta", "editOptionsFlag": true, "option": "true" } ]
barcode: [ ],	Lista	Lista de códigos de barra asociados al item	"barcode": [ "77123456789", "77111111111", "44332211" ],

Informações

La unidad de peso: “kg”

Para las dimensiones: “cm”

Bloco de código

language	js
theme	Emacs
title	Ejemplo de respuesta
collapse	true

{   
 "ack": 0,
    "data": [
        {
            "internalCode": "GF01",
            "description": "TV65 4K",
            "itemDepth": "220.50",
            "itemWidth": "220.50",
            "itemHeight": "220.50",
            "itemGrossWeight": "5"
        }

  ]
}

Ejemplo de respuesta con el parámetro "moreDetail": true

Bloco de código

language	js
theme	Emacs
title	Ejemplo de respuesta
collapse	true

{
    "ack": 0,
    "data": [
        {
            "attributes": [
                {
                    "code": "23001",
                    "name": "Envase de plástico",
                    "editOptionsFlag": true,
                    "option": "true"
                },
                {
                    "code": "23006",
                    "name": "Fecha de envase",
                    "editOptionsFlag": true,
                    "option": "2022-10-01"
                },
                {
                    "code": "23008",
                    "name": "Laboratorio",
                    "editOptionsFlag": true,
                    "option": "Gador"
                },
                {
                    "code": "Rec",
                    "name": "Receta",
                    "editOptionsFlag": true,
                    "option": "true"
                }
            ],
            "internalCode": "C123456",
            "description": "Articulo C123456",
            "price": "525.0000",
            "unitCost": "230.0000",
            "updatedAt": "2023-03-30T14:47:55",
            "disabled": false,
            "notForSale": false,
            "discountsNotAllowed": false,
            "priceRequired": false,
            "sellerRequired": false,
            "magnitudeRequired": false,
            "quantityRequired": false,
            "quantityAllowed": true,
            "restrictedSalesHour": true,
            "recordInExceptionLog": false,
            "authorizationRequired": false,
            "foodStampTender": false,
            "serialNumberRequired": false,
            "refundNotAllowed": false,
            "kitComponent": false,
            "stockReservationRequired": false,
            "genericItem": false,
            "fullDescription": "Articulo C123456 con atributos",
            "promotionalPrice": "0.0000",
            "calculateCommission": false,
            "detailedDescription": "Articulo C123456 con atributos",
            "unitOfMeasure": "u",
            "ivaType": "2",
            "location": "DEP1",
            "taxCategory": "G",
            "itemDepth": "0",
            "itemWidth": "0",
            "itemHeight": "0",
            "itemGrossWeight": "0",
            "hierarchyGroup": "ALMA",
            "brand": "MERCEDES",
            "relevance": 1,
            "supplier": "37719221",
            "published": true,
            "upc": "C123",
            "exemptFlag": false,
            "maxStock": "100",
            "securityStock": "5",
            "blockedForIcd": true,
            "requiresPrescriptionFlag": false,
            "manufacturer": "FAB1",
            "barcode": [
                "77123456789",
                "77111111111",
                "44332211"
            ],
            "stockItem": {
                "looseWeight": "false",
                "itemDepth": "0",
                "itemHeight": "0",
                "itemNetWeight": "0",
                "itemCost": "0",
                "gainWeight": "false",
                "baseCost": "0",
                "unitsPerSellingUnit": "0",
                "itemGrossWeight": "0",
                "itemDiameter": "0",
                "itemDrainedWeight": "0",
                "itemWidth": "0",
                "netCost": "0",
                "availableDate": "Tue Mar 28 2023 19:12:34 GMT-0300 (hora estándar de Argentina)"
            }
        }
    ]
}

...

itemPriceCurrent

Precios vigentes: informa los precios vigentes para una tienda/canal según fuera obtenido por el servicio "itemPriceBuildProcess"

Disponible a partir de v7.4

https://[direccion_ip]:[puerto]/itemPriceCurrent/all

En el body se deberá informar al menos uno de los dos datos requeridos: store y/o channel (código de tienda y/o código de canal)

Si se solicita store, se informarán aquellos precios vigentes de los artículos de esa tienda (según lo informado en el reporte de precios vigentes, tabla itemPriceCurrent)
Si se solicita channel, se informarán aquellos precios vigentes de los artículos de ese canal para toda tienda (según lo informado en el reporte de precios vigentes, tabla itemPriceCurrent)
Si se solicita store y channel, se informarán aquellos precios vigentes de los artículos de ese canal para esa tienda (según lo informado en el reporte de precios vigentes, tabla itemPriceCurrent)
Se recomienda el uso de los parámetros max y skip (por el volumen de información que pudiera devolver)

{
"store": "1",
"channel": "online",
"max": 5000,

"skip": 1
}

Informações

title	Parámetros adicionales para las consultas

Para todos los servicios se tiene un default de cantidad de registros a devolver de los primeros 3000

Si se desea ampliar la consulta, se debe enviar como parámetro el campo "max" pudiendo combinarse con el parámetro "skip" pudiendo ir solicitando tipo paginada la respuesta. Ej: max 2000 y skip: 1 los primeros 2000 y luego con skip: 2, los otros siguientes 2000.

{
"max": 2000,
"skip": 1
}

Campo	Tipo	Descripción	Ejemplo
internalCode	String	Código de la tienda	"internalCode": "16122022",
name	String	Nombre de la tienda	"name": "Artículo Crédito",
store	String	Código de la tienda	"store": "1"
channel	String	Código del canal	"channel": "online",
origin	String	Origen del precio informado "ListaPrecios" (ó "Catalogo" para el maestro de ítems si no está en lista de precios)	"origin": "ListaPrecios",
price	Number	Precio de venta	"price": 175667,
unitCost	Number	Precio de costo	"unitCost": 10,
sellingPriceListNumber	Number	Nro de lista de precios	"sellingPriceListNumber": 99,
validFrom	Date	Fecha de validez desde	"validFrom": "2022-12-19T00:00:00",
validTo	Date	Fecha de validez hasta	"validTo": "2028-01-19T23:59:59",
marginAsNumber	Number	Margen (margen del precio de venta sobre el precio de costo)	"marginAsNumber": 175657,
marginAsPercent	Number	Porcentaje de margen (porcentaje de margen del precio de venta sobre el precio de costo)	"marginAsPercent": 1756570,
barcode	String	Código de barras (sólo si la lista de precios tuviera un código asignado)	"barcode": null,
updatedAt	Date	Fecha de actualización

Bloco de código

language	js
theme	Emacs
title	Ejemplo de respuesta
collapse	true

Body
{
  "store": "1",
  "channel": "online",
  "max": 50
}

Respuesta
{
  "ack": 0,
     "data": [
    {
      "_id": "642d689eec1542a9e5b37d6b",
      "price": 175667,
        {
            "unitCost": 10,
      "sellingPriceListNumber": 99,
      "marginAsNumber": 175657,
      "marginAsPercent": 1756570,
      "internalCode": "GF0116122022",
      "origin": "ListaPrecios",
      "name": "Artículo        "descriptionCrédito",
      "validFrom": "TV65 4K2022-12-19T00:00:00",
            "itemDepth      "validTo": "220.502028-01-19T23:59:59",
            "itemWidth      "barcode": "220.50",
            "itemHeightnull,
      "channel": "220.50online",
            "itemGrossWeight      "store": "51"
            }

   ]
}

...

Store

TIENDA: indica la lista de tiendas que tiene configuradas BRIDGE

...

https://[direccion_ip]:[puerto]/orderType/all o https://[direccion_ip]:[puerto]/orderType/[código]

Campo	Tipo	Descripción
code	String	Código del tipo de orden
name	String	Nombre del tipo de orden

Bloco de código

language	js
theme	Emacs
title	Ejemplo de respuesta
collapse	true

{
	"ack":0,
	"data":[
	{ 
    	"code" : "order", 
    	"name" : "Pedido",
	}
]
}

...

https://[direccion_ip]:[puerto]/orderState/all o https://[direccion_ip]:[puerto]/orderState/[código]

Campo	Tipo	Descripción
code	String	Código del estado de un pedido
name	String	Nombre del estado de un pedido
description	String	Descripción del estado de un pedido

Bloco de código

language	js
theme	Emacs
title	Ejemplo de respuesta
collapse	true

{
	"ack":0,
	"data":[
	{ 
    	"code" : "confirmed", 
    	"name" : "Confirmado",
		"description" : "El pedido se ha confirmado en cuanto a la cantidad de productos a ingresar."
	}
]
}

...

https://[direccion_ip]:[puerto]/orderDeliveryCompany/all ]

Campo	Tipo	Descripción
code	String	Código del operador logístico
name	String	Nombre del operador logístico

Bloco de código

language	js
theme	Emacs
title	Ejemplo de respuesta
collapse	true

{
    "ack": 0,
    "data": [
        {
            "code": "Andreani",
            "name": "Andreani"
        }
    ]
}

...

https://[direccion_ip]:[puerto]/taxJurisdiction/all o https://[direccion_ip]:[puerto]/taxJurisdiction/[código]

Campo	Tipo	Descripción
code	String	Código de la jurisdicción
name	String	Nombre de la jurisdicción

Bloco de código

language	js
theme	Emacs
title	Ejemplo de respuesta
collapse	true

{
    "ack":0,
    "data":[{
	    "code" : "BA",
    	"name" : "Buenos Aires"
	},		
	{
    "code" : "CABA",
    "name" : "CABA"
		}]
}

...

https://[direccion_ip]:[puerto]/taxJurisdictionTaxType/all

Campo	Tipo	Descripción
jurisdictionCode	String	Código de la jurisdicción
jurisdictionName	String	Nombre de la jurisdicción
taxTypeCode	String	Código del tipo de impuesto (IB o IVA)


taxTypeName	String	Nombre del tipo de impuesto
taxCategoryCode	String	Código de categoría impositiva
taxCategoryName	String	Nombre de la categoría impositiva

Bloco de código

language	js
theme	Emacs
title	Ejemplo de respuesta
collapse	true

{
    "ack":0,
    "data":[{
 		" jurisdictionCode" : "ARG",
	    " jurisdictionName" : "Argentina",
	    " taxTypeCode" : "IVA",
	    " taxTypeName" : "IVA",
	    " taxCategoryCode" : "RI",
	    " taxCategoryName " : "Responsable inscripto"
		}]
}

...

Árvore de páginas

Versões comparadas

Versão antiga 16

Nova versão 17

Chave

Revisiones

itemPriceCurrent

Store

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 16

Nova versão 17

Chave

Revisiones

itemPriceCurrent

Store