Treinamento — Site H2i

1. Visão geral

O site é a loja B2B da H2i. O cliente (revenda) faz login, escolhe a filial em que está comprando, navega pelos produtos, monta o carrinho e finaliza o pedido. A partir daí o pedido passa por um ciclo: pagamento/aprovação → reserva → faturamento (vira venda) → nota fiscal → entrega ou retirada.

2. Página do produto

Mostra tudo num card único: foto/galeria e o bloco de preço/compra.

• Preço em destaque: o menor preço para aquele cliente. Acima, quando existe, o preço cheio de referência e os ícones/formas de pagamento aceitas.
• Promoção especial promoção especial: selo laranja + descrição da condição (ex.: "à vista ou 3x no cartão ou boleto").
• Condições por quantidade: "a partir de 5/10/20 un", cada uma com o preço — quanto mais, menor o unitário. Clicar ajusta a quantidade. Faixa acima do estoque não aparece.
• Estoque: aviso "está acabando" e o bloco "consulte estoque em outras filiais" (clicar = comprar nessa filial).
• Semelhantes aparecem antes de "detalhes / dimensões / garantia".

3. Regras de preço — como o preço é calculado

Esta é a parte mais importante. O mesmo produto pode ter preços diferentes para cada cliente. Quem calcula é o motor de preço da API — o site apenas exibe o resultado. O preço final sai de uma sequência de regras: tabela do cliente → preço por quantidade / promoção → pisos → forma de pagamento → parcelas → descontos.

3.1 Cada cliente tem um "tipo de preço"

Ao calcular, a API olha o cadastro do cliente (tipo de pessoa, atividade, tipo de cliente, UF) e escolhe uma tabela de preço. É por isso que dois clientes veem preços diferentes para o mesmo item.

3.2 Pisos de preço — o preço nunca cai abaixo

Existem "pisos" que protegem a margem. O preço final nunca fica abaixo deles:

A ordem é: consumidor respeita o PMC, depois PMD, depois PP. Caso especial de varejo: quando o cliente e o produto são "varejo", o PMC passa a valer como o PMD.

3.3 Preço por quantidade (faixas)

O produto pode ter faixas por quantidade: comprando a partir de X unidades, o unitário cai. A API pega a faixa cuja quantidade mínima é ≤ à quantidade do carrinho e respeita o piso PP. É o que a página mostra como "a partir de 5/10/20 un".

3.4 Promoções especiais (e compre-e-ganhe)

• Promoção especial: vale por atividade do cliente, dentro de um período e — importante — pode ser por forma de pagamento (só boleto, só cartão, só à vista…). Por isso a mesma promoção pode aparecer para um cliente e não para outro, ou só numa forma.
• Compre e ganhe: alguns produtos dão outro produto (grátis ou com preço) ao comprar certa quantidade, dentro da validade.
• Fidelidade: cliente PJ técnico pode acumular um pequeno percentual (fidelidade) em compras elegíveis.

3.5 A forma de pagamento influencia o preço

No carrinho, escolher a forma de pagamento muda o preço/total. As formas se agrupam assim:

As promoções especiais têm colunas por forma (boleto/cartão/à vista), então a condição exibida no produto e o total no carrinho podem variar conforme o cliente escolhe pagar.

3.6 Parcelamento — e produtos que limitam parcelas

O número de parcelas do cartão é limitado por duas coisas ao mesmo tempo:

1. Máximo de parcelas do produto: cada produto (pelo seu subgrupo) tem um máximo de parcelas e um máximo sem juros. Existem produtos que limitam as parcelas (ex.: só até 3x).
2. Parcela mínima: o valor de cada parcela não pode ficar abaixo de um mínimo. Então, mesmo que o produto permita 12x, se dividir o total der uma parcela pequena demais, o site oferece menos parcelas.

O site mostra as parcelas disponíveis, indicando sem juros até o limite e com juros acima dele.

3.7 "Permite desconto" — vendedor e gerente

Cada produto tem uma flag permite desconto. Quando ligada, é possível aplicar desconto manual no carrinho, dentro de limites:

• Desconto do vendedor: o vendedor pode conceder até o limite dele.
• Desconto do gerente: acima do limite do vendedor, precisa do gerente (limite maior).
• O desconto é distribuído entre os itens e nunca pode furar os pisos (3.2).

3.8 O "motor de preço" é a fonte da verdade

O site exibe condições, mas quem calcula e valida é a API (o motor de preço). Consequências práticas:

• O site não inventa preço nem escolhe a promoção — ele pergunta ao back.
• No fechamento, a API recalcula o preço de cada item e confere se bate com o que veio do site. Se não bater (ex.: tentativa de burlar), o pedido é recusado.
• Isso garante que ninguém venda abaixo da regra (tabela do cliente + pisos + promoção válida).

4. Adicionar ao carrinho

O cliente ajusta a quantidade e clica em adicionar ao carrinho. Aparece um balão verde de confirmação saindo do ícone do carrinho (canto superior) e o contador aumenta. O preço aplicado segue a quantidade (pega a faixa correta) e depois a forma de pagamento escolhida no fechamento.

5. Fechamento do pedido (checkout)

Etapas: entrega → pagamento → confirmação.

5.1 Entrega em casa ou retirada na loja

5.2 Pagamento — a forma muda o total

