Obter o ID do estágio de um Business Process Flow (BPF)

Por vezes precisamos atualizar o estágio de um BPF através de código e/ou Power Automate, por exemplo, mas os ID’s dos estágios de um BPF não são facilmente obtidos no Dynamics. Para ter acesso aos ID’s, assim como a outras informações que podem ser úteis, precisamos realizar uma chamada à seguinte API:

https://<<SUA_ORG_URL>>.dynamics.com/api/data/<<VERSAO>>/processstages?$select=stagename&$filter=processid/workflowid eq <<BPF_GUID>>

Como você deve ter observado, existem alguns trechos que devem ser substituídos pelos seus recpectivos valores. Para facilitar, você pode obter a Root URL indo em:

• Configurações Avançadas >> Personalizações >> Recursos do Desenvolvedor

• URL Raiz do Serviço (Service Root URL)

Com a URL em mãos, é só concatenar com o trecho /processstages?$select=stagename&$filter=processid/workflowid eq <<BPF_GUID>>, onde <<BPF_GUID>> é o GUID do Business Process Flow que você deseja consultar. O resultado será parecido com isso:

Para facilitar a visualização, você pode utilizar uma ferramenta como JSON Viewer:

Abs e até a próxima 😉