CONTEÚDO
01. VISÃO GERAL
A ferramenta de Quantidades Consumidas do Produto (get_product_consumption) fornece informações sobre as quantidades requisitadas e devolvidas no processo de produção para um produto em determinado período de datas, listando as datas onde houve a requisição ou devolução do produto dentro do período da busca.
02. EXEMPLO DE UTILIZAÇÃO
Esta ferramenta é capaz de interagir com solicitações semelhantes a:
- Quanto foi consumido do produto 'código do produto' no mês passado?
No período de 'data inicial' e 'data final', qual a quantidade requisitada e devolvida do produto 'código do produto'?
Em quais datas houve consumo do produto 'código do produto' no período de 'data inicial' e 'data final'?
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 das quantidades consumidas | Sim |
| start_date | Data inicial para realizar a busca dos consumos de produção | Sim |
| end_date | Data final para realizar a busca dos consumos de produção | Sim |
04. DADOS RETORNADOS
A ferramenta irá retornar as informações a seguir:
| 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_request_quantity | Total da quantidade requisitada para o produto no período de pesquisa | Somatório de D3_QUANT para movimentos de requisição (D3_CF iniciando com 'RE'). |
| total_return_quantity | Total da quantidade de devolução para o produto no período de pesquisa | Somatório de D3_QUANT para movimentos de devolução (D3_CF iniciando com 'DE'). |
| total_consumption_quantity | Quantidade total consumida, obtida pela subtração das quantidades devolvidas das quantidades requisitadas | total_request_quantity - total_return_quantity |
| date_consumption_list | Lista com as quantidades consumidas/requisitadas por data | Lista de quantidades por data |
| Lista de quantidades por data (date_consumption_list) | ||
|---|---|---|
| Campo | Descrição | Origem da informação |
date | Data da movimentação | D3_EMISSAO |
request_quantity | Quantidade requisitada para o produto na data | Somatório de D3_QUANT para movimentos de requisição (D3_CF iniciando com 'RE') agrupados pela data de emissão. |
return_quantity | Quantidade devolvida para o produto na data | Somatório de D3_QUANT para movimentos de devolução (D3_CF iniciando com 'DE') agrupados pela data de emissão. |
consumption_quantity | Quantidade consumida na data, obtida pela subtração das quantidades devolvidas das quantidades requisitadas | request_quantity - return_quantity |
Para identificar as quantidades de consumo, será realizada a busca na tabela SD3 pelo produto informado (D3_COD), e utilizando a emissão do movimento (D3_EMISSAO) dentro dos períodos de data solicitados. Serão considerados somente registros da tabela SD3 que não estejam estornados, que possuam vínculo com alguma ordem de produção (D3_OP preenchido) e que tenham o tipo de requisição de requisição ou devolução (D3_CF iniciando com 'DE' ou 'RE').
A Lista de quantidades por data mostra no máximo 30 datas. Se houver mais de 30 datas com consumo do produto, o total do período será exibido, mas a lista trará apenas as primeiras 30 datas. Para ver o detalhamento completo das datas, será preciso consultar um período menor.
05. TABELAS UTILIZADAS
- SD3 - Movimentações internas
- SB1 - Produtos