Compras y stock

Gastos de importación

dolixapproche · versión 1.0.4

Usted reparte el transporte, la aduana y los demás gastos de una llegada de mercancía sobre el coste de los productos y su precio medio ponderado.

Precio
99 € sin IVA
Dolibarr
19.0 mínimo
Versión
1.0.4
Licencia
GPL v3+
Idiomas
Francés, inglés, alemán, español

99 € sin IVA.

El pedido, el pago, la factura y la descarga corren a cargo del DoliStore.

Comprar en el DoliStore — 99 € sin IVA

Pruébelo sin instalar nada: la demo en línea (usuario demo, contraseña demo; datos ficticios, que se restablecen cada noche; la demo está en francés).

Un contenedor, dos proveedores, tres gastos: transporte por peso, aduana por valor, transitario a partes iguales. El coste de importación de cada producto se calcula al céntimo, se aplica antes de la recepción y queda anotado en el registro.
Un contenedor, dos proveedores, tres gastos: transporte por peso, aduana por valor, transitario a partes iguales. El coste de importación de cada producto se calcula al céntimo, se aplica antes de la recepción y queda anotado en el registro. Captura de la interfaz en francés.
01

Lo que hace el módulo

  • Un expediente de llegada agrupa uno o varios pedidos a proveedor, de proveedores distintos si hace falta: un camión, un contenedor. Los pedidos en borrador no se proponen.
  • Cinco tipos de gasto: transporte, derechos e impuestos de aduana, seguro, transitario, otro. Cada gasto tiene un importe sin IVA y, si lo desea, la factura de proveedor correspondiente, vinculada para encontrar el justificante.
  • Cuatro claves de reparto, gasto por gasto: por valor (importe neto de la línea, descuento deducido), por cantidad, por peso (de la ficha del producto, convertido a kg desde t, g, mg, libra u onza) o a partes iguales entre las líneas.
  • Cálculo al céntimo: los céntimos de redondeo van a las líneas cuya parte tiene el mayor resto, y la suma repartida es siempre igual al importe del gasto. Un gasto negativo, un abono por ejemplo, se reparte de la misma manera.
  • Tabla de reparto línea por línea: cantidad, cantidad que ya ha entrado en stock, precio de compra neto, peso unitario, gastos asignados, gastos por unidad y coste unitario de importación. Un gasto imposible de repartir —peso que falta, base nula— bloquea la aplicación y se indican los productos afectados.
  • Aplicación antes de la recepción: el coste de importación se escribe en las líneas de las recepciones que siguen en borrador. Al validar la recepción, Dolibarr calcula el precio medio ponderado con ese coste, con su propia fórmula.
  • Aplicación después de la recepción: el precio medio ponderado se corrige producto por producto, solo sobre la parte que sigue en stock (stock actual / stock justo después de la recepción). La parte que ya ha salido no se revaloriza.
  • Registro de cada cambio y anulación todo o nada, rechazada si desde entonces se ha validado una recepción, ha cambiado un coste o ha cambiado un precio medio ponderado. Opción: actualizar también el precio de coste de los productos, que se anula con el resto. Pestaña en el pedido a proveedor, aviso cuando un pedido figura también en otro expediente, multiempresa respetada.
02

Para quién es

El transportista y el transitario facturan aparte, y el precio medio ponderado de sus productos solo refleja el precio de compra: el valor del stock y los márgenes son erróneos.

Un camión trae las mercancías de dos proveedores. El transportista, un tercer proveedor, factura aparte. El transitario y la aduana también.

En Dolibarr, el PMP (precio medio ponderado) de un producto se calcula al entrar en stock solo con el precio de compra. Los gastos de importación no se reparten sobre ningún producto: el valor del stock queda infravalorado, y los márgenes, sobrevalorados. La única forma nativa es corregir el precio en la recepción, a mano, línea por línea.

Para quién es: Comerciantes e importadores que reciben mercancías de varios proveedores en el mismo camión o contenedor, y pagan el transporte, la aduana o el transitario con facturas separadas.

03

Lo que el módulo no hace

