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 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 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.

Tabela de conteúdos

Beestock

Regras Comuns

Formato do Retorno

Parâmetros de Sistema

Métodos