Cadastrar ou substituir roteiro de item

Cria ou atualiza o roteiro mestre identificado por itemId e variationId, na empresa da chave, sem poId/saleId. itemId é obrigatório; a variação, se informada, deve pertencer ao item. Não usar esta rota como roteiro de execução de uma OP/cartão.

Substituição integral: enviar todas as operações desejadas, na ordem final. Omitir operations equivale a []; pode remover operações já cadastradas. Cada linha exige operationId e timeSpent; ordination é gerada pela posição no array, começando em 0. O backend gera novos operationHash a cada gravação; repetir o corpo pode alterar esses identificadores mesmo mantendo o _id do roteiro. Não envia nem aceita operationHash/ordination pelo corpo público.

Com engineeringModule=true, cada operação exige sequence e exatamente um de resourceGroup ou service. Sequências informadas não podem repetir mesmo sem engenharia. As referências a operação, grupo, máquinas, serviço, fornecedor e centro de custo são validadas na empresa.

Corpo público permite somente itemId, variationId, referenceQty, defaultDimension, status e operations. Não aceita _id, poId, saleId, user, company, editAllVariations ou campos de composição. defaultDimension/dimension devem ser uma unidade reconhecida (enum no schema).

Remover operações com plano de controle vinculado é bloqueado com 400. A gravação também recalcula custos e ajusta os vínculos de plano de controle; estes efeitos seguem as opções da empresa. Como operationHash é regenerado, um roteiro com plano vinculado pode impedir até uma substituição com a mesma lista de operationId.

Requisição

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples

RoteiroMestreRoteiroDaVariacaoServicoInternoEngenharia

{
    "itemId": "64f1c0c2a1b2c3d4e5f60714",
    "referenceQty": 1,
    "defaultDimension": "UN",
    "operations": [
        {
            "operationId": "64f1c0c2a1b2c3d4e5f60713",
            "sequence": 10,
            "timeSpent": 12.4,
            "typeTime": "seconds",
            "setup": 15,
            "typeSetup": "minutes",
            "resourceGroup": "64f1c0c2a1b2c3d4e5f60711",
            "machines": [
                "64f1c0c2a1b2c3d4e5f60712"
            ],
            "partCicle": 1,
            "pointOutProduction": true
        }
    ]
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respostas

🟢200OK

application/json

Cadastrar ou substituir roteiro de item

Bodyapplication/json

Exemplo

{
    "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

🟠404Registo Não Encontrado

🟠429

🔴500Erro do Servidor