Redactar Un Asiento Contable

---
name: redactar-un-asiento-contable
title: "Redactar un asiento contable"
description: "Úsalo cuando digas 'registra el asiento del devengo' / 'redacta el asiento de depreciación del Q1' / 'contabiliza la amortización del prepago' / 'reconocimiento de ingresos de este período' / 'asiento de compensación en acciones' / 'reclasifica este gasto'. Redacto un asiento contable de partida doble balanceado que se ramifica según `type`: `accrual` | `prepaid` | `payroll` | `revrec` | `depreciation` | `stock-comp` | `adjustment` | `reclass`. Cada asiento se valida para que cuadre hasta el centavo, cada código de cuenta se valida contra `config/chart-of-accounts.json`, y el asiento se escribe con `status: \"draft\"`. El submodo `type=accrual mode=reversing` revierte automáticamente cada devengo activo marcado `reversing=true`. Solo borrador, nunca publico en QuickBooks Online ni en Xero."
version: 1
category: Contabilidad
featured: no
image: ledger
integrations: [quickbooks, xero, linear]
x_houston:
  created_by: houston
  skill_schema: 1
---


# Redactar un Asiento Contable

Un asiento contable balanceado a partir de una plantilla específica del tipo. Invariantes que se hacen cumplir en cada escritura: los débitos igualan a los créditos con una diferencia de hasta 1 centavo, cada `glCode` existe en el plan de cuentas bloqueado, `status: "draft"` (nunca `posted` sin confirmación explícita tuya), `reversing: true` requiere `reversesEntryId` más la convención de signo opuesta.

Solo borrador: escribo markdown más una fila de índice; tú o tu contador publican en QuickBooks Online / Xero.

## Cuándo usarlo

- "registra el asiento del devengo" / "redacta el asiento de depreciación del Q1" / "contabiliza la amortización del prepago".
- "asiento de reconocimiento de ingresos para marzo" / "asiento de compensación en acciones para el período".
- "reclasifica este $X de Administración General a I+D" / "registra este ajuste".
- "registra el asiento de nómina de Gusto / Rippling / Justworks", usa `type=payroll` con el resumen del período de pago.
- "publica los asientos de reversión de este período" / "redacta las reversiones de este período", usa `type=accrual mode=reversing` para revertir automáticamente cada devengo activo marcado `reversing=true`.
- Invocado por `run-monthly-close` para cada asiento contable estándar que venza en el ciclo de cierre.

## Conexiones que necesito

Ejecuto el trabajo externo a través de Composio. Antes de correr este skill verifico que las categorías de abajo estén conectadas. Si falta alguna, nombro la categoría, te pido que la conectes desde la pestaña de Integraciones, y me detengo.

- **Proveedor de nómina** (Gusto, Rippling, Justworks, Deel, ADP), requerido para `type=payroll` si quieres que traiga el resumen del período de pago directamente. De lo contrario, pegas tú el resumen.
- **QuickBooks Online o Xero** (contabilidad), opcional, se usa para cruzar los códigos de cuenta en `type=adjustment` o `type=reclass`.
- **Linear**, opcional, solo se usa para consultar contexto de proyecto si quieres un memo respaldado en un ticket.

Si `type=payroll` y no existe conexión de nómina, me detengo y te pido conectar Gusto / Rippling / Justworks, o que pegues el resumen del período de pago.

## Información que necesito

Primero leo tu contexto de contabilidad. Por cada campo requerido que falte, hago UNA pregunta en lenguaje sencillo (mejor modalidad: app conectada > archivo > URL > pegar) y espero.

- **Un plan de cuentas**, requerido. Por qué: cada línea del asiento contable tiene que referenciar un código de cuenta real. Si falta, pregunto: "¿Ya tenemos un plan de cuentas? Si no, redactemos uno primero."
- **El tipo de asiento y el período**, requerido. Por qué: me dice qué plantilla usar (devengo, prepago, nómina, reconocimiento de ingresos, depreciación, compensación en acciones, ajuste, reclasificación) y en qué mes cae. Si falta, pregunto: "¿Qué tipo de asiento estamos registrando, y para qué mes?"
- **Una lista de activos fijos, para `type=depreciation`**, requerido para ese tipo. Por qué: calculo la depreciación mensual a partir del costo, el valor de rescate y la vida útil de cada activo. Si falta, pregunto: "¿Tienes una lista de activos fijos capitalizados con costo, fecha de puesta en servicio y vida útil? Suelta la hoja de cálculo o pégala."
- **Una valuación 409A y un cronograma de vesting, para `type=stock-comp`**, requerido para ese tipo. Por qué: impulsa el gasto lineal ASC 718 después del cliff. Si falta, pregunto: "¿Tienes una valuación 409A vigente y el cronograma de vesting de las concesiones vigentes? Suéltalos o comparte lo que tengas."
- **Un resumen del período de pago, para `type=payroll`**, requerido para ese tipo. Por qué: divido los salarios entre I+D / Ventas y Marketing / Administración General a partir de esto. Si falta, pregunto: "¿Puedes conectar Gusto, Rippling o Justworks, o pegar el resumen del período de pago con bruto, impuestos, beneficios y pago neto por departamento?"

