top of page

Integración simplificada...

el oasis

¿Qué es El Oasis...?

El OASIS es el proceso 3T para la integración con Event.

Ordene la entrada de datos y la salida de datos enrutados.

¿Qué es Evento..?

Event es la plataforma de gestión de transporte 3T.

Donde podrá controlar el transporte de su producto a sus clientes.

Por lo tanto, está creando la capacidad de poner los datos de su pedido en un formato que se puede usar para:

  1. Enrutamiento y programación

  2. Gestión de la bahía

  3. tus transportistas

    1. Las tarifas de tu operador

  4. El proceso de entrega

  5. El proceso POD y Factura

  6. Informes

Por lo tanto, es importante que estos datos de pedidos sean lo suficientemente completos para que su equipo de enrutamiento y programación tenga la información correcta para poder crear cargas de vehículos y pueda completar esto con precisión para obtener el mejor ajuste y costo y que tenga la información requerida en el informe. cuando esté todo entregado.

¿Qué necesitarás?

Deberá poder enviar información precisa y en vivo del pedido del Evento.

  • Un nuevo pedido, cuando se recibe por primera vez

  • Cualquier actualización de ese pedido que ya se haya enviado a Event [cambios de fecha, cantidad, estimación de fabricación  etc.]

  • Para decirle al evento si ha sido cancelado

  • Para confirmar a Evento que ha sido enviado [la cantidad de envío real y la referencia POD]

¿Donde empezamos?

La integración es un archivo de pedido.

También es el ciclo de vida de este pedido, ya que pasa de ser un pedido NUEVO, a través de ACTUALIZADO [tal vez Fecha o cantidad de pedido] hasta ser enviado [COMPLETO].

El OASIS se compone de varias secciones:

  1. El diseño de los archivos de pedido xml

    • Campos de datos obligatorios

    • Campos de datos opcionales

    • Campos de datos personalizados

  2. El envío de los archivos de pedido xml

  3. la exportacion  de los datos planificados de vuelta del Evento

¿Quién necesita crear la integración?

El requisito es crear una salida en formato OASIS.

Esto puede ser realizado por su TI interno o a través de una empresa de terceros que puede hacer la traducción de su formato y procesar al formato Oasis.

In the below example, you can see a 3rd party translation company in GREEN. If the integration is direct between Event and your WMS / ERP, the GREEN section would be ignored.

SAP 3rd party.png

¿Dónde consigo la especificación?

Esta es la especificación para diseñar su integración.

Archivos de pedidos entrantes [NUEVO, ACTUALIZAR, COMPLETAR, CANCELAR]

El esquema OASIS

04-01-2021

Hoja 1 = La especificación. Diseña lo que quieres enviar. Los campos de datos disponibles, qué significan.

Hoja 2 = un ejemplo de un NUEVO  xml creación desde el esquema

Hoja 3 = un ejemplo de un COMPLETO  xml creado a partir del esquema

¿Tiene algún ejemplo de archivos reales?

A continuación se muestran ejemplos de archivos de prefijo NUEVO/ACTUALIZADO y CANX que utilizan los campos de datos más populares

Estos son los mismos con diferentes prefijos

El archivo COMPLETO tiene algunos archivos de datos diferentes

El esquema OASIS

NUEVO / ACTUALIZAR / CANX

21-11-2020

.DAF  expediente

El esquema OASIS

COMPLETO

22-11-2020

.DAF  expediente

Puede usar la especificación anterior para mapear los datos 'requeridos' y luego decidir qué otra información desea proporcionar que signifique algo para usted.

Por ejemplo, proporcione una fecha de entrega para sus pedidos, díganos si el pedido está "en espera" o agregue información sobre el "producto".

Una vez que haya decidido los datos a enviar además de la información requerida, puede construir su pedido xml. También se pueden encontrar ejemplos de estos xml arriba para ayudarlo.

El flujo del proceso OASIS

NUEVO

Flujo de datos y validación

OASIS

Enviar una vez

Enviar múltiples

Enviar múltiples

o

Pedidos enrutados

Enviar una vez

Enviar una vez

pedido enviado

Opcional 

Enviar una vez

Datos de ejemplo

Número de orden único

Col fecha

Del Fecha

Dirección de entrega

Dirección de destino

Unidad de embalaje total

Descripción del producto

...

...

Número de orden único

Col fecha

Del Fecha

Dirección de entrega

Dirección de destino

