02.04.26

modules/purchase_trade/AGENTS.md

@@ -59,6 +59,11 @@ de negoce physique:
 - Pour remonter d'une facture vers shipment / BL / controller / fret:
   - privilegier le lot physique
   - ne pas multiplier des chemins d'acces concurrents
+- Pour les champs de colis (`NB BALES`) dans les templates facture:
+  - la source de verite est `line.lot.lot_qt`
+  - sur une facture, sommer les `lot_qt` des lignes de facture
+  - tenir compte du signe de la ligne de facture pour les notes finales
+  - ne pas proratiser depuis le poids (`net` / `gross`)
 - Le `FREIGHT VALUE` d'un template facture vient du `fee.fee` du shipment
   dont le produit est `Maritime freight`.
 - Le wizard `Create contracts` en mode `matched` peut maintenant partir de
@@ -86,6 +91,8 @@ de negoce physique:
   - le `unit_price` doit rester un prix de base, hors `premium`
   - le `premium` doit impacter le prix total economique et donc le `amount`,
     aussi bien en `priced` qu'en `basis`
+  - pour les documents commerciaux / facture, une ligne `basis` affiche le
+    `premium` comme prix visible, pas le prix economique total
   - si `linked currency` est active, le `premium` est saisi dans la devise /
     unite liee (ex: `USC/LB`) puis converti vers le repere de la ligne pour le
     calcul du `amount`
@@ -118,6 +125,9 @@ de negoce physique:
    `docs/template-rules.md`.
 6. Pour les vues XML Tryton de ce module, utiliser `editable="1"` sur les
    `<tree>` editables; ne pas utiliser `editable="bottom"`.
+7. Si une regle de texte par defaut durable est demandee sur achat/vente,
+   preferer un singleton de configuration expose dans un menu fonctionnel
+   existant plutot qu'un menu technique `purchase_trade`.
 
 ## 6) Pieges connus
 
@@ -128,6 +138,9 @@ de negoce physique:
 - Pour les donnees achat/vente partagees, ne pas supposer qu'une facture de
   vente doit lire directement sur la `sale.line`: souvent, la verite metier
   passe par le lot physique et/ou la `account.invoice.line`.
+- Les templates `invoice_ict*` peuvent partager les memes proprietes Python;
+  si une regle doit valoir pour provisional et final, la mettre dans
+  `modules/purchase_trade/invoice.py` plutot que dupliquer dans les `.fodt`.
 - Dans les ecrans PnL, le label `Sale price` correspond au type stocke
   `sale priced`; idem pour `Pur. price` / `pur. priced`.
 - Une ligne `basis` sans resume de pricing peut sinon disparaitre de la