Crear Cuenta

POST

/fidix/v1/accounts

Crea una nueva cuenta contable. Una cuenta representa una posición financiera dentro de un ledger específico.

Requisitos:

Todas las cuentas deben tener un balance normal (normal_balance) que puede ser DEBIT o CREDIT

El owner_id debe corresponder a una persona existente

Todos los IDs (ledger_id, asset_id, owner_id) deben ser UUIDs válidos

Nota: El ID de la cuenta creada se guardará en ${account_id} para uso posterior.

Solicitud

Autorización

JWT Bearer

Agregar el parámetro

Authorization

a Encabezados

Ejemplo:

Authorization: ********************

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢201

application/json

Cuenta creada exitosamente. El ID de la cuenta está en el campo id.

Importante: Guarda el valor de id en la variable ${account_id} para usar en consultas posteriores.

Body

🟠400

🟠401

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

cURL

Cuenta con balance normal DEBITCuenta con balance normal CREDIT

curl --location --request POST 'https://api-preview.fidi.money/fidix/v1/accounts' \
--header 'traceparent: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Cuenta de Efectivo",
    "ledger_id": "c2b5d3b8-6f5e-4b34-9c9b-2a5e2c1f7a10",
    "asset_id": "0e7f5c58-2b7a-4d2a-a2e1-9d9a6b3f1a23",
    "owner_id": "1f8a6d59-3c8b-5e3b-b3f2-0e0b7c4a2b34",
    "normal_balance": "DEBIT"
}'

Ejemplo de Respuesta

201 - Cuenta creada exitosamente

{
    "id": "4f5a2d7a-4c1e-4f2a-9e9a-1234567890ab",
    "parent_account_id": null,
    "name": "Cuenta de Efectivo",
    "ledger_id": "c2b5d3b8-6f5e-4b34-9c9b-2a5e2c1f7a10",
    "asset_id": "0e7f5c58-2b7a-4d2a-a2e1-9d9a6b3f1a23",
    "owner_id": "1f8a6d59-3c8b-5e3b-b3f2-0e0b7c4a2b34",
    "status": "active",
    "created_at": "2025-01-10T12:00:00Z",
    "updated_at": "2025-01-10T12:00:00Z"
}

Modificado en 2026-01-10 20:33:00

Obtener Token de Acceso

Obtener Cuenta por ID