## Pasos
<!-- houston-workflow:v1 -->

1. **Analizar las entradas.** Requerido: `type` (uno de `accrual` | `prepaid` | `payroll` | `revrec` | `depreciation` | `stock-comp` | `adjustment` | `reclass`) y `period` (`YYYY-MM`). Opcional: `mode` (solo tiene sentido cuando `type=accrual`, `reversing`), un `slug` corto para el nombre del archivo.

2. **Leer el contexto.** Cargar `context/bookkeeping-context.md` (detenerse si falta), `config/context-ledger.json`, `config/chart-of-accounts.json` (**bloqueado** para la ejecución, detenerse si no existe), `accruals.json` (arreglo vacío si no existe). Para nómina / depreciación / compensación en acciones, también leer la configuración específica del tipo (abajo).

3. **Ramificar según `type`.** Cada rama construye un arreglo `lines[]`; el Paso 4 valida antes de escribir.

   ### `accrual`
   Devengo de fin de período (ingresos no facturados, nómina devengada, interés devengado). Debitar la línea de gasto / ingreso, acreditar `Accrued Liabilities` (o debitar `Accrued Revenue` más acreditar ingreso). `reversing: true` por defecto. Anexar a `accruals.json`: `{id, type, active: true, reversing: true, period, amount, glCode, counterGlCode, memo, createdAt, updatedAt}`.

   **Submodo `mode=reversing`.** Leer `accruals.json`, encontrar cada entrada con `active=true AND reversing=true AND period < current`. Para cada una, producir un asiento de reversión con `reversesEntryId` apuntando al original y la convención de signo invertida. Marcar el original `active: false` y establecer `reversedOn`. Escribir cada reversión como un asiento contable separado.

   ### `prepaid`
   Amortizar prepagos (renta, SaaS, seguro). Debitar la cuenta de gasto, acreditar la cuenta de activo prepagado. `reversing: false`. Memo: `"Amortize {asset} - {period}"`.

   ### `payroll`
   Resumen del período de pago. Orden de origen: app conectada (`composio search payroll` → Gusto / Rippling / Justworks / Deel / ADP, esquema vía `--get-schema`) > resumen pegado `{gross, taxes, benefits, netPay, byDepartment: {rd, sm, ga}}`. Líneas: debitar `Wages - R&D / Sales & Marketing / General & Admin` según el plan de cuentas, debitar `Payroll Taxes`, debitar `Employee Benefits`; acreditar `Wages Payable` (o `Cash` si se pagó dentro del período, preguntar una vez), `Payroll Tax Liabilities`, `Benefits Payable`. Memo: `"Payroll - {period} - {provider}"`.

   ### `revrec`
   Leer cada `revrec/**/*.json`, elegir las filas con `period = current`. Debitar `Deferred Revenue`, acreditar cuenta de ingresos. Multi-moneda: consolidar en la moneda local (ya está en el cronograma). Memo: `"Revenue recognition - {period} - {N} contracts"`.

   ### `depreciation`
   Leer `config/fixed-assets.json` (forma: `[{id, description, class, cost, salvage, usefulLifeMonths, inServiceOn, method: "straight-line"}]`). Si no existe, pedir UNA vez el cronograma (archivo > pegar), NUNCA inventar. Calcular `(cost - salvage) / usefulLifeMonths` por activo, agrupar por clase. Debitar `Depreciation Expense - {class}`, acreditar `Accumulated Depreciation - {class}`. Memo: `"Depreciation - {period} - {N} assets"`.

   ### `stock-comp`
   Leer `config/stock-comp.json` (forma: `{valuation: {fmv, asOf}, grants: [{employeeId?, grantDate, shares, strike, vestingMonths, cliff}]}`). Si no existe, pedir UNA vez la 409A más el cronograma de vesting. Gasto lineal después del cliff según ASC 718. Debitar `Stock-Based Compensation Expense` (dividido por I+D / Ventas y Marketing / Administración General si el plan de cuentas lo permite), acreditar `Additional Paid-in Capital`. Memo: `"Stock-based compensation - {period} - {N} grants"`. Si `context/bookkeeping-context.md` marca la compensación en acciones como un no rotundo sin aprobación previa, detenerse y presentar el borrador para aprobación.

   ### `adjustment`
   Ajuste manual general. Tú dictas `{glCode, debit, credit, memo}` por línea (2 o más líneas). Fuentes comunes: comisiones no registradas de las conciliaciones, redondeo cambiario, correcciones de codificación previas.

   ### `reclass`
   Entradas `{fromGlCode, toGlCode, amount, memo}`. Debitar `toGlCode`, acreditar `fromGlCode`. Ambas deben ser líneas de gasto o activo; una sección cruzada (gasto → pasivo) requiere `type=adjustment` en su lugar.