Unidad de embalaje total

Descripción del producto

...

...

ACTUALIZAR o CANCELAR

Archivo de RUTA

Nombre de la compañía

Col fecha

Del Fecha

Número de ruta

No detener

Números de pedido

productos

...

...

Número de orden único

Col fecha

Del Fecha

Dirección de entrega

Dirección de destino

DespachadoHU total

Producto enviado

...

...

COMPLETO

¿Qué significa Requerido?

Este es el comienzo del proceso. Aquí le proporcionamos los campos de datos que deben incluirse en la construcción de su integración de eventos

Esta es la información base que requerimos para que Event funcione para que pueda entregar pedidos a los clientes.

¿Qué significa Opcional?

Esta es la segunda parte del proceso, la etapa de datos opcionales. Aquí le proporcionamos los campos de datos que se utilizan con más frecuencia para mejorar las integraciones de eventos.

Por ejemplo, es posible que desee agregar información del producto, no solo el nivel de HU o tal vez una fecha de recolección o instrucciones de entrega.

Tienes la opción de decidir...

¿Qué significa Personalizado?

La integración de OASIS busca brindarle los tipos de datos más comunes para su pedido y, en la mayoría de los casos, esto es suficiente.

Pero para algunos clientes, tienen tipos de datos específicos para ellos. Para aquellos hemos creado Campos Personalizados

Los campos personalizados deben agregarse a la sección correcta. Si estás agregando  un nuevo artículo que se relaciona con un producto, agréguelo a la sección de productos, si es una referencia, en la sección de referencia...

¿Qué significa realmente NUEVO, ACTUALIZAR, etc.?

Líneas de pedido de la integración del libro de pedidos 

Habla a

Col fecha

Del fecha

Horarios de reserva

Equipo

Números de pedido

Incoterms

...

Validación [esquema]

¿Se puede consolidar un pedido en un pedido existente ya recibido?

NO

Encuentre la línea de pedido coincidente y consolide las líneas de pedido en la ruta

Packaging tomará todas las líneas de pedido proporcionadas y calculará el "paquete" óptimo. Mirando el tamaño, el apilamiento, la rotación, la inclinación, para proporcionar un volumen.

Empaca el pedido para calcular el volumen. Crear una nueva parada

Verifique el ajuste en la ruta existente, el tamaño del vehículo. Vuelva a calcular el embalaje y vuelva a agregarlo a la ruta existente.

Utilizamos nuestra propia base de datos global de direcciones y los servicios de Google para validar las direcciones proporcionadas.

Establecer fechas de recogida/entrega a partir de los tiempos de tránsito

Reoptimice automáticamente la parada actualizada dentro del plan diario

Paradas más cercanas

Ventanas de reserva

Tamaño de la parada

Detener instrucciones

Capacidad del vehículo

Mejor reasignación de operador  

...

Consulta todas las rutas de ACVE para conocer la mejor ubicación de las paradas

¿Se puede reoptimizar Stop en el plan de día ACTIVO actual?

NO

Portador de equipo

Ubicación del equipo

Mejor costo

Disponibilidad

Prioridad  

...

...

NUEVO prefijo para un archivo de pedido

Este es un pedido nuevo que nunca se ha enviado a Event.

Para un número de pedido [que DEBE ser único], solo enviará 1 archivo de pedido NUEVO

Si envía un NUEVO y luego otro NUEVO para el mismo número de pedido, ignoraremos el archivo del segundo pedido.

En este caso, debería haber enviado una ACTUALIZACIÓN después del NUEVO

¿Cómo lo sabe Event?

Usamos el número de pedido para identificar si ya lo tenemos en Evento.

¿Qué sucede si tengo diferentes productos para el mismo número de pedido, así que varios pedidos nuevos para el mismo número de pedido?

Luego los identificará usando el campo <LINE_No> en la especificación para diferenciarlos.

  • 0123456_1  -  Producto A

    • Obligatorio <CUS_ORD_NO>0123456</CUS_ORD_NO>

    • Opcional <LINE_NO>1</LINE_NO>

  • 0123456_2  -  Producto B

  • 0123456_3  -  Producto C

ACTUALIZAR prefijo a un archivo de pedido

Este es un cambio realizado a un NUEVO existente.

Por ejemplo, su equipo de servicio al cliente actualiza la fecha de entrega requerida en un pedido. Generarás y enviarás el mismo formato que el archivo NUEVO pero con un PREFIJO de ACTUALIZAR y la nueva fecha de entrega requerida.