Este apartado figura en las 21 fichas de módulos, sin excepción.

  • No se modifica ningún asiento contable ni ninguna factura: el módulo actúa sobre los costes de recepción, el precio medio ponderado y, como opción, el precio de coste.
  • Sin gastos en moneda extranjera: los gastos se introducen en la moneda de la empresa. Los pedidos en moneda extranjera, en cambio, se toman al tipo del pedido, como hace Dolibarr.
  • Sin arancel aduanero por código de nomenclatura ni cálculo del valor en aduana: los derechos se introducen como importe y se reparten como los demás gastos.
  • Sin reparto por lote o número de serie. Solo los productos reciben gastos: las líneas de servicio y las líneas libres quedan excluidas.
  • La aplicación antes de la recepción exige el módulo Recepciones y una recepción en borrador. Si el stock se actualiza al validar el pedido o la factura de proveedor, no es posible ninguna de las dos aplicaciones.
  • Las cantidades todavía no recibidas en el momento de la aplicación no reciben gastos. Un aviso lo indica antes de confirmar.
  • La corrección del precio medio ponderado después de la recepción se escribe directamente en el producto: no se crea ningún movimiento de stock. Un expediente aplicado ya no puede modificarse mientras no se anule la aplicación.
  • El mismo pedido puede figurar en dos expedientes: el módulo lo recuerda pero no lo impide. La elección de un pedido abarca los 500 últimos pedidos a proveedor, y la de una factura que vincular, las 300 últimas facturas de proveedor.
04

Cómo funciona

El módulo crea un expediente de llegada: un camión, un contenedor. Usted añade los pedidos a proveedor que han llegado juntos, aunque sean de proveedores distintos, y después los gastos.

Los gastos: una descripción, un tipo —transporte, derechos e impuestos de aduana, seguro, transitario, otro—, un importe sin IVA y, si lo desea, la factura de proveedor correspondiente. Este vínculo sirve para encontrar el justificante: no se modifica ningún asiento contable.

El reparto, gasto por gasto:

Clave Base de cada línea
Por valor importe neto de la línea de pedido, descuento deducido
Por cantidad cantidad pedida
Por peso cantidad × peso de la ficha del producto, convertido a kg desde t, g, mg, libra u onza
A partes iguales una parte por línea de producto

El cálculo se hace al céntimo. Los céntimos de redondeo van a las líneas cuya parte tiene el mayor resto: la suma repartida es siempre igual al importe del gasto. Un gasto negativo, un abono por ejemplo, se reparte de la misma manera. Un gasto imposible de repartir —un producto sin peso en un reparto por peso, una base nula— bloquea la aplicación, y se indican los productos afectados.

Antes o después de la recepción

Antes de la recepción. El coste de importación (precio de compra neto + gastos por unidad) se escribe en las líneas de las recepciones que siguen en borrador. Al validar la recepción, es Dolibarr quien calcula el PMP con ese coste, con su propia fórmula. El módulo no reescribe ese cálculo.

Después de la recepción, cuando la factura del transportista llega más tarde. El PMP se corrige producto por producto, solo sobre la parte que sigue en stock: la parte de los gastos aplicada es stock actual / stock justo después de la recepción. La parte que ya ha salido no se revaloriza, y los márgenes pasados no cambian.

Lo que es posible depende de cómo entran en stock sus compras:

Entrada en stock de las compras Antes de la recepción Después de la recepción
Validación de una recepción (módulo Recepciones) sí sí
Recepción desde el pedido a proveedor, sin el módulo Recepciones no sí
Validación del pedido o de la factura de proveedor no no

En el último caso, el módulo no encuentra ninguna cantidad recibida y no puede aplicar nada.

El registro y la anulación

Cada valor modificado se registra con el valor anterior y el nuevo, la cantidad, el stock y el importe. La aplicación puede anularse, todo o nada, mientras nada se haya movido: recepción todavía en borrador, coste de línea, PMP y precio de coste sin cambios. Si un solo producto ha cambiado, no se anula nada y se muestra el motivo producto por producto.

El menú está en ProductosAlmacenesGastos de importación.

La ficha de un expediente cabe en una página. En la captura, el expediente «Conteneur Le Havre — semaine 41» agrupa dos pedidos de dos proveedores, 5000 y 15 000 sin IVA, y tres gastos: 4000 de flete marítimo por peso, 1200 de derechos de aduana por valor, 300 de honorarios del transitario a partes iguales.

