====== POST - Ajuste de Saldo de Estoque ======

Este método recebe da Beestock os **ajustes de inventário e as movimentações internas** feitas no armazém. Conforme os depósitos informados, o ERP grava um ajuste a mais, um ajuste a menos ou uma transferência entre locais de estoque.

<code>
/api/beestock/stockAdjustment
</code>

===== Exemplo URL =====

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

===== Parâmetros do Header =====

|auth|Token adquirido no [[..:primeirospassos:login|]].|

===== Exemplo de Body =====

<code json>
{
  "adjustments": [
    { "type": "AJUSTE", "branchCode": "1", "depositIn": "12", "productCode": "MP-001234", "quantity": 5, "orderNumber": "200" },
    { "type": "AJUSTE", "branchCode": "1", "depositOut": "12", "productCode": "MP-004455", "quantity": 3, "orderNumber": "INV-201" },
    { "type": "TRANSFERENCIA", "branchCode": "1", "depositOut": "12", "depositIn": "15", "productCode": "MP-007788", "quantity": 5, "orderNumber": "202" }
  ]
}
</code>

==== Explicação dos campos do Body ====

^ Nome ^ Tipo ^ Obrigatório ^ Descrição ^
| adjustments | Lista | Sim | Ajustes realizados. Pelo menos um. |
| type | String | Sim | Tipo da movimentação na Beestock. É gravado no complemento do movimento, mas não define a regra aplicada. |
| branchCode | String | Sim | Código do estabelecimento na Beestock. Precisa ser informado, mas não é usado na gravação. |
| productCode | String | Sim | Código editável do material no ERP. |
| orderNumber | String | Sim | Número do documento na Beestock. Deve conter um número maior que zero; apenas os dígitos são gravados (''INV-201'' é gravado como 201). |
| quantity | Decimal | Sim | Quantidade ajustada. Deve ser maior que zero. |
| depositOut | String | Um dos dois | Código numérico do local de estoque de saída. |
| depositIn | String | Um dos dois | Código numérico do local de estoque de entrada. |

===== Tipo de Movimentação =====

A regra aplicada depende apenas dos depósitos preenchidos:

^ Depósitos informados ^ O que o ERP faz ^ Parâmetro ^
| Só ''depositIn'' | Ajuste a mais no local de entrada. | ''BEESTOCK-TIPOMOV-AJUSTE-MAIS'' |
| Só ''depositOut'' | Ajuste a menos no local de saída. O saldo do local precisa ser suficiente. | ''BEESTOCK-TIPOMOV-AJUSTE-MENOS'' |
| ''depositOut'' e ''depositIn'' | Transferência do local de saída para o local de entrada. Os dois precisam ser diferentes. | ''BEESTOCK-TIPOMOV-TRANSF'' |

===== Regras e Observações =====

  * Os ajustes a mais e a menos são gravados primeiro. As transferências só são gravadas se todos os ajustes forem aceitos.
  * O método não trata lote nem validade.
  * Em caso de sucesso, **novoCodigo** traz os códigos dos movimentos gerados, separados por "; ".

<note important>Os parâmetros de tipo de movimento correspondentes a cada caso precisam estar configurados. Sem eles, o ajuste é recusado.</note>

===== Exemplos de Retorno =====

=== Sucesso ===

<code json>
{
  "bemSucedido": true,
  "mensagemFalha": null,
  "novoCodigo": "1045; 1046; 1047",
  "dados": null,
  "retorno": "Arquivo recebido com sucesso!"
}
</code>

=== Falha ===

Retorna **400**:

<code json>
{
  "bemSucedido": false,
  "mensagemFalha": "Depósito de entrada '77' inexistente no Prosyst (produto MP-001234, documento 200).",
  "novoCodigo": null,
  "dados": null,
  "retorno": "Depósito de entrada '77' inexistente no Prosyst (produto MP-001234, documento 200)."
}
</code>