Manual de uso

Registra Recibidos a Satisfacción con HandyBot

Cómo crear una entrada en Siesa desde Teams, paso a paso, y qué hacer cuando algo no sale como esperabas. Las tarjetas son ejemplos con datos ficticios: no se pueden pulsar.

¿Qué necesitas?

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”.

  1. Preparar la sesiónInicio, sociedad y centro
  2. Encontrar la ordenBúsqueda y resultados
  3. Indicar qué recibesTotal o parcial y cantidades
  4. Confirmar y revisarResumen y resultado
Fase 1

Preparar la sesión

  1. 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.”

  2. 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].”

  3. 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.

Fase 2

Encontrar la orden

  1. 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 OM14340 u OM14744. 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.

  2. 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.

Fase 3

Indicar qué recibes

  1. 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.

  2. 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.

Fase 4

Confirmar y revisar

  1. 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”:

  2. 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.

  3. 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 vesQué 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ónNo 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:

  1. Escribe verificar OMO4346 25 021 (orden, sociedad y centro) o solo verificar para abrir el formulario.
  2. 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

✅ AprobadaLa entrada quedó creada en Siesa. Guarda la referencia de entrada.
RechazadaSiesa no aceptó la solicitud. Revisa el motivo, corrige y vuelve a intentar.
OmitidaNo se envió, por ejemplo porque el mes aún no está habilitado en Siesa.
⏳ Pendiente de verificaciónResultado incierto. Usa verificar antes de reenviar.

Comandos

ayudaAbre el menú: el flujo de creación de entradas o la lista de comandos.
verificarConsulta en Siesa el estado real de una solicitud pendiente. Es de solo lectura.
volverRegresa un paso.
reiniciarEmpieza el flujo de nuevo.
finalizarTermina el flujo actual.
cerrar sesionCierra tu sesión en HandyBot.

Términos

TérminoQué significa
HandyBotAsistente en Microsoft Teams que consulta y crea Recibidos a Satisfacción directamente contra Siesa.
Recibido a satisfacciónConfirmació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 compraDocumento 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.
SociedadCompañía del grupo bajo la cual se registran la orden y la entrada.
Centro de operaciónCiudad 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 totalRecibe todo lo pendiente de las líneas de la orden que pertenecen al centro elegido.
Entrada parcialRecibes, línea por línea, una cantidad entera mayor que cero y menor o igual al pendiente.
Referencia de entradaCó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 inciertoEstado 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