Events Order Changes

Estos eventos son de uso interno entre los microservicios de MOP.

Topicos Disponibles

MFC-ORDER-CHANGES.FIFO

Ambiente	ARN	Tipo
Production	arn:aws:sns:us-east-1:849786826922:mfc-order-changes.fifo	fifo
Staging	arn:aws:sns:us-east-2:529305108461:mfc-order-changes-fifo.fifo	fifo

Inicio del Picking

Este evento nos indica cuándo se inició el picking. Se emite solo una vez por orden (excepto en caso de reagendas).

Tópico al que se publica el SNS: mfc-order-changes

Cuerpo del mensaje:

{
  "event": "PICKING_STARTED",
  "orderId": 3932636,
  "country": "MX",
  "warehouseSapCode": "DF0007G",
  "brand": "amazon",
  "origin": "ms-orders"
}

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden en formato numérico.
country: País al que pertenece la orden, en mayúsculas.
warehouseSapCode: Código de SAP para almacén.
brand: Indica por qué canal vino la orden.
origin: Indica por qué canal fue creada la orden. Posibles valores: ms-orders | saleor.

Cierre de Orden (Order Completa)

Este evento indica cuándo una orden está lista para salir a ruta.

Tópico al que se publica el SNS: mfc-order-changes

Cuerpo del mensaje:

{
  "event": "CLOSE_FULFILLMENT",
  "orderId": 3932292,
  "country": "MX",
  "warehouseSapCode": "DF0007G",
  "userId": "userid",
  "brand": "amazon",
  "origin": "ms-orders"
}

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden en formato numérico.
country: País al que pertenece la orden, en mayúsculas.
warehouseSapCode: Código de SAP para almacén.
userId: Usuario que emitió el cierre de la orden.
brand: Indica por qué canal vino la orden.
origin: Indica por qué canal fue creada la orden. Posibles valores: ms-orders | saleor.

Producto On-Hold (Producto Pausado)

Este evento indica cuándo un producto fue pausado y su causa.

Tópico al que se publica el SNS: mfc-order-changes

Cuerpo del mensaje:

{
  "event": "ORDER_REQUIREMENT_ON_HOLD",
  "reason": "ORDER_REQUIREMENT_ON_HOLD",
  "orderId": "105641",
  "country": "MX",
  "warehouseSapCode": "MX0002G",
  "ean": "2018737",
  "brand": "web",
  "cause": "other"
}

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
country: País al que pertenece la orden, en mayúsculas.
warehouseSapCode: Código de SAP para almacén.
ean: Identificador único de producto.
brand: Indica por qué canal vino la orden.
cause: Motivo por el que un producto es marcado como on-hold. Valores aceptados: pending-restock | other.

Creación de una orden

Emitido al crearse una orden desde saleor (Legacy) o el nuevo flujo

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

{
    "event": "ORDER_CHANGE",
    "orderId": "4171681-mx",
    "reason": "PICKING_REQUIREMENT_PLACED",
    "timestamp": "2024-11-04T19:32:25.015Z",
    "isFromOldLayout": false
  }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
timestamp: Fecha de emisión
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Cancelacion de una orden

Emitido al cancelarse una orden desde saleor (Legacy) o el nuevo flujo

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

{
    "event": "ORDER_CHANGE",
    "orderId": "4171681-mx",
    "reason": "PICKING_REQUIREMENT_CANCEL",
    "timestamp": "2024-11-04T19:32:25.015Z",
    "isFromOldLayout": false
  }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
timestamp: Fecha de emisión
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Reagenda de una orden

Emitido al reagendarse una orden desde saleor (Legacy) o el nuevo flujo

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

{
    "event": "ORDER_CHANGE",
    "orderId": "4171681-mx",
    "reason": "PICKING_REQUIREMENT_RESCHEDULE",
    "timestamp": "2024-11-04T19:32:25.015Z",
    "isFromOldLayout": false
  }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
timestamp: Fecha de emisión
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Modificacion de una orden

Emitido al modificarse una orden desde saleor (Legacy) o el nuevo flujo

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

{
    "event": "ORDER_CHANGE",
    "orderId": "4171681-mx",
    "reason": "PICKING_REQUIREMENT_MODIFIED",
    "timestamp": "2024-11-04T19:32:25.015Z",
    "isFromOldLayout": false
  }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
timestamp: Fecha de emisión
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Edicion de una orden

Emitido al modificarse una orden desde saleor

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

{
    "event": "ORDER_CHANGE",
    "orderId": "4171681-mx",
    "reason": "PICKING_REQUIREMENT_EDITED",
    "timestamp": "2024-11-04T19:32:25.015Z",
    "isFromOldLayout": false
  }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
timestamp: Fecha de emisión
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Entrega fallida

Emitido al fallar entrega de una orden desde saleor o el nuevo flujo.

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

{
    "event": "ORDER_CHANGE",
    "orderId": "4171681-mx",
    "reason": "PICKING_REQUIREMENT_DELIVERY_FAILED",
    "timestamp": "2024-11-04T19:32:25.015Z",
    "isFromOldLayout": false
  }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
