Documentación/ Integraciones con programas externos/ ICG
Albaranes y facturas de proveedor directos a ICG
Dijit.app registra albaranes y facturas de compra directamente en ICG: numeración por serie, impuestos, descuentos de proveedor y el vencimiento en tesorería, tal y como quedarían si alguien los tecleara a mano en la propia aplicación. Cuando una factura trae los números de albarán del proveedor, además los enlaza, igual que hace ICG al facturar un albarán desde dentro.
Varias sociedades a la vez
Una sola integración atiende cada base de datos de sociedad, cada una con su propio usuario y sus propios valores por defecto.
No deja documentos a medias
Se comprueba antes de escribir que existan los artículos y que el proveedor tenga cuenta contable. Si falta algo, el documento entero se rechaza.
Factura enlazada con sus albaranes
Si la factura trae los números de albarán del proveedor, cada uno se localiza y se marca como facturado.
No adivina
Impuestos, descripciones y descuentos se leen del ERP. El conector no crea proveedores, artículos ni tipos de IVA.
En esta página
Qué hace
Qué hace el conector
Búsqueda de proveedores y artículos
Antes de enviar nada, se puede buscar por nombre, CIF, descripción o referencia de proveedor para casar los datos con los códigos de ICG.
Validación de artículos antes de escribir
Se comprueba de una vez que todos los artículos de las líneas existen en el maestro. Si falta alguno, el documento entero se rechaza sin tocar la base de datos.
Numeración coherente con ICG
El número se toma del contador oficial de la serie o del máximo ya existente en la tabla, el que sea mayor: no colisiona con documentos creados a mano.
Descuento de proveedor prioritario
Si el proveedor tiene un descuento pactado en su ficha, prevalece sobre el que traiga la línea del documento.
Impuestos y tesorería automáticos
El desglose por tipo de IVA y el vencimiento de pago se generan con la cuenta contable y la forma de pago del proveedor.
Enlace de factura con sus albaranes
Los números de albarán del proveedor que cubre la factura se localizan y se marcan como facturados, exactamente igual que al facturar desde ICG.
Multiempresa con credenciales propias
Cada sociedad se conecta con su propio usuario de base de datos y con los permisos que le correspondan.
Aislamiento del envío
Un documento que falla no afecta a los demás del mismo envío: cada uno recibe su propio resultado.
Multiempresa
Varias sociedades a la vez
Un grupo empresarial suele tener una base de datos de ICG por sociedad. La integración atiende a todas desde un único punto: cada envío indica sobre qué sociedad debe trabajar, y en ese momento se resuelve la conexión que corresponde, con su propio usuario y sus propios valores por defecto de serie, almacén y cuenta de gasto.
No existe un estado compartido entre envíos que pueda mezclar datos de una sociedad con los de otra: la sociedad se declara en cada petición, y un envío sin sociedad se rechaza de inmediato.
Añadir una sociedad nueva es una operación de configuración, no un despliegue nuevo que mantener.
Cómo conecta
Cómo conecta
La integración escribe directamente en la base de datos de ICG. Los documentos que crea son albaranes y facturas de compra corrientes: se ven, se contabilizan y se informan exactamente igual que los que introduce tu equipo a mano.
Acceso y seguridad
- Un usuario de base de datos por cada sociedad. La integración se conecta con las credenciales que facilites y trabaja con los permisos de ese usuario: lectura sobre los maestros, escritura sobre compras y tesorería.
- Sentencias preparadas siempre. Todos los valores viajan como parámetros; nunca se concatenan directamente en la sentencia.
- Sociedad validada antes de conectar. El identificador de sociedad se comprueba contra un formato cerrado antes de usarse para resolver la conexión.
- Contraseñas ocultas en la configuración. Se guardan cifradas; dejar el campo vacío al editar los parámetros conserva la anterior.
- Despliegue en la red del cliente. El servicio corre junto al ERP, dentro del perímetro del cliente, y no expone la base de datos al exterior.
Flujo del documento
Cómo se procesa cada documento
Un documento se escribe en varios pasos y el orden importa, porque cada uno depende de lo que ha generado el anterior.
Albarán de compra
- 01Validación de destino. Se comprueba que el documento trae serie y almacén. Sin ellos no hay dónde escribir y se rechaza sin tocar la base de datos.
- 02Validación de artículos. Se comprueba de una vez que todos los artículos de las líneas existen en el maestro. Si falta alguno, se rechaza el documento entero.
- 03Reserva de número. Se calcula el siguiente número de la serie, tomando el mayor entre el contador oficial y el máximo ya presente en la tabla.
- 04Cabecera. Se registra con proveedor, fecha, descuentos, base, impuestos y total, y se avanza el contador de la serie.
- 05Líneas. Cada una se inserta con la descripción oficial del artículo, su tipo de impuesto y el descuento del proveedor si existe.
- 06Impuestos y tesorería. Se registra el desglose por tipo de IVA y el vencimiento con la cuenta contable y la forma de pago del proveedor.
Regla de integridad. Los artículos se validan antes de registrar la cabecera: evita que un artículo desconocido en una línea deje un albarán a medias en ICG que alguien tenga que borrar a mano.
Factura de compra
Sigue el mismo camino que el albarán —numeración, cabecera, líneas, impuestos— con una particularidad: puede incluir los números de albarán del proveedor que cubre. Cada uno se localiza dentro de los albaranes de ese proveedor, se marca como facturado y guarda la referencia a la factura, igual que al facturar un albarán desde la propia aplicación.
La búsqueda se acota siempre al proveedor de la factura, porque el número de albarán solo es único dentro de un proveedor. Si no aparece ninguna coincidencia, o aparece más de una, no se toca ese albarán y se deja constancia del motivo: enlazar el albarán equivocado es peor que no enlazarlo. Una factura sin albaranes se procesa igual, sin ningún enlace.
Si la factura se registra pero algún albarán no se puede enlazar, el envío se da por correcto e indica qué albaranes quedaron pendientes. Reenviar la factura duplicaría un documento contable; el enlace, en cambio, se puede rehacer a mano.
Reglas de negocio
Reglas de negocio
Estas son las decisiones que toma el conector al traducir un documento al modelo de ICG. Explican diferencias entre lo enviado y lo que aparece en el ERP.
| Regla | Comportamiento |
|---|---|
| Numeración | Se toma el contador oficial de la serie o el máximo existente en la tabla, el que sea mayor, para no colisionar con documentos creados a mano. |
| Impuesto de la línea | Se toma del maestro de artículos del ERP, no del documento entrante. |
| Impuesto del desglose | Se busca el tipo cuyo porcentaje coincide con el desglose enviado. Ante varios candidatos, se toma el más bajo, de forma determinista. |
| Descripción de la línea | Se sobrescribe con la descripción oficial del artículo en ICG. |
| Descuento de línea | El descuento pactado con el proveedor, si existe, prevalece sobre el de la línea del documento. |
| Redondeo | Bases y cuotas se redondean a dos decimales, y el total de cada tipo se recalcula ya redondeado. |
| Proveedor o artículo sin referencia | Se usan los valores por defecto configurados en la puesta en marcha. |
| Tesorería | El vencimiento se genera con la cuenta contable y la forma de pago de la ficha del proveedor. Sin cuenta contable, el documento no se da por correcto. |
Principio general. Cuando el documento entrante y el maestro del ERP discrepan en algo que ICG considera suyo —impuestos, descripciones, descuentos de proveedor— gana el ERP. El conector no altera maestros.
Resultados
Resultados y errores
Cada documento enviado produce su propio resultado: cuántos entraron, cuáles no y por qué. Los que fallan se quedan en el listado con su motivo, y la lista se refresca en cualquier caso.
| Situación | Causa | Actuación |
|---|---|---|
| Falta ID de proveedor en ICG | La ficha del proveedor no tiene su referencia. | Completarla en el maestro de proveedores. |
| Fallan todos los documentos de un proveedor | Es el mismo dato ausente en su ficha. | Corregir la ficha una vez y reenviar todos. |
| La insignia ERP muestra un guion en varias líneas | Faltan artículos por asignar. | Asignarlos desde el diálogo de asignación. |
| Falla toda una línea con «artículo sin impuesto de compra» | El artículo no tiene un tipo de IVA configurado en ICG. | Completarlo en el maestro de artículos del ERP. |
| Una factura no enlaza alguno de sus albaranes | El número no aparece, o aparece repetido, entre los del proveedor. | La factura queda registrada igual; revisar y enlazar ese albarán a mano si hace falta. |
| El envío falla entero con error de conexión | Problema con el acceso a la base de datos de ICG. | Repetir una vez; si persiste, revisar los parámetros con quien administre el ERP. |
| Hay que corregir un código de referencia ya puesto | Se asignó el artículo equivocado. | Usar el diálogo de información adicional de esa línea. |
Puesta en marcha
Puesta en marcha
La puesta en marcha es una lista corta. Casi todo consiste en confirmar lo que ya existe en ICG, no en construir nada nuevo.
- 01El servidor de ICG accesible desde donde se conecta Dijit.app.
- 02Un usuario de base de datos por sociedad, con lectura en los maestros y escritura en compras y tesorería.
- 03Series y almacenes acordados por sociedad, con el contador de la serie ya existente en ICG.
- 04Proveedores con su código de referencia completado en su ficha, para que los documentos se asocien sin fallos.
- 05Cuenta contable y forma de pago completas en la ficha de cada proveedor habitual.
- 06Un proveedor y un artículo por defecto, para los documentos o líneas que no traigan referencia.
- 07Prueba en una base de datos de ensayo antes de activar sociedades reales.
- 08Quién recibe el resumen de cada envío, con el recuento de documentos correctos y fallidos.
Alcance
Qué hace hoy y qué no
Qué cubre
- Crea albaranes y facturas de compra completos, con impuestos y vencimiento en tesorería.
- Enlaza facturas con los albaranes que cubren, igual que ICG al facturar desde dentro.
- Consulta proveedores y artículos para casar datos antes de enviar nada.
- Atiende a varias sociedades desde una sola integración, sin mezclar datos entre ellas.
- Rechaza por completo un documento que no puede escribir entero, en vez de dejarlo a medias.
Qué no hace
- No crea ni modifica proveedores, artículos ni tipos de IVA: son siempre los de ICG.
- No genera asientos contables ni cierra periodos.
- No cubre el ciclo de venta ni el inventario, solo compras.
- No corrige documentos incompletos ni adivina el artículo pretendido.