Puede importar Eventos de la cadena de suministro de forma masiva en OriginsNext usando un archivo CSV estructurado. Esto le permite registrar muchos Eventos a la vez en lugar de crearlos uno por uno. Hay una plantilla de ejemplo descargable, con una fila de ejemplo por tipo de Evento, que también sirve como ejemplo práctico.
Descargar el CSV de ejemplo
La forma más rápida de armar su archivo es empezar por el CSV de Eventos de ejemplo. Tiene los encabezados de columna exactos que el upload espera y una fila de ejemplo para cada tipo de Evento admitido, por lo que también funciona como ejemplo práctico. Conserve la fila de encabezado, reemplace las filas de ejemplo por sus propios Eventos y guarde el archivo como .csv.
Conceptos básicos de archivo y formato
Su upload debe cumplir estas reglas de formato antes de que la plataforma lo acepte.
El archivo debe ser un archivo .csv y pesar menos de 20 MB.
Los identificadores, en todas partes, usan el formato Type.Value, por ejemplo GLN.WAREHOUSE-A. Para poner más de un identificador en una sola celda, sepárelos con el carácter de barra vertical ( | ).
El archivo tiene un conjunto amplio de columnas que abarca todos los tipos de Evento. Qué columnas importan depende del Type del Evento. Las columnas se agrupan como se muestra en la siguiente sección.
Grupos de columnas
Todos los tipos de Evento comparten las mismas columnas. Solo completa las columnas relevantes para el Type que está registrando.
Grupo de columnas | Qué abarca |
Nivel del Evento | Id, Type, Organisation, Name, Location, Time, Permission, Data Qualifier y Accurate Timestamp. |
Lado de entrada | Los Productos o unidades que entran en el Evento, incluidos su propietario, la logística y las Ubicaciones de origen o destino, la cantidad, el recuento y cualquier ID de dispositivo IoT de entrada. |
Lado de salida | Los Productos producidos o que salen del Evento, incluidos el SKU y el lote de salida, la Organización propietaria y de logística, la cantidad y el recuento, los ID transferibles asignados a ellos, y si se debe incrementar la generación del producto. |
Vínculos de pedido | Vínculos con un Pedido de Compra, Pedido de Venta o consignación. |
Valor y costo | Campos de valor o costo (valor del producto, costo adicional y costo de logística), cada uno asociado a una moneda. |
Metadatos | Columnas de formato libre llamadas Metadata.<key> para sus propios campos adicionales. |
Nota: La columna Permission define la visibilidad de cada Evento. Ingrese Private para Privado, o MyProductPartners para My Product Partners. Esto controla quién puede ver el Evento. Para entender la diferencia, consulte ¿Por qué no puedo ver todos los Eventos en el recorrido de un Producto?
Tipos de Evento admitidos
La columna Type debe ser uno de los tipos de Evento admitidos a continuación. Cualquier otro valor se rechaza. Para saber qué significa cada uno y ver un ejemplo, consulte ¿Cuáles son los Tipos de Evento admitidos?
Tipo de Evento | Tipo de Evento |
Commission | Decommission |
Object | Transformation |
Ownership Change | Aggregation |
Disaggregation | Received |
Dispatched | Transportation Started |
Transportation Ended | Storage Started |
Storage Ended | Bulk Receival |
Bulk Outturn |
|
Reglas clave
Siga estas reglas al completar el archivo, porque el upload se valida contra todas ellas antes de crear nada.
Id y Type siempre son obligatorios en cada fila.
Las filas que comparten el mismo Id se combinan en un solo Evento. Así es como un único Evento puede listar varias entradas: agrega una fila por entrada, todas con el mismo Id. Por ejemplo, un Evento Received con tres Productos de entrada usa tres filas que comparten un Id.
Las marcas de tiempo deben estar en formato ISO completo con zona horaria, en el formato YYYY-MM-DDTHH:MM:SS.ZZZ TZ (por ejemplo 2026-01-01T08:00:00.000Z, donde Z significa UTC).
Las cantidades deben ser numéricas, los recuentos deben ser números enteros, y cualquier campo de valor debe estar asociado a una moneda.
Cada tipo de Evento tiene sus propios campos obligatorios. Por ejemplo, un Evento Commission necesita un SKU de salida e identificadores de Producto de salida.
Cómo subir su archivo
Para subir su CSV de Eventos completado:
Vaya a Product Traceability > Events en el menú lateral para abrir la Events List.
Haga clic en + Add Events en la esquina superior derecha.
En el formulario de carga, arrastre y suelte su archivo CSV completado en el área sombreada, o haga clic en el área sombreada para buscar y seleccionar su archivo.
Haga clic en Upload para iniciar el procesamiento.
Qué ocurre después de subir el archivo
El archivo completo se valida por adelantado antes de crear nada, y los Eventos correctos se procesan luego en segundo plano en lugar de al instante.
Importante: Las cargas son de todo o nada. Si alguna fila o Evento no pasa la validación, toda la carga se rechaza con una lista combinada de los errores, y no se crea nada. Corrija todos los errores indicados y suba el archivo de nuevo.
Cuando el archivo pasa la validación, los Eventos se ponen en cola y se procesan en segundo plano. No se crean al instante y no se guardan como borradores. Puede seguir el progreso de cada Evento en la página de detalles de la carga, donde pasa por los estados de abajo.
Estado | Qué significa |
Pending | El Evento está en cola, esperando ser procesado. |
In Progress | El Evento se está procesando ahora. |
Completed | El Evento se creó correctamente. |
Failed | El Evento no se pudo crear. |
Una vez procesados, los Eventos subidos aparecen en la Events List y en la vista Journey de cada Producto relevante.