Documentacion KSIDol > Modulos KSIDol > Tercero por SIREN

Guia del modulo: Tercero por SIREN

Guía de uso no técnica: para qué sirve el módulo, cómo usarlo y cómo se articula con Dolibarr.

Una entrada, una fichaCon el SIREN basta: razón social, dirección, SIRET, APE, forma jurídica, IVA

Factura electrónicaVeredicto del directorio en cada búsqueda (Peppol y plataforma homologada)

Fichas vigiladasDiferencias con el registro Sirene señaladas al abrir la ficha

Cuota preservadaRespuestas del INSEE en caché local 30 días

1. Descripcion del modulo

SirenCreatTiers elimina la introducción manual de los terceros franceses: escriba el número SIREN en el campo «Id prof. 1» del formulario de creación o edición de un tercero, y el módulo consulta la API Sirene oficial del INSEE para rellenar el formulario por usted. De paso comprueba si la empresa puede recibir facturas electrónicas (directorio central Peppol, más el directorio de la plataforma homologada cuando el módulo EInvoicing está conectado), y después sigue vigilando sus fichas en el tiempo: al abrir una ficha, las diferencias con el registro Sirene se listan en un banner, con actualización en un clic.

Relleno automático desde el SIREN: razón social (y sigla como alias), dirección de la sede, código postal, ciudad, SIRET de la sede, código APE, forma jurídica, NIF-IVA intracomunitario calculado.
Botón lupa junto al campo SIREN, y búsqueda automática en cuanto se teclea un SIREN válido (desactivable).
Veredicto del directorio de factura electrónica: empresa localizable o no, plataforma de recepción, aceptación de Factur-X.
Control periódico de las fichas: un banner lista las diferencias, con botones «Actualizar la ficha» y «Validar tal cual».
Avisos útiles: empresa cesada, difusión restringida, dígito de control SIREN inusual.
Caché local de 30 días y acceso reservado a usuarios autenticados con permiso de lectura de terceros.

2. Puesta en marcha: la clave API del INSEE

El módulo se apoya en la API Sirene oficial del INSEE, gratuita pero protegida por clave.

Cree una clave gratuita en el portal de APIs del INSEE (portail-api.insee.fr): la página de configuración del módulo contiene la guía completa paso a paso (cuenta, aplicación, suscripción a la API Sirene, recuperación de la clave).
Pegue la clave en la configuración del módulo y valide con «Probar la conexión».
La oferta pública del INSEE (30 peticiones/minuto, 2 000 peticiones/hora) es de sobra: el módulo guarda las respuestas en caché local durante 30 días.
Active el módulo, abra un formulario de creación de tercero, escriba un SIREN: ya está en servicio.

3. Crear una ficha de tercero desde el SIREN

En el formulario de creación, todo parte del campo «Id prof. 1 (SIREN)».

Escriba el SIREN — se toleran espacios y formato: «938 582 186» se acepta y se limpia automáticamente.
La búsqueda se lanza sola en cuanto hay 9 dígitos válidos (regulable), o manualmente con el botón lupa.
El módulo rellena: razón social, sigla como alias, dirección de la sede, código postal, ciudad, SIRET de la sede (Id prof. 2), código APE (Id prof. 3), forma jurídica y NIF-IVA intracomunitario calculado.
Para un empresario individual cuya denominación es el nombre civil, el nombre comercial del INSEE alimenta el nombre alternativo de la ficha.
Un mensaje bajo el campo confirma la recuperación y muestra el veredicto del directorio de factura electrónica.

4. Completar una ficha existente

El módulo también funciona en el formulario de edición, sin machacar su trabajo.

En edición solo se completan los campos vacíos: lo que ya escribió se conserva.
Un ajuste («Sobrescribir los campos en edición») permite que los datos del INSEE reemplacen los valores existentes.
El botón lupa sigue disponible en todo momento para relanzar la búsqueda.

5. El veredicto del directorio de factura electrónica

