📄 Truckflow

Truckflow

Flux d'échange Truckflow <=> Odoo

Odoo => Truckflow

voir si on exporte en FTP ou pas.

Produits

​ ​On exporte les produits depuis Odoo dans Truckflow. 



 Exemple des champs existants sur Produit dans TruckFlow 

💡

Seuls les produits avec un "flag" Produit Pesable sur pont bascule sont exportés (bouton radio pesable / pas pesable à sélectionner obligatoirement à la création du produit)

      • Export API toutes les heures de toute la base (au cas où un petit malin supprimerait un produit de TruckFlow + Mise à jour des actifs/inactifs)


données exportées et mapping

  • nom Odoo => libellé produit Truckflow
  • ID Odoo => code produit Truckflow + ID_ODOO_Produit
    Le code produit est la clé dans Truckflow
  • Actif Odoo => Est actif Truckflow



            champs dans Truckflow (Produit)

⚠️

Il faut empêcher de supprimer un produit de Odoo (en prod) (avec une automatisation à la suppression qui raise User Error ("blabala merci d'archiver le produit"). Utiliser l'archivage à la place et passer le champ 

Tiers

Export tous les heures

💡

Dans Odoo, il n'existe qu'une base de contacts mêlant les personnes et sociétés, les clients (= ont déjà acheté) et les fournisseurs (=on a déjà commandé là bas) et les autres contacts.

Dans Truckflow,  2 cas de figure :

  • C'est un pro et c'est la société qui vous intéresse (c'est elle qui va porter la commande)
  • C'est un particulier, je prends le particulier

Ce qui revient à dire qu'on exclue l'import des contacts personnes physiques liés à une société (Emmanuel chez Digitalsace ne sera jamais exporté vers Truckflow)

En effet, la hierarchie contact personnes physiques / nom société n'existe pas dans TruckFlow, donc n'y est pas récupérable (ce qui n'empêche pas d'y saisir des noms au niveau chauffeur/contact client par ex.)

EMMANUEL : VOIR COMMENT rapproter le distingo PRO/particulier dans TF

PLAQUE 

      • données exportées et mapping

        • nom odoo => libellé tiers Truckflow
        • ID Odoo => code tiers Truckflow + ID Odoo tiers
        • street + street 2 + zip + city dans Adresse 1 du tiers
        • plaque d'immatriculation
          Faut il d'autres données??
Commandes ou Livraisons...??

Export FTP toutes les heures toutes les 5 minutes

  • des commandes de ventes (pas les devis) contenant un produit pesable et modifiées depuis moins de 1 jour 
    • les commandes de ventes répondant aux critères suivants seront passées en Est actif = False (masquée à la pesée dans Truckflow) :
      • soit une date de livraison > J+48h
      • soit entièrement facturées
      • Soit statut <> commande client (donc on inactive les devis, et commandes annulées)
    • Toutes les autres commandes devront être forcée en Est actif = True
  • et des commandes d'achat (pas les demandes de prix) contenant un produit pesable et modifiées depuis moins de 1 jour
    • les commandes d'achat répondant aux critères suivants seront passées en Est actif = False :
      • soit une date de réception > J+7 (je sens que les users vont être moins assidus sur ces items)
      • soit réceptionnées entièrement
      • Toutes les autres commandes devront être forcée en Est actif = True


Toutes ces commandes vont dans regroupement côté Truckflow. 

💡

On exportera dans regroupement côté Truckflow avec

ODOO

Champs Truckflow

Remarques

Numéro de commande (SOxxxxx pour les devis, POxxxx pour les Achats)

N° commande ODOO et dans Commande ODOO

1 champs pour la visibilité opérateur, 1 champ pour l'export pesée

Nom contact + Nom du produit pesable

Client : 5 stères Buches 30cm 

Attention ici il faut prévoir que l'automatisation découpe la commande client si elle contient plusieurs produits pesables :
Client : 5 stères de buche 30cm => 1 ligne d'export
Client : 50 kg de compost => 1 autre ligne d'export

Descriptif


Le client

identifié par son ID en base 

Code tiers


Truckflow regarde si le code Tiers existe déjà ou pas

Le produit 

identifié par son ID en base

Code produit 

Truckflow regarde si le code Tiers existe déjà ou pas

!! dans le cas où plusieurs produits pesables apparaitraient sur la même commande il faut exporter autant de commandes dans Odoo (une avec le 1er produit pesable, une autre avec le deuxième etc..

Société (Bois Bûche, EARL Ste ANNE..)

Quelles sociétés vont vendre des produits pesables par le pont bascule?

Code société



Type

Si on exporte une commande achat alors on met type à Livraison Fournisseur

pour éviter une ressaisie

Type de flux

Expédition pour une commande client, Réception pour un commande d'achat


Truckflow => Odoo

Export depuis TruckFlow au fil de l'eau (=~instantané) des pesées. Ces pesées sont importées immédiatement et créés dans Odoo (avec dédoublonnage)


Mécanismes de traitements des flux de pesées dans Odoo

Exemple de fichier d'export de pesées en xlsx : Aurélie, peux-tu nous informer des champs que tu souhaites que nous expotions dans Odoo (pour consultation de l'historique des pesées) ?/

Dans tous les cas de figure, en cas d'anomalie, une alerte sera remontée à un user Sainte Anne défini dans la configuration.

  1. Type de flux = Expédition (verrouillé par TruckFlow : poids sortie > poids d'entrée)
    1. Si une commande Odoo a été sélectionnée on la met à jour pour le produit qui a été pesé (puisque il peut y avoir plusieurs fois la même commande avec plusieurs produits)
      1. Le produit peut avoir été substitué par un produit de même catégorie (commande odoo = buche 30cm/retour truckflow : buches 25cm) => dans ce cas si même catégorie et si le produit matche pas , il faut le substituer dans la commande odoo
    2. Sinon, on la crée avec LE produit pesé
    3. attention pour les pesées sans commandes liées il faut mettre le champ plaque d'immatriculation de façon à ce qu'il ressorte à la caisse lors de l'appel de la commande (donc dans l'adresse a priori, qui elle ne sera pas remplie).
      il faut mettre le champ par ici :
      ⚠️

      Le poids remonté de truckflow doit alimenter la livraison du produit .

      Attention à prévoir des cas tordus comme une commande avec plusieurs livraisons (19 stères répartie en 10 + 9 par ex) et des livraisons multiples de ce type (pour une même commande) regroupé (fusionné) sur un seul BL (ce qui donne 2 lignes du même produit sur le même BL => voir si il faut automatiser que ces 2 lignes ne redeviennent qu'une)


    4. La commande pourra être rappelé à la caisse pour encaissement ou facturée (fin de mois ou pas) depuis Odoo
  2. Type de flux = Réception
    1. Cas du retour client => il faut le flaguer au moment de la saisie Truckflow (Type = retour client colonne AT ) et que faire ??? (le client aura peut-être été remboursé en caisse ou pas;..) => levé une activité dans Odoo
    2. Livraison de marchandise => Type = Livraison Fournisseur
      1. Si une commande Odoo a été sélectionnée on la met à jour pour le produit qui a été pesé (puisque il peut y avoir plusieurs fois la même commande avec plusieurs produits)
      2. Sinon, on la crée avec LE produit pesé (ce cas de figure peut il se produire réellement en réception??)
    3. Le produit est de type "apport matière" (Les 3 produits possibles Déchets végétaux/ Terre / Souches: unité kg)
      1. on génère une commande CLIENT avec la quantité = la quantité pesée

​Sécurisation des pesées

Truckflow ne garantit pas que chaque pesée sera transmise en temps réel sans erreur. 

​En revanche, les pesées ne sont jamais modifiables côté Truckflow après clôture : ce qui arrive dans Odoo est définitif.

Pour s'assurer qu'aucune pesée ne manque dans Odoo, on met en place un double flux :

Le flux principal (fil de l'eau) — Chaque pesée terminée est envoyée automatiquement vers Odoo dès qu'elle est clôturée sur le pont ​bascule. C'est le fonctionnement normal, au quotidien.

Le flux de contrôle (batch nocturne) — Chaque nuit, Truckflow réexporte l'intégralité des pesées des 72 dernières heures vers une table de ​contrôle dans Odoo. Odoo compare alors cette table avec les pesées déjà reçues en journée. Si elle existe déjà, elle est simplement ignorée — aucun doublon possible. [on se base sur l'ID de pesée de Truckflow i.e. : d2e08805-295f-f111-b3d7-e4c767013195]
​ ​
⚠️
Si une pesée manque , que fait-on ?
​ ​
​ ​Je propose :
      • création de la pesée dans la table des pesées (pour que cette table soit complète)
      • flag automatique de la dite pesée ("importée a posteriori")

        • on ne déclenche aucun traitement automatique (possible qu'elle est était traitée manuellement)
        • on envoi un mail à un responsable pour dire "il y a un problème"


Cas à traiter encore (EM)

  • cas des chèques energie (probable moyen de paiement au niveau de la caisse)
  • documenter et tester le cas des encaissement en avance (enregistrer une commande + facture d'acompte + les différentes pesées qui viennent alimenter la même commande)
  • Attention un certain nombre de commandes sont livrés par EARL Ste Anne à ses clients. Ils vont donc pas mal utiliser les Bons de livraison
❌

L'architecture TRUCKFLOW CI-DESSOUS doit être remise à jour, même si on est très proche du final. PAS DE RELECTURE CI-DESSOUS