---
title: "Crear Cuenta Contable"
method: POST
path: "/cuentaContable"
tags: ["Contabilidad"]
---

# Crear Cuenta Contable

`POST /cuentaContable`

Permite registrar una o varias cuentas contables. Cada petición puede contener múltiples registros y cada uno será validado individualmente antes de procesarse. La información no se guarda directamente en las tablas definitivas de cuentas contables, sino en una tabla de importación intermedia que permite su posterior revisión y procesamiento. El servicio retorna una lista de resultados que indican si cada cuenta contable fue creada exitosamente o si presentó errores.

## Request body

- union
  - object
    - `control` string, required — Cadena que identifica un lote de cuentas contables a importar
    - `codigo` string, required — Código de la cuenta contable
    - `nivelCuentaMayor` integer — Nivel de la cuenta mayor
    - `nombre` string — Nombre de la cuenta contable
    - `tipoCuenta` string — Código del tipo o clase de la cuenta contable
    - `naturaleza` 'DB' | 'CR' — Naturaleza contable de la cuenta: DB: Débito, CR: Crédito
    - `esPresupuestable` 'S' | 'N' — Indica si la cuenta es presupuestable (S/N)
    - `codigoAlternoPresupuesto` string — Código alterno de presupuesto
    - `esEstadistica` 'S' | 'N' — Indica si la cuenta es de tipo estadística (S/N)
    - `esDiferenciable` 'S' | 'N' — Indica si la cuenta es diferenciable (S/N)
    - `esMonetaria` 'S' | 'N' — Indica si la cuenta es monetaria (S/N)
    - `manejaMonedaExtranjera` 'S' | 'N' — Indica si la cuenta maneja moneda extranjera (S/N)
    - `capturaMoneda` string — Indicador de captura de moneda
    - `esAjustable` 'S' | 'N' — Indica si la cuenta es ajustable por inflación (S/N)
    - `manejaCantidad` 'S' | 'N' — Indica si la cuenta maneja cantidades (S/N)
    - `elemento1` integer — Código del elemento 1 (centro de responsabilidad)
    - `elemento2` integer — Código del elemento 2 (concepto)
    - `elemento3` integer — Código del elemento 3 (tercero)
    - `elemento4` integer — Código del elemento 4 (documento)
    - `elemento5` integer — Código del elemento 5 (fecha de vencimiento)
    - `controlElemento1` integer — Control del elemento 1 (centro de responsabilidad): 0: No lleva saldo a este nivel, 1: Exigido y lleva saldo a este nivel, 2: Exigido y no lleva saldo a este nivel, 3: Opcional y lleva saldo a este nivel
    - `controlElemento2` integer — Control del elemento 2 (concepto): 0: No lleva saldo a este nivel, 1: Exigido y lleva saldo a este nivel, 2: Exigido y no lleva saldo a este nivel, 3: Opcional y lleva saldo a este nivel
    - `controlElemento3` integer — Control del elemento 3 (tercero): 0: No lleva saldo a este nivel, 1: Exigido y lleva saldo a este nivel, 2: Exigido y no lleva saldo a este nivel, 3: Opcional y lleva saldo a este nivel
    - `controlElemento4` integer — Control del elemento 4 (documento): 0: No lleva saldo a este nivel, 1: Exigido y lleva saldo a este nivel, 2: Exigido y no lleva saldo a este nivel, 3: Opcional y lleva saldo a este nivel
    - `controlElemento5` integer — Control del elemento 5 (fecha de vencimiento): 0: No lleva saldo a este nivel, 1: Exigido y lleva saldo a este nivel, 2: Exigido y no lleva saldo a este nivel, 3: Opcional y lleva saldo a este nivel
    - `clasificacion` 'I' | 'M', required — Clasificación de la cuenta contable. Solo se permiten los valores I o M
    - `baseIvaReteFte` string — Indicador de base de IVA/retención en la fuente
    - `porcentajeIvaReteFte` number, double — Porcentaje de IVA/retención en la fuente
    - `tipoIvaReteFte` string — Tipo de IVA/retención en la fuente
    - `toleranciaIvaReteFte` integer — Tolerancia de IVA/retención en la fuente
    - `comentario` string — Comentario adicional sobre la cuenta contable
  - RecepcionCuentaContableDatosEntrada[]
    - `control` string, required — Cadena que identifica un lote de cuentas contables a importar
    - `codigo` string, required — Código de la cuenta contable
    - `nivelCuentaMayor` integer — Nivel de la cuenta mayor
    - `nombre` string — Nombre de la cuenta contable
    - `tipoCuenta` string — Código del tipo o clase de la cuenta contable
    - `naturaleza` 'DB' | 'CR' — Naturaleza contable de la cuenta: DB: Débito, CR: Crédito
    - `esPresupuestable` 'S' | 'N' — Indica si la cuenta es presupuestable (S/N)
    - `codigoAlternoPresupuesto` string — Código alterno de presupuesto
    - `esEstadistica` 'S' | 'N' — Indica si la cuenta es de tipo estadística (S/N)
    - `esDiferenciable` 'S' | 'N' — Indica si la cuenta es diferenciable (S/N)
    - `esMonetaria` 'S' | 'N' — Indica si la cuenta es monetaria (S/N)
    - `manejaMonedaExtranjera` 'S' | 'N' — Indica si la cuenta maneja moneda extranjera (S/N)
    - `capturaMoneda` string — Indicador de captura de moneda
    - `esAjustable` 'S' | 'N' — Indica si la cuenta es ajustable por inflación (S/N)
    - `manejaCantidad` 'S' | 'N' — Indica si la cuenta maneja cantidades (S/N)
    - `elemento1` integer — Código del elemento 1 (centro de responsabilidad)
    - `elemento2` integer — Código del elemento 2 (concepto)
    - `elemento3` integer — Código del elemento 3 (tercero)
    - `elemento4` integer — Código del elemento 4 (documento)
    - `elemento5` integer — Código del elemento 5 (fecha de vencimiento)
    - `controlElemento1` integer — Control del elemento 1 (centro de responsabilidad): 0: No lleva saldo a este nivel, 1: Exigido y lleva saldo a este nivel, 2: Exigido y no lleva saldo a este nivel, 3: Opcional y lleva saldo a este nivel
    - `controlElemento2` integer — Control del elemento 2 (concepto): 0: No lleva saldo a este nivel, 1: Exigido y lleva saldo a este nivel, 2: Exigido y no lleva saldo a este nivel, 3: Opcional y lleva saldo a este nivel
    - `controlElemento3` integer — Control del elemento 3 (tercero): 0: No lleva saldo a este nivel, 1: Exigido y lleva saldo a este nivel, 2: Exigido y no lleva saldo a este nivel, 3: Opcional y lleva saldo a este nivel
    - `controlElemento4` integer — Control del elemento 4 (documento): 0: No lleva saldo a este nivel, 1: Exigido y lleva saldo a este nivel, 2: Exigido y no lleva saldo a este nivel, 3: Opcional y lleva saldo a este nivel
    - `controlElemento5` integer — Control del elemento 5 (fecha de vencimiento): 0: No lleva saldo a este nivel, 1: Exigido y lleva saldo a este nivel, 2: Exigido y no lleva saldo a este nivel, 3: Opcional y lleva saldo a este nivel
    - `clasificacion` 'I' | 'M', required — Clasificación de la cuenta contable. Solo se permiten los valores I o M
    - `baseIvaReteFte` string — Indicador de base de IVA/retención en la fuente
    - `porcentajeIvaReteFte` number, double — Porcentaje de IVA/retención en la fuente
    - `tipoIvaReteFte` string — Tipo de IVA/retención en la fuente
    - `toleranciaIvaReteFte` integer — Tolerancia de IVA/retención en la fuente
    - `comentario` string — Comentario adicional sobre la cuenta contable

## Response `201`

Todas las cuentas contables fueron creadas correctamente

- RespuestaImportacion[]
  - `identificacion` string
  - `operacionExitosa` boolean
  - `mensaje` string

## Other responses

- `400` — Error en la validación o al menos una cuenta contable falló en la creación
- `404` — Recurso no encontrado
- `500` — Error interno inesperado en el servidor

---

[API](https://skmtc.net/loggro/apis/documentos-electr-nicos.md) · [All operations](https://skmtc.net/loggro/apis/documentos-electr-nicos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loggro/documentos-electr-nicos/versions/f390b90daf37/schema)