4. **Validar antes de escribir.** Guardas estrictas, si fallan se detiene la escritura y se muestra el error:
   - `sum(debits) === sum(credits)` con una diferencia de hasta 1 centavo.
   - Cada `glCode` existe en `config/chart-of-accounts.json` (no solo el padre, el código exacto).
   - `lines[].length >= 2`.
   - `type = reversing` implica que `reversesEntryId` está definido Y el asiento contable referenciado tiene `reversing: true` Y la convención de signo está invertida.
   - Nada de `status: "posted"` (solo se permite `draft` desde este skill).

5. **Escribir el asiento contable en markdown** en `journal-entries/{YYYY-MM}/{type}-{slug}.md`. Estructura:
   - Encabezado: `id`, `type`, `period`, `date`, memo, status, reversing, reversesEntryId (si aplica).
   - **Líneas**, tabla en markdown `{glCode | glName | debit | credit | memo}`.
   - Fila de totales: total de débitos, total de créditos, diferencia (debería ser 0).
   - Documentos de soporte: rutas referenciadas (resumen del período de pago, cronograma de reconocimiento de ingresos, archivo de activos fijos, recibos).
   - Notas: preguntas abiertas presentadas en línea.

6. **Anexar a `journal-entries.json`** en la raíz del agente. Lectura-fusión-escritura atómica. Esquema completo desde `data-schema.md`: `{id, createdAt, updatedAt, date, type, memo, reversing, reversesEntryId?, period, lines[], status: "draft", supportingDocs?}`.

7. **Efectos secundarios específicos del tipo.**
   - `accrual` (no en submodo de reversión) → anexar a `accruals.json` con `active: true`.
   - `accrual mode=reversing` → actualizar la fila del devengo original a `active: false, reversedOn, reversedByEntryId`.
   - `revrec` → marcar las filas correspondientes en `revrec/{customer-slug}/{contract-slug}.json` como `recognized: true, recognizedBy: {id}` para ese período.
   - `depreciation` → marcar las filas correspondientes en `config/fixed-assets.json` con `lastDepreciatedPeriod: "{period}", accumulated += monthly`.

8. **Anexar una fila a `outputs.json`**: `{type: "journal-entry", title: "{type} journal entry - {period} - {slug}", summary, path, status: "draft", domain: "close"}`. Lectura-fusión-escritura; nunca sobrescribir.

9. **Resumirte.** Un bloque compacto: id del asiento, monto total, tipo, ruta, recordatorio de que sigue en `draft` hasta que tú lo publiques en QuickBooks Online / Xero y lo confirmes. Ofrecer cambiar `status` a `"posted"` solo con confirmación explícita.

## Salidas

- `journal-entries/{YYYY-MM}/{type}-{slug}.md`, asiento contable legible con la tabla de líneas balanceada.
- `journal-entries.json`, lectura-fusión-escritura, asiento contable anexado con `status: "draft"`.
- `accruals.json`, solo en `type=accrual` (anexar) o `type=accrual mode=reversing` (actualizar la fila original).
- `revrec/{customer-slug}/{contract-slug}.json`, solo en `type=revrec` (marcar el período reconocido).
- `config/fixed-assets.json`, solo en `type=depreciation` (marcar el último período depreciado más el acumulado).
- `outputs.json`, una fila anexada, `type: "journal-entry"`.