Archivos de Interface Onebeat

REQUERIMIENTOS DE ONEBEAT

ESTRUCTURA DEL SISTEMA

El propósito de este documento es describir los aspectos técnicos necesarios para Onebeat.

Onebeat tiene una arquitectura cliente-servidor. Su componente principal, el servidor Onebeat debe
instalarse en una máquina servidor, junto con el servidor SQL. Las aplicaciones cliente de Onebeat
están conectadas a la aplicación Servidor Onebeat. Pueden ubicarse en el servidor o en estaciones
remotas a través de LAN o WAN.

CAPACIDAD DEL ERP

Onebeat interactúa con el sistema ERP intercambiando archivos todos los días. Por lo tanto, debemos
asegurarnos de que el sistema ERP local pueda proporcionarnos los datos que Onebeat necesita. Los
siguientes son ejemplos de todos los campos obligatorios que deberán cargarse en Onebeat. Al iniciar
el proyecto, realizaremos un taller y decidiremos juntos exactamente los datos que se transferirán entre
los sistemas.
MTSSKUS

Todos los SKU que se cargarán en el sistema deben definirse en un archivo MTSSKUS que contenga los
siguientes datos:

Información Técnica

Nombre del Campo Tipo Esperado Estado Validación Técnica

Stock Location Name String Mandatory Not Empty

SKU Name String Mandatory Not Empty

SKU Description String Optional

Origin SKU String Optional

Origin Stock Location String Optional Not Empty

Stock Location SKU Name String Optional

Buffer Size (will be explained on site) Decimal Mandatory Valid Decimal

Replenishment Time Decimal Mandatory Valid Decimal

Inventory At Site Decimal Mandatory Valid Decimal

Inventory At Transit Decimal Mandatory Valid Decimal

Inventory At Production Decimal Mandatory Valid Decimal

Unit Price Decimal Mandatory Valid Decimal

Minimum Buffer Size Integer Optional Valid Integer

Throughput Decimal Optional Valid Decimal

TVC Decimal Optional Valid Decimal

Safety Stock Decimal Optional Valid Decimal

Minimum Replenishment Decimal Optional Valid Decimal

Last Batch Replenishment Decimal Optional Valid Decimal

Replenishment Multiplications Decimal Optional Valid Decimal

 Unit Of Measurement
String Optional Not Empty

Avoid Replenishment Boolean Optional Valid Boolean

Avoid Seasonality Boolean Optional Valid Boolean

Auto Replenishment Boolean Optional Valid Boolean

Irregular Inventory at Site Decimal Optional Valid Decimal

Irregular Inventory at Transit Decimal Optional Valid Decimal

Irregular Inventory at Production Decimal Optional Valid Decimal

Buffer Management Policy Decimal Optional Valid Decimal

Shipments Measure Optional

End of Life Policy Optional

EOL State Optional

SKU Property 1 String Optional

SKU Custom Text 1 String Optional

SKU Custom Num 1 Decimal Optional

Reported Date Year Integer Mandatory Valid Integer

Reported Date Month Integer Mandatory Valid Integer

Reported Date Day Integer Mandatory Valid Integer

Información Lógica

Nombre del
Descripción
campo

Stock Location El nombre de la SL en donde el SKU está definido.

SKU SKU ID

SKU Description Cualquier descripción deseada.

El origen desde el cual se embarcar mercancía a la SL. Será posible recibir

Origin Stock
transacciones de cualquier otro origen, pero las recomendaciones de
Location
Onebeat, siempre serán con respecto al Origin SL.

El nombre de SKU en Origin SL que se entrega de forma predeterminada

para satisfacer la reposición de este SKU. En la mayoría de los casos, este
campo no se utilizará, ya que normalmente tenemos una conexión
directa (de una a muchas) entre el mismo SKU en diferentes niveles de la
cadena de suministro. Sin embargo, en algunos casos de modelado es
Origin SKU
posible reponer un SKU en el destino desde una SKU diferente en el
origen. Una vez que el usuario haya establecido este campo, aparecerá
como el SKU de origen predeterminado en la pantalla de distribución.
Además, este campo también es opcional en los archivos de salida de
Transacciones y Distribución.

