Skip to main content
GET
Cuentas de una entidad

Descripción general

Las cuentas son recursos hijos de entidades persona y empresa. Permiten registrar varias cuentas por cliente, incluso en distintas monedas. Cada cuenta tiene un externalId definido por el cliente, una currency ISO 4217 y al menos un identificador de pago. Los datos quedan aislados dentro de la organización actual.

Endpoints

El mismo CRUD existe para tres búsquedas de entidad, igual que actualizar por external ID y PATCH /entities/by-tax-id/{taxId}: {accountId} es siempre el UUID de Gu1 de la cuenta (el de create/list). Búsqueda por tax ID ignora puntuación y mayúsculas (CUIT 20-12345678-9 matchea 20123456789). Usa la misma clave alfanumérica que la unicidad de tax ID a nivel organización (idx_entities_org_norm_tax_id). Codificá el segmento de path si el valor tiene caracteres reservados. La lectura requiere entities:read. Las mutaciones requieren entities:edit, con fallback legacy entities:write.

Campos de la cuenta

Tipos de cuenta admitidos

accountType acepta exclusivamente uno de estos valores:
  • Genéricos: bank_account, personal, business, other
  • Depósitos bancarios: checking, savings, business_checking, business_savings, payroll, pension, money_market, fixed_deposit
  • Inversión y custodia: investment, brokerage, custody, escrow
  • Pagos y fondos digitales: payment, wallet, virtual_account, prepaid, merchant
  • Crédito: credit, loan
  • Operación institucional: correspondent, settlement, clearing, cash_management
Usá bank_account cuando sabés que es una cuenta bancaria pero no conocés el producto, y other solo cuando ninguna categoría represente la cuenta. checking corresponde a cuenta corriente y savings a caja de ahorro. Un valor fuera del enum devuelve 400 VALIDATION_ERROR. Al crear una cuenta se requiere al menos uno de estos campos: accountNumber, cbu, cvu, iban o alias.

Ejemplo de creación

Crear con tu externalId en vez del UUID de Gu1:
Crear por tax ID (la puntuación es opcional):
Al enviar isPrimary: true, la API quita la marca principal de las otras cuentas de la misma entidad y moneda.

Errores