POST - Confirmar Recebimento

Este método recebe da Beestock a conferência e a armazenagem dos documentos de entrada. Para notas fiscais e ordens de produção, o ERP transfere o material do local de conferência para os depósitos informados. Para solicitações de almoxarifado de retorno e de transferência, o ERP dá baixa na SMA. As quantidades avariadas e divergentes são enviadas para os locais de estoque definidos em parâmetro.

/api/beestock/inboundCheck

Exemplo URL

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

Parâmetros do Header

auth	Token adquirido no Login.

Exemplo de Body

{
  "conferences": [
    {
      "orderType": "NFE",
      "orderNumber": "5678",
      "serie": "1",
      "branchCode": "1",
      "lineNumber": 1,
      "productCode": "MP-001234",
      "quantityDamage": 3,
      "quantityDivergence": 4,
      "storages": [
        { "depositCode": "12", "quantityStorage": 2, "lotNumber": "L001", "expirationDate": "2027-03-31T00:00:00" }
      ]
    },
    {
      "orderType": "SMA-R",
      "orderNumber": "45021",
      "branchCode": "1",
      "lineNumber": 1,
      "productCode": "MP-004455",
      "quantityDamage": 2,
      "storages": [
        { "depositCode": "12", "quantityStorage": 4 },
        { "depositCode": "15", "quantityStorage": 2 }
      ]
    },
    {
      "orderType": "SMA-TR",
      "orderNumber": "45100",
      "branchCode": "1",
      "lineNumber": 2,
      "productCode": "MP-007788",
      "storages": [
        { "depositCode": "99", "quantityStorage": 8, "lotNumber": "L010" }
      ]
    }
  ]
}

Explicação dos campos do Body

Nome	Tipo	Obrigatório	Descrição
conferences	Lista	Sim	Conferências realizadas. Pelo menos uma.
orderType	String	Sim	Tipo do documento conferido. Veja a tabela de tipos abaixo.
orderNumber	String	Sim	Número da nota fiscal, da ordem de produção ou da SMA. Deve ser numérico e maior que zero.
serie	String	Não	Série da nota fiscal. Gravada no complemento do movimento (NFE e OP).
branchCode	String	Sim	Código do estabelecimento na Beestock. Precisa ser informado, mas não é usado na gravação.
lineNumber	Inteiro	Sim para SMA	Sequência do item na SMA. Nos demais tipos é usado apenas nas mensagens.
productCode	String	Sim	Código editável do material no ERP.
quantityDamage	Decimal	Não	Quantidade avariada, enviada ao local de avaria.
quantityDivergence	Decimal	Não	Quantidade divergente, enviada ao local de divergência.
storages	Lista	Sim	Armazenagens do item. Pelo menos uma, exceto em SMA-R com avaria ou divergência.

storages

Nome	Tipo	Obrigatório	Descrição
depositCode	String	Sim	Código numérico do local de estoque de destino. Ignorado em SMA-TR.
quantityStorage	Decimal	Sim	Quantidade armazenada. Deve ser maior que zero.
lotNumber	String	Não	Lote. Gravado apenas quando o material controla lote.
expirationDate	Data	Não	Validade do lote.

Os campos supplierCode, depositCode e quantityStorage no nível da conferência são aceitos, mas não são usados.

Tipos de Documento

orderType	O que o ERP faz
NFE, OP	Para cada armazenagem, transfere a quantidade do local de conferência (`LOCAL-CONF-BEESTOCK`) para o depósito informado, com o tipo de movimento `BEESTOCK-TIPOMOV-TRANSF`, lote e validade.
SMA-R	Baixa a SMA de retorno de material, levando cada armazenagem para o depósito informado.
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, SMA-D	Recusados: a separação desses tipos é confirmada pelo Confirmar Separação.

Regras e Observações

Avaria e divergência: as quantidades de quantityDamage e quantityDivergence são transferidas para os locais BEESTOCK-LOCAL-AVARIA e BEESTOCK-LOCAL-DIVERG, sem lote. O parâmetro só é exigido quando a quantidade correspondente é maior que zero.
Saldo da SMA: para SMA-R e SMA-TR, a soma das armazenagens, da avaria e da divergência de cada item, somando todas as linhas do payload, não pode passar do saldo do item na SMA.
Correspondência da SMA: o item da SMA precisa existir na sequência informada, com o mesmo material e com o tipo de movimento correspondente ao orderType. A SMA de transferência precisa ter local de origem e de destino cadastrados.
SMA-TR e o depósito informado: o depositCode enviado não é usado; valem os locais da SMA. O lote e a validade seguem apenas na implantação de saldo devolvida à Beestock.
Para NFE e OP, o saldo precisa estar no local de conferência. Este método não dá entrada na nota fiscal nem aponta a produção.
Reenviar o mesmo payload de NFE ou OP grava a transferência novamente.

Os parâmetros LOCAL-CONF-BEESTOCK e BEESTOCK-TIPOMOV-TRANSF são obrigatórios para NFE e OP. Sem eles, a conferência é recusada.

Exemplos de Retorno

Sucesso

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

Falha

Retorna 400:

{
  "bemSucedido": false,
  "mensagemFalha": "Quantidade conferida (10) maior que o saldo da SMA '45021' na sequência 1 (saldo: 6).",
  "novoCodigo": null,
  "dados": null,
  "retorno": "Quantidade conferida (10) maior que o saldo da SMA '45021' na sequência 1 (saldo: 6)."
}