timestamp: Fecha de emisión
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Importar una orden

Desde mfc-orders-front se puede importar una orden desde Saleor la cual no aparezca en la lista.

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

{
    "event": "ORDER_CHANGE",
    "orderId": "4171681-mx",
    "reason": "IMPORT_ORDER",
    "timestamp": "2024-11-04T19:32:25.015Z",
    "isFromOldLayout": false
  }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
timestamp: Fecha de emisión
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Cancelar una orden desde el dashboard

Desde mfc-orders-front se puede importar una orden desde Saleor la cual no aparezca en la lista.

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

{
    "event": "ORDER_CHANGE",
    "orderId": "4171681-mx",
    "reason": "ORDER_CANCELED_IN_DASHBOARD",
    "timestamp": "2024-11-04T19:32:25.015Z",
    "isFromOldLayout": false
  }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
timestamp: Fecha de emisión
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
timestamp: Fecha de emisión
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Completar un pick

Este evento se emite cuando la cantidad requerida es igual a la cantidad pickeada

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

{
    "event": "ORDER_CHANGE",
    "orderId": "4171762-mx",
    "reason": "PICKING_REQUIREMENT_FULFILL_SKU",
    "ean": "769361101435",
    "timestamp": "2024-11-04T20:00:28.998Z",
    "pickStartDate": "2024-11-04T19:57:28.998Z",
    "isFromOldLayout": false
  }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
timestamp: Fecha de emisión,
ean: Numero identificador del producto pickeado,
pickStartDate: Fecha de inicio de pickeo,
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Completar un pick con faltantes

Este evento se emite cuando la cantidad requerida es mayor a la cantidad pickeada ya sea en un producto pesable o unitario. Esto se puede dar por falta de stock o por algun problema operativo.

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

{
    "event": "ORDER_CHANGE",
    "orderId": "4171762-mx",
    "reason": "PICKING_REQUIREMENT_MISSING_SKU",
    "ean": "769361101435",
    "timestamp": "2024-11-04T20:00:28.998Z",
    "pickStartDate": "2024-11-04T19:57:28.998Z",
    "isFromOldLayout": false
  }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
timestamp: Fecha de emisión,
ean: Numero identificador del producto pickeado,
pickStartDate: Fecha de inicio de pickeo,
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Completar un pick pesable

Este evento se emite cuando la cantidad requerida es igual a la cantidad pickeada pero en productos pesables

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

{
    "event": "ORDER_CHANGE",
    "orderId": "4171762-mx",
    "reason": "BIZERBA_FULFILL_WEIGHT",
    "ean": "769361101435",
    "timestamp": "2024-11-04T20:00:28.998Z",
    "pickStartDate": "2024-11-04T19:57:28.998Z",
    "isFromOldLayout": false
  }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
timestamp: Fecha de emisión,
ean: Numero identificador del producto pickeado,
pickStartDate: Fecha de inicio de pickeo,
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Deshacer cambios de picking

Puede que algunos picks deban ser revertidos. Por lo tanto este evento se emite de ser necesario. Actualmente solo es usado en un caso de uso para las picking-tasks

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

{
    "event": "ORDER_CHANGE",
    "orderId": "4171762-mx",
    "reason": "ROLLBACK_PICKING",
    "timestamp": "2024-11-04T20:00:28.998Z",
    "isFromOldLayout": false
  }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
orderId: Número de orden.
timestamp: Fecha de emisión,
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Asignacion de Ola de picking Puede que algunos picks deban ser revertidos. Por lo tanto este evento se emite de ser necesario. Actualmente solo es usado en un caso de uso para las picking-tasks

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

    {
      "event": "ORDER_REQUIREMENT_ASSIGNED",
      "reason": "ORDER_REQUIREMENT_ASSIGNED",
      "orderId": 4172065,
      "country": "MX",
      "warehouseSapCode": "DF0004G",
      "brand": "rappi"
    }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
country: País al que pertenece la orden, en mayúsculas.
warehouseSapCode: Código de SAP para almacén.
brand: Indica por qué canal vino la orden.
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.

Aceptacion de una ola de picking Si la ola de picking asignada es aceptada por el picker se emite dicho evento que pasa a executing los items y la orden de la ola.

Tópico al que se publica el SNS: mfc-order-changes.fifo Cuerpo del mensaje:

    {
      "event": "ORDER_REQUIREMENT_EXECUTING",
      "reason": "ORDER_REQUIREMENT_EXECUTING",
      "orderId": 4172065,
      "country": "MX",
      "warehouseSapCode": "DF0004G",
      "brand": "rappi"
    }

Definición de los campos:

event (campo discriminador): Indica la acción/motivo del evento.
country: País al que pertenece la orden, en mayúsculas.
warehouseSapCode: Código de SAP para almacén.
brand: Indica por qué canal vino la orden.
isFromOldLayout: Booleano que indica si es de la versión legacy de MOP.