Documentación: Instalación de un Módulo en Dolibarr

 

Facturae para Dolibarr versión 1.0.0 beta

Idiomas soportados: (Catalán, Castellano, Aranés, Euskera, Gallego y Inglés)

Probado en versiones de Dolibarr desde la 17.0.2 hasta la 20.0.3

Última revisión 29/1/2025

Requisitos previos

Pasos para instalar un módulo en Dolibarr

1. Obtención del módulo

Puedes obtener el módulo Facturae en la dirección https://www.projectesidisseny.com.

 

2. Instalación del módulo

Para instalar o crear un módulo externo desde la aplicación se necesita guardar los ficheros del módulo en el directorio /htdocs/rostit/dolibarr/htdocs/custom. Para  permitir a  a Dolibarr el processamento de este directorio, debes configurar tu conf/conf.php añadiendo estas 2 línias:

$dolibarr_main_url_root_alt=’/custom’;
$dolibarr_main_document_root_alt='[ruta completa del servidor]/htdocs/custom’;

Accede a Configuración > Módulos y selecciona la pestaña “Instalar Módulo externo”. Elige el archivo .zip desde tu ordenador y súbelo.

También puedes copiar el contenido del zip en la carpeta “htdocs/custom”

3. Activación del módulo

  1. Accede a Dolibarr como administrador.
  2. Ve a Configuración > Módulos.
  3. Busca el módulo en la lista (en el apartado Módulos Financieros) y haz clic en “Activar”.

4. Configuración del módulo

  1. Accede a Configuración > Módulos/Aplicaciones > Facturae > Configuración.
  2. Sube el certificado digital requerido (formatos .pfx o .p12).
  3. Introduce la contraseña del certificado.
  4. Guarda los cambios.

Funcionalidades del módulo

El módulo Facturae ofrece dos funcionalidades principales:

  • Generación de facturas digitales: Facturas normales y rectificativas adaptadas a las normativas.
  • Integración de facturas digitales de proveedores: Importación y gestión automática de facturas en formato Facturae.

Ejemplo de flujo de trabajo

  • Generación de factura: El funcionamiento del módulo requiere pocas explicaciones ya que la generación es automática. Debemos seguir haciendo lo mismo que hacíamos hasta ahora con la única diferencia de que en el momento en que se genera la factura en PDF, automáticamente también se generará en xml. En próximas versiones habrá una diferencia que dependerá del momento en que hagamos el envío a los organismos oficiales. En ese momento, la factura se bloqueará y no se podrá modificar bajo ningún concepto.
  • Integración de factura: Este proceso puede convertirse en muy útil desde el momento en que tus proveedores comiencen a enviar las facturas en formato facturae, ya que solo arrastrando los archivos a la casilla correspondiente las facturas quedarán registradas. En caso de que se produzca algún error, quedarán en una lista pendientes de solución.

Consideraciones importantes

  • Certificado digital: Debe ser válido y estar instalado correctamente y que no esté caducado.
  • Compatibilidad: Asegúrate de que tus clientes y proveedores utilizan el formato Facturae.
  • ¡ATENCIÓN! Facturas dirigidas a entidades públicas: En la ficha de cliente hay los campos Código Gestor, Nombre Gestor, Código Tramitador, Nombre Tramitador, Código Contable, Nombre Contable.  Estos campos son obligatorios en caso de que las facturas vayan dirigidas a las entitades públicas y no se validará la factura si no se rellenan. Por lo tanto ES RECOMENDABLE , si es su caso, rellenarlas  inmediatamente para todas les entidades públicas donde posiblemente vaya a facturar.
  • La compra del módulo: La compra del módulo da derecho a su utilización indefinida i a todas las actualizaciones y correcciones durante un año. Para seguir disfrutando de las nuevas versiones con las correcciones y actualizaciones, es recomendable abonar la quota de mantenimiento anual y se ira actualizando con las nuevas versiones de dolibarr o requisitos del formato. En caso de dejar de abonarla, se podrà seguir utilizando el programa siempre que las actualizaciones de dolibarr o de los requerimientos técnicos externos lo permitan. En este caso se podra optar a adquirir de nuevo el paquete.

Creación de la sèrie y el número de factura

Dolibarr no diferencia entre los campos de serie y número de factura, por lo que hemos implementado un sistema de separación. El módulo gestiona la separación entre serie y número de factura según el formato introducido:

  • Sin separador (-): Todo el contenido se considera como número; la serie será ‘N’ o ‘R’ según el tipo. Si el número de factura no contiene separador, la serie será ‘N’ en caso de factura normal y ‘R’ en caso de rectificativa. El número de factura se mantendrá tal como se introduzca.

  • Con separador (-): El primer bloque se considera la serie; el resto, el número. La primera parte del número de factura se considerará la serie, y la segunda parte, el número.

Ejemplos:

  • 12345 -> Serie: N, Número: 12345
  • 2023-0456 -> Serie: 2023, Número: 0456

Versión demo

Ahora puedes descargar una versión demo con limitaciones:

  • Puedes generar hasta 25 .xml sin firma
  • No podràs generar facturas a la administración porque no puedes rellenar los campos a tal efecto
  • No podras inegrar facturas de proveedor

 

Descargar version Demo

 

En próximas versiones

  

  • Envio automático al organisme correspondiente.
  • Bloqueo de opciones No se podrà modificar bajo ningún concepto ninguna factura cuando se haya enviado el XML a Face.

Nota:

Este módulo ha requerido muchas horas de desarrollo para garantizar su correcto funcionamiento. La licencia adquirida permite su instalación en un solo sitio web. Si necesitas instalarlo en más de un sitio, será necesario adquirir licencias adicionales.

Si crees que el precio es elevado o necesitas más módulos, no dudes en ponerte en contacto con nosotros para encontrar una solución que se adapte a tus necesidades.

¡Gracias por valorar y respetar el trabajo detrás de este desarrollo!