The productLogique métier(in French)Shared rules3 min read
Prix, remises, TVA et port
Le prix affiché, un prix barré honnête, la répartition des remises, la TVA d’une commande et le prix de la livraison.
Not translated yet
Toutes ces règles sont dans packages/domain/src. Du coup, le panier du site, la vente au magasin et le devis de l’ERP calculent avec le même code.
Le prix affiché
Le prix d’une déclinaison s’annonce éco-contribution comprise (announcedPriceCents, offer.ts). Une pièce est disponible si elle est fabriquée à la commande, ou si elle est suivie en stock avec un solde positif. Sinon, elle est épuisée et elle passe en fin de vitrine (offerAvailability).
Le prix barré
Un prix barré doit être honnête. Donc le prix de référence d’une remise, c’est le plus bas pratiqué dans la fenêtre qui précède son début. On y compte aussi le prix en vigueur à l’ouverture de la fenêtre (referencePriceCents, REFERENCE_PRICE_WINDOW_DAYS, reference-price.ts). Pour ça, on garde chaque changement de prix (VariantPriceChange). Le pourcentage annoncé est arrondi vers le bas, pour ne pas promettre plus que la vraie remise (discountPercent).
Dès qu’une remise est échue, le site et l’ERP affichent le prix d’avant. Ils n’attendent pas que la veille du matin l’écrive en base (settleEndedDiscount, ended-discount.ts). Ce prix d’avant se lit dans l’historique des prix. Si quelqu’un a retouché le prix pendant la remise, c’est ce dernier prix qui reste (endedDiscountPriceCents, discount-return.ts).
Les codes promo
Un code donne un pourcentage ou un montant. On le calcule sur la base des lignes qui y ont droit (promotionDiscountCents). Ensuite, la remise se répartit entre ces lignes au plus fort reste (allocateLineDiscounts). Chaque ligne porte sa part, et la somme des parts vaut exactement la remise. Ça compte pour la facture et pour un remboursement partiel. Le plafond d’usages d’un code se vérifie sous un verrou que le site et l’ERP partagent (promotion-lock.ts), pour que le dernier usage ne parte pas deux fois.
Avec un code à usages limités, il faut dire ce qui compte comme un usage. Une commande qui garde l’argent du client en est un. Une commande du site en cours de paiement en est un aussi, tant que sa session est ouverte. Stripe peut confirmer ce paiement des heures plus tard, et le code aurait alors servi une fois de trop (promotionRedemptionsWhere, promotion-redemptions.ts). Le site compte comme ça au paiement. L’ERP compte pareil quand il affiche les usages d’un code ou qu’on baisse son plafond. La commande en attente d’un client ne compte pas contre lui. Donc s’il revient de Stripe pour corriger son adresse, il ne perd pas son propre code.
Une facture cite le code promo, et l’ERP le traite en conséquence (apps/erp/modules/promotions/services/promotion-admin.service.ts). Tant qu’aucune commande ne porte le code, on peut tout modifier et le supprimer. Dès qu’une commande payée l’a utilisé, on ne peut plus changer que son libellé, son dernier jour et son plafond (LOCKED_AFTER_SALE). Et le plafond ne descend pas sous le nombre d’usages déjà comptés. Un code qui a servi s’archive. Son nom redevient libre, parce que l’unicité ne porte que sur les codes en service (Promotion_code_key).
La TVA
Les taux français sont écrits une fois (FRENCH_VAT_RATES_BPS, vat-rates.ts). Le taux réduit n’est admis que sur une commande qui comporte une prestation (isReducedVatRateAllowed).
La livraison prend le taux des marchandises qu’elle accompagne. Si la commande mélange plusieurs taux, le port se répartit entre eux au prorata de leurs montants, au plus fort reste. Chaque part porte la TVA de son taux (shippingVatShares, shipping-vat.ts).
Le prix de la livraison
La boutique ne livre qu’en France métropolitaine. La grille de port se lit par zone (un début de code postal, ou toute la métropole), par mode de livraison et par tarif (shipping-grid.ts). Dès que le panier connaît le code postal, il montre le prix exact. Pour un retrait au magasin, il n’y a ni port ni délai de transport.
Les totaux
Le total d’une commande (lignes, remise, port, TVA par taux) se calcule dans checkout-totals.ts. Le paiement du site et l’ERP l’appellent tous les deux. Au paiement, le site compare ligne par ligne ce qu’il a montré au client et ce qu’il s’apprête à encaisser (Panier et paiement).