El nombre del SKU según la SL. Éste debe ser el nombre de SKU. Para
Stock Location
todas las entradas relacionadas con este SL y SKU. Por ejemplo, en
SKU Name
transacciones y status.

Es la protección contra los agotados. Cantidad de piezas que se desea

Buffer Size
mantener en la SL

El buffer es un número dinámico. En algunas ocasiones es necesario

Minimum Buffer establecer un valor mínimo para el buffer, de tal manera que las
Size recomendaciones de Onebeat no sean menores a éste. En algunos
entornos, cumple la función de establecer la exhibición mínima.
Replenishment El tiempo que toma para reponer una unidad de venta, desde el
Time momento que se consume, hasta que se vuelve a recibir en la SL.

Inventory At
Existencia acual en la SL
Site

Inventory At
Cantidad total de inventario que está en camino o asignado a una SL
Transit

Inventory At Cantidad de inventario que está en producción, antes de ser embarcado

Production a una SL.

Irregular
Inventory At Existencia irregular de un SKU en una SL
Site

Irregular
Cantidad total de inventario irregular que está en camino o asignado a
Inventory At
una SL
Transit

Irregular
Cantidad de inventario irregular que está en producción, antes de ser
Inventory At
embarcado a una SL.
Production

Unit Price Precio de venta

Throughput Ganancia tras una venta, el resultado del precio de venta menos el costo.

TVC Truly variable Cost – Costo del SKU

Algunos SKUs, en algunos entornos, que son críticos y que deben ser
protegidos de agotados.

Safety Stock El SS es un inventario que se requiere siempre esté presente.

1. Asegurar un nivel de inventario durante un periodo de prueba de

Onebeat.
 2. Asegurar inventario en góndola para la venta.

3. Asegurar un nivel mínimo de SKUs críticos, como medicamentos

Este inventario no se verá en el BP. Este valor

se tratará como un cero virtual en el
inventario del SKU.

SKU A Buffer Size = 40

SKU A “Safety Stock” = 20
SKU A Inventario en Sitio = 40

SKU A Buffer Penetration en Sitio = 50% (No 0%, debido al SS).

DBM Policy Este campo tiene la Política de DBM asignada.

Minimum
Este parámetro restringe la distribución a ser mayor a este valor mínimo.
Replenishment

Sólo aplica cuando se definen "Minimum Replenishment" o

"Replenishment Multiplications".

Tenemos una tienda de muebles. El tamaño del buffer para una

mesa redonda es 20. Nuestro proveedor tiene reglas estrictas de
lote mínimo de 5. Por lo tanto, definimos el búfer como 20 y la
reposición mínima como 5.
Last Batch
Ahora, la pregunta es cuándo colocar el pedido, ¿cuándo la
Replenishment
cantidad en la tubería es 19 o 15? Aquí es donde entra en juego LBR.

Last Batch Replenishment = 100%: Significa que hasta que hagan

falta 5 unidades (inventario menor o igual a 15), sólo entonces se
recomendará la siguiente distribución de 5.

Last Batch Replenishment = 0%: Significa que, aunque solo falte

una pieza, se generará la distribución de 5.
 En algunos casos, la distribución puede ocurrir sólo en lotes de tamaño
Replenishment
específico. Por ejemplo, se manda mercancía a una Tienda en empaques
Multiplications
con 5 unidades de venta.

Unit Of
Measurement Unidad de Medida
(UOM)

De no requerirse, dejar la bandera no seleccionada (=0).

La estacionalidad se puede definir para un grupo de productos. En caso

Avoid de que un producto sea parte de todo un grupo de productos de
Seasonality temporada, y por alguna razón, la temporada no es relevante para éste,
marcarlo como "Evitar estacionalidad" hará que Onebeat evite cambiar
su Buffer debido a las definiciones de estacionalidad.

Avoid De no requerirse, dejar la bandera no seleccionada (=0).

Replenishment Los SKUs marcados no generarán recomendaciones de distribución.

De no haber un motivo en particular, dejar la bandera seleccionada (=1).

Auto
Replenishment Los SKUs marcados serán los que se puedan distribuir en forma
automática.

SKU Free
Property 1

SKU Free
Property 2
Campos definidos como propiedades para los SKUs
SKU Free
Property 3

SKU Free
Property 4
 SKU Free
