A ferramenta de Vencimento de Produtos (get_lots_expirations_quantity) fornece informações sobre as quantidades em estoque de um produto que estão vencendo dentro de determinado período.
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? |
|---|---|---|
| start_date_optional | Data de início para buscar produtos com vencimento | Não |
| end_date_optional | Data de término para buscar produtos com vencimento | Não |
A ferramenta irá retornar as informações a seguir:
| Cabeçalho | ||
|---|---|---|
| Campo | Descrição | Origem da informação |
| total_products | Quantidade de produtos com vencimento no período | Contador de produtos com vencimento no período da tabela SB8 |
| products_list | Lista de produtos | Lista de produtos |
| Lista de produtos (products_list) | ||
|---|---|---|
| Campo | Descrição | Origem da informação |
| product_code | Código do produto | B8_PRODUTO |
| product_description | Descrição do produto | B1_DESC |
| product_unit_measure | Unidade de medida do produto | B1_UM |
| total_lots_balance | Quantidade total dos lotes vencendo no período | Somatório de B8_SALDO |
| total_quantity_to_address | Quantidade total pendente de endereçamento | Somatório de B8_QACLASS |
Caso a consulta seja executada sem enviar os argumentos de data inicial e data final, serão assumidos valores padrões para filtro das datas.
A busca possui um limite de períodos para busca. O range entre a data inicial e data final não pode ser superior a 365 dias.
Caso a busca encontre muitos produtos com lotes vencendo no período, a Lista de produtos será limitada aos 20 primeiros produtos com vencimento, ordenados pelos produtos que possuem lotes vencendo mais cedo dentro do período.