La tabla «Répartition» (reparto) da, para cada línea, la cantidad, la cantidad que ya ha entrado en stock, el precio de compra neto, el peso unitario, los gastos asignados, los gastos por unidad y el coste unitario de importación: 77,35710 para el taladro y 59,21430 para el estuche de brocas, comprados a 50 cada uno. La suma de los gastos asignados vuelve a dar 5500,00. El expediente está «Appliqué avant réception» (aplicado antes de la recepción); el registro muestra, línea por línea, el coste de recepción antes y después.

En el pedido a proveedor, la pestaña «Frais d’approche» (gastos de importación) lista los expedientes de llegada que contienen el pedido, con su estado. El botón + crea un nuevo expediente con este pedido ya añadido.

Desde el pedido a proveedor, la pestaña «Frais d'approche» (gastos de importación) muestra los expedientes de llegada que lo contienen, y permite crear uno nuevo con este pedido.
Desde el pedido a proveedor, la pestaña «Frais d'approche» (gastos de importación) muestra los expedientes de llegada que lo contienen, y permite crear uno nuevo con este pedido. Captura de la interfaz en francés.
05

Ajustes

Ajuste Por defecto Efecto
Actualizar también el precio de coste de los productos desactivado El precio de coste de la ficha del producto (campo «Precio de compra» en la interfaz española de Dolibarr) toma el coste de importación de la última llegada aplicada. Vuelve a su valor anterior si se anula la aplicación.

Solo se modifican los productos realmente tratados. Un producto presente en varias líneas toma la media de sus costes de importación, ponderada por las cantidades.

06

Seguridad y salvaguardas

  • Dos permisos propios: «Ver los expedientes de llegada» y «Crear, modificar y aplicar los expedientes de llegada». Sin el segundo, los expedientes se pueden consultar pero no se muestra ningún botón, y una escritura forzada se rechaza.
  • Token anti-CSRF comprobado en todas las acciones que escriben, incluida la página de configuración, reservada a los administradores.
  • Confirmación antes de aplicar, anular o eliminar un expediente. Antes de aplicar, la ventana señala las líneas de pedido que no están totalmente recibidas o en recepción.
  • Transacciones: una aplicación o una anulación que falla a mitad de camino no escribe nada.
  • Expediente aplicado bloqueado: no se pueden modificar ni pedidos ni gastos mientras no se anule la aplicación.
  • Pestaña del pedido sujeta a los mismos controles de acceso que la ficha del pedido a proveedor de Dolibarr.
  • Proveedores limitados como en Dolibarr: sin el permiso de ver todos los terceros, un usuario solo ve los expedientes cuyos pedidos y facturas de proveedor son todos de proveedores de los que es el comercial asignado; solo se le proponen esos, y un pedido o una factura de otro proveedor se rechaza.
  • Multiempresa: expedientes, pedidos, facturas y stocks limitados a las entidades autorizadas.
07

Lo que se entrega

Lo que el módulo escribe en su instalación
Tablas creadas en la base de datosCuatro tablas: llx_dolixapproche_dossier (expedientes de llegada: referencia, descripción, fecha de llegada, estado, nota), llx_dolixapproche_order (pedidos a proveedor vinculados a cada expediente), llx_dolixapproche_frais (gastos: descripción, tipo, importe sin IVA, clave de reparto, factura de proveedor vinculada) y llx_dolixapproche_journal (cada valor modificado, con el valor anterior y el nuevo, la cantidad, el stock y el importe, para poder anularlo).
PermisosDos permisos: «Ver los expedientes de llegada» y «Crear, modificar y aplicar los expedientes de llegada». Sin el segundo, los expedientes se pueden consultar pero no se muestra ningún botón. La pestaña del pedido a proveedor está sujeta además a los mismos controles de acceso que la ficha del pedido a proveedor de Dolibarr. La página de configuración está reservada a los administradores.
Desinstalación
  • Desactive el módulo en ConfiguraciónMódulos. El menú y la pestaña del pedido a proveedor desaparecen.
  • Los costes de recepción, precios medios ponderados y precios de coste ya aplicados quedan como están. Para volver a los valores anteriores, anule la aplicación antes de desactivar.
  • Las cuatro tablas llx_dolixapproche_* y el ajuste del módulo no se eliminan.

