Referência CLI Inventory Management
O Inventory Management fornece comandos para gerenciar dados de inventário e definições de configuração.
Esses comandos incluem:
- Verificando e resolvendo inconsistências de reserva que afetam a quantidade vendável
- Adicionar geocódigos para o algoritmo de Prioridade de Distância
Resolver inconsistências de reservas
As reservas colocam uma retenção de quantidade vendável para SKUs de produto por estoque. Ao entregar, adicionar produtos, cancelar ou reembolsar uma ordem, as reservas de compensação são informadas para colocar ou limpar essas retenções.
Inventory Management fornece dois comandos para verificar e resolver inconsistências de reserva:
Causas de inconsistências de reserva
Inventory Management gera reservas para eventos chave:
- Colocação de pedido (reserva inicial)
- Remessa de pedido (reserva de remuneração)
- Ordem de reembolso ou emissão de um aviso de crédito (reserva de compensação)
- Cancelamento de pedido (reserva de compensação)
As inconsistências de reserva podem ocorrer quando:
- Inventory Management perde a reserva inicial e insere muitas compensações de reserva (supercompensando e levando a valores inconsistentes)
- Inventory Management coloca corretamente a reserva inicial, mas perde as reservas compensatórias.
Você pode revisar e verificar manualmente as reservas na tabela inventory_reservation.
As seguintes configurações e eventos podem causar inconsistências de reserva:
- Atualize para 2.3.x com pedidos que não estão em um estado final (Concluído, Cancelado ou Fechado). Inventory Management cria reservas compensatórias para essas ordens, mas não insere ou tem a reserva inicial que deduz da quantidade vendável. Recomenda-se o uso desses comandos após o upgrade para Adobe Commerce ou Magento Open Source v2.3.x de 2.1.x ou 2.2.x. Se você tiver ordens pendentes, os comandos atualizarão corretamente a quantidade e as reservas para vendas e atendimento de ordens.
- Você não gerencia estoque e depois altera essa configuração. Você pode começar a usar o 2.3.x com Manage Stock definido como
Nona configuração. Commerce não faz reservas em eventos de envio e posicionamento de pedidos. Se você habilitar posteriormente a configuração Manage Stock e alguns pedidos forem criados, a Quantidade Venável será corrompida com a reserva de compensação quando você manipular e atender a esse pedido. - Você reatribui o Estoque para um Site enquanto os pedidos são enviados para esse site. A reserva inicial é inserida para o estoque inicial e toda a reserva de compensação é inserida para o novo estoque.
- O total de todas as reservas pode não resolver para
0. Todas as reservas no escopo de um pedido em um estado final (Concluído, Cancelado, Fechado) devem ser resolvidas como0, limpando todas as retenções de quantidade vendável.
Comando Listar inconsistências
O comando list-inconsistencies detecta e lista todas as inconsistências de reserva. Use as opções de comando para verificar apenas pedidos concluídos ou incompletos, ou todos.
bin/magento inventory:reservation:list-inconsistencies
Opções de comando:
-c,--complete-orders- Retorna inconsistências para pedidos concluídos. Reservas incorretas ainda podem estar em espera para ordens concluídas.-i,--incomplete-orders- Retorna inconsistências para pedidos incompletos (parcialmente remetidos, não remetidos). Reservas incorretas podem reter uma quantidade suficiente ou insuficiente para as ordens.-b,--bunch-size- Define quantas ordens carregar de uma vez.-r,--raw- Saída bruta.
Respostas usando -r retornam no formato <ORDER_INCREMENT_ID>:<SKU>:<QUANTITY>:<STOCK-ID>:
- A ID do pedido indica o escopo da inconsistência.
- O SKU indica o produto com a inconsistência.
- Quantidade define o valor a ser inserido para a compensação da reserva.
- A ID do estoque define o escopo para o estoque, que usa as reservas para calcular a quantidade vendável.
Exemplos:
bin/magento inventory:reservation:list-inconsistencies
Inconsistencies found on following entries:
Order 172:
- Product bike-123 should be compensated by +2.000000 for stock 1
bin/magento inventory:reservation:list-inconsistencies -r
172:bike-123:+2.000000:1
Se nenhum problema for encontrado, essa mensagem retornará: Nenhuma inconsistência de ordem foi encontrada.
Comando Criar compensações
O comando create-compensations cria reservas de remuneração. Dependendo da emissão, novas reservas são criadas para colocar ou liberar uma retenção na quantidade vendável.
Para criar reservas, forneça compensações usando o formato <ORDER_INCREMENT_ID>:<SKU>:<QUANTITY>:<STOCK-ID>, como 172:bike-123:+2.000000:1.
bin/magento inventory:reservation:create-compensations
Opção de comando:
-r,--raw- Retorna saída bruta.
Se o formato da solicitação estiver incorreto, a seguinte mensagem será exibida:
Error while parsing argument "your_incorrect_format_argument". Given argument does not match pattern "/(?P<increment_id>.*):(?P<sku>.*):(?P<quantity>.*):(?P<stock_id>.*)/".
À medida que o comando cria reservas, ele exibe mensagens indicando as atualizações por SKU, pedido e estoque.
bin/magento inventory:reservation:create-compensations 172:bike-123:+2.000000:1
Following reservations were created:
- Product bike-123 was compensated by +2.000000 for stock 1
Se o SKU de uma entrada de compensação incluir espaços, coloque o SKU entre aspas.
bin/magento inventory:reservation:create-compensations 172:"bike 123":+2.000000:1
Detectar inconsistências e criar compensações
Você pode detectar inconsistências e criar compensações imediatamente usando um pipe para executar o list-inconsistencies e o create-compensations. Use a opção de comando -r para gerar e enviar os dados brutos para create-compensations.
bin/magento inventory:reservation:list-inconsistencies -r | bin/magento inventory:reservation:create-compensations
Exemplo de resposta:
bin/magento inventory:reservation:list-inconsistencies -r | bin/magento inventory:reservation:create-compensations
Following reservations were created:
- Product bike-123 was compensated by +2.000000 for stock 1
- Product bikehat-456 was compensated by +1.000000 for stock 1
Após a conclusão das atualizações, execute o comando list para verificar:
bin/magento inventory:reservation:list-inconsistencies -r
No order inconsistencies were found.
Você também pode canalizar os comandos para detectar inconsistências e criar compensações apenas para ordens incompletas (-i) ou completas (-c).
bin/magento inventory:reservation:list-inconsistencies -r -i | bin/magento inventory:reservation:create-compensations
bin/magento inventory:reservation:list-inconsistencies -r -c | bin/magento inventory:reservation:create-compensations
Importar geocódigos
Inventory Management fornece o algoritmo de Prioridade de Distância, que ajuda a determinar a melhor opção para enviar um pedido completo ou parcial. O algoritmo usa informações de GPS ou geocódigos para calcular a distância entre a origem (um depósito ou outro local físico) de cada item em um pedido e o endereço de entrega. Com base nesses resultados, o algoritmo recomenda qual origem deve ser usada para entregar cada item na ordem.
O comerciante seleciona o provedor dos dados de GPS ou geocode necessários para calcular as distâncias:
-
O Google MAP usa os serviços da Plataforma Google Maps para calcular a distância e o tempo entre o endereço de destino da remessa e os locais de origem. Essa opção requer um plano de faturamento da Google e pode gerar cobranças por meio do Google.
-
O cálculo offline calcula a distância usando dados baixados de geonames.org e importados para a Commerce com um comando. Essa opção é gratuita.
Para importar geocódigos para cálculo off-line:
Digite o seguinte comando com uma lista separada por espaços de códigos de país ISO-3166 alpha2:
bin/magento inventory-geonames:import <country code> <country code> ...
Por exemplo:
bin/magento inventory-geonames:import us ca gb de
O sistema baixa e importa os dados de geocodes para o banco de dados e, em seguida, exibe a mensagem Importing <country code>: OK.