As formas dependem da filial e do cliente: à vista/pix, cartão (1–12x), boleto e, quando a filial permite, pagar na loja. Ao trocar a forma, o total é recalculado (à vista costuma ser o menor; cartão pode ter juros; boleto consome limite). O parcelamento segue as regras da seção 3.6 (máximo do produto e parcela mínima), mostrando sem juros até o limite.

5.3 Desconto

Se o item permite desconto, o vendedor/gerente pode aplicar dentro do limite (seção 3.7). O desconto entra no resumo e é distribuído nos itens.

5.4 Revisão e limite de crédito

A tela de revisão resume itens, descontos, frete, forma de pagamento e o limite disponível do cliente (mostrado ao vivo — seção 8).

5.5 Confirmar

Ao confirmar, grava o pedido e mostra o número. Proteções: não duplica pedido em duplo clique/oscilação; se criou o pedido mas um passo seguinte falhar, limpa o carrinho e confirma "Pedido registrado nº X" (não se perde).

5.6 Vendedor: tirando um pedido por um cliente

Quando você está logado como vendedor, pode montar e fechar um pedido em nome de um cliente:

1. Selecione o cliente (revenda) pelo qual vai comprar. A partir daí o site passa a mostrar o preço, o limite e as condições daquele cliente (lembre: preço é por cliente — seção 3.1).
2. Monte o carrinho normalmente: adicione produtos, ajuste a quantidade e escolha a forma de pagamento (que influencia o total — seção 3.5).
3. No carrinho, o vendedor do pedido é solicitado apenas na primeira vez que você entra — você seleciona quem é o vendedor. Depois ele não pergunta de novo.
4. Pode trocar o vendedor a qualquer momento: é só clicar no resumo, ao lado, dentro do próprio carrinho, e selecionar outro.

6. O ciclo do pedido

* Aceite do cliente só existe quando o pedido foi criado por um vendedor (seção 7).

7. Aprovação e reservas

7.1 Pedido do cliente x pedido do vendedor

7.2 Autorização de faturamento

Alguns pedidos precisam de autorização antes de faturar (ex.: acima de um valor, ou primeira compra). Autorizado, o sistema faz as reservas.

7.3 Reserva de estoque e de limite

• Reserva de estoque: separa a mercadoria, para não vender o mesmo item duas vezes.
• Reserva de limite: a parte em boleto "segura" um pedaço do limite do cliente até faturar (vira boleto real) ou cancelar (estorna).

8. Limite de crédito

Na tela Meu Limite e na revisão do checkout, o cliente vê o limite disponível ao vivo, calculado igual ao que a API usa para autorizar:

• É por filial e sempre bate com o que o checkout permite.
• Ao faturar, a reserva sai e o boleto real passa a contar (sem contar em dobro).
• Ao cancelar, a reserva é estornada e o limite volta.
• Só a parte em boleto consome limite (à vista/pix/cartão não seguram limite de crédito de boleto).

9. Faturamento — o pedido vira venda

Quando faturado, o pedido/DAV vira venda na filial. Na mesma operação o sistema gera:

• A venda (cabeçalho + itens) e a saída de estoque.
• Os pagamentos da venda.
• Boletos, quando houver — já em aberto e atrelados ao CNPJ (contam no limite).
• Cartão: uma linha por parcela (1–12x), vencimento a cada 30 dias, valor rateado (a sobra fica na 1ª parcela), com bandeira, taxa/desconto e o número de autorização.

10. Nota fiscal (NF-e)

A NF-e é emitida no sistema de emissão. Autorizada pela SEFAZ, o sistema guarda a chave de acesso e o XML autorizado junto do pedido — para consulta, envio ao cliente e conciliação.

11. Retirada na loja

1. No checkout, o cliente escolhe retirada e o ponto (a filial precisa atender o ponto).
2. Informa o portador e, quando disponível, a data/hora programada.
3. Chegando a mercadoria, a equipe do ponto confirma a chegada.
4. O cliente é avisado e retira. A liberação exige que a venda já tenha nota fiscal.

12. Cancelamento de pedido

Em "Meus Pedidos", quando permitido, o cliente cancela informando um motivo (lista ou "Outro"). Regras:

• Só enquanto não faturado (ex.: retirada aguardando pagamento, ou aguardando confirmação do cliente).
• Estorna reservas de estoque e de limite.
• Registra o motivo, exibido como cancelado · motivo.

13. Meus Pedidos e status

Etapas concluídas em azul; próxima pendente em laranja; cancelado em vermelho com o motivo.

14. Impressão do pedido (DAV)

• O QR do cabeçalho (chegada) só aparece depois de expedido.
• O QR do PIX só aparece enquanto não está pago.
• Pedido cancelado sai com marca d'água diagonal.
• Layout em minúsculas (exceto o nome da empresa), valores em destaque.

15. "Pagar na loja" por filial

Cada filial habilita ou não o pagamento na loja. Se a filial está marcada para não permitir, o site não oferece essa opção para quem compra nela — e o servidor recusa o pedido se a forma vier mesmo assim (proteção dupla).

16. Como o back valida o pedido (bastidores)

Ao fechar, antes de gravar, a API confere uma série de coisas. Se algo não bater, o pedido é recusado (nada é gravado pela metade):

17. Glossário rápido