No solo el campo de fecha de entrega requerido, sino todo el mensaje del pedido nuevamente.

Nuestro proceso verificará el número de pedido, buscará el prefijo y luego identificará la actualización  hecha. Luego haga esta actualización en Evento para el equipo de operaciones.

¿Cómo trata Event estas actualizaciones en un entorno LIVE?

En Evento, usamos diferentes estados para representar en qué parte del proceso se encuentra actualmente la orden.

Actuamos la actualización de diferentes maneras en función de su estado actual.

Prefijo COMPLETO para un archivo de pedido

Este es un cambio realizado a una NUEVA o ACTUALIZACIÓN existente

Se envía específicamente en el momento en que se envía el pedido para su entrega [este suele ser el equipo de envío que actualiza lo que realmente salió del almacén]

Por ejemplo, se carga un pedido en un vehículo. La cantidad planificada es de 12 plts, pero solo 10 están listos a tiempo para la carga, por lo que Despatch actualizará su sistema con 10 plts. Creas un nuevo mensaje de pedido, agregas el prefijo COMPLETO y actualizas los campos ENVIADO con 10.

El formato es el mismo que NUEVO y ACTUALIZAR, excepto que se deben completar los siguientes campos:

  1. <QTY_DELIVERED>: deberá informarnos a HU qué se envió para la entrega

  2. <DEL_QUANTITY>: opcionalmente, puede  díganos qué cantidad de producto se envió realmente

  3. <DESP_NOTE_NO>: deberá indicarnos la referencia del POD por la que sus usuarios buscarán un POD.

Ejemplo

  • <UNIDADES_DE_MANEJO>

    • <CANTIDAD_ENTREGADA>10</ CANTIDAD_ENTREGADA>

 

y si está utilizando el campo Productos

  • <PRODUCTOS>

    • <DEL_CANTIDAD>2000</DEL_QUANTITY>

¿Qué pasa con las entregas cortas? ¿Cómo se envían los artículos restantes en el número de pedido?

Entonces, a veces no todo el producto para una entrega está listo en el punto de partida.

Se queda corto.

Entonces, el mensaje de pedido COMPLETO [desde arriba] dirá 12 plts para entregar, pero solo se enviaron 10 plts.

Eso significa que todavía tienes 2 plts para enviar.

En esta situación tienes 2 opciones en OASIS:

  1. Para cerrar el pedido en su sistema y crear un nuevo número de pedido para los 2 plts.

  2. Para usar el campo <PREV_DESPATCH> para mostrar que

El Despacho anterior le permite indicarle a OASIS que desea que NO se ignore el mismo número de orden/línea [recuerde, ya tenemos esa combinación como COMPLETA].

Al configurar el Despacho anterior, OASIS ahora usará order / line / prev destach para verificar la exclusividad. Si esa combinación es única, permitir la importación.

Ejemplo para 12plts

  • <LINEA>

    • <CUS_ORD_NO>0123456</CUS_ORD_NO>

    • <LINE_NO>1<LINE_NO> ​​

    • <ENVÍO_ANTERIOR/>

Ahora, en el punto de envío, solo 10 plts estaban listos. Tiene 2 capas restantes que aún desea entregar en la misma combinación de pedido/número de línea.

  • <LINEA>

    • <CUS_ORD_NO>0123456</CUS_ORD_NO>

    • <LINE_NO>1<LINE_NO> ​​

    • <PREV_DESPATCH>1</PREV_DESPATCH>

Prefijo CANCELAR a un archivo de pedido

Este es un cambio realizado a un NUEVO o NUEVO existente. No a un COMPLETO.

Es el mismo formato, solo que con un prefijo diferente, 'CANCELAR'.

Este prefijo se utilizará cuando una orden/línea se cancele por completo.

Si se cancela para mañana porque el cliente lo quiere 6 días después, entonces es una ACTUALIZACIÓN, así que actualice la fecha.

Si elimina el pedido en su sistema, envíelo a Evento como CANCELAR.

¿Qué pasa si el mensaje de pedido falla?

El evento tiene una función de error de importación que detecta el esquema fallido y los datos incorrectos para su corrección 

¿Qué nombre de archivo uso?

El nombre del archivo será su nombre de cuenta acordado y un sello de fecha y hora.

El tiempo a segundos.

Ejemplo:

'ACMEPACKAGING-NUEVO-11102020234712'

