WebAPI – Obter ordens de trabalho e técnicos que pertencem às oficinas nas quais o utilizador autenticado é responsável

WebAPI – Obter ordens de trabalho e técnicos que pertencem às oficinas nas quais o utilizador autenticado é responsável

Este métoto devolve a lista de ordens de trabalho e técnicos que pertencem ás oficinas nos quais o utilizador autenticado é responsável.

O métodos a utilizar para obter a lista são:
  1. GET /api/mytenant/myorganization/maintenance/planners/getplanneritems?start=2019-03-01&end=2019-04-01
  2. GET /api/mytenant/myorganization/maintenance/planners/getplanneritems?start=2019-03-01&end=2019-04-01&maxRecords=100
  3. GET /api/mytenant/myorganization/maintenance/planners/getplanneritems?start=2019-03-01&end=2019-04-01&stateKey=003WORKORDER;004&workShopKey=MN;OT&technicianKey=0006;0007

O método recebe a data de início e fim para filtrar as Ordens de Trabalho pela data esperada. 
Se o parâmetro maxRecords não for especificado, devolve no máximo 100 registos. Os parâmetros stateKey, workShopKey e technicianKey são opcionais e permitem definir uma lista de valores separados por “;”. A lófica é a seguinte:
  1. stateKey: devolve todas as OTs com estes estados
  2. workShopKey: devolve todas as OTs destas oficinas, e os funcionários pertencentes às mesmas.
  3. technicianKey: devolve as OTs atribuídas a estes técnicos, e na lista de funcionários devolve apenas estes.

O servidor devolve uma resposta HttpStatusCode.OK, com as ordens de trabalho e o técnicos, com data esperada entre as datas de início e fim, os técnicos atribuídos a essas OTs e todos os técnicos das oficinas do utilizador autenticado, com as respetivas oficinas e especialidades.
Se o parâmetro maxRecords for especificado e o valor for inferior a 100, devolve esse número de registos. Se o valor do parâmetro for superior a 100, devolve uma mensagem de erro.
A descrição do estado da OT é devolvida no idioma do utilizador.

    • Related Articles

    • WebAPI – Obter Ordens de trabalho atribuídas ao funcionário

      Este métoto devolve a lista de ordens de trabalho atribuidas a cada funcionário de uma determinada empresa. O método a utilizar para a obter a lista de ordens de trabalho atribuídas ao funcionário é: GET ...

    • WebAPI – Como criar ordens de trabalho?

      Este método oferece uma forma simplificada de criar uma Ordem de Trabalho para um determinado Ativo, Localização, Ferramenta ou Rota. O método a utilizar para a criação de uma ordem de trabalho é : POST ...

    • WebAPI - Como obter o registo da webapi?

      No momento em que é realizada a subscrição no Valuekeep CMMS o subscriber recebe um email com as credenciais da subscrição, compostas por client_Id e um Cliente_Secret. Estas credencias devem ser guardadas, caso contrário não será possível utilizar a ...

    • WebAPI – Alterar estado da ordem de trabalho

      Este método permite efetuar a mudança de estado de uma ordem de trabalho. O método a utilizar para a alteração de estado da ordem de trabalho é: Post {{url}/api/{{tenant}}/{{organization}}/maintenance/workorders/changeSchemaEntityState/{{companyKey}} ...

    • WebAPI – Atualizar Registo de Mão de Obra

      Este método permite alterar o registo de mão de obra uma ordem de trabalho. O método a utilizar para a alteração do registo de mão de obra é: POST /api/mytenant/myorganization/maintenance/workorderreportlabors/ ...