Instalación

Instalación de Módulo

Antes de poder partir con la instalación del módulo, cada región debe realizar dos desarrollos previos:

1. Crear un nuevo flujo de tareas para merma:

¿Qué implica esto?:

• Preparar el Task-injector para poder soportar dos tipos de tarea:
  • Productos por agregar fecha de vencimiento
  • Productos próximos a vencer
• Merma enviará la tarea a través de un tópico y sus actualizaciones.
• Canalizar estas nuevas tareas al servicio de notificaciones push (si es que aplica).
• Ajustar el FrontEnd de la app para que aparezca el botón con el tipo de tarea y la cantidad de items a gestionar.

El path para hacer la redirección al módulo de merma para la gestión de productos próximos a vencer será el siguiente: /merma/alert

El path para hacer la redirección al módulo de merma para asignar fecha de vencimiento a los productos será el siguiente: /merma/alert-product-entry

Ya finalizados los pasos previos, se podrá continuar con la instalación del módulo.

Instalación de Manual:

1. Clonar el repositorio: https://github.com/Cencosud-X/yumi-curated-catalog.git

Integración Backend

Para realizar la integración con el modulo de merma se deberá los siguientes pasos:

Paso 1: Armar el objeto a enviar

El objeto a enviar debe tener la siguiente estructura:

Input

{
  "ean": "123344",
  "store": "J353",
  "expirationDate": "2023-08-03T21:48:09.071Z",
  "section": 1,
  "sector": 1,
  "quantity": 10,
  "typeUnit": "Kg",
  "netWeight": 15.6,
  "origin": "national"
}

Nombre	Tipo	Descripción
ean	string	Número de Artículo Internacional
store	string	Identificador de la tienda
expirationDate	string	Fecha de expiración del producto
section	string	Identificador de la sección del producto
sector	string	Identificador del sector del producto
quantity	number	Unidades
typeUnit	string	Tipo de unidad del producto (Kg, Caja, Unidad, Paquete, Lb)
netWeight	number	Peso neto del producto
origin	string	Origen (national, imported)

2. enviar el registro al siguiente tópico:

• Argentina: ar.mitienda.pre-waste.product-create.v1
• Colombia: co.mitienda.pre-waste.product-create.v1
• Chile: cl.mitienda.pre-waste.product-create.v1
• Perú: pe.mitienda.pre-waste.product-create.v1

1. suscribirse en el siguiente topico:
   1. Argentina: ar.mitienda.pre-waste.alert.v1
   2. Colombia: co.mitienda.pre-waste.alert.v1
   3. Chile: cl.mitienda.pre-waste.alert.v1
   4. Perú: pe.mitienda.pre-waste.alert.v1

el dato a recibir sera el siguiente:

{
  "primarysid": "64cc20982414164096337643",
  "state": "PENDING",
  "country": "cl",
  "local": "storage:J510",
  "createdAt": "2023-08-03T21:48:09.071Z",
  "updateAt": "2023-08-03T21:48:09.071Z",
  "ean": "24806244",
  "tally": "000000248062440021500NN9500196553000280923",
  "hu": "9500196553",
  "netWeight": 21.5,
  "typeUnit": "Kg",
  "quantity": 10
}

Nombre	Tipo	Descripción
primarysid	string	Primarysid del usuario
state	string	Estado (PENDING, ONPROGRESS, COMPLETED)
country	string	Identificador del país
local	string	ID de la tienda
createdAt	string	Fecha de creación del registro
updateAt	string	Fecha de actualización del registro
ean	string	Número de Artículo Internacional
tally	string	Identificador de seguimiento
netWeight	number	Peso del producto
quantity	number	Unidades a ingresar

Posterior a estos pasos el país ya se encontrará con la data disponible para integrarlo con su flujo de Tareas. Esta integración es obligatoria, ya que permitirá habilitar el botón para ingresar al modulo de merma para gestionar la tarea