A ferramenta de Utilização de um produto empenhado (get_product_allocation_usage) fornece informações sobre quais ordens de produção irão utilizar determinado produto em sua lista de empenhos, e também fornece informações sumarizadas do saldo total de empenho do produto e o total de ordens de produção que possuem este produto empenhado.
Esta ferramenta é capaz de interagir com solicitações semelhantes a:
Esta ferramenta utiliza os seguintes argumentos para sua execução:
| Argumento | Descrição | Obrigatório? |
|---|---|---|
| product_code | Código do produto para busca dos empenhos | Sim |
A ferramenta irá retornar as informações a seguir:
| Cabeçalho | ||
|---|---|---|
| Campo | Descrição | Origem da informação |
| product_code | Código do produto | B1_COD |
| product_description | Descrição do produto | B1_DESC |
| product_unit_measure | Unidade de medida do produto | B1_UM |
| production_orders_list | Lista de ordens de produção que possuem o produto empenhado | Lista de ordens de produção |
| Lista de ordens de produção (production_orders_list) | ||
|---|---|---|
| Campo | Descrição | Origem da informação |
| production_order_code | Código da ordem de produção | D4_OP |
| production_order_product | Código do produto da ordem de produção | D4_PRODUTO |
| production_order_product_description | Descrição do produto da ordem de produção | B1_DESC |
| production_order_allocation_balance | Saldo do empenho para a ordem de produção | Somatório de D4_QUANT para o produto empenhado na ordem de produção |
| production_order_product_unit_measure | Unidade de medida do produto da ordem de produção | B1_UM |
| allocation_date_list | Lista dos empenhos da ordem por data | |
| Lista das ordens que consomem o saldo do lote (production_orders_list) | ||
|---|---|---|
| Campo | Descrição | Origem da informação |
| production_order_code | Código da ordem de produção | D4_OP |
| production_order_product | Produto da ordem de produção | D4_PRODUTO |
| allocation_balance | Quantidade do empenho a ser consumido | D4_QUANT |
| allocation_date | Data do empenho | D4_DATA |
Para identificar em quais ordens determinado lote será utilizado, é verificado os armazéns onde o lote existe. Em seguida, com os armazéns e o código do lote, é realizada a busca por empenhos registrados para o produto (D4_COD), armazém (D4_LOCAL) e lote (D4_LOTECTL). Somente serão considerados empenhos que ainda possuem algum valor a ser requisitado (D4_QUANT maior que 0).
A consulta somente será realizada para produtos que possuem controle de lote (B1_RASTRO igual à "L").