Alterar estágio de ordem de serviço

Move uma OS não removida para um estágio ativo WorkOrder da mesma empresa. Exige stageId; consulte os IDs em GET /stages/work-orders. Transições permitidas entre status: OPEN → IN_PROGRESS/CANCELED; IN_PROGRESS → WAITING_PART/DONE/CANCELED; WAITING_PART → IN_PROGRESS/CANCELED; DONE_API → DONE. DONE e CANCELED não permitem saída por esta rota. Trocar de coluna mantendo o mesmo linkedStatus altera apenas estágio e histórico de estágio. Enviar o estágio atual retorna a OS sem alteração. Para WAITING_PART, waitingPartNotes é obrigatório e não vazio. Para DONE, actualDurationMinutes deve ser positivo, resolutionNotes é obrigatório e o checklist precisa estar completo. A finalização normal valida disponibilidade das peças, gera baixas de estoque e recalcula custos; não repita automaticamente chamadas de finalização após timeout sem consultar o estado atual. Na finalização, omitir partsUsed preserva as peças existentes; null ou [] substitui por lista vazia. Campos de conclusão são aplicados apenas na transição para DONE. Quando houver permissões no contexto autenticado, exige cemt.

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.

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respostas

🟢200OK

application/json

Operação concluída.

Bodyapplication/json

Examples

Em execuçãoFinalizada normalmente

{
    "success": true,
    "response": {
        "_id": "507f1f77bcf86cd799439010",
        "code": "OS-0010",
        "assetId": "507f1f77bcf86cd799439003",
        "planId": null,
        "workType": "CORRECTIVE",
        "origin": "MANUAL",
        "priority": "MEDIUM",
        "status": "IN_PROGRESS",
        "stage": "507f1f77bcf86cd799439007",
        "dueDate": null,
        "startedAt": "2026-11-07T12:00:00.000Z",
        "finishedAt": null,
        "isAPIDone": false,
        "estimatedDurationMinutes": 60,
        "actualDurationMinutes": null,
        "requestedByUserId": "507f1f77bcf86cd799439002",
        "assignedToUserId": null,
        "assignedToPersonIds": [],
        "description": "Inspecionar ruído no motor",
        "resolutionNotes": "",
        "partsUsedNotes": "",
        "waitingPartNotes": "",
        "partsUsed": [],
        "laborCost": 0,
        "partsCost": 0,
        "externalServiceCost": 0,
        "totalCost": 0,
        "statusHistory": [
            {
                "fromStatus": null,
                "toStatus": "OPEN",
                "changedAt": "2026-11-07T12:00:00.000Z",
                "changedByUserId": "507f1f77bcf86cd799439002",
                "note": "OS criada"
            }
        ],
        "stageHistory": [],
        "deletedAt": null,
        "company": "507f1f77bcf86cd799439001",
        "user": "507f1f77bcf86cd799439002",
        "createdAt": "2026-11-07T12:00:00.000Z",
        "updatedAt": "2026-11-07T12:00:00.000Z"
    }
}

🟠400Pedido Inválido

🟠401Não Autorizado

🟠402

🟠403Proibido

🟠404Registo Não Encontrado

🟠429

🔴500Erro do Servidor

Alterar estágio de ordem de serviço

Requisição

Códigos de solicitação

Respostas