Contabilidad y reportes

CRUD de las cuentas contables que componen el plan de cuentas. Cada cuenta tiene un código, un tipo y una posición jerárquica que permite armar el árbol contable. Soporta cargar un plan de cuentas argentino por defecto y consultar el saldo de cada cuenta.

Endpoint base: /api/v1/accounting/accounts

Scope: accounting:read / accounting:write

Campos

Body de POST /api/v1/accounting/accounts/:

Petición

{
  "code": "1.1.01",
  "name": "Caja",
  "account_type": "asset",
  "parent_code": "1.1",
  "level": 3,
  "is_detail": true,
  "description": "Dinero en efectivo disponible"
}

Respuesta

{
  "success": true,
  "data": {
    "_id": "66f1a2b3c4d5e6f7a8b9c0d1",
    "code": "1.1.01",
    "name": "Caja",
    "account_type": "asset",
    "parent_code": "1.1",
    "level": 3,
    "is_detail": true,
    "is_active": true,
    "balance": 0.0
  }
}

CRUD de asientos contables. Cada asiento se compone de al menos dos líneas que imputan cuentas al debe y al haber. Los asientos se crean en estado de borrador y luego pueden asentarse (post) para actualizar los saldos de las cuentas, o revertirse mediante un contrasiento.

Endpoint base: /api/v1/accounting/journal

Scope: accounting:read / accounting:write

Campos

Body de POST /api/v1/accounting/journal/:

Cada elemento del array lines tiene estos campos:

Petición

{
  "date": "2026-05-21",
  "description": "Venta de mercadería en efectivo",
  "lines": [
    {
      "account_code": "1.1.01",
      "account_name": "Caja",
      "debit": 12100.00,
      "credit": 0.00
    },
    {
      "account_code": "4.1.01",
      "account_name": "Ventas",
      "debit": 0.00,
      "credit": 10000.00
    },
    {
      "account_code": "2.1.05",
      "account_name": "IVA Débito Fiscal",
      "debit": 0.00,
      "credit": 2100.00
    }
  ],
  "reference_type": "invoice",
  "reference_id": "66f1a2b3c4d5e6f7a8b9c0d1"
}

Respuesta

{
  "success": true,
  "data": {
    "_id": "66f1a2b3c4d5e6f7a8b9c0e2",
    "date": "2026-05-21",
    "description": "Venta de mercadería en efectivo",
    "lines": [
      { "account_code": "1.1.01", "debit": 12100.00, "credit": 0.00 },
      { "account_code": "4.1.01", "debit": 0.00, "credit": 10000.00 },
      { "account_code": "2.1.05", "debit": 0.00, "credit": 2100.00 }
    ],
    "total_debit": 12100.00,
    "total_credit": 12100.00,
    "status": "draft"
  }
}

Gestión de los libros de IVA compras y ventas, la administración de impuestos y la generación de la declaración jurada de IVA. Los libros se arman por período, pueden cerrarse y reabrirse, y exportarse para su presentación.

Endpoint base: /api/v1/iva

Scope: accounting:read / accounting:write

Este submódulo expone endpoints específicos de su dominio. Estos son los principales:

Reportes contables generados a partir del plan de cuentas y los asientos del libro diario: balance de sumas y saldos, estado de resultados, balance general, libro mayor y flujo de efectivo.

Endpoint base: /api/v1/accounting/reports

Scope: accounting:read

Este submódulo expone endpoints específicos de su dominio, todos de solo lectura:

Importación de extractos bancarios y conciliación de sus movimientos contra los registros contables. Soporta conciliación automática y conciliación manual movimiento por movimiento.

Endpoint base: /api/v1/accounting/bank

Scope: accounting:read / accounting:write

Este submódulo expone endpoints específicos de su dominio. Estos son los principales:

Seguimiento de los vencimientos fiscales: lista de obligaciones, vencimientos próximos y marcado de obligaciones como cumplidas. Permite cargar un set de vencimientos por defecto.

Endpoint base: /api/v1/accounting/fiscal-calendar

Scope: accounting:read / accounting:write

Este submódulo expone endpoints específicos de su dominio. Estos son los principales:

Cierre del ejercicio contable. Permite listar los ejercicios fiscales, calcular el resultado del ejercicio antes de cerrarlo y ejecutar el cierre definitivo del año.

Endpoint base: /api/v1/accounting/fiscal-close

Scope: accounting:read / accounting:write

Este submódulo expone endpoints específicos de su dominio. Estos son los principales:

Administración de regímenes de retención y percepción, cálculo y aplicación de retenciones y percepciones, emisión de certificados y generación de declaraciones juradas del período.

Endpoint base: /api/v1/accounting/retenciones-percepciones

Scope: accounting:read / accounting:write

Este submódulo expone endpoints específicos de su dominio. Estos son los principales:

Datos fiscales del contribuyente por sistema de facturación. Permite cargar y mantener los datos del contribuyente, elegir el sistema de facturación activo, gestionar el certificado y verificar la delegación de servicios y los puntos de venta ante AFIP.

Endpoint base: /api/v1/bill/tax_info

Scope: accounting:read / accounting:write

Este submódulo expone endpoints específicos de su dominio. Estos son los principales:

Métricas del negocio: indicadores del panel principal, estadísticas de actividad y métricas de transacciones. Es un recurso de solo lectura.

Endpoint base: /api/v1/stats

Scope: stats:read (solo lectura)

Endpoints principales de Estadísticas: