Frais d'approche

Le module crée un dossier d’arrivage : un camion, un conteneur. Vous y ajoutez les commandes fournisseurs arrivées ensemble, même de fournisseurs différents, puis les frais.

Les frais : un libellé, un type — transport, droits et taxes de douane, assurance, transitaire, autre —, un montant HT et, si vous le souhaitez, la facture fournisseur correspondante. Ce lien sert à retrouver la pièce : aucune écriture comptable n’est modifiée.

La répartition, frais par frais :

Le calcul se fait au centime. Les centimes d’arrondi vont aux lignes dont la part a le plus grand reste : la somme répartie est toujours égale au montant du frais. Un frais négatif, un avoir par exemple, se répartit de la même façon. Un frais impossible à répartir — un produit sans poids pour une répartition au poids, une base nulle — bloque l’application, et les produits en cause sont nommés.

Avant ou après la réception

Avant la réception. Le coût rendu (prix d’achat net + frais par unité) est inscrit sur les lignes des réceptions encore en brouillon. À la validation de la réception, c’est Dolibarr qui calcule le PMP avec ce coût, par sa propre formule. Le module ne réécrit pas ce calcul.

Après la réception, quand la facture du transporteur arrive plus tard. Le PMP est corrigé produit par produit, sur la seule part encore en stock : la part des frais appliquée est stock actuel / stock juste après la réception. La part déjà sortie n’est pas revalorisée, et les marges passées ne changent pas.

Le moment possible dépend de la façon dont vos achats entrent en stock :

Dans le dernier cas, le module ne trouve aucune quantité reçue et ne peut rien appliquer.

Le journal et l’annulation

Chaque valeur modifiée est enregistrée avec l’ancienne et la nouvelle, la quantité, le stock et le montant. L’application peut être annulée, tout ou rien, tant que rien n’a bougé : réception toujours en brouillon, coût de ligne, PMP et prix de revient inchangés. Si un seul produit a changé, rien n’est annulé et le motif est affiché produit par produit.

Le menu se trouve sous ProduitsEntrepôtsFrais d’approche.

La fiche d’un dossier tient en une page. Sur la capture, le dossier « Conteneur Le Havre — semaine 41 » regroupe deux commandes de deux fournisseurs, 5 000 et 15 000 HT, et trois frais : 4 000 de fret maritime au poids, 1 200 de droits de douane à la valeur, 300 d’honoraires du transitaire à parts égales.

Le tableau « Répartition » donne, pour chaque ligne, la quantité, la quantité déjà entrée en stock, le prix d’achat net, le poids unitaire, les frais affectés, les frais par unité et le coût rendu unitaire : 77,35710 pour la perceuse et 59,21430 pour le coffret de forets, achetés 50 chacun. La somme des frais affectés retombe sur 5 500,00. Le dossier est « Appliqué avant réception » ; le journal montre, ligne par ligne, le coût de réception avant et après.

Sur la commande fournisseur, l’onglet « Frais d’approche » liste les dossiers d’arrivage qui contiennent la commande, avec leur état. Le bouton + crée un nouveau dossier avec cette commande déjà ajoutée.

Seuls les produits réellement traités sont modifiés. Un produit présent sur plusieurs lignes prend la moyenne de ses coûts rendus, pondérée par les quantités.

• Deux droits dédiés : « Consulter les dossiers d’arrivage » et « Créer, modifier et appliquer les dossiers d’arrivage ». Sans le second, les dossiers restent consultables mais aucun bouton n’est affiché, et une écriture forcée est refusée.
• Jeton anti-CSRF vérifié sur toutes les actions qui écrivent, y compris la page de configuration, réservée aux administrateurs.
• Confirmation avant d’appliquer, d’annuler ou de supprimer un dossier. Avant d’appliquer, la fenêtre signale les lignes de commande qui ne sont pas entièrement reçues ou en réception.
• Transactions : une application ou une annulation qui échoue en cours de route n’écrit rien.
• Dossier appliqué verrouillé : ni commande, ni frais ne peuvent être modifiés tant que l’application n’est pas annulée.
• Onglet de la commande soumis aux mêmes contrôles d’accès que la fiche commande fournisseur de Dolibarr.
• Multi-société : dossiers, commandes, factures et stocks limités aux entités autorisées.

Le dossier dolixapproche, code source complet et lisible, sous licence GPL v3 ou ultérieure : le descripteur du module, les écrans (liste, fiche du dossier, onglet de la commande, page de configuration), les classes de calcul et d’application, les scripts SQL des tables et les icônes.

Aucune version maximale n’est inscrite dans le module.

• Quatre tables sont ajoutées : llx_dolixapproche_dossier (les dossiers), llx_dolixapproche_order (les commandes rattachées), llx_dolixapproche_frais (les frais) et llx_dolixapproche_journal (chaque valeur modifiée, avec l’ancienne).
• Ce que le module écrit en dehors de ses tables, et seulement quand vous appliquez ou annulez : le coût des lignes de réception en brouillon, le PMP des produits et, si l’option est cochée, leur prix de revient. Aucune facture ni écriture comptable n’est touchée.
• Un réglage est enregistré : DOLIXAPPROCHE_UPDATE_COST_PRICE.
• Aucune connexion sortante : rien n’est envoyé nulle part.
• À la désactivation, le menu et l’onglet disparaissent. Les coûts, PMP et prix de revient déjà appliqués restent tels quels : annulez l’application avant de désactiver si vous voulez revenir en arrière. Les quatre tables, avec le journal, et le réglage ne sont pas supprimés.