Parte 1
Antes de empezar
Para qué sirve
Este manual explica cómo usar HandyBot para consultar órdenes de compra y registrar Recibidos a Satisfacción (RAS) directamente en Siesa, desde una conversación en Microsoft Teams.
HandyBot te guía con tarjetas y botones, aplica las reglas de negocio de forma consistente y deja registro de cada intento.
Requisitos y acceso
- Cuenta de Microsoft Teams: cuenta corporativa vigente, con sesión iniciada. HandyBot valida tu identidad automáticamente; no escribes usuario ni contraseña aparte.
- La app en tu Teams: HandyBot es una app personal, se usa en una conversación uno a uno, no en un canal. Búscala como “HandyBot” en el buscador de aplicaciones de Teams. Si no aparece, pide acceso al área de Tecnología (ver Ayuda y soporte).
- Rol: se asigna solo la primera vez que entras. Si tu acceso está desactivado o aún no tienes rol, HandyBot te lo dice y te pide contactar a un administrador de HandyBot.
Antes de empezar ten a mano:
- La sociedad y, si aplica, la ciudad o centro de operación donde vas a recibir.
- El NIT o el nombre del proveedor, o el número de la orden de compra con su prefijo (por ejemplo
OM14340).
Para cerrar tu sesión en cualquier momento escribe cerrar sesion.
Alcance
Quién puede usarlo
Cualquier persona de la organización que tenga la app disponible en Teams. Al entrar por primera vez, HandyBot te registra con el rol RAS_Usuario. El rol RAS_Administrador lo otorga a mano otro administrador y suma funciones de administración (equivalencias de comprador, calendario de cortes contables, auditoría) y la verificación de solicitudes de otras personas. Este manual cubre el uso normal con RAS_Usuario.
Qué cubre
Consulta de órdenes de compra por proveedor o por número de orden, selección de sociedad y centro de operación, entrada total o parcial, confirmación explícita, creación de la entrada en Siesa y verificación del resultado.
Qué no cubre
- Causación de facturas.
- Integración con GoSocket.
- Notificaciones o recordatorios automáticos.
- Cantidades decimales en entradas parciales: solo se aceptan números enteros.
- Recibir por encima de la cantidad pendiente que informa Siesa.
Parte 2
Crear una entrada
Cada paso muestra el texto tal como lo ves en Teams. En cualquier tarjeta con “Volver” o “Reiniciar” puedes regresar un paso o empezar de nuevo; también funcionan escribiendo volver, reiniciar o finalizar.
Puedes repasar este flujo dentro de HandyBot escribiendo ayuda y eligiendo “Ver flujo de creación de entradas”.
- Preparar la sesiónInicio, sociedad y centro
- Encontrar la ordenBúsqueda y resultados
- Indicar qué recibesTotal o parcial y cantidades
- Confirmar y revisarResumen y resultado
Preparar la sesión
-
1Inicio de la conversación
Al abrir la conversación, HandyBot te saluda por tu nombre y te pregunta qué quieres hacer. El único botón es “📥 Crear entradas”.
Si tu sesión anterior se cerró por inactividad, antes del saludo verás: “⌛ Tu sesión anterior expiró por inactividad. Empezamos de nuevo.”
Inactividad. A los 5 minutos sin actividad HandyBot te avisa. A los 10 minutos cierra la sesión: “❌ Tu sesión expiró por inactividad. Escríbeme cuando quieras continuar.”
-
2Selección de sociedad
HandyBot muestra las sociedades disponibles, una por fila. Toca la que corresponda.
Al elegir, HandyBot confirma: “✅ Sociedad seleccionada: [nombre de la sociedad].”
-
3Selección de centro de operación
Si tu sociedad lo requiere, HandyBot pregunta a qué ciudad pertenece la entrada y muestra solo las ciudades habilitadas para esa sociedad. Algunas sociedades ofrecen todas sus ciudades; otras, solo una o dos. HandyBot confirma: “✅ Centro de operación seleccionado: [nombre del centro].”
Si la sociedad no requiere esta elección, HandyBot asigna el centro principal y sigue al paso siguiente sin preguntar.
Este centro filtra las líneas de las órdenes: solo ves y puedes recibir las líneas de ese centro, aunque el encabezado de la orden pertenezca a otro.
Encontrar la orden
-
4Búsqueda de la orden
HandyBot pregunta cómo quieres buscar. Tienes dos opciones y, al elegir una, te lo confirma con “✅ Modalidad seleccionada: …”.
Buscar por proveedor
Escribe el NIT o el nombre del proveedor. Si escribes solo números, HandyBot lo toma como NIT (coincidencia exacta). Con cualquier otro texto lo toma como nombre y te muestra las coincidencias para elegir. El nombre admite letras, números, espacio, punto,
&y guion, hasta 100 caracteres.Buscar por número de OC
Escribe el prefijo del tipo de documento (2 o 3 letras) y el consecutivo, por ejemplo
OM14340uOM14744. Puedes escribir varias órdenes en el mismo mensaje, separadas por espacio, coma, punto y coma, guion o diagonal.Rango de fechas. Las dos búsquedas consideran las órdenes del mes en curso y de los tres meses anteriores. Cuando el corte contable del mes ya pasó, también incluyen las del mes siguiente. Una orden fuera de ese rango no aparece.
-
5Revisión de resultados
HandyBot muestra las órdenes en una tabla, de 10 en 10, con el proveedor y el centro de tu sesión siempre visibles. Cada orden indica su número, el estado que trae Siesa y cuántos ítems quedan pendientes en tu centro (“Sin ítems pendientes”, “1 ítem” o “N ítems”).
Solo aparecen las órdenes que todavía tienen algo pendiente en tu centro, y solo las líneas de ese centro.
- Por proveedor: marca una o varias órdenes con la casilla y pulsa “Confirmar selección”.
- Por número de OC: pulsa “Continuar con N orden(es)”.
Cuando tu búsqueda por OC incluye órdenes que no se pueden procesar, HandyBot te las muestra en tablas aparte con el motivo: no existe, su estado no es procesable, está fuera del rango de búsqueda o su mes aún no está habilitado.
Indicar qué recibes
-
6Selección de entrada total o parcial
Para cada orden elegida, HandyBot pregunta cómo quieres registrarla. “Total” ya viene seleccionado en todas las filas: si es lo que necesitas, solo pulsa “Confirmar selección”. Para recibir solo una parte, cambia esa orden a “Parcial”.
Si una orden tiene una sola línea pendiente en tu centro y esa cantidad es exactamente 1, HandyBot la prepara como total y no te pregunta.
Después te muestra un resumen de la preparación: cuántas solicitudes quedaron como total, parcial u omitida.
-
7Registro de cantidades
Si elegiste “Parcial”, HandyBot muestra la tarjeta “🧾 Detalle de la solicitud” con el centro, el proveedor y la orden, y una tabla con cada línea pendiente: descripción, cantidad pedida, cantidad pendiente, valor unitario y el campo “Cantidad a recibir”.
En ese campo escribe un número entero mayor que cero y que no supere el pendiente de la línea. Debes indicar cantidad en al menos una línea; las que dejes vacías no se reciben.
Si elegiste “Total”, no escribes nada: HandyBot toma todo el pendiente de cada línea de tu centro.
Confirmar y revisar
-
8Confirmación antes de crear la entrada
Antes de enviar nada a Siesa, HandyBot te muestra “📤 Revisa antes de enviar a Siesa (N solicitudes)” con el detalle de cada solicitud: orden de compra, sociedad, ciudad, proveedor, modalidad, fecha e ítems.
Es tu última oportunidad de corregir. HandyBot no crea ninguna entrada hasta que pulses “Confirmar y enviar”.
- Confirmar y enviar: crea las entradas en Siesa.
- Volver y modificar: regresa a la selección para corregir órdenes, cantidades o modalidad.
- Cancelar lote: descarta todo sin enviar nada a Siesa.
- Reiniciar: empieza de nuevo.
Al pulsar “Confirmar y enviar”, la tarjeta se bloquea y los botones se reemplazan por un acuse verde con tu nombre y la hora (“✅ Confirmaste el envío”). Mientras se procesa verás “⏳ Enviando a Siesa, esto puede tardar unos segundos...”. No vuelvas a pulsar el botón.
Después de pulsar “Confirmar y enviar”:
-
9Resultado exitoso
HandyBot procesa cada solicitud por separado: si una falla, las demás que ya se crearon siguen creadas. Al terminar muestra el resultado del lote. Si Siesa aceptó la entrada, el estado es “✅ Aprobada” y la columna “Referencia de entrada” trae el código del documento creado.
Si el lote tiene varios proveedores, cada uno aparece bajo su propia franja “Proveedor: …”.
Los botones son “Crear otra entrada” y “Finalizar”. Si no vas a crear otra entrada, pulsa “Finalizar”: la sesión también se cierra sola tras 10 minutos sin actividad.
-
10Resultado rechazado, omitido o incierto
En la misma tarjeta, cada solicitud puede tener otro estado:
- Omitida: no se envió porque, al revisar la orden justo antes del envío, algo había cambiado: la orden ya no existe o ya no tiene pendiente en tu centro, cambió su estado, cambió la sociedad, faltaba una unidad de medida, cambió la información contable o una cantidad parcial ya no era válida.
- ❌ Rechazada: Siesa rechazó la solicitud. Verás el motivo debajo de la tabla. Si el rechazo es un error técnico interno de Siesa, el mensaje es “No fue posible completar la creación por un error interno de Siesa. Se guardó el detalle en el historial de intentos.”
- ❌ Envío no completado: la solicitud sigue pendiente; vuelve a intentarlo o avisa a un administrador.
- ⏳ Pendiente de verificación: resultado incierto. HandyBot envió la solicitud pero no recibió una respuesta concluyente de Siesa a tiempo. No significa que la entrada no se creó. Ver la sección 7.
Cuando el rechazo es porque el mes contable aún no está abierto en Siesa para esa sociedad, la tarjeta incluye un enlace “Más información” que lo explica.
El título de la tarjeta resume el lote, por ejemplo “⚠️ Lote enviado a Siesa: 1 aprobada, 1 rechazada, 1 pendiente de verificación, 1 omitida”.
Parte 3
Si algo sale mal
Según el mensaje
Busca el mensaje que te mostró HandyBot y ve a la explicación.
| Si ves | Qué hacer |
|---|---|
| La orden no aparece, o «No se encontró ningún proveedor con ese dato» | Revisa el número o el NIT, y que estés en la sociedad y el centro correctos. |
| «Alguna cantidad ingresada no es válida…» | Usa enteros mayores que cero que no superen el pendiente de la línea. |
| «Debes indicar la cantidad a recibir de al menos una línea.» | En parcial, escribe la cantidad de al menos una línea. |
| «Debes elegir Total o Parcial para cada orden de la tabla.» | Marca una modalidad en cada orden. |
| ⏳ Pendiente de verificación | No reenvíes. Usa verificar primero. |
| «⚠️ Ocurrió un error inesperado…» | Espera unos minutos y reintenta. Si se repite, escribe a soporte. |
Datos inválidos
HandyBot no avanza hasta que el dato sea válido. Los mensajes más comunes son:
- “Alguna cantidad ingresada no es válida: debe ser un entero mayor que cero y no superar el pendiente de esa línea.” (vacía, cero, negativa, decimal o mayor al pendiente).
- “Debes indicar la cantidad a recibir de al menos una línea.”
- “Debes elegir Total o Parcial para cada orden de la tabla.”
Orden o proveedor no encontrados
Verás este mensaje si la orden no existe, si no tiene líneas pendientes en tu centro, si está fuera del rango de fechas o si el proveedor no tiene órdenes con pendiente. En la búsqueda por proveedor agrega “Recuerda que esta búsqueda solo considera el rango de fechas vigente.”
Si buscaste por proveedor y no hubo coincidencias: “🔍❓ No se encontró ningún proveedor con ese dato. Intenta de nuevo.”
Revisa que escribiste bien el número (prefijo y consecutivo) o el NIT o nombre, y confirma que estás en la sociedad y el centro correctos.
Resultado incierto
Si una solicitud queda como “⏳ Pendiente de verificación”, HandyBot la envió pero no recibió respuesta concluyente. HandyBot no reintenta por su cuenta: crear una entrada duplicada sin saberlo es peor que esperar y verificar.
Antes de hacer cualquier otra cosa con esa orden y centro:
- Escribe verificar OMO4346 25 021 (orden, sociedad y centro) o solo verificar para abrir el formulario.
- Si aparece confirmada en Siesa, ya quedó creada y no tienes que hacer nada más. Si aparece rechazada, corrige y vuelve a intentar. Si sigue incierta, usa “Reintentar envío” desde la tarjeta de resultado o consulta más tarde.
La verificación es de solo lectura: nunca vuelve a enviar nada a Siesa. Solo consultas tus propias solicitudes.
Error inesperado y buenas prácticas
- Revisa el resumen antes de pulsar “Confirmar y enviar”: sociedad, ciudad, orden, modalidad, fecha e ítems.
- Si algún dato es incorrecto, no confirmes: usa “Volver y modificar” o “Cancelar lote”.
- No dupliques solicitudes ante un resultado incierto: verifica primero el estado real.
- Si ves “⚠️ Ocurrió un error inesperado. Intenta de nuevo en unos minutos.”, espera unos minutos y reintenta. Si se repite, escribe a soporte. Anota el mensaje exacto, la orden, la sociedad, el centro y la hora aproximada.
Parte 4
Referencia
Estados del resultado
| ✅ Aprobada | La entrada quedó creada en Siesa. Guarda la referencia de entrada. |
| Rechazada | Siesa no aceptó la solicitud. Revisa el motivo, corrige y vuelve a intentar. |
| Omitida | No se envió, por ejemplo porque el mes aún no está habilitado en Siesa. |
| ⏳ Pendiente de verificación | Resultado incierto. Usa verificar antes de reenviar. |
Comandos
| ayuda | Abre el menú: el flujo de creación de entradas o la lista de comandos. |
| verificar | Consulta en Siesa el estado real de una solicitud pendiente. Es de solo lectura. |
| volver | Regresa un paso. |
| reiniciar | Empieza el flujo de nuevo. |
| finalizar | Termina el flujo actual. |
| cerrar sesion | Cierra tu sesión en HandyBot. |
Términos
| Término | Qué significa |
|---|---|
| HandyBot | Asistente en Microsoft Teams que consulta y crea Recibidos a Satisfacción directamente contra Siesa. |
| Recibido a satisfacción | Confirmación de que el bien o servicio de una orden de compra se recibió. En Siesa queda como una entrada de almacén. |
| Orden de compra | Documento de Siesa que origina la solicitud de bienes o servicios. Se identifica con un prefijo de tipo de documento y un consecutivo, por ejemplo OM14340 u OM14744. Una misma orden puede tener líneas de distintos centros de operación. |
| Sociedad | Compañía del grupo bajo la cual se registran la orden y la entrada. |
| Centro de operación | Ciudad o sede de cada línea de la orden. HandyBot solo muestra las líneas del centro que elegiste en la sesión, sin importar qué centro tenga el encabezado de la orden. |
| Entrada total | Recibe todo lo pendiente de las líneas de la orden que pertenecen al centro elegido. |
| Entrada parcial | Recibes, línea por línea, una cantidad entera mayor que cero y menor o igual al pendiente. |
| Referencia de entrada | Código de la entrada creada en Siesa: centro de operación, tipo de documento y consecutivo, por ejemplo 020EAM3399. Es el dato que debes dar al proveedor. |
| Resultado incierto | Estado que se muestra como “Pendiente de verificación”: HandyBot no recibió una respuesta concluyente de Siesa. No significa que la entrada no se creó. Ver la sección 7. |
Ayuda y soporte
Ayuda dentro de HandyBot
Escribe ayuda para abrir el menú: puedes ver el flujo de creación de entradas o la lista de comandos disponibles. Otros comandos útiles: verificar, cerrar sesion y, en cualquier paso, volver, reiniciar y finalizar.
Qué información enviar a soporte
- Sociedad y centro de operación (ciudad) de la sesión.
- Número de la orden de compra, con su prefijo (por ejemplo
OM14340). - La referencia de entrada, si el resultado llegó a mostrarla.
- En qué paso del flujo ocurrió.
- El mensaje exacto que mostró HandyBot, y la fecha y hora aproximada.
- Una captura de la tarjeta de confirmación o de resultado, y del mensaje de error completo.
Si el resultado fue “Pendiente de verificación”, intenta primero el comando verificar antes de escribir a soporte.
A quién escribir
Acceso a la app
No ves HandyBot en Teams o te dice que no tienes permiso.
Área de Tecnología
jmesias@unico.com.co
Siesa y fallas de HandyBot
Dudas sobre una entrada hecha con HandyBot, o si el bot no responde, muestra un error o se comporta de manera inusual.
Área de Contabilidad
arosero@unico.com.co