CONTEÚDO
01. VISÃO GERAL
A ferramenta de Uso do Produto nas Ordens de Produção (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.
02. EXEMPLO DE UTILIZAÇÃO
Esta ferramenta é capaz de interagir com solicitações semelhantes a:
- Quais ordens de produção vão consumir o produto 'código do produto' até o fim desse mês?
- O produto 'código do produto' está empenhado em quais ordens de produção?
- Qual o saldo total empenhado do produto 'código do produto' até 'data final'?
- Em quantas ordens de produção o produto 'código do produto' está empenhado a partir de 'data inicial'?
- Qual é a previsão de consumo do produto 'código do produto' para o mês de Dezembro?
03. ARGUMENTOS
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 |
| start_date_optional | Data inicial para filtro da data dos empenhos | Não |
| end_date_optional | Data final para filtro da data dos empenhos | Não |
04. DADOS RETORNADOS
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 |
| total_orders | Contador de ordens de produção que utilizam o empenho | Contador distinto de D4_OP |
| total_balance | Saldo total do empenho em todas as ordens de produção | Somatório de D4_QUANT em todas as ordens de produção |
| 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 de produção por data | Lista de datas do empenho |
| Lista das datas do empenho (allocation_date_list) | ||
|---|---|---|
| Campo | Descrição | Origem da informação |
| allocation_date | Data do empenho | D4_DATA |
| allocation_balance | Saldo do empenho na data | Somatório de D4_QUANT para os empenhos da mesma data |
A busca considera apenas empenhos que possuem saldo (D4_QUANT diferente de zero). Sendo assim, ordens de produção já finalizadas ou que já requisitaram os empenhos na sua totalidade não serão consideradas nesta consulta.
A lista de ordens de produção tem o limite de 20 ordens de produção. Caso o empenho pesquisado seja utilizado em mais de 20 ordens de produção, somente as 20 primeiras serão exibidas, não sendo possível consultar as demais ordens. Apenas os totalizadores de quantidade de ordens de produção (total_orders) e saldo total do empenho (total_balance) representam as informações de todas as ordens de produção, mesmo quando a consulta ultrapassar o limite de 20 ordens de produção.
05. TABELAS UTILIZADAS
- SD4 - Empenhos
- SB1 - Produtos