Continuamos a expandir as possibilidades da API pública v2 no RO App. Agora, através da API, pode gerir as tarefas dos funcionários, definir níveis mínimos e máximos de stock dos produtos nos armazéns e associar com mais precisão as faturas às ordens. Isto ajuda a sincronizar os dados com outros sistemas sem os introduzir manualmente. Além disso, há novos webhooks para tarefas.
Tarefas através da API
A API pública v2 passou a incluir endpoints para trabalhar com tarefas. Estes suportam os status e a prioridade das tarefas, pelo que os dados na API correspondem ao que vê no RO App.
Agora pode:
obter a lista de tarefas ou uma tarefa específica – com nome, descrição, status, prioridade, autor, responsáveis, data de vencimento e registo associado;
criar, editar e eliminar tarefas;
alterar o status de uma tarefa e adicionar-lhe comentários;
obter a lista de status das tarefas.
Pode filtrar as tarefas por status, prioridade, autor, responsáveis, data de criação e data de vencimento. Existem também filtros separados para tarefas atrasadas e tarefas sem responsável. Pode ordenar a lista por data de criação, data de alteração, data de vencimento ou prioridade.
Atenção: uma nova tarefa é sempre criada no status inicial, que pode ser alterado com um pedido separado. Através da API, só pode definir um status disponível para a função do funcionário, tal como na versão web. A alteração de status através da API fica registada na tarefa da mesma forma que uma alteração manual.
Também adicionámos novos webhooks para tarefas – para alterações de status e de prioridade. Assim, outros sistemas ficam a saber de imediato, sem pedidos regulares à API. Para os ligar, ao configurar o webhook, selecione os eventos "Status alterado" e "Prioridade alterada" no bloco "Tarefas".
Mais informações na documentação dos endpoints de tarefas.
Níveis mínimos e máximos de stock
Agora pode definir os níveis mínimos e máximos de stock dos produtos através da API – separadamente para cada armazém. Pode:
obter os níveis mínimos e máximos de stock de um produto em todos os armazéns ou num armazém específico;
defini-los e alterá-los para um armazém;
removê-los de um armazém, se já não forem necessários.
Os produtos com stock abaixo do mínimo aparecem na página "Produtos a encomendar". Se planeia as compras noutro sistema, pode transferir estas definições a partir dele automaticamente, em vez de preencher as fichas dos produtos manualmente.
Mais informações na documentação dos endpoints de níveis mínimos e máximos de stock.
Faturas e ordens
Também melhorámos os endpoints para trabalhar com faturas, para que seja mais fácil associar as faturas às ordens. Agora:
os itens da fatura contêm o ID da ordem a partir da qual foram adicionados;
pode filtrar a lista de faturas por ordem – obtém todas as faturas que contêm pelo menos um item dessa ordem;
com um novo endpoint, pode adicionar a uma fatura itens de ordens.
Mais informações na documentação do endpoint para adicionar itens de ordens a uma fatura.
Como os novos endpoints ajudam o seu negócio
Por exemplo, com eles pode:
sincronizar tarefas com gestores de tarefas e calendários dos funcionários;
criar tarefas automaticamente com base em eventos noutros sistemas – por exemplo, um lembrete para ligar de volta a um cliente;
criar relatórios próprios sobre a execução e os atrasos das tarefas;
atualizar em simultâneo os níveis mínimos e máximos de stock de muitos produtos e armazéns – por exemplo, antes da época;
faturar automaticamente itens de ordens e verificar se já foi tudo faturado ao cliente.
Acesso aos endpoints
A chave API pertence a um funcionário específico do RO App e tem as mesmas permissões de acesso que ele. Por exemplo, para trabalhar com tarefas através da API, o funcionário precisa das permissões correspondentes na sua função: ver, criar, editar ou eliminar tarefas.
Se tiver dúvidas, sugestões ou comentários sobre a API pública e os webhooks do RO App, contacte-nos através do chat de suporte.