Listar ordens de serviço

Lista somente OS não removidas da empresa. Retorna response, total, page e limit no nível principal. A página padrão é 1, o limite padrão é 50 e o máximo efetivo é 500. assetId, planId, assignedToPersonIds e stage são expandidos com os campos resumidos indicados no schema; referências ausentes podem resultar em null. DONE_API é um status válido de filtro. Objetos com operadores MongoDB, datas inválidas e IDs malformados são rejeitados. Quando houver permissões no contexto autenticado, exige cvmt (visualizar manutenção).

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

Página de resultadosSem resultados

{
    "success": true,
    "response": [
        {
            "_id": "507f1f77bcf86cd799439010",
            "code": "OS-0010",
            "assetId": {
                "_id": "507f1f77bcf86cd799439003",
                "name": "Prensa hidráulica",
                "code": "MAQ-01",
                "status": "Ativo"
            },
            "planId": null,
            "workType": "CORRECTIVE",
            "origin": "MANUAL",
            "priority": "MEDIUM",
            "status": "OPEN",
            "stage": {
                "_id": "507f1f77bcf86cd799439006",
                "name": "Aberta",
                "linkedStatus": "OPEN",
                "step": 1
            },
            "dueDate": null,
            "startedAt": null,
            "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"
        }
    ],
    "total": 1,
    "page": 1,
    "limit": 50
}

🟠400Pedido Inválido

🟠401Não Autorizado

🟠402

🟠403Proibido

🟠429

🔴500Erro do Servidor

Listar ordens de serviço

Requisição

Códigos de solicitação

Respostas