Lotes, capacidade e aquisições

Caminho: Produtos → Gerenciar → Lotes. Cada lote registra um período e uma quantidade máxima para o produto.

Criar um lote

1. Clique em Novo lote.
2. Informe Quantidade máxima.
3. Preencha Data de início e Data de fim.
4. Confira que a data final não precede a inicial.
5. Clique em Criar lote ou Concluir e aguarde a confirmação.

O formulário exige os três campos e aceita quantidade a partir de zero. Para um limite efetivo, use quantidade maior que zero. A capacidade aparece no cartão do lote, mas essa aba não apresenta saldo consumido, preço por lote ou identificador comercial do lote.

Datas ISO à meia-noite UTC podem aparecer com o dia anterior no cartão, por causa da conversão para o fuso local. Se houver diferença, confira as datas no formulário de edição; essa divergência está registrada na análise técnica.

Para corrigir, use o lápis, altere os dados e clique em Salvar alterações. A lixeira pede confirmação e remove o lote permanentemente.

Como o limite é escolhido

No fluxo de aquisições de produtos das Áreas de Membros, a API busca:

1. Um lote vigente, com capacidade positiva. Quando há mais de um, a consulta principal prioriza o que termina primeiro.
2. Na ausência desse lote, uma afiliação Ativa ou Em andamento com limite positivo.
3. Se nenhum limite positivo for encontrado, a disponibilidade é tratada como sem limite configurado.

As datas são comparadas com a data corrente em UTC no backend. Um lote com quantidade zero é ignorado pela resolução de limite; não deve ser usado para “esgotar” ou suspender uma oferta. Da mesma forma, o término de um lote não fecha o produto automaticamente: a consulta pode encontrar outra fonte de limite ou tratá-lo como ilimitado. Para suspender a oferta na área, altere o status da associação.

Saldo e fila de aquisições

A API pública de áreas calcula o saldo por área + produto, subtraindo a quantidade de registros de aquisição em reserva (holding) e confirmados (confirmed). Não subtrai diretamente o total de unidades de todos os pedidos comerciais.

Uma reserva tem prazo de 10 minutos. A API prevê consulta da posição, saída da fila, confirmação e expiração agendada. Confirmar uma aquisição não comprova pagamento nem cria sozinho um pedido comercial.

Alcance do controle

Esse controle pertence à API de aquisições das áreas. A ficha de Produtos não oferece uma tela de fila e o checkout público do marketplace não está conectado a esse mecanismo.

O limite de afiliação é procurado por produto, sem isolar o parceiro na consulta; o saldo também é contado por área e produto, sem separar lote. Portanto, não considere esses campos um estoque global ou uma cota individual confiável por afiliado. Veja a análise técnica.

Conferência operacional

Após salvar, reabra Lotes, confira datas e capacidade e consulte o produto na área em que será utilizado. Se o objetivo for mudar a disponibilidade comercial, confira também status da área, visibilidade pública e afiliação: esses controles são independentes.