Listar estágios de ordens de serviço

Retorna estágios ativos do tipo WorkOrder da empresa, ordenados por step, incluindo workOrderCount. A consulta garante os estágios base (Aberta, Em Execução, Aguardando Peça, Finalizada e Cancelada) e vincula OS legadas sem estágio ao estágio correspondente. Podem existir vários estágios com o mesmo linkedStatus. Use o _id retornado como stageId na mudança de estágio. Não há paginação ou filtros específicos. Quando houver permissões no contexto autenticado, exige cvmt.

Autenticação: envie Authorization: Bearer <chave da API pública do Sensio ERP>. Use uma chave atual vinculada a um usuário ativo da empresa; empresa e autoria são determinadas pelo servidor. Não envie company, user, permissões, _id ou histórico para controlar a gravação. IDs documentados são strings hexadecimais de 24 caracteres. Datas devem ser ISO 8601. Textos recebidos são aparados e limitados a 10000 caracteres, salvo indicação específica. A API usa o limite de 25 requisições por minuto por empresa. Chaves revogadas ou substituídas são rejeitadas.

Respostas

🟢200OK

application/json

Operação concluída.

Bodyapplication/json

Exemplo

{
    "success": true,
    "message": "Estágios encontrados",
    "response": [
        {
            "_id": "507f1f77bcf86cd799439006",
            "name": "Aberta",
            "type": "WorkOrder",
            "status": "Ativo",
            "linkedStatus": "OPEN",
            "step": 1,
            "isDefault": true,
            "sortBy": "dueDate",
            "workOrderCount": 0,
            "company": "507f1f77bcf86cd799439001"
        },
        {
            "_id": "507f1f77bcf86cd799439007",
            "name": "Em Execução",
            "type": "WorkOrder",
            "status": "Ativo",
            "linkedStatus": "IN_PROGRESS",
            "step": 2,
            "isDefault": true,
            "sortBy": "dueDate",
            "workOrderCount": 0,
            "company": "507f1f77bcf86cd799439001"
        },
        {
            "_id": "507f1f77bcf86cd799439008",
            "name": "Aguardando Peça",
            "type": "WorkOrder",
            "status": "Ativo",
            "linkedStatus": "WAITING_PART",
            "step": 3,
            "isDefault": true,
            "sortBy": "dueDate",
            "workOrderCount": 0,
            "company": "507f1f77bcf86cd799439001"
        },
        {
            "_id": "507f1f77bcf86cd799439009",
            "name": "Finalizada",
            "type": "WorkOrder",
            "status": "Ativo",
            "linkedStatus": "DONE",
            "step": 4,
            "isDefault": true,
            "sortBy": "createdAt",
            "workOrderCount": 0,
            "company": "507f1f77bcf86cd799439001"
        }
    ]
}

🟠400Pedido Inválido

🟠401Não Autorizado

🟠402

🟠403Proibido

🟠429

🔴500Erro do Servidor

Listar estágios de ordens de serviço

Requisição

Códigos de solicitação

Respostas