View source for Siren-b2b-pa-pdp

<nowiki>[[Category:Modules complémentaires]]</nowiki>

== SirenCreatTiers — Fiche tiers automatique par SIREN ==
'''SirenCreatTiers complète automatiquement une fiche tiers Dolibarr à partir de son numéro SIREN (raison sociale, adresse du siège, SIRET, code APE, forme juridique, TVA intracommunautaire), vérifie si l'entreprise est joignable en facturation électronique, permet de la relancer par mail quand elle ne l'est pas, et contrôle dans le temps que la fiche reste conforme au répertoire Sirene.'''

=== Présentation ===
SirenCreatTiers s'installe en complément du module natif Tiers (modSociete). Dès qu'un SIREN valide est saisi dans le champ « Id prof. 1 » d'une fiche tiers, le module interroge le répertoire Sirene de l'INSEE et remplit automatiquement les informations de l'entreprise, tout en indiquant si celle-ci peut recevoir des factures électroniques. Un contrôle périodique, à l'ouverture de chaque fiche, signale ensuite les écarts éventuels avec les données officielles. Le module ne modifie aucun fichier du cœur de Dolibarr.
{| class="wikitable"
!Information
!Valeur
|-
|Nom technique
|sirencreattiers
|-
|Numéro de module
|493163
|-
|Version
|1.2.5
|-
|Éditeur
|KSIDol.io (copyright KSI 30)
|-
|Compatibilité Dolibarr
|18.0 à 24.x (testé en exécution réelle sur Dolibarr 18.0.6 / PHP 8.1 et Dolibarr 24 / PHP 8.3)
|-
|PHP minimum
|7.1
|-
|Dépendance
|Module natif Tiers (modSociete)
|-
|Licence
|GPLv3
|-
|Langues
|fr_FR, en_US, de_DE, es_ES, it_IT
|}

=== Liens officiels ===

* Boutique : <nowiki>https://ksidol.io</nowiki>
* Fiche du module : <nowiki>https://www.ksidol.io/fr/modules/detail?module=main_module_sirencreattiers</nowiki>
* Démonstration en ligne : <nowiki>https://www.ksidol.io/t/demo-erp/</nowiki> (identifiant : Login / mot de passe : DEMO)

=== Installation ===

# Téléchargez le module depuis la fiche produit indiquée ci-dessus.
# Décompressez l'archive dans le répertoire <code>htdocs/custom/</code> de votre installation Dolibarr.
# Depuis Dolibarr, allez dans '''Configuration → Modules''', repérez SirenCreatTiers et activez-le.
# Le module dépend du module natif Tiers (modSociete) : vérifiez qu'il est bien activé.
# Ouvrez la configuration du module pour renseigner la clé API INSEE (voir la section Configuration).

=== Droits ===
Le module ne déclare aucun droit Dolibarr qui lui soit propre : c'est le droit natif Tiers → Lire (ou le statut d'administrateur) qui autorise la recherche, et le droit Tiers → Créer/Modifier qui autorise la relance par mail.

=== Périmètre fonctionnel détaillé ===