Property 5

SKU Free
Property 6

SKU Free
Property 7

Campos numéricos definidos por el usuario para dar información

Custom Num
adicional.

Custom Text Campos de texto definidos por el usuario para dar información adicional.

Reported Date
Year

Reported Date
Fecha de reporte
Month

Reported Date
Day

Todo lo anterior son campos obligatorios que debemos obtener del sistema ERP para comenzar a
trabajar con Onebeat. Otros campos son opcionales, como las propiedades, campos de texto o
numéricos.
 STOCK LOCATIONS

Este archivo insertará o actualizará Stock Locations en la cadena de suministro.

Información Técnica

Nombre del Tipo Valor Validación

Estado Validación Lógica
Campo Esperado Default Técnica

Stock Location String Mandatory Not Empty SL Exists

Stock Location
String Optional Empty Not Empty
Description

SL Type o SL Type ID, de

acuerdo con:

SL
SL Type Type
ID

plant 1
Stock Location string or Valid String or
Optional Warehouse
Type int valid Integer
supplier 2

point of sale 3

Transparent 4

warehouse 5

Is Supplier? Boolean Optional False Valid Boolean

Is Plant? Boolean Optional False Valid Boolean

Is
Boolean Optional False Valid Boolean
Transparent?
SL Free
String Optional Empty None Valid Property Item 1-7
Property 1-7

SL Custom
String Optional None Valid Custom Num 1-10
Num 1-10

Zero/Empty
Allocation (will be Zero or positive
Integer Optional
Priority replaced to integer
zero)

Allow Over
Integer Optional Null Yes/No/Null
Allocation

Can be any
Replenishment Tiny
Optional Zero Positive/Negative
Priority Integer
integer value

Stop False/True/
Bit Optional False
Allocations 'No'/'Yes'

Reported Date
Integer Mandatory Valid Integer Valid Date
Day

Reported Date
Integer Mandatory Valid Integer Valid Date
Month

Reported Date
Integer Mandatory Valid Integer Valid Date
Year

Información Lógica

Nombre del
Descripción
Campo

Stock Location SL ID.

Stock Location Cualquier descripción deseada. Se presentará con el campo "SL" en
Description cualquier reporte.

1. "1" si es proveedor
Is Supplier?
2. "0" si no es proveedor

1. "1" si es planta
Is Plant?
2. "0" si no es planta

1. "1" si es una Transparent stock location

Is Transparent?
2. "0" si es una stock Location regular

SL Free Property
Campos para uso del usuario.
1-7

Esos campos son para el usuario y representan campos de numéricos

SL Custom Num
personalizados. Sólo se agregarán números personalizados a stock
1-10
locations definidas, se mostrarán con su nombre definido por el usuario.

Allocation Stock locations con mayor valor en la columna de prioridad se asignarán

Priority primero.

Allow Over Esto permitirá determinar para cada SL si será accesible para la exceder la
Allocation asignación.

Replenishment
Este parámetros define la prioridad de distribución para una SL.
Priority

Stop Allocations · 'Stop Allocations' es 'No' = no cambia el comportamiento.

 'Stop Allocations' is 'Yes' = Se realiza toda la funcionalidad del
Retail para la tienda, como: verificación de validez, estimación de
·
ventas y cálculos de Gaps, etc. sin embargo, se evitará el 'Proceso
de asignación' y no se calcularán recomendaciones.

Reported Date
Day Fecha del reporte, separada por año, mes y día
STATUS

El archivo Status es un recuento de existencias que notificará a Onebeat con el total de todos los SKU
del sistema. Debe reflejar los niveles de Stock en un día específico.

Información Técnica

Nombre del Campo Tipo Esperado Estado Validación Técnica

Stock Location Name String Mandatory SL Exists

SKU Name String Mandatory SKU exists

SKU Type String Optional "Order" or "Stock"

Inventory At Hand Decimal Optional Valid Decimal

Inventory On the Way Decimal Optional Valid Decimal

Reported Date Day Integer Mandatory Valid Date

Reported Date Month Integer Mandatory Valid Date

Reported Date Year Integer Mandatory Valid Date

Información Lógica

Nombre del Campo Descripción

Stock Location Name

SKU Name

La cantidad total de inventario que va camino a la SL. Siempre estará

