Saltar al contenido principal

Gestión de Asientos Contables (/entries)

Permite generar y contabilizar asientos contables en el libro diario de BaseGes Contabilidad. Cada petición procesa un único asiento compuesto por una colección de movimientos al debe y al haber.

1. Valores y Condiciones Requeridas​

Para que un asiento sea procesado con éxito, la petición debe cumplir:

  • Fecha (date): Fecha contable del asiento.
  • Movimientos (movements): Al menos un movimiento válido.
  • Importes no nulos: Cada línea de movimiento debe contener un importe distinto de cero en debitCurrency (debe divisa) o creditCurrency (haber divisa). Los movimientos con importe 0 en ambas columnas se omiten automáticamente.

2. Reglas Contables y Creación Automática de Cuentas​

  • Cuentas PGC a 9 Dígitos: Si la cuenta contable indicada (pgcAccount) no existe en el plan contable del ejercicio, se creará automáticamente asignándole como descripción el valor de accountName.
    • Excepción: La cuenta debe tener una longitud estricta de 9 dígitos. Si tiene una longitud distinta, el sistema no la creará y registrará una incidencia.
  • Ajuste Automático de Ejercicio Fiscal:
    • El asiento se inserta en el ejercicio correspondiente a la fecha indicada.
    • Si ese ejercicio no está dado de alta en la empresa, la fecha se ajusta automáticamente al último día del ejercicio abierto más cercano (por ejemplo, si sólo está abierto 2025 y se envía una fecha de 2026, se asigna al 31/12/2025).
  • Sustitución de Asientos Duplicados: Si se indica una clave única (uniqueKey) y ya existe un asiento con dicha clave y el mismo tipo (entryType), el asiento existente es reemplazado por el nuevo.

3. Asientos Descuadrados​

En el caso de que la suma de importes al debe no coincida con la del haber:

  • El asiento y sus apuntes se insertan de todos modos en el diario.
  • Queda marcado administrativamente como descuadrado.
  • No actualiza los saldos acumulados de los mayores contables para no falsear balances.
  • La respuesta del servicio incluirá una incidencia de tipo D.

4. Clasificación de Incidencias en la Respuesta​

Cuando se procesa el asiento, la propiedad incidents puede retornar advertencias informativas:

ClasificadorMensajeCausa
CLA CUENTA NO ES IMPUTABLE A 9 DIGITOS: {PgcAccount}La cuenta contable no tiene 9 caracteres y no ha podido crearse en el PGC.
DASIENTO DESCUADRADO.El debe y el haber no cuadran a nivel de divisa o importe base.