Seguimos ampliando las posibilidades de la API pública v2 en Orderry. 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 capturarlos manualmente. Además, hay nuevos webhooks para tareas.
Tareas a través de la API
La API pública v2 ahora incluye 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 Orderry.
Ahora puedes:
obtener la lista de tareas o una tarea específica – 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 agregarle 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 agregamos 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 específico;
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 planeas las compras en otro sistema, puedes transferir estos ajustes desde él automáticamente en lugar de llenar 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 mejoramos 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 agregaron;
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 agregar a una factura líneas de órdenes.
Más información en la documentación del endpoint para agregar 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 devolverle la llamada a un cliente;
crear reportes propios sobre el cumplimiento y los retrasos de las tareas;
actualizar al mismo tiempo 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 revisar si ya se le facturó todo al cliente.
Acceso a los endpoints
La clave API pertenece a un empleado específico de Orderry 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 Orderry, escríbenos en el chat de soporte.