* Sur le formulaire de création ou de modification d'un tiers, la saisie du SIREN se fait dans le champ « Id prof. 1 » : un bouton loupe déclenche la recherche, ou celle-ci se lance automatiquement dès que 9 chiffres valides sont saisis (réglable).
* Remplissage automatique : raison sociale (le sigle alimente l'alias quand il existe), adresse du siège, code postal, ville, SIRET du siège (Id prof. 2), code APE (Id prof. 3), forme juridique, numéro de TVA intracommunautaire calculé.
* En création, tous les champs sont remplis ; en modification, seuls les champs vides le sont par défaut (un réglage permet d'écraser les valeurs existantes).
* Pour un entrepreneur individuel dont la dénomination légale est le nom civil, le nom commercial INSEE (enseigne ou dénomination usuelle de l'établissement) alimente le nom alternatif de la fiche.
* La saisie du SIREN tolère les espaces et le formatage : « 938 582 186 » est accepté et nettoyé automatiquement.
* À chaque recherche, l'annuaire central Peppol (SML/SMP) est interrogé nativement : l'entreprise peut-elle recevoir des factures électroniques, par quelle plateforme de réception, le Factur-X est-il accepté. Ce canal fonctionne sans le module EInvoicing.
* Si le module EInvoicing est actif et relié à une plateforme agréée, son service d'annuaire normalisé (AFNOR XP Z12-013) est également interrogé et l'adresse de routage du tiers est pré-remplie sur le formulaire de création.
* Quand les deux sources d'annuaire ne concordent pas, un seul verdict est affiché : la réponse positive fait foi, une plateforme pouvant ignorer à tort une entreprise pourtant enregistrée et joignable.
* Si l'entreprise n'est pas joignable en facturation électronique, une confirmation est demandée à l'enregistrement de la fiche (désactivable).
* Contrôle périodique : à l'ouverture d'une fiche tiers, ses données sont comparées au répertoire Sirene et à l'annuaire de facturation électronique. En cas d'écart, un bandeau liste les différences champ par champ avec deux boutons : « Mettre à jour la fiche » (applique les données INSEE) ou « Valider telle quelle » (garde les valeurs actuelles). Une fiche conforme ou validée n'est plus contrôlée pendant la durée réglable (90 jours par défaut).
* Avertissements sans blocage de la saisie : entreprise administrativement cessée, en diffusion restreinte au répertoire Sirene, ou clé de contrôle SIREN inhabituelle (certains SIREN parfaitement légitimes dérogent à la règle de contrôle, par exemple celui de La Poste).
* Cache local des réponses INSEE pendant 30 jours, pour économiser le quota de l'API (offre publique INSEE : 30 requêtes/minute, 2000 requêtes/heure).
* La page de configuration intègre un guide pas-à-pas complet (en 5 langues) pour créer la clé API INSEE gratuite, avec un bouton « Tester la connexion ».
* Un réglage limite tous les contrôles aux tiers français (activé par défaut) ; pour les entreprises étrangères, le contrôle TVA VIES natif de Dolibarr, à côté du champ de TVA intracommunautaire, reste l'outil de référence.
* Le point d'accès de recherche (<code>ajax/lookup.php</code>) est réservé aux utilisateurs internes authentifiés disposant du droit de lecture des tiers.

=== Relance par mail des entreprises absentes de l'annuaire ===

* Sur la fiche d'une entreprise (B2B) qui ne peut pas recevoir de factures électroniques, une enveloppe rouge « Envoyer un mail de mise à jour au client » ouvre une fenêtre d'envoi. L'enveloppe apparaît aussi sur le formulaire de modification du tiers, à côté du résultat du contrôle SIREN.
* Le message est prérempli depuis le modèle de la page de configuration (objet et corps), les jetons étant remplacés à l'envoi. Il est affiché mis en forme et modifiable directement : ce qui est relu est exactement ce que le client recevra.
* Le destinataire et la copie se choisissent parmi le tiers et ses contacts, avec une case « recevoir une copie » et une case « accusé de réception » (valeur par défaut réglable). Toute adresse postée est revalidée côté serveur contre cette liste : aucune saisie libre n'est acceptée.
* Chaque envoi est tracé dans l'historique du module et donne lieu à un événement dans l'agenda du tiers ; la date du dernier envoi est rappelée dans la fenêtre.
* Le modèle livré est rédigé comme une demande d'information entre entreprises : il demande l'adresse électronique de facturation du client (l'identifiant déclaré à l'annuaire : SIREN, SIRET ou code de routage), seule donnée nécessaire pour lui adresser ses factures.
* Jetons disponibles dans le modèle : <code>__THIRDPARTY_NAME__</code>, <code>__THIRDPARTY_SIREN__</code>, <code>__REPLY_EMAIL__</code>, <code>__SENDER_NAME__</code>, <code>__MYCOMPANY_NAME__</code>.

=== Notes techniques ===
Le module crée trois tables SQL :

* <code>llx_sirencreattiers_cache</code> — cache des réponses de l'API Sirene INSEE, durée de vie 30 jours, purge automatique des entrées expirées.
* <code>llx_sirencreattiers_check</code> — état du contrôle périodique par fiche tiers (date, statut, écarts).
* <code>llx_sirencreattiers_mail</code> — historique des mails de relance envoyés.

Il expose trois points d'accès ajax :

* <code>ajax/lookup.php</code> — recherche par SIREN : API Sirene INSEE, annuaire central Peppol, et service d'annuaire de EInvoicing si ce module est actif.
* <code>ajax/check.php</code> — applique le contrôle périodique (mise à jour de la fiche avec les données INSEE, ou validation manuelle).
* <code>ajax/mail.php</code> — envoi du mail de relance (liste de destinataires fermée, accusé de réception, traçabilité).

=== Configuration ===

* <code>SIRENCREATTIERS_INSEE_API_KEY</code> : clé API gratuite du portail INSEE Sirene, avec bouton « Tester la connexion » et guide intégré.
* <code>SIRENCREATTIERS_AUTO_LOOKUP</code> : déclenche la recherche automatiquement dès qu'un SIREN valide (9 chiffres) est saisi. Activé par défaut.
* <code>SIRENCREATTIERS_OVERWRITE_ON_EDIT</code> : écrase les champs non vides du tiers en modification au lieu de ne compléter que les champs vides. Désactivé par défaut.
* <code>SIRENCREATTIERS_PEPPOL_CHECK</code> : interroge l'annuaire de facturation électronique (Peppol natif, et EInvoicing si actif). Activé par défaut.
* <code>SIRENCREATTIERS_CONFIRM_ON_SUBMIT</code> : demande une confirmation à l'enregistrement de la fiche si l'entreprise n'est pas joignable. Activé par défaut.
* <code>SIRENCREATTIERS_CHECK_ENABLED</code> : active le contrôle périodique des fiches tiers à l'ouverture. Activé par défaut.
* <code>SIRENCREATTIERS_CHECK_TTL_DAYS</code> : durée de validité, en jours, d'un contrôle réussi ou validé manuellement. 90 par défaut.
* <code>SIRENCREATTIERS_ONLY_FR</code> : ignore les tiers dont le pays n'est pas la France. Activé par défaut.
* <code>SIRENCREATTIERS_MAIL_ENABLED</code> : affiche l'enveloppe rouge de relance sur les fiches non joignables. Réservé aux utilisateurs pouvant modifier les tiers.
* <code>SIRENCREATTIERS_MAIL_SUBJECT</code> / <code>SIRENCREATTIERS_MAIL_BODY</code> : modèle du mail de relance (objet et corps, jetons remplacés à l'envoi).
* <code>SIRENCREATTIERS_MAIL_ACK</code> : coche par défaut la case « accusé de réception » dans la fenêtre d'envoi.

=== Parcours type ===

# Créez un compte gratuit sur le portail des API de l'INSEE et souscrivez à l'API Sirene (guide intégré à la configuration du module).
# Collez la clé API dans la configuration du module puis cliquez sur « Tester la connexion ».
# Ouvrez un formulaire de création de tiers et saisissez un SIREN : la fiche se remplit automatiquement.
# Vérifiez le verdict d'annuaire de facturation électronique affiché sous le champ SIREN.
# Enregistrez la fiche (une confirmation est demandée si l'entreprise n'est pas joignable).
# Si elle n'est pas joignable, cliquez sur l'enveloppe rouge pour lui envoyer une demande d'adresse électronique de facturation.
# Aux ouvertures suivantes de la fiche, le contrôle périodique signale les écarts éventuels avec le répertoire Sirene et propose une mise à jour en un clic.

=== Dépannage ===

* Clé API INSEE non configurée : renseignez la clé dans la configuration du module puis utilisez « Tester la connexion ».
* Aucune donnée récupérée pour un SIREN qui existe réellement : vérifiez le format (9 chiffres), vérifiez que l'entreprise n'est pas en diffusion restreinte au répertoire Sirene, vérifiez le quota de l'API INSEE.
* Verdict d'annuaire de facturation électronique absent : le contrôle peut être désactivé (<code>SIRENCREATTIERS_PEPPOL_CHECK</code>) ou limité aux tiers français (<code>SIRENCREATTIERS_ONLY_FR</code>).
* Enveloppe de relance absente : la relance peut être désactivée (<code>SIRENCREATTIERS_MAIL_ENABLED</code>), l'utilisateur peut ne pas avoir le droit de modifier les tiers, ou l'entreprise est joignable (l'enveloppe ne s'affiche jamais dans ce cas, ni sur un particulier).
* Mail non envoyé : vérifiez qu'une adresse e-mail valide figure sur la fiche du tiers et que l'adresse d'expéditeur est renseignée dans la configuration des e-mails de Dolibarr ou sur votre fiche utilisateur.
* Le champ Forme juridique ne s'affiche pas sur une installation V18 : cela dépend de la constante native <code>MAIN_INFO_SOCIETE_COUNTRY</code> de l'instance Dolibarr, indépendamment du module.

=== Support ===
Éditeur : KSIDol.io — <nowiki>https://ksidol.io</nowiki>