API: Contabilidad

Esta página requiere el encabezado X-Api-Key y el parámetro ?companyId= descritos en la descripción general de la API REST para desarrolladores.

Contabilidad (solo lectura)

Estos endpoints exponen los datos producidos por el motor de depreciación, el generador de asientos, las bajas y las revaluaciones. Todos son solo GET, requieren X-Api-Key y ?companyId=, y devuelven el sobre paginado estándar ({items, total, skip, take}) — excepto las consultas de elemento único, que devuelven el objeto directamente.

GET /api/v1/fiscal-years

Lista paginada de años fiscales.

{ "id": "...", "year": 2025, "startDate": "2025-01-01", "endDate": "2025-12-31", "isClosed": false }

GET /api/v1/depreciation-runs

Lista paginada de ejecuciones de depreciación. Use ?skip=&take= para paginar.

curl -s "https://acme.activohq.cloud/api/v1/depreciation-runs?companyId=3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "X-Api-Key: $ACTIVOHQ_API_KEY"

Elementos de la respuesta:

{
  "id": "...",
  "postingPeriodId": "...",
  "depreciationBookId": "...",
  "runDate": "2025-03-31",
  "status": "Posted",
  "totalDepreciation": 4250.00,
  "entryCount": 17
}

GET /api/v1/depreciation-runs/

Ejecución de depreciación individual — mismos campos que los anteriores (sin sobre).

GET /api/v1/depreciation-entries

Lista paginada de líneas individuales de depreciación. Filtre los resultados con ?runId= y/o ?assetId=.

Elementos de la respuesta:

{
  "id": "...",
  "depreciationRunId": "...",
  "assetId": "...",
  "year": 2025,
  "month": 3,
  "openingNbv": 10000.00,
  "depreciationAmount": 250.00,
  "closingNbv": 9750.00,
  "accumulatedDepreciation": 2500.00
}

GET /api/v1/journal-batches

Lista paginada de lotes de asientos contables (un lote por evento contable — depreciación, baja, revaluación, etc.).

GET /api/v1/journal-batches/

Lote de asientos individual. La consulta de elemento único incluye un arreglo lines:

{
  "id": "...",
  "eventType": "Depreciation",
  "sourceId": "...",
  "postedDate": "2025-03-31",
  "status": "Posted",
  "totalDebit": 250.00,
  "totalCredit": 250.00,
  "lines": [
    { "id": "...", "accountCode": "6200", "debit": 250.00, "credit": 0.00, "description": "Depreciation - LAP-0042", "assetId": "..." },
    { "id": "...", "accountCode": "1510", "debit": 0.00, "credit": 250.00, "description": "Acc. Depreciation - LAP-0042", "assetId": "..." }
  ]
}

GET /api/v1/disposals

Lista paginada de Bajas de activos.

{
  "id": "...",
  "assetId": "...",
  "disposalDate": "2025-06-15",
  "type": "Sale",
  "proceeds": 500.00,
  "nbvAtDisposal": 400.00,
  "gainLoss": 100.00,
  "notes": "Sold at auction."
}

GET /api/v1/revaluations

Lista paginada de revaluaciones y deterioros de Activos.

{
  "id": "...",
  "assetId": "...",
  "revaluationDate": "2025-06-01",
  "type": "Upward",
  "amount": 5000.00,
  "carryingBefore": 20000.00,
  "carryingAfter": 25000.00,
  "notes": "Market appraisal June 2025."
}