Modelo JSON pelo tipo de promoção
Exemplos dos distintos tipos de promoção existentes LLEVA_PAGA ADICIONAL_DESCUENTO ADICIONAL_REGALO PRECIO_FIJO DESCUENTO_VARIABLE DESCUENTO_FIJO
Promoção por meio de pagamento (ex. LLEVA_PAGA)
O modelo JSON de uma promoção está composto por um cabeçalho comum e um detalhe variável dependendo do tipo de promoção indicado (ver Tipos de Promoções).
Cabeçal
id Código da promoção
titulo Título da promoção
descripcion Descrição da promoção
tipo Tipo de promoções:
LLEVA_PAGA ADICIONAL_DESCUENTO ADICIONAL_REGALO PRECIO_FIJO DESCUENTO_VARIABLE DESCUENTO_FIJO
detalle Detalhe da promoção. JSON com a especificação particular da promoção. Variável segundo o tipo definido. O detalhe será analisado com mais detalhe na próxima tabela.
autor Informação do autor. JSON com um único campo descripcion que indica quem foi o autor da promoção.
vigenciaDesde Data a partir da qual a promoção está disponível.
vigenciaHasta Data a partir da qual a promoção deixa de estar disponível.
Detalhes (campo detalle da tabela anterior)
condiciones Lista de items que ativam a promoção no PDV em caso de uma venda. Cada elemento da lista inclui uma quantidade (campo cantid ad) e uma lista de produtos (campo articulos) por código de barras. Cada uma dessas linhas representa uma regra que significa “se leva uma quantidade cantidad dos produtos com uma barra que está na lista articulos”.
Lista de meios de pagamento que ativam a promoção. Cada elemento indica uma possível forma de pagamento a ser usada para pagar a venda. Em cada caso, o tipo de pagamento é indicado (9 = Dinheiro, 10 = Cartão de Crédito, 11 = Cheque, 12 = Vale, 13 = Cartão de Débito), descrição (ex: "Cartão de crédito XXX"), código da moeda e lista do BIN's (para cartões). No caso de cartões, o BIN indicado na venda deve coincidir com os especificados nesta lista para que a promoção seja válida.
beneficios Lista de items para os quais é aplicado um benefício, por exemplo, os produtos de presente em um pack (ADICIONAL_REGALO) ou aqueles sobre os quais se aplica um desconto. Cada elemento da lista inclui uma quantidade (campo cantidad) e uma lista de produtos (campo articulos) por código de barras. Cada uma dessas linhas representa uma regra que significa “O beneficio se aplica a uma quantidade cantidad de produtos dentre aqueles que tenham alguma das barras definidas na lista articulos”.
precio Valor fixo em caso de PRECIO_FIJO
descuento Porcentagem de desconto (0-100) em caso de ADICIONAL_DESCU ENTO o DESCUENTO_VARIABLE, ou ainda, um valor fixo de desconto no caso de DESCUENTO_FIJO
paga Quantidade de items a pagar em caso de LLEVA_PAGA.
Exemplos dos distintos tipos de promoção existentes
Seguem alguns exemplos, da representação JSON correspondente ao campo detalle, para alguns dos tipo de promoção existente.
LLEVA_PAGA
“Levando 3 unidades de Fanta paga 2”
"detalles":{ "condiciones":{ "items":[ { "cantidad":3, "articulos":[ { "codigoBarras":"7790580651008",
"nombre":"REFRESCO FANTA POMELO PET.600 ML" } ] } ] }, "beneficios":null, "precio":null, "descuento":null, "paga":2 } ADICIONAL_DESCUENTO
“Levando 2 unidades de Fanta, desconto de 50% num alfajor” "detalles":{ "condiciones":{ "items":[ { "cantidad":2, "articulos":[ { "codigoBarras":"7790580651008",
"nombre":"REFRESCO FANTA POMELO PET.600 ML" } ] } ] }, "beneficios":{ "items":[ { "cantidad":1, "articulos":[ { "codigoBarras":"7790580651067", "nombre":"ALFAJOR MILKA MOUSSE" } ] } ] }, "precio":null, "descuento":50, "paga":null } ADICIONAL_REGALO
"Levando 2 unidades de Fernet, leva como presente umas papas Lay’s" "detalles":{ "condiciones":{ "items":[ { "cantidad":2, "articulos":[ { "codigoBarras":"7790580651008", "nombre":"FERNET DUVAL 750 ML." } ] } ] }, "beneficios":{ "items":[ { "cantidad":1, "articulos":[ { "codigoBarras":"7790580651008", "nombre":"PAPAS LAYS 150 GRS" } ] } ] }, "precio":null, "descuento":null, "paga":null } PRECIO_FIJO
"Levando 2 alfajores, paga $ 10" "detalles": { "condiciones": { "items": [ { "cantidad": 2, "articulos": [ { "codigoBarras":"7790580651067", "nombre":"ALFAJOR MILKA MOUSSE" },
{
"codigoBarras":"7896019601559", "nombre":"ALFAJOR MILKA AO LEITE" } ] } ] }, "beneficios": null, "precio": 10, "descuento": null, "paga": null } DESCUENTO_VARIABLE
“Levando 2 produtos (Pepsi ou Fanta Pomelo), tem um desconto de 30% no preço total” "detalles":{ "condiciones":{ "items":[ { "cantidad":2, "articulos":[ { "codigoBarras":"7790580651008",
"nombre":"REFRESCO PEPSI LIGHT PET.500 ML" },
{
"codigoBarras":"7790580651008",
"nombre":"REFRESCO FANTA POMELO PET.600 ML" } ] } ] }, "beneficios":null, "precio":null, "descuento":30, "paga":null } } DESCUENTO_FIJO
“Levando 2 produtos (Pepsi ou Fanta Pomelo), tem um desconto de $10 no preço total” "detalles":{ "condiciones":{ "items":[ { "cantidad":2, "articulos":[ { "codigoBarras":"7790580651008",
"nombre":"REFRESCO PEPSI LIGHT PET.500 ML" },
{
"codigoBarras":"7790580651008",
"nombre":"REFRESCO FANTA POMELO PET.600 ML" } ] } ] }, "beneficios":null, "precio":null, "descuento":10, "paga":null } }
“Levando 3 unidades de Fanta paga 2 só com Visa Crédito o Débito Santander” "detalles":{ "condiciones":{ "items":[ { "cantidad":3, "articulos":[ { "codigoBarras":"7790580651008", "nombre":"FANTA POMELO 600 ML." } ] } ], "formasPago":[ { "codigoTipoPago":10,
"descripcion": "Visa Crédito Santander", "codigoMoneda": null,
"bines": ["100000", "200000", "300000"] },
{
"codigoTipoPago":13,
"descripcion": "Visa Débito Santander", "codigoMoneda": null, "bines": ["400000", "500000", "600000"] } ], }, "beneficios":null, "precio":null, "descuento":null, "paga":2 }
