POST - Confirmar Separação para Produção

Este método recebe da Beestock a separação de materiais para a produção. Para ordens de produção, o ERP registra o atendimento da requisição de materiais da OP, incluindo o material na requisição quando ele ainda não consta nela. Para solicitações de almoxarifado de requisição, devolução a fornecedor e transferência, o ERP dá baixa na SMA, da mesma forma que o Confirmar Separação.

/api/beestock/confirmPickingProduction

Exemplo URL

<IP do Serviço>:<Porta liberada para o serviço>/api/beestock/confirmPickingProduction

Parâmetros do Header

auth	Token adquirido no Login.

Exemplo de Body

{
  "pickingConfirmProduction": [
    {
      "branchCode": "1",
      "orderType": "OP",
      "orderProduction": "500",
      "products": [
        {
          "lineNumber": 1,
          "productCode": "MP-100",
          "allocations": [
            { "depositCode": "10", "checkedQuantity": 5, "lotNumber": "L20260901" }
          ]
        }
      ]
    },
    {
      "branchCode": "1",
      "orderType": "SMA-D",
      "orderProduction": "3325",
      "products": [
        {
          "lineNumber": 2,
          "productCode": "MP-220",
          "allocations": [
            { "depositCode": "10", "checkedQuantity": 4 },
            { "depositCode": "11", "checkedQuantity": 2 }
          ]
        }
      ]
    }
  ]
}

Explicação dos campos do Body

Nome	Tipo	Obrigatório	Descrição
pickingConfirmProduction	Lista	Sim	Separações realizadas. Pelo menos uma.
branchCode	String	Sim	Código do estabelecimento na Beestock. Precisa ser informado, mas não é usado na gravação.
orderType	String	Sim	Tipo do documento. Veja a tabela de tipos abaixo.
orderProduction	String	Sim	Número da ordem de produção ou da SMA. Para OP, deve ser numérico e maior que zero.
products	Lista	Sim	Materiais separados. Pelo menos um.

products

Nome	Tipo	Obrigatório	Descrição
lineNumber	Inteiro	Sim para SMA	Sequência do item na SMA. Na OP é usado apenas nas mensagens.
productCode	String	Sim	Código editável do material no ERP.
allocations	Lista	Sim	Depósitos e quantidades separadas. Pelo menos uma.

allocations

Nome	Tipo	Obrigatório	Descrição
depositCode	String	Sim	Código numérico do local de estoque de onde saiu o material.
checkedQuantity	Decimal	Sim	Quantidade separada. Deve ser maior que zero.
lotNumber	String	Não	Lote. Na OP, gravado quando o material controla lote. Na SMA-TR, segue na implantação de saldo.
expirationDate	Data	Não	Validade do lote. Usada apenas na implantação de saldo da SMA-TR.

Os campos orderNumber, sequence, depositCode, customerCode, customerOrderCode, grossWeight, netWeight e volumes do documento, e orderNumber, depositCode, checkedQuantity e serialNumber do produto, são aceitos, mas não são usados. O número do documento é sempre o de orderProduction.

Tipos de Documento

orderType	O que o ERP faz
OP	Registra o atendimento da requisição de materiais da OP, com um movimento de requisição a partir do depósito de cada alocação. Se o material não consta na requisição, ele é incluído antes, com a quantidade necessária igual ao total separado.
SMA	Baixa a SMA de requisição, com saída do depósito informado.
SMA-D	Baixa a SMA de devolução a fornecedor, com saída do depósito informado. Antes da baixa, confere se há saldo do material em cada depósito.
SMA-TR	Baixa a SMA de transferência do local de origem para o local de destino cadastrados na SMA. Em seguida, o saldo é implantado na Beestock no local de destino.
RTM	Ignorado. Um payload só com RTM é respondido com sucesso, sem gravar nada.
SMA-R	Recusado: o retorno de material é confirmado pelo Confirmar Recebimento.

Regras e Observações

Situação da OP: ordens de produção Produzidas ou Canceladas são recusadas, a menos que o parâmetro PERM-MOV-OP-ENC (sistema 4) esteja ligado.
Material já requisitado: quando o material já consta na requisição da OP, a quantidade necessária não é alterada; o método só registra o atendimento.
Linhas repetidas: várias linhas do mesmo material na mesma OP são somadas.
Transferência para a produção: com o parâmetro REQUIS-MAT-LOCAL-PRODUCAO (sistema 4) ligado, o movimento da OP passa a ser uma transferência do depósito informado para o local de produção parametrizado.
Estoque negativo: com o parâmetro PERM-CONTR-EST-NEG (sistema 16) ligado, as verificações de saldo negativo na requisição não são feitas.
As regras de saldo, tipo de movimento e locais da SMA são as mesmas do Confirmar Separação.
Em caso de sucesso, novoCodigo traz as sequências dos movimentos de requisição gerados, separadas por “; ”.

Neste método o número do documento vai sempre em orderProduction, inclusive para as SMAs. O campo orderNumber é ignorado.

Exemplos de Retorno

Sucesso

{
  "bemSucedido": true,
  "mensagemFalha": null,
  "novoCodigo": "88214",
  "dados": null,
  "retorno": "Arquivo recebido com sucesso!"
}

Falha

Retorna 400:

{
  "bemSucedido": false,
  "mensagemFalha": "Falha ao consumir o material 'MP-100' na OP 500 (linha 1).",
  "novoCodigo": null,
  "dados": [
    {
      "tipo": 2,
      "codigoErro": null,
      "descricao": "Ordem de produção 500 já produzida.",
      "nomeCampo": null,
      "detalhes": null,
      "acaoExecutar": null,
      "registro": null
    }
  ],
  "retorno": "Falha ao consumir o material 'MP-100' na OP 500 (linha 1)."
}