Seguimos ampliando las posibilidades de la API pública v2 en RO App. Ahora, a través de la API, puedes gestionar las tareas de los empleados, configurar niveles mínimos y máximos de stock de los productos en los almacenes y vincular con más precisión las facturas con las órdenes. Esto te ayudará a sincronizar los datos con otros sistemas sin introducirlos manualmente. Además, hay nuevos webhooks para tareas.
Tareas a través de la API
La API pública v2 incluye ahora endpoints para trabajar con tareas. Admiten los estados y la prioridad de las tareas, por lo que los datos de la API coinciden con lo que ves en RO App.
Ahora puedes:
obtener la lista de tareas o una tarea concreta – con su nombre, descripción, estado, prioridad, autor, responsables, fecha de vencimiento y registro vinculado;
crear, editar y eliminar tareas;
cambiar el estado de una tarea y añadirle comentarios;
obtener la lista de estados de las tareas.
Puedes filtrar las tareas por estado, prioridad, autor, responsables, fecha de creación y fecha de vencimiento. También hay filtros independientes para las tareas atrasadas y las tareas sin responsable. Puedes ordenar la lista por fecha de creación, fecha de modificación, fecha de vencimiento o prioridad.
Ten en cuenta: una tarea nueva siempre se crea en el estado inicial, que puedes cambiar con una solicitud aparte. A través de la API solo puedes establecer un estado disponible para el rol del empleado, igual que en la versión web. El cambio de estado a través de la API se registra en la tarea igual que un cambio manual.
También hemos añadido nuevos webhooks para tareas – de cambio de estado y de prioridad. Así, otros sistemas se enteran al instante, sin solicitudes periódicas a la API. Para conectarlos, al configurar el webhook, selecciona los eventos "Estado modificado" y "Prioridad actualizada" en el bloque "Tareas".
Más información en la documentación de los endpoints de tareas.
Niveles mínimos y máximos de stock
Ahora puedes configurar los niveles mínimos y máximos de stock de los productos a través de la API – por separado para cada almacén. Puedes:
obtener los niveles mínimos y máximos de stock de un producto en todos los almacenes o en un almacén concreto;
establecerlos y modificarlos para un almacén;
eliminarlos para un almacén si ya no los necesitas.
Los productos con stock por debajo del mínimo aparecen en la página "Productos para pedir". Si planificas las compras en otro sistema, puedes transferir estos ajustes desde él automáticamente en lugar de rellenar las fichas de producto manualmente.
Más información en la documentación de los endpoints de niveles mínimos y máximos de stock.
Facturas y órdenes
También hemos mejorado los endpoints para trabajar con facturas, para que te resulte más fácil vincular las facturas con las órdenes. Ahora:
las líneas de la factura incluyen el ID de la orden desde la que se añadieron;
puedes filtrar la lista de facturas por orden – obtendrás todas las facturas que contengan al menos una línea de esa orden;
con un nuevo endpoint puedes añadir a una factura líneas de órdenes.
Más información en la documentación del endpoint para añadir líneas de órdenes a una factura.
Cómo ayudarán los nuevos endpoints a tu negocio
Por ejemplo, con ellos puedes:
sincronizar las tareas con gestores de tareas y calendarios de los empleados;
crear tareas automáticamente a partir de eventos en otros sistemas – por ejemplo, un recordatorio para devolver la llamada a un cliente;
crear informes propios sobre el cumplimiento y los retrasos de las tareas;
actualizar a la vez los niveles mínimos y máximos de stock de muchos productos y almacenes – por ejemplo, antes de la temporada;
facturar automáticamente las líneas de las órdenes y comprobar si ya se ha facturado todo al cliente.
Acceso a los endpoints
La clave API pertenece a un empleado concreto de RO App y tiene los mismos permisos de acceso que él. Por ejemplo, para trabajar con tareas a través de la API, el empleado necesita los permisos correspondientes en su rol: ver, crear, editar o eliminar tareas.
Si tienes preguntas, sugerencias o comentarios sobre la API pública y los webhooks de RO App, escríbenos en el chat de soporte.