Consultar roteiros de um item

Autenticação: Authorization: Bearer <chave da API pública Sensio>. O servidor determina a empresa pela chave; não envie company/user no corpo. Não confundir esta chave com o token da API do Apidog. Limite compartilhado de 25 requisições a cada 60 segundos por empresa; ao exceder, HTTP 429 e bloqueio temporário de 150 segundos.

Lista os documentos de roteiro do item informado, dentro da empresa autenticada. O id no caminho é o ID do item, não o ID do roteiro. O único filtro adicional é variation, aplicado quando é um ObjectId válido. Um valor malformado de variation é ignorado pelo controller atual e não gera 400.

Resposta normal: response é um ARRAY de roteiros, inclusive quando só há um. Sem resultados, retorna []. A consulta não filtra status, poId, saleId ou itemRoutingCustom: pode incluir roteiros mestre, roteiros de execução de OPs/pedidos, de outras variações (sem filtro) e removidos. Referências de operações/máquinas/grupos são IDs, sem nomes populados. O cliente deve selecionar o documento conforme seu uso; esta rota não resolve o snapshot de execução de uma OP/cartão.

PCP desabilitado: o formato muda para HTTP 200 com response={operations:[]}. ID do item malformado gera 400; item válido sem roteiros retorna [] mesmo que o cadastro não exista. Sem paginação ou ordenação garantida.

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respostas

🟢200OK

application/json

Consultar roteiros de um item

Bodyapplication/json

Examples

RoteirosSemRoteiroPcpDesabilitado

{
    "success": true,
    "response": [
        {
            "_id": "64f1c0c2a1b2c3d4e5f60715",
            "company": "64f1c0c2a1b2c3d4e5f60717",
            "user": "64f1c0c2a1b2c3d4e5f60716",
            "itemId": "64f1c0c2a1b2c3d4e5f60714",
            "status": "Ativo",
            "referenceQty": 1,
            "defaultDimension": "UN",
            "dateCreated": "2026-11-11T13:00:00.000Z",
            "dateUpdated": "2026-11-11T13:00:00.000Z",
            "itemRoutingCustom": false,
            "operations": [
                {
                    "operationId": "64f1c0c2a1b2c3d4e5f60713",
                    "sequence": 10,
                    "timeSpent": 12.4,
                    "typeTime": "seconds",
                    "setup": 15,
                    "typeSetup": "minutes",
                    "resourceGroup": "64f1c0c2a1b2c3d4e5f60711",
                    "machines": [
                        "64f1c0c2a1b2c3d4e5f60712"
                    ],
                    "partCicle": 1,
                    "pointOutProduction": true,
                    "operationHash": "64f1c0c2a1b2c3d4e5f60724",
                    "ordination": 0
                }
            ]
        }
    ]
}

🟠400Pedido Inválido

🟠402

🟠403Proibido

🟠429

🔴500Erro do Servidor

Consultar roteiros de um item

Requisição

Códigos de solicitação

Respostas