Inventory On the Way
de acuerdo con la UOM definida.

Cantidad total de inventario en existencia en la SL. Siempre estará de

Inventory at Hand
acuerdo con la UOM definida.

Reported Date Year Fecha reportada

 Reported Date Month

Reported Date Day

Definirá si actualiza el inventario regular (Stock) o el inventario

SKU Type
irregular (Order).

En caso de múltiples registros para la misma entidad:

1. Para cada SL+SKU+Reported Date+SKU Type, el sistema ordenará de acuerdo al inventario en

sitio, de forma ascendente.
2. Onebeat procesará todos los registros, sin validar duplicidad, de acuerdo con el orden anterior
actualizará el inventario.
TRANSACTIONS

El archivo Transactions representa el consumo dentro de la cadena de suministro, como el consumo

de clientes de POS, las transacciones entre Stock Locations, el almacén de productos terminados en la
planta, etc.

Los consumos de clientes se expresarán como una transacción OUT a Onebeat.

Las transacciones entre Stock Locations también se declararán como consumo y se dividirán en dos
transacciones separadas, una OUT de la SL Origen y una IN en la SL de Destino.

Información Técnica

Nombre del Campo Tipo Esperado Estado Validación Técnica

Transaction ID String Optional Not Empty

Type String Mandatory IN, OUT and RETURN

SL Exists. Only if the transaction is OUT

Source Stock Location String Mandatory
or RETURN

Destination Stock Location String Mandatory SL Exists. Only if the transaction is IN

SKU String Mandatory SKU Exists

Quantity Decimal Mandatory Not Empty

Adjustment Boolean Optional 0 or 1 (for true or false)

Client Order ID String Optional

Adjust Inventory Boolean Optional 0 or 1

Shipping Date Day Integer Mandatory Valid Date

Shipping Date Month Integer Mandatory Valid Date

Shipping Date Year Integer Mandatory Valid Date

Información Lógica

Nombre del
Descripción
campo

Hay tres opciones para mandar el Transaction ID

El usuario la provee una ID idéntica para cada relación de transacción

1.
relevante

Transaction ID 2. El usuario provee una ID para cada Transacción (IN, OUT, RETURN)

3. Onebeat provee la Transación ID (No identicas ID)

Sólo la opción 1 o 2 requieren que el campo esté en el archivo. Al usar la 3, no se

requiere poner en el archivo.

Hay tres tipos de transacción: IN, OUT y Return.

1. IN – los SKUs llegan a SL destino (incrementa inventario)

Type OUT – los SKUs salen de SL Origen para ir hacia una SL Destino
2.
(disminuyen inventario en origen y aumenta el tránsito)

Return – El SKU llegó a la SL destino, pero lo devuelve por alguna

3.
razón.

En transacciones de OUT y RETURN, la Fuente debe ser una SL definida.

Origin
En transacción de IN, la Fuente puede ser cualquier cadena.

El nombre de SKU en el origen. Este es un campo opcional que se requiere solo

Origin SKU en entornos específicos. Si este campo no está definido, Onebeat asume que el
SKU de origen tiene el mismo nombre que el archivo SKU en el destino.

Destination En transacciones de IN, el destino debe ser una SL definida.

Stock Location En transacciones de OUT y RETURN, el destino puede ser cualquier cadena.
SKU El nombre del SKU en el destino

La cantidad del SKU en la transacción, de acuerdo con su UOM.

1. IN – cuenta la cantidad, de acuerdo con la UOM del destino.

Quantity
2. OUT - cuenta la cantidad, de acuerdo con la UOM de la fuente.

3. Return - cuenta la cantidad, de acuerdo con la UOM de la fuente.

Shipping Date
Day
1. IN – fecha de llegada

Shipping Date
2. OUT – fecha de envío
Month

3. Return – fecha de devolución

Shipping Date
Year

La Client Order con la que está relacionada esta transacción. También es posible
Client Order ID ingresar la palabra "ORDER" en este campo cuando no hay una Orden de Cliente
específica definida.

Adjust Define si la transacción OUT es considerada como consumo, o sólo un ajuste de

Inventory inventario y no consumo.
PURCHASING

Recibe la información de toda orden de compra fincada y abierta en el sistema. Se ocupa cuando se
tiene el módulo en “Open Cycle”.