La carpeta dolixapproche, código fuente completo y legible, bajo licencia GPL v3 o posterior: el descriptor del módulo, las pantallas (lista, ficha del expediente, pestaña del pedido, página de configuración), las clases de cálculo y de aplicación, los scripts SQL de las tablas y los iconos.

Idiomas francés (fr_FR), inglés (en_US), alemán (de_DE), español (es_ES)
Documentación README.md y ChangeLog.md en la carpeta del módulo
Versión mínima de Dolibarr 19.0, declarada en el descriptor
Versiones en las que el módulo se ha instalado y ejecutado 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4, 24.0.1 y 24.0.2
PHP mínimo 7.4
Módulos de Dolibarr necesarios Proveedores, Stocks de productos
Módulo de Dolibarr recomendado Recepciones, para aplicar antes de la recepción

El módulo no declara ninguna versión máxima.

  • Se añaden cuatro tablas: llx_dolixapproche_dossier (los expedientes), llx_dolixapproche_order (los pedidos vinculados), llx_dolixapproche_frais (los gastos) y llx_dolixapproche_journal (cada valor modificado, con el anterior).
  • Lo que el módulo escribe fuera de sus tablas, y solo cuando usted aplica o anula: el coste de las líneas de recepción en borrador, el PMP de los productos y, si la opción está marcada, su precio de coste. No se toca ninguna factura ni ningún asiento contable.
  • Se guarda un ajuste: DOLIXAPPROCHE_UPDATE_COST_PRICE.
  • Ninguna conexión saliente: no se envía nada a ninguna parte.
  • Al desactivarlo, el menú y la pestaña desaparecen. Los costes, PMP y precios de coste ya aplicados quedan como están: anule la aplicación antes de desactivar si quiere volver atrás. Las cuatro tablas, con el registro, y el ajuste no se eliminan.
08

Compatibilidad

El descriptor del módulo solo declara una versión mínima. En el código no figura ningún límite superior: las versiones siguientes son aquellas en las que el módulo se ha ejecutado de verdad.

Compatibilidad del módulo Gastos de importación
Versiones de DolibarrDolibarr 19.0 mínimo. Instalado y ejecutado en 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4, 24.0.1 y 24.0.2.
PHP mínimo7.4
Módulos de Dolibarr que activarProveedores, Stocks de productos
LicenciaGPL v3 o posterior, código fuente completo
IdiomasFrancés, inglés, alemán, español
MenúMenú ProductosAlmacenes«Gastos de importación», y pestaña «Gastos de importación» en la ficha del pedido a proveedor.
09

Instalación

  1. Obtenga el módulo en el DoliStore y descargue el archivo zip.
  2. En Dolibarr: InicioConfiguraciónMódulospestaña «Instalar módulo externo», y suba el zip. Si no, descomprima la carpeta dolixapproche en htdocs/custom/.
  3. Active «Gastos de importación» en la lista de módulos. Los módulos Proveedores y Stocks de productos se activan si no lo estaban, y las cuatro tablas se crean en ese momento.
  4. Conceda a los usuarios correspondientes el permiso «Ver los expedientes de llegada», y «Crear, modificar y aplicar los expedientes de llegada» a quienes aplican los gastos.
  5. Para aplicar antes de la recepción, utilice el módulo Recepciones y cree la recepción sin validarla. Opcional: marque la actualización del precio de coste en la página de configuración del módulo.

El detalle — permisos de la carpeta custom, alojamiento compartido, actualizaciones, desinstalación — está en la página Instalación y actualizaciones.

10

Preguntas frecuentes

¿En qué versiones de Dolibarr funciona este módulo?

El descriptor exige Dolibarr 19.0 como mínimo y PHP 7.4 como mínimo. El módulo se ha instalado y ejecutado en 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4 y 24.0.1. Si tiene alguna duda sobre su versión, escriba antes de comprar.

La factura del transportista llega después de la recepción. ¿Es demasiado tarde?