En cada búsqueda, el módulo comprueba si la empresa es localizable para la facturación electrónica — la pregunta que todos se harán con la reforma francesa.

Comprobación nativa del directorio central Peppol (SML/SMP), el canal oficial máquina de la reforma, que cubre todas las plataformas homologadas: registrada o no, plataforma de recepción declarada, aceptación de Factur-X.
Si el módulo EInvoicing está activo y vinculado a una plataforma homologada, también se consulta su servicio de directorio normalizado (AFNOR XP Z12-013), y la dirección de enrutamiento del tercero se prerrellena en el formulario de creación.
Se muestra un único veredicto: si las dos fuentes discrepan, prevalece la respuesta positiva (una plataforma puede ignorar una empresa realmente registrada).
Si la empresa no es localizable, guardar la ficha pide confirmación — una simple barrera, desactivable en la configuración.

6. El control periódico de las fichas

Una ficha correcta el día de su creación puede quedarse obsoleta: traslado, cambio de forma jurídica, cese. El módulo vigila sin imponer nada.

Al abrir una ficha de tercero, sus datos se comparan con el registro Sirene y el directorio de factura electrónica.
Si hay diferencias, un banner las lista con precisión, campo a campo (valor de la ficha contra valor del INSEE).
«Actualizar la ficha con los datos del INSEE» aplica las correcciones en un clic; «Validar la ficha tal cual» conserva sus valores.
Una ficha conforme o validada no vuelve a controlarse durante 90 días (regulable); el control puede desactivarse por completo.

7. Avisos y casos particulares

El módulo señala sin bloquear: usted siempre decide.

Empresa administrativamente cesada: se muestra un aviso, la ficha puede crearse igualmente (útil para histórico o contencioso).
Empresa en difusión restringida en el registro Sirene: el módulo se lo indica; algunos datos pueden faltar.
Dígito de control SIREN inusual: simple aviso, la entrada nunca se bloquea (números perfectamente legítimos incumplen la regla — La Poste, por ejemplo).
SIREN desconocido en el registro: mensaje claro, no se rellena nada.

8. Los ajustes del módulo

Todo se pilota desde la página de configuración, sin tocar código.

Clave API del INSEE, con botón «Probar la conexión» y guía de creación integrada.
Búsqueda automática al teclear: activada por defecto, desactivable (el botón lupa permanece).
Sobrescribir los campos en edición: desactivado por defecto.
Control del directorio de factura electrónica: activado por defecto.
Confirmación al guardar cuando la empresa no es localizable: activada por defecto.
Control periódico de las fichas y duración de validez (90 días por defecto).
Limitar los controles a los terceros franceses: activado por defecto — para las empresas extranjeras, el control IVA VIES nativo de Dolibarr sigue siendo la herramienta adecuada.

9. Vinculos con Dolibarr

El modulo no funciona de forma aislada: se integra con los bloques nativos de Dolibarr.

Terceros : El módulo trabaja directamente en el formulario nativo de creación y edición de terceros: sin pantallas paralelas, los datos rellenados son los de la ficha estándar de Dolibarr.
Identificadores profesionales : Los campos nativos Id prof. 1 (SIREN), Id prof. 2 (SIRET) e Id prof. 3 (APE) se usan tal cual, junto con la forma jurídica y el NIF-IVA intracomunitario de la ficha.
Módulo EInvoicing (factura electrónica) : Cuando EInvoicing está activo y vinculado a una plataforma homologada, su directorio normalizado se consulta además del directorio central Peppol, y la dirección de enrutamiento e-invoicing del tercero se prerrellena. Sin EInvoicing, el módulo funciona íntegramente por el canal Peppol nativo.
Control IVA VIES nativo : Para las empresas no francesas, el botón de verificación VIES nativo de Dolibarr, junto al campo de IVA intracomunitario, sigue siendo la herramienta de referencia — el módulo no lo sustituye.
Permisos de usuario : La búsqueda está reservada a usuarios autenticados con permiso de lectura de terceros; ningún dato es accesible sin conexión.