Información Técnica

Nombre del Tipo Valor Validación Validación

Estado
Campo Esperado Default Técnica Lógica

Stock
String Mandatory Not Empty SL Exist
Location

SKU Exists at
SKU String Mandatory Not Empty
SL

Quantity Decimal Mandatory Valid Decimal

Order ID String Mandatory Not Empty

SL Exists,
Supplier ID String Mandatory Not Empty Marked as
Vendor

Not Empty / Valid

Time Buffer Integer Optional Bigger Than Zero
Decimal

Order Type String Mandatory Order / Stock

Order Price Decimal Mandatory Valid Decimal

Order Year Integer Mandatory Valid Integer Valid Date

Order Month Integer Mandatory Valid Integer Valid Date

Order Day Integer Mandatory Valid Integer Valid Date

Promised
Due Date Integer Optional Empty Valid Integer Valid Date
Year

Promised
Due Date Integer Optional Empty Valid Integer Valid Date
Month

Promised
Due Date Integer Optional Empty Valid Integer Valid Date
Day

Need Date
Integer Optional Empty Valid Integer Valid Date
Year

Need Date
Integer Optional Empty Valid Integer Valid Date
Month

Need Date
Integer Optional Empty Valid Integer Valid Date
Day

Is Shipped Boolean Optional "0" "0"/"1" True/False

Reported
Integer Mandatory Valid Integer Valid Date
Date Year

Reported
Integer Mandatory Valid Integer Valid Date
Date Month

Reported
Integer Mandatory Valid Integer Valid Date
Date Day

Client Order
String Optional
ID

Property 1-7 String Optional

Información Lógica

Nombre del
Descripción
campo

La SL destino de la Orden de Compra.

Para pedidos PTS, el destino debe definirse como SL en Onebeat y el SKU debe
Stock
definirse en el destino como un SKU MTS.
Location
Para pedidos de PTO, el destino puede o no estar definido. El SKU puede o no
estar definido en el destino (pero la ubicación de Stock debe existir).

SKU El SKU en la Orden de Compra.

Quantity Cantidad del SKU en la Orden de Compra, de acuerdo a la UOM.

Order ID ID única de la orden de compra.

Supplier Proveedor, puede o no estar definido en Onebeat

Campo alternativo para "Lead Time" + "Time Protection" en los "SKU

Procurement Data". Si se da un valor, será usado en lugar del "Lead Time and" +
"Time Protection". Es el tiempo de entrega en días, cuando hay suficiente tiempo
Time Buffer
antes del tiempo real de requerimiento del material (el buffer es mayor al tiempo
de entrega del proveedor en la protección de Murphy). Es un dato relevante sólo
para las PTO.

Stock (PTS) – cuando la orden es para SKUs que llenarán un buffer y

1.
serán almacenados para distribución.
Order Type
Order (PTO) – cuando la orden es para SKUs que no llenarán un buffer
2.
y serán entregados directamente (sin almacenar).

Order Price Monto del pedido

Order Year Fecha en que se ejecuta la orden de compra.

Order Month

Order Day

Promised
Fecha en que el proveedor promete entregar la mercancía.
Due Date
Year En caso de Order Type = Order (PTO):

Esta fecha, por definición, es anterior a la fecha de necesidad. Si se da esa fecha,

Promised
el color del pedido se volverá rojo solo después de que se haya pasado esa fecha.
Due Date
Si no se le da el orden, el color se volverá rojo después de cruzar 2/3 del buffer.
Month
En caso de Order Type = Stock (PTS)
Promised
Pasada esta fecha, ya se toma como un retraso del proveedor.
Due Date Day

Need Date
Year

Need Date Fecha en que la mercancía o material se requiere en sitio. Pasada esta fecha, el
Month color es negro.

Need Date
Day

Is Shipped Indica que un pedido está siendo embarcado por el proveedor.

Reported
Date Year

Reported
Fecha del reporte
Date Month

Reported
Date Day
 La Client Order con la que está relacionada esta orden. También es posible
Client Order
ingresar la palabra "ORDER" en este campo cuando no hay una Orden de Cliente
ID
específica definida.

Properties 1-
Campos adicionales para el usuario.
7