No. La aplicación después de la recepción corrige el precio medio ponderado de los productos que ya están en stock, solo sobre la parte que sigue en él. La parte ya vendida no se revaloriza: los márgenes pasados no cambian. Si todo ha salido ya, el producto se omite y se muestra el motivo.

¿El módulo modifica mi contabilidad?

No. No se modifica ningún asiento contable ni ninguna factura. La factura de proveedor vinculada a un gasto solo sirve para encontrar el justificante. El módulo escribe el coste de las líneas de recepción en borrador, el precio medio ponderado de los productos y, si la opción está marcada, su precio de coste.

No utilizo el módulo Recepciones. ¿Funciona el módulo?

En parte. Si registra las entradas en stock desde el pedido a proveedor, solo es posible la aplicación después de la recepción: no hay recepción en borrador en la que escribir el coste. Si el stock se actualiza al validar el pedido o la factura de proveedor, el módulo no ve ninguna cantidad recibida y no puede aplicar nada.

¿Se puede deshacer una aplicación?

Sí, mientras nada se haya movido: recepción todavía en borrador, coste de línea, precio medio ponderado y precio de coste sin cambios. La anulación restaura entonces todos los valores anteriores. Si un solo producto ha cambiado, no se anula nada y se muestra el motivo producto por producto.

¿Y si lo desinstalo?

El menú y la pestaña desaparecen. Los precios medios ponderados y los costes ya aplicados se mantienen: son datos de su base de datos. Las tablas del módulo, con el registro, también se mantienen; puede eliminarlas usted mismo.

¿Quién se encarga del soporte y cómo funcionan las actualizaciones?

El soporte lo presta la persona que escribió el módulo, en support@dolix.fr. El pedido, el pago, la factura y la descarga corren a cargo del DoliStore, donde se publican las nuevas versiones.

11

Historial de versiones

Tomado del archivo ChangeLog.md del módulo: una sola fuente.

1.0.45 de noviembre de 2026

Tras «Aplicar después de la recepción», el mensaje indica el PMP de cada producto antes y después y recuerda que la corrección no crea movimiento de stock; la referencia del producto en el registro abre su ficha de stock. Pedidos en moneda extranjera probados. Probado en 19.0.4 a 24.0.2.

1.0.33 de noviembre de 2026

Interfaz traducida al español (es_ES). Probado en 19.0.4 a 24.0.2 con Dolibarr en español.

1.0.225 de octubre de 2026

Permisos de Dolibarr respetados: sin el permiso de ver todos los terceros, un usuario ya solo ve los expedientes de llegada cuyos pedidos y facturas de proveedor son todos de proveedores de los que es el comercial asignado, y solo esos pedidos y facturas se proponen o se aceptan en un expediente. Probado en 19.0.4 a 24.0.2.

1.0.114 de octubre de 2026

Corrección: la página de un expediente de llegada abierta sin un expediente válido, o «New file» (nuevo expediente) abierto sin permiso de escritura, mostraba los menús dos veces y escribía avisos PHP en el registro del servidor. El mensaje de rechazo se muestra ahora una sola vez. Ningún dato se vio afectado.

1.0.012 de octubre de 2026

Primera versión: expediente de llegada que agrupa uno o varios pedidos a proveedor, de proveedores distintos si hace falta; gastos repartidos por valor, por cantidad, por peso o a partes iguales, al céntimo; factura de proveedor vinculada para la trazabilidad; aplicación antes o después de la recepción; registro y anulación todo o nada; opción de precio de coste; pestaña en el pedido a proveedor; interfaz en francés, inglés y alemán.

12

Soporte de este módulo

Escriba a support@dolix.fr. Responde la persona que escribió el módulo.

Respuesta en un plazo de dos días laborables. No es un servicio de guardia.

Qué incluir en su mensaje

  • La versión exacta de Dolibarr.
  • El módulo afectado y su versión — aquí dolixapproche 1.0.4.
  • Lo que ha hecho, y lo que esperaba.
  • El mensaje de error copiado tal cual, o una captura de pantalla.
  • Cómo está instalado Dolibarr, si lo sabe.

Este módulo está a la venta en el DoliStore.

El pedido, el pago, la factura y la descarga corren a cargo del DoliStore.

Comprar en el DoliStore — 99 € sin IVA
También

Los demás módulos