Logística
O módulo modela origens, docas, zonas, políticas, SLA, entrega e retirada. A simulação considera CEP, itens, quantidade, estoque e regras da operação.
Siga a sequência da tarefa, entenda os pontos de validação e volte a esta página sempre que precisar repetir a operação.
Nesta página · 6 tópicos
Reserva de estoque concorrente
No fechamento do pedido, a reserva usa transação PostgreSQL e bloqueio da linha de saldo. Duas tentativas sobre a mesma oferta não conseguem consumir a mesma unidade: a primeira reserva o saldo e a seguinte recebe conflito quando o saldo livre não é suficiente.
commerce_inventory_balancesmantém saldo disponível e saldo reservado por produto e origem;commerce_inventory_reservationsregistra pedido, quantidade, expiração e estado da reserva;- reservas expiram conforme o prazo definido em Logística no EcommPanel e devolvem o saldo reservado;
- confirmação de pagamento consome o saldo; cancelamento ou falha libera a reserva;
- a origem principal sem armazém específico usa o saldo consolidado do produto. Origens com armazéns mapeados continuam tendo precedência para operações distribuídas.
O mecanismo é ativado com COMMERCE_INVENTORY_RESERVATIONS_ENABLED=true. O schema é idempotente e pertence ao runtime, nunca ao build.
Componentes
| Componente | Responsabilidade |
|---|---|
| Origem | local físico ou estoque que atende o item |
| Doca | ponto operacional ligado a uma origem |
| Zona | cobertura geográfica e restrições |
| Política | preço, prazo, classe e modo de serviço |
| Oferta | resultado calculado para o carrinho |
| Alocação | distribuição de item e quantidade por origem |
Operação
- Cadastre origens e confirme endereço.
- Vincule docas e disponibilidade.
- Defina zonas e faixas de CEP.
- Configure políticas de entrega ou retirada.
- Associe classe logística aos produtos.
- Simule CEP e carrinho representativos.
- Valide split quando itens partem de origens diferentes.
- Confirme preço e prazo no OrderForm e no pedido.
Promoções e frete
O motor promocional recebe a oferta selecionada e pode aplicar frete grátis ou desconto. A logística calcula o preço base; a promoção registra a redução separadamente.
Diagnóstico
Ausência de oferta normalmente indica CEP fora da zona, origem sem disponibilidade, classe incompatível, política pausada ou item sem alocação. Use o simulador do painel antes de alterar código.
Da cotação à expedição
Esta área calcula a escolha de entrega antes da compra. A operação posterior do pedido, incluindo separação, romaneio, etiqueta, emissão fiscal, coleta e rastreio, pertence ao fluxo de fulfillment. O desenho e a sequência de implantação estão em 11 - Fulfillment Fiscal e Expedição.