'ACMEPACKAGING-ACTUALIZACIÓN-11102020234712'

'ACMEPACKAGING-COMPLETO-11102020234712'

'ACMEPACKAGING-CANCELAR-11102020234712'

Qué soy yo  creando?

Utilizará la especificación para diseñar su propia integración en función de los datos que desee enviar.

Asegurándose de haber incluido todos los campos de datos requeridos.

Está creando un servicio para generar y enviar un archivo xml desde un disparador en su negocio para:

  1. Se crea un NUEVO pedido

  2. Se ACTUALIZA un pedido

  3. Se CANCELA un pedido

  4. Un pedido está COMPLETADO [Enviado]

Como estoy  enviándolo?

Será ftp o sftp.

Puede configurar esto o podemos hacerlo por usted

Se activa cada vez que se crea, actualiza, envía o cancela un nuevo pedido.

o usa nuestra API...

Puede utilizar nuestra API si lo prefiere.

Deberá suscribirse y obtener una cuenta, luego puede seguir la documentación para diseñar y probar.

Llévame al portal de desarrolladores

¿Qué datos puedo recibir de vuelta?

Cuando todo el enrutamiento y la programación estén completos, querrá saber cómo se combinaron los pedidos para crear rutas.

Podemos proporcionarle datos en 2 puntos diferentes del proceso:

  1. En el punto en que una ruta es aceptada por un transportista

    1. Esto proporcionará datos por ruta sobre qué pedidos, cuándo, el costo y entregado por quién ​​​

  2. En el momento en que se crea una factura

    1. Esto proporcionará información sobre las adiciones de costos y los costos finales de la factura.

El esquema de exportación OASIS

archivo de transporte

31-01-2022

El esquema de exportación OASIS

Ejemplo de archivo de transporte

22-01-2022

archivo .txt

The OASIS .xsd

Transport file 

31-05-2022

.TXT file

El OASIS .xsd

Ejemplo de archivo de transporte, simple

08-02-2022

archivo .txt

El OASIS .xsd

Ejemplo de archivo de transporte multi HU y paradas

08-02-2022

archivo .txt

El esquema de exportación OASIS

archivo de factura

por confirmar

El esquema de exportación OASIS

Ejemplo de archivo de factura

por confirmar

Se le envía un archivo de transporte en el momento en que el transportista acepta la oferta de ruta

¿Qué haces ahora?

Empecemos.

Defina su proceso operativo para crear su integración

Use la hoja de cálculo para obtener los datos requeridos

Decide si necesitas alguno de los datos opcionales o si tienes requisitos personalizados.

Utilice los ejemplos xml para ayudar a crear sus archivos de mensajes de pedido.

Cuando esté listo para la prueba, podemos proporcionarle un entorno.

Podemos ayudarlo a verificar y validar su integración.

Envíanos tu hoja de cálculo de integración OASIS

Cree el xml usando el ejemplo y envíenoslo para cada prefijo para un pedido de ejemplo

Pregúntanos cualquier duda

Detalles de contacto para el soporte de OASIS

Correo electrónico: antony.pratt@3t-europe.com

Correo electrónico: Chad.martin@3t-europe.com

Correo electrónico: Scott.pemberton@3t-europe.com

OASIS v's Event

¿Cómo afecta OASIS al estado del evento?

El evento está controlado por sus muchos estados diferentes. Estos controlan la etapa en el proceso de Evento donde se encuentra una orden y, por lo tanto, cómo se ve afectada por los diferentes prefijos que usa OASIS.

Esto lo ayudará a comprender el impacto que tendrá una ACTUALIZACIÓN tardía si un transportista debe recogerla en 20 minutos.

¿Cómo trata Event las actualizaciones de OASIS?

¿Cómo afecta OASIS al estado del evento?

o

Manejo de errores

Validación de formato

Metaheurísticas de empaquetado de pedidos

Servicio de consolidación de pedidos

Selección de operador

Enviar una vez

Enrutamiento de pedidos

Validación de dirección

Reglas de actualización predeterminadas o personalizadas

Reglas de actualización predeterminadas o personalizadas

Enviar múltiples

Enviar una vez

Enviado cuando el transportista acepta la ruta

NUEVO, MODIFICAR, CANCELAR 

Enviar múltiples

Proporciona la cantidad enviada

Proporciona información sobre la nota de envío

pedido enviado

Opcional 

El equipo del evento

bottom of page