Documento de entrega a Frontend y QA. Sprint-4 Asiento Contable + Aprobación/Anulación de Causación para habilitar el desarrollo Frontend.
Destinatarios: Mauricio (QA Lead)
Plantilla canónica base:
architecture/nebula-erp/QA_HANDOFF_TEMPLATE.mdv1.0.0.
| Campo | Valor |
|---|---|
| Sprint | Sprint-4 |
| Repos | nebula-accounting-core + nebula-models + nebula-frontend |
| Branch promovida | qa |
Commit SHA en qa |
88c9aa10e0200f87fed213f002fcf9e3f46d7d40 |
| Ambiente | nodo-02 QA |
| URL Swagger | https://api-dev.centricasoluciones.com/nebula-accounting-core/api-docs |
| URL Frontend QA | https://qa.centricasoluciones.com/nebula-erp |
| Fecha entrega a Frontend/QA | 2026-06-03 (cierre Sprint-4) |
| HT | Título | Estado | Folder |
|---|---|---|---|
| HT_CON_016 | Elaboración de Asiento Contable | Released v0.3.0 | sprint-4/htu/HT_CON_016_AsientoContable/ |
| HT_CON_013 | Aprobación de Causación | Released v0.3.0 | sprint-4/htu/HT_CON_013_AprobacionCausacion/ |
| HT_CON_014 | Anulación de Causación | Released v0.3.0 | sprint-4/htu/HT_CON_014_AnulacionCausacion/ |
Total: 3 HTs (35 endpoints REST funcionales)
| Método | Ruta | Descripción |
|---|---|---|
| GET | /api/v1/asientos/read |
Lista de asientos contables activos |
| GET | /api/v1/asientos/get?id={id} |
Obtiene asiento por ID |
| POST | /api/v1/asientos/page |
Paginación de asientos contables |
| POST | /api/v1/asientos/create |
Crear asiento contable (manual) |
| PUT | /api/v1/asientos/update?id={id} |
Actualizar asiento contable |
| DELETE | /api/v1/asientos/delete?id={id} |
Eliminar (soft delete) |
| GET | /api/v1/asientos/tipos |
Lista de tipos de asiento |
| POST | /api/v1/asientos/aplicar-formato |
Aplicación de formato contable (RN-46.x) |
| POST | /api/v1/asientos/importar-asiento |
Importación CSV/XLSX/TXT |
| GET | /api/v1/asientos/exportar-plantilla |
Descarga plantilla de importación |
| GET | /api/v1/asientos/entidades-bancarias/read |
Lista de entidades bancarias |
| POST | /api/v1/asientos/entidades-bancarias/page |
Paginación de entidades bancarias |
| GET | /api/v1/saldos-bancos/read |
Lista de saldos bancarios |
| POST | /api/v1/saldos-bancos/page |
Paginación de saldos bancarios |
| POST | /api/v1/saldos-bancos/upsert |
Crear/Actualizar saldo bancario |
| Método | Ruta | Descripción |
|---|---|---|
| GET | /api/v1/aprobacion/read |
Lista de documentos pendientes de aprobación |
| GET | /api/v1/aprobacion/get?id={id} |
Obtiene documento por ID |
| POST | /api/v1/aprobacion/page |
Paginación de documentos |
| POST | /api/v1/aprobacion/create |
Crear solicitud de aprobación |
| PUT | /api/v1/aprobacion/update?id={id} |
Actualizar solicitud |
| DELETE | /api/v1/aprobacion/delete?id={id} |
Eliminar (soft delete) |
| POST | /api/v1/aprobacion/aprobar |
Aprobar documento de causación (Caso B) |
| POST | /api/v1/aprobacion/rechazar |
Rechazar documento de causación |
| GET | /api/v1/aprobacion/estados |
Lista de estados de aprobación |
| GET | /api/v1/aprobacion/orden-pago/get?id={id} |
Obtener orden de pago generada |
| POST | /api/v1/aprobacion/orden-pago/page |
Paginación de órdenes de pago |
| GET | /api/v1/aprobacion/orden-pago/estados |
Lista de estados de orden de pago |
| Método | Ruta | Descripción |
|---|---|---|
| GET | /api/v1/anulacion/read |
Lista de documentos anulables |
| GET | /api/v1/anulacion/get?id={id} |
Obtiene documento por ID |
| POST | /api/v1/anulacion/page |
Paginación de documentos |
| POST | /api/v1/anulacion/create |
Crear solicitud de anulación |
| PUT | /api/v1/anulacion/update?id={id} |
Actualizar solicitud |
| DELETE | /api/v1/anulacion/delete?id={id} |
Eliminar (soft delete) |
| POST | /api/v1/anulacion/anular |
Anular documento de causación |
| GET | /api/v1/anulacion/movimiento-inversor |
Genera asiento inversor |
| Método | Ruta | Descripción |
|---|---|---|
| GET | /api/v1/causacion/read |
Lista documentos causados (Sprint-3) |
| GET | /api/v1/causacion/get?id={id} |
Obtiene documento por ID (Sprint-3) |
| POST | /api/v1/causacion/page |
Paginación de causaciones (Sprint-3) |
| GET | /api/v1/terceros/read |
Lista de terceros (Sprint-2) |
| POST | /api/v1/terceros/page |
Paginación de terceros (Sprint-2) |
| GET | /api/v1/plan-cuentas/page |
Paginación de cuentas contables (Sprint-2) |
| GET | /api/v1/formatos/page |
Paginación de formatos contables (Sprint-2) |
| HT | Componente Frontend | Ruta / Módulo | Breadcrumb | Descripción |
|---|---|---|---|---|
| HT_CON_016 | AsientosList |
src/pages/contabilidad/asientos/ |
Contabilidad > Asientos Contables |
Listado y paginación de asientos contables con filtros (tipo, fecha, estado). |
| HT_CON_016 | AsientosForm |
src/pages/contabilidad/asientos/ |
Contabilidad > Asientos Contables > Nuevo Asiento |
Formulario de creación/edición de asiento contable manual con líneas de detalle (débito/crédito). |
| HT_CON_016 | AsientosDetail |
src/pages/contabilidad/asientos/ |
Contabilidad > Asientos Contables > Detalle |
Vista detallada del asiento contable con líneas de detalle y totales. |
| HT_CON_016 | AsientosAplicarFormato |
src/pages/contabilidad/asientos/aplicar-formato/ |
Contabilidad > Asientos Contables > Aplicar Formato |
Wizard de aplicación de formato contable (RN-46.x) con previsualización. |
| HT_CON_016 | AsientosImportar |
src/pages/contabilidad/asientos/importar/ |
Contabilidad > Asientos Contables > Importar Asientos |
Componente de importación masiva de asientos (CSV/XLSX/TXT) con validación previa. |
| HT_CON_016 | EntidadesBancariasList |
src/pages/configuracion/entidades-bancarias/ |
Configuración > Entidades Bancarias |
Listado y paginación de entidades bancarias. |
| HT_CON_016 | EntidadesBancariasForm |
src/pages/configuracion/entidades-bancarias/ |
Configuración > Entidades Bancarias > Nueva Entidad |
Formulario de creación/edición de entidad bancaria. |
| HT_CON_016 | SaldosBancosList |
src/pages/contabilidad/saldos-bancos/ |
Contabilidad > Saldos Bancarios |
Listado y paginación de saldos bancarios por cuenta y fecha. |
| HT_CON_016 | SaldosBancosForm |
src/pages/contabilidad/saldos-bancos/ |
Contabilidad > Saldos Bancarios > Nuevo Saldo |
Formulario para crear/actualizar saldo bancario. |
| HT_CON_016 | AsientosService |
src/services/api/asientos.service.ts |
N/A | Servicio con métodos CRUD para asientos, formatos, importación, entidades bancarias y saldos. |
| HT_CON_013 | AprobacionList |
src/pages/contabilidad/aprobacion/ |
Contabilidad > Aprobación de Causación |
Listado y paginación de documentos pendientes de aprobación con filtros (estado, fecha). |
| HT_CON_013 | AprobacionDetail |
src/pages/contabilidad/aprobacion/ |
Contabilidad > Aprobación de Causación > Detalle |
Vista detallada del documento con acciones: Aprobar / Rechazar. |
| HT_CON_013 | AprobacionService |
src/services/api/aprobacion.service.ts |
N/A | Servicio con métodos para aprobar, rechazar y listar documentos. |
| HT_CON_013 | OrdenPagoAprobacionList |
src/pages/contabilidad/aprobacion/orden-pago/ |
Contabilidad > Aprobación > Órdenes de Pago |
Listado de órdenes de pago generadas desde la aprobación. |
| HT_CON_014 | AnulacionList |
src/pages/contabilidad/anulacion/ |
Contabilidad > Anulación de Causación |
Listado y paginación de documentos anulables con filtros. |
| HT_CON_014 | AnulacionDetail |
src/pages/contabilidad/anulacion/ |
Contabilidad > Anulación de Causación > Detalle |
Vista detallada del documento con acción de anulación y generación de movimiento inversor. |
| HT_CON_014 | AnulacionService |
src/services/api/anulacion.service.ts |
N/A | Servicio con métodos para anular y listar documentos anulables. |
Total de componentes Frontend: 17
| Componente Dependiente | HT Origen | Uso en Sprint-4 |
|---|---|---|
CausacionList / CausacionService |
Sprint-3 (HT_CON_012) | Listado de causaciones para aprobación y anulación |
TercerosList / TercerosService |
Sprint-2 (HT_CON_002) | Selección de terceros en asientos y aprobación |
PlanCuentasList / PlanCuentasService |
Sprint-2 (HT_CON_004) | Selección de cuentas contables en asientos |
FormatosList / FormatosService |
Sprint-2 (HT_CON_009) | Selección de formato contable en asientos |
MonedasList / MonedasService |
Sprint-2 (HT_CON_017) | Selección de moneda en asientos y saldos bancarios |
| Ruta | Componente | HT | Breadcrumb | Descripción |
|---|---|---|---|---|
/contabilidad/asientos |
AsientosList |
HT_CON_016 | Contabilidad > Asientos Contables |
Listado principal de asientos contables |
/contabilidad/asientos/nuevo |
AsientosForm |
HT_CON_016 | Contabilidad > Asientos Contables > Nuevo Asiento |
Creación de nuevo asiento contable |
/contabilidad/asientos/:id |
AsientosDetail |
HT_CON_016 | Contabilidad > Asientos Contables > Detalle |
Detalle de asiento contable |
/contabilidad/asientos/:id/editar |
AsientosForm |
HT_CON_016 | Contabilidad > Asientos Contables > Editar Asiento |
Edición de asiento contable |
/contabilidad/asientos/aplicar-formato |
AsientosAplicarFormato |
HT_CON_016 | Contabilidad > Asientos Contables > Aplicar Formato |
Wizard de aplicación de formato |
/contabilidad/asientos/importar |
AsientosImportar |
HT_CON_016 | Contabilidad > Asientos Contables > Importar Asientos |
Importación masiva de asientos |
/configuracion/entidades-bancarias |
EntidadesBancariasList |
HT_CON_016 | Configuración > Entidades Bancarias |
Listado de entidades bancarias |
/configuracion/entidades-bancarias/nuevo |
EntidadesBancariasForm |
HT_CON_016 | Configuración > Entidades Bancarias > Nueva Entidad |
Creación de entidad bancaria |
/configuracion/entidades-bancarias/:id/editar |
EntidadesBancariasForm |
HT_CON_016 | Configuración > Entidades Bancarias > Editar Entidad |
Edición de entidad bancaria |
/contabilidad/saldos-bancos |
SaldosBancosList |
HT_CON_016 | Contabilidad > Saldos Bancarios |
Listado de saldos bancarios |
/contabilidad/saldos-bancos/nuevo |
SaldosBancosForm |
HT_CON_016 | Contabilidad > Saldos Bancarios > Nuevo Saldo |
Creación de saldo bancario |
/contabilidad/saldos-bancos/:id/editar |
SaldosBancosForm |
HT_CON_016 | Contabilidad > Saldos Bancarios > Editar Saldo |
Edición de saldo bancario |
/contabilidad/aprobacion |
AprobacionList |
HT_CON_013 | Contabilidad > Aprobación de Causación |
Listado de documentos pendientes de aprobación |
/contabilidad/aprobacion/:id |
AprobacionDetail |
HT_CON_013 | Contabilidad > Aprobación de Causación > Detalle |
Detalle con acciones aprobar/rechazar |
/contabilidad/aprobacion/orden-pago |
OrdenPagoAprobacionList |
HT_CON_013 | Contabilidad > Aprobación > Órdenes de Pago |
Listado de órdenes de pago generadas |
/contabilidad/anulacion |
AnulacionList |
HT_CON_014 | Contabilidad > Anulación de Causación |
Listado de documentos anulables |
/contabilidad/anulacion/:id |
AnulacionDetail |
HT_CON_014 | Contabilidad > Anulación de Causación > Detalle |
Detalle con acción de anulación |
Total de rutas: 17 (7 nuevas + 10 de detalle/edición)
| Tipo | Cantidad |
|---|---|
| HTs Backend | 3 |
| Endpoints REST | 35 |
| Componentes Frontend | 17 |
| Servicios API Frontend | 4 |
| Rutas Frontend | 17 |
| Dependencias Cross-HT | 5 |
| Versión | Fecha | Autor | Descripción |
|---|---|---|---|
| 1.1 — Actualización | 2026-08-28 | Edward Alejandro Macias | Se actualiza con HT_CON_016, HT_CON_013 y HT_CON_014. Mauricio QA Lead. |
| 1.2 — Frontend agregado | 2026-08-28 | Edward Alejandro Macias | Se agrega sección de componentes Frontend, rutas y dependencias Cross-HT. |
| 1.3 — Breadcrumbs agregados | 2026-08-28 | Edward Alejandro Macias | Se añade columna de Breadcrumb a componentes y rutas. |
| 1.4 — Firmado | por firmar | Mauricio + Carlos | Versión firmada al cierre ciclo QA consolidado |
QA_HANDOFF.md — Sprint-4 — Centrica Nebula ERP