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 un identificador del titular de la cuenta

El ledger_id debe ser un UUID válido

El asset_code es el código del asset (ej. CLP, ARS), no un UUID

El header Idempotency-Key debe ser único por solicitud

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

Solicitud

Autorización

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.

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠409

🟠422

🔴500

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

cURL

Cuenta con balance normal DEBITCuenta con balance normal CREDIT

curl --location 'https://sandbox.fidi.money/fidix/v1/accounts' \
--header 'traceparent: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01' \
--header 'Idempotency-Key: create-acc-2026-04-10-abc123' \
--header 'x-api-key: {{apikey}}' \
--header 'x-api-key: {{apikey}}' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Cuenta de Efectivo",
    "ledger_id": "c2b5d3b8-6f5e-4b34-9c9b-2a5e2c1f7a10",
    "asset_code": "CLP",
    "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_code": "CLP",
    "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-07-27 21:27:38

Cuentas

Obtener Cuenta por ID