====== Beestock ======

Os métodos descritos a seguir são chamados pelo **WMS Beestock** para informar ao ERP Prosyst o que foi executado no armazém: conferência de recebimento, separação de pedidos, separação para produção, ajustes de saldo e cancelamentos de ordens.

O envio no sentido contrário, do ERP para a Beestock (cadastros, pedidos, ordens de produção e solicitações de almoxarifado), é feito pelos agendadores da integração e está documentado em **[[prosyst:developer:instegracoes:beestock|Integração Beestock]]**.

===== Regras Comuns =====

  * Todos os métodos usam **POST** e ficam em ''/api/beestock/<método>'' no serviço web do Prosyst.
  * O header **auth** é obrigatório, com o token adquirido no **[[:enduser:erp:developer:integracao:integracaowebservice:primeirospassos:login|Login]]**. Sem token válido a requisição é recusada com **401**. As movimentações ficam registradas no ERP em nome do usuário desse token.
  * Os produtos são identificados pelo **código editável do material** (o código que o usuário digita no ERP). Os depósitos são identificados pelo **código numérico do local de estoque** no Prosyst.
  * Cada requisição é processada **por inteiro ou não é processada**: se um único item do payload falhar, nada do payload é gravado e a resposta traz o motivo.
  * Os itens do tipo **RTM** (transferência entre materiais) são aceitos nas confirmações e ignorados, sem gravar nada no ERP.
  * Quando o parâmetro ''INTWSLOG_ATIVA_LOGS_DB'' (sistema 98) está ligado, cada chamada fica registrada no log de integrações do ERP, com o corpo recebido e a resposta devolvida.

===== Formato do Retorno =====

Todos os métodos devolvem a mesma estrutura:

^ Campo ^ Tipo ^ Descrição ^
| bemSucedido | Booleano | Indica se a requisição foi processada. |
| mensagemFalha | String | Motivo da recusa. Vazio no sucesso. |
| novoCodigo | String | Códigos gerados no ERP, quando o método os informa (romaneios, movimentos). |
| dados | Lista | Detalhes da recusa: erros de validação dos campos ou ocorrências das regras do ERP. |
| retorno | String | No sucesso, sempre o texto **Arquivo recebido com sucesso!**. Na falha, repete a ''mensagemFalha''. |

^ HTTP ^ Situação ^
| 200 | Requisição processada. |
| 400 | Recusada por validação dos campos, regra do ERP ou corpo incompatível com o modelo. |
| 401 | Token ausente ou inválido. |
| 500 | Falha não prevista durante o processamento. |

===== Parâmetros de Sistema =====

Os parâmetros abaixo precisam estar configurados antes de habilitar os métodos que os utilizam:

^ Parâmetro ^ Sistema ^ Conteúdo ^ Usado em ^
| LOCAL-CONF-BEESTOCK | 17 | Local de estoque de conferência da Beestock | Confirmar Recebimento |
| BEESTOCK-TIPOMOV-TRANSF | 98 | Tipo de movimento de transferência | Confirmar Recebimento, Ajuste de Saldo |
| BEESTOCK-LOCAL-AVARIA | 98 | Local de estoque das quantidades avariadas | Confirmar Recebimento |
| BEESTOCK-LOCAL-DIVERG | 98 | Local de estoque das quantidades divergentes | Confirmar Recebimento |
| BEESTOCK-TIPOMOV-AJUSTE-MAIS | 98 | Tipo de movimento de ajuste a mais | Ajuste de Saldo |
| BEESTOCK-TIPOMOV-AJUSTE-MENOS | 98 | Tipo de movimento de ajuste a menos | Ajuste de Saldo |
| PERM-MOV-OP-ENC | 4 | Permite movimentar requisições de OPs produzidas ou canceladas | Confirmar Separação para Produção |

Os tipos de movimento usados na baixa das SMAs vêm da configuração do **Gerenciador de SMA (PRX036316)**, e não dos parâmetros acima.

===== Métodos =====

{{indexmenu>beestock}}