Reservas

A reserva é uma ação que garante alocação de oferta para uma demanda para consumo posterior.

O processo de conversão de pedidos é um processo complexo, pois o vendedor deve garantir que a quantidade em um site de comércio eletrônico ou local de loja seja cumprida no final do pipeline. Geralmente, se houver um atraso de conversão de pedido entre o front-end e o sistema backend, isso poderá levar à supervenda, se não for manipulado corretamente Por exemplo, em uma página de detalhes do produto, o vendedor pode indicar a quantidade total disponível e quando dois compradores estão incluindo o item no carrinho de compras ou checkout ao mesmo tempo, há uma necessidade de uma maneira determinística para resolver quem recebe a última quantidade do produto.

A reserva permite que as quantidades de itens sejam reservadas para curto prazo, o que permite que o sistema backend conclua o processamento de demandas. As solicitações de reserva ocorrem em tempo real e têm um comportamento de desbloqueio, de forma que quando uma solicitação é recebida, a disponibilidade é verificada antes da reserva. No caso de várias reservas acessarem a mesma quantidade, a primeira reserva bem-sucedida será processada e todas as reservas que forem feitas em datas posteriores serão recuperadas e rejeitadas. A quantidade de reserva aceita é considerada em seguida em consultas de disponibilidade futuras que incluem as novas solicitações de reserva.

A seguir estão as características dos pedidos de reserva de inventário:
  • Recuperação automática na reserva malsucedida
  • A validação de reserva é configurável..
  • A reserva pode ser consumida como parte da atualização da demanda
  • Reserva pode ser agrupada por referência
  • A reserva parcial é suportada
É possível usar reservas para o seguinte:

Criando reserva para nó ou rede

É possível criar reservas no nível do nó e da rede
Reserva no nível do nó..
A criação de uma reserva no nível do nó permite que o inventário seja bloqueado em um local ou nó de remessa específico É possível criar a reserva de um ou mais itens na quantidade especificada No sucesso, um ID de confirmação de reserva é retornado.
Nota: a reserva parcial é suportada no caso de reserva de nível do nó..

Uma reserva bem-sucedida considera um tipo de demanda que impacta a disponibilidade do inventário Toda reserva tem um período de expiração e, no final do período, o inventário é retornado para o conjunto disponível se não for consumido por meio de uma captura de pedido.

Reserva no nível da rede
Para maximizar o recurso de captura de pedido, um gerente de cumprimento configura uma rede de locais de remessa. A reserva de rede geralmente é usada em um sistema de e-commerce, pois no momento da captura é desconhecido qual local de remessa é usado para cumprimento.
Capturar uma reserva de rede afeta o nível de inventário no nível de rede e de nó. Considere que há dois nós cada um com 5 quantidade de disponibilidade, então haveria 10 qty disponibilidade total para reserva.
Nota: quando uma reserva de rede é criada, a reserva quebra automaticamente na reserva de nível do nó com base na prioridade do nó.

Para obter mais informações, consulte Reservas usando o comportamento de prioridade do nó

Observação: a lógica de disponibilidade considera suprimentos, demandas e reservas ativas, entre outros aspectos, para calcular a disponibilidade real.
Para obter informações adicionais sobre casos especiais em reserva, consulte Casos especiais.
Para obter mais informações sobre como recuperar a lista de reservas ativas, consulte Get Reservations API.

Em ambos os casos de reserva de nó ou de rede, é possível usar a capacidade de customizar o ID de reserva. Para obter mais informações, consulte Criando reservas com ID de reserva customizado.

Reservas usando o comportamento de prioridade do nó

Quando uma reserva de nível de rede é criada, o sistema considera a disponibilidade de rede antes de bloquear a quantidade de inventário.. Em algum cenário complexo em que um ou mais nós fazem parte de várias redes, isso pode rapidamente levar a um cenário de sobrevenda.

Por exemplo, considere que Node1 possui 5 qty e Node2 possui 7 qty de disponibilidade. Se dois grupos de distribuição forem criados como DG1 e DG2 em que ambos tenham o mesmo nó, então ambos observam a mesma disponibilidade de 12 qty. Nesse comportamento anterior, a reserva criada em um grupo de distribuição não está ciente do outro grupo. Isso significa que é possível que o DG1 e o DG2 reservem 12 qty levando à supervenda.

Para superar esse comportamento, o vendedor precisa rastrear essas reservas de nível de rede como reservas não confirmadas e convertê-las na reserva de nível de nó para minimizar o risco de sobrevenda. A reserva de prioridade do nó para o grupo de distribuição é introduzida na lógica de reserva para minimizar o esforço do vendedor na execução da conversão de reserva de rede para nó

A diferença fundamental com a reserva de prioridade do nó é que o sistema executa uma verificação de inventário no nó individual no grupo de distribuição e na rede ao aceitar a quantidade solicitada. A quantidade de reserva é designada a um nó em vez do nível de rede para que qualquer rede que compartilhe o mesmo nó tenha a imagem de inventário mais recente... Quando existem vários nós na definição de grupo de distribuição, o registro de reserva é feito na ordem do valor de prioridade do nó..

Para configurar a ordem em que os nós são considerados, o usuário pode definir o valor de prioridade para cada nó no grupo de distribuição como vários nós podem ter o mesmo valor de prioridade. O desempatador é o nó com o inventário mais antigo reservado primeiro.
Para obter mais informações, consulte Distribution Group API.

Como um exemplo, DG1 possui [Node2, Node1, Node3, Node4] como a sequência de prioridade do nó. Isso significa que a disponibilidade do Node2 é sempre reservada primeiro. Depois que o Node2 se esgota, o sistema então atravessa para o nó de prioridade subsequente até que a quantidade de solicitação de reserva seja atendida.

Atualizando a quantidade de reserva

Em uma reserva existente, é possível executar as seguintes ações:
  • Aumentar e diminuir uma quantidade de reserva para uma linha de reserva.
    Nota: no caso de mudança de quantidade, a reserva suporta aumento parcial da quantidade de reservas. Isso é verdadeiro até que o inventário esteja disponível na combinação item-nó específica..
  • Atualizando o prazo de expiração
Nota: configure a sinalização acceptPartialReserve como true para permitir que a linha de pedido seja liberada para qualquer quantidade reservada que seja reserva absoluta. Caso o sinalizador seja definido como ' false, as linhas do pedido serão processadas quando toda a quantidade for reservada.

Definindo prazos de expiração para reservas

Ao criar uma reserva para um nó ou rede, é possível definir o carimbo de data/hora de expiração no nível da linha de reserva individual ou para todas as reservas com a mesma referência. Quando uma reserva expira, a quantidade reservada é liberada de volta para o pool de disponibilidade. Nesse momento, as APIs de disponibilidade refletem o inventário atualizado e os eventos relevantes podem ser publicados se as assinaturas estiverem em vigor. Os eventos incluem productAvailbaility, dgAvailability e supplyAvailbility . Para obter mais informações, consulte Formatos de eventos.

Extensão de reservas para um carrinho ou por referência

A reserva existente pode ser substituída com o novo registro de data e hora de expiração durante a criação ou atualização da reserva Por exemplo, se você configurar a sinalização com um registro de data e hora de expiração de substituição definido, a referência de reserva consistirá em [rsv1, rsv2, rsv3] que atualiza a expiração para todas as reservas. Se você não especificar a substituição de expiryTs na entrada da solicitação, a sinalização poderá ser ignorada
Nota:
  • O sistema impõe o limite de reserva para o máximo de 30 dias com um valor padrão de 15 minutos.
  • É possível estender o prazo de vencimento para várias reservas de uma vez que tenham a mesma referência.
Para obter mais informações, consulte Update Reservations API.

Pesquisa de reservas de inventário

A pesquisa de reservas de inventário permite que você pesquise reservas por item, referência ou ID de reserva. Você também pode pesquisar as reservas de inventário com a ajuda da Search Reservations API.

Para obter mais informações sobre as etapas de pesquisa de reservas de estoque, consulte Pesquisa de reservas de estoque por referência ou ID de reserva.

Remoção de reservas

Você pode excluir ou usar a reserva selecionada como parte da atualização da demanda quando um pedido for convertido.

O sistema executa uma validação para evitar a duplicação do ID de reserva na chamada API de reserva. A criação de reserva bem-sucedida retorna o valor reference correspondente da carga útil de resposta. As APIs que trabalham com o ID de reserva customizada são as seguintes:
  • GET
  • DELETE
  • POST
  • PATCH
Para obter mais informações sobre como remover as reservas, consulte Delete Reservations API.

Status da reserva

A seguir estão os tipos de reserva que podem ser feitos com relação ao nó específico, grupo de distribuição específico e método de entrega específico, dependendo da remessa ou retirada em loja.

Considere um cenário de compra on-line no qual um comprador deseja fazer um pedido para um item... Quando o item é incluído em um carrinho de compras ou como parte do registro de saída, as etapas a seguir ocorrem no sistema backend:
  1. Obtenha a disponibilidade do item e compare-o com relação à quantidade de solicitação
  2. Se houver quantidade suficiente disponível, uma reserva de item será solicitada.
    Nota: A segunda etapa pode ser executada quando os itens são incluídos em um carrinho de compras ou quando os itens estão em processo de check-out...
  3. Verifique o estado da reserva e determine se a reserva está totalmente reservada, parcialmente reservada ou não reservada Se a quantidade não for totalmente reservada, o usuário deverá ser notificado de quantidade insuficiente..
  4. Se a quantidade for cancelada ou removida do carrinho, a reserva correspondente deverá ser alterada para refletir a quantidade mais recente reservada que libera a disponibilidade para outros compradores.
  5. A reserva é convertida em ordem ou demanda O sistema backend inclui o ID de reserva como parte da atualização de demanda e pedido, que aciona o consumo da reserva.
Quando o inventário é baixo, a reserva pode ter um dos seguintes resultados:
Reserva Resultado
Reservado Se a quantidade total for reservada, a loja publicará uma demanda que inclui os detalhes da reserva para que a reserva possa ser consumida..
Parcialmente reservado As quantidades parciais são reservadas no sistema.. Com base no status de aceitação do pedido, o cliente precisa determinar se a reserva precisa de ser preservada ou excluída
Não reservado O inventário não está reservado e os clientes precisam procurar inventário alternativo.