Saltar al contenido principal

Entrada de Produto Acabado (PA)

📌 Descrição do Processo​

A entrada de Produto Acabado (PA) ocorre quando uma Ordem de Produção (OP) é finalizada no SAP B1. O objetivo da integração é garantir que, ao finalizar a OP no ERP, o produto acabado correspondente seja registrado no WMS, com seus lotes e quantidades, assegurando o controle físico do estoque.

O SAP B1 registra a finalização da OP como evento contábil, enquanto o WMS controla a entrada física do PA em seus endereços logísticos.

🔄 Fluxo de Integração​

  1. Finalização da OP (SAP B1)

    • O usuário encerra uma ProductionOrder no SAP B1.
    • Status da OP: Finalizado.

  2. Consulta pelo WMS (GET)

    • O WMS consome a API ProductionOrders do SAP B1, filtrando por status Finalizado.
    • O sistema identifica os PAs finalizados que precisam ser registrados fisicamente no armazém.

  3. Entrada no WMS

    • O operador registra no WMS o lote e as quantidades efetivamente conferidas.
    • Caso haja divergência, o ajuste é feito no WMS (durante inventário ou auditoria interna).

  4. Retorno ao SAP B1 (POST)

    • O WMS envia um POST /InventoryGenEntries, com referência à OP, indicando:

      • Item produzido
      • Quantidade final
      • Lote gerado

  5. Atualização no SAP B1

    • O B1 registra a entrada de estoque vinculada à OP, via InventoryGenEntries.
    • O documento de entrada é criado com baseType=202 (ProductionOrders).

🖥️ APIs Envolvidas​

  • SAP B1 → WMS (GET)

    • Endpoint: /ProductionOrders
    • Filtros: status=Finalizado

  • WMS → SAP B1 (POST)

    • Endpoint: /InventoryGenEntries

    • Parâmetros principais:

      • baseType=202 (indica vínculo com OP)
      • AbsoluteEntry da OP
      • Quantidade e lote

📦 Exemplo de Fluxo (Objeto Fictício)​

Cenário:​

  • Ordem de Produção: OP-32005
  • Item produzido: PA-789 – Bateria Automotiva 60Ah
  • Quantidade planejada: 200 unidades
  • Após produção: 195 unidades produzidas
  • Lote gerado: L2025-002

1. Ordem no SAP B1 (Finalizada)​

{
  "DocEntry": 32005,
  "ProductionOrderStatus": "bopos_Closed",
  "ItemCode": "PA-789",
  "PlannedQuantity": 200,
  "DueDate": "2025-10-09"
}

2. Entrada registrada no WMS​

  • Quantidade: 195 unidades
  • Lote: L2025-002

3. Retorno ao SAP B1 (POST /InventoryGenEntries)​

{
  "DocType": "dDocument_Items",
  "DocDate": "2025-10-09",
  "DocumentLines": [
    {
      "BaseType": 202,
      "BaseEntry": 32005,
      "ItemCode": "PA-789",
      "Quantity": 195,
      "WarehouseCode": "01",
      "BatchNumbers": [
        {
          "BatchNumber": "L2025-002",
          "Quantity": 195
        }
      ]
    }
  ]
}

4. Atualização no SAP B1​

  • Criado documento de entrada de estoque nº 9902 vinculado à OP-32005.
  • Estoque atualizado: 195 unidades no depósito.
  • OP permanece como Finalizada (sem possibilidade de alteração posterior).

✅ Regras de Negócio​

  • A integração deve ocorrer apenas para OPs finalizadas.
  • O campo baseType=202 garante vínculo entre a entrada de estoque e a OP.
  • Controle de lotes: obrigatório informar quando o item estiver configurado com ManageBatchNumbers = tYES.
  • Divergências de produção (ex.: planejado 200, produzido 195) devem ser registradas pelo WMS. O ajuste contábil/fiscal é responsabilidade do SAP B1.
  • Caso a OP seja encerrada sem produção (zero unidades), o WMS não deve gerar InventoryGenEntries.

📌 Resumo: Esse fluxo garante que a finalização da produção no SAP B1 seja refletida no estoque físico do WMS, com rastreabilidade de lotes e consistência de quantidades.