API :: PATCH Adiciona linha de conteúdo no Roteiro

Permite alterar o roteiro, adicionando uma linha de conteúdo, quando necessário.

Endpoint: PATCH /api/v1/producao/roteiro/{codigoRoteiro}/operacao/{codigoOperacao}/sequencia/{sequenciaOperacao}

Parâmetros de rota (path)

Campo

Tipo

Obrigatório

Descrição / validação

codigoRoteiro

integer¹

Sim

Código do roteiro. Deve aceitar valores alfanuméricos.

codigoOperacao

string

Sim

Código da operação. Deve aceitar valores alfanuméricos e corresponder a uma operação já cadastrada.

sequenciaOperacao

integer

Sim

Sequência da operação. Apenas valores numéricos inteiros.

Nota

¹ O documento de origem declara codigoRoteiro como integer, mas a regra de validação pede caracteres alfanuméricos — mesma inconsistência do endpoint de consulta, vale checar com o autor.

Corpo da requisição (Request Body)

{
  "modeloAnalise": "",
  "desconsiderarLeadTime": true,
  "dataInicio": "2024-11-14",
  "horaInicio": 0,
  "dataTermino": "2024-11-14",
  "horaTermino": 0,
  "linhasOperacao": [
    {
      "tipoRecurso": "",
      "codigoRecurso": "",
      "quantidadeBase": 0,
      "quantidadeFixa": 0,
      "quantidadePlanejada": 0,
      "tempoFixo": 0,
      "tempoVariavel": 0,
      "tempoPlanejado": 0,
      "dimensao1": 0,
      "dimensao2": 0,
      "depositoComponente": "",
      "metodoBaixa": "",
      "dataInicio": "2024-11-14",
      "horaInicio": 0,
      "dataTermino": "2024-11-14",
      "horaTermino": 0,
      "observacao": "",
      "observacao2": "",
      "percentualPerda": 0,
      "recursos": [
        {
          "codigoRecurso": ""
        }
      ]
    }
  ]
}

Campos do corpo

Campo

Obrigatório

Descrição / validação

modeloAnalise

Não

Modelo de análise vinculado ao roteiro. Pode ser vazio ou um modelo já cadastrado.

desconsiderarLeadTime

Sim

Indica se o lead time é desconsiderado na programação. true ou false.

Dentro de linhasOperacao (uma ou mais linhas por operação):

Campo

Obrigatório

Descrição / validação

tipoRecurso

Não

Classificação do recurso utilizado na operação.

codigoRecurso

Sim, se recursos estiver preenchido

Código do recurso vinculado à operação — deve ser um código já cadastrado.

quantidadeBase / quantidadeFixa

Quantidades envolvidas na operação. Devem ser maiores que zero.

tempoFixo / tempoVariavel

Sim

Tempos de produção estimados, em minutos. Devem ser valores positivos.

dimensao1 / dimensao2

Não

Dimensões do componente, quando aplicável.

depositoComponente

Não

Depósito onde os componentes serão consumidos — deve ser um depósito válido no sistema.

metodoBaixa

Sim

Método de baixa do componente na produção. Exemplos: Automático, Manual.

observacao / observacao2

Não

Campos livres para observações sobre a operação.

percentualPerda

Não

Percentual estimado de perda na operação. De 0 a 100%.

Erros

Condição

Mensagem

codigoOperacao não informado

BR One :: Erro Campo não pode ser nulo. Informar um valor válido.

codigoOperacao não corresponde a uma operação cadastrada

BR One :: Erro Favor informar operações válidas.

sequenciaOperacao não informado

BR One :: Erro Campo não pode ser nulo. Informar um valor válido.

Autenticação, headers, response e códigos HTTP

Importante

[INFORMAÇÃO NÃO ENCONTRADA] — não definidos na especificação de origem.

Veja também

  • api-roteiro-consultar

  • api-roteiro-atualizar

  • api-roteiro-excluir-linha