Cuentas de tesorería
Una cuenta de banco, caja, tarjeta, crédito o préstamo, con su moneda y su saldo.
Campos
El nombre API es el que usan la API, MCP y la CLI.
| Nombre | Nombre API | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
| ID | id | ID de registro | Sí | |
| Nombre | label | Texto | Sí | |
| Código | code | Texto | Sí | Clave interna. No es el número de cuenta del banco. |
| Cuenta contable | accountingledgeraccountId | Referencia | ||
| Moneda de cotización | currency | Constante | Sí | Moneda de esta cuenta. No se puede cambiar después de crear. |
| Tipo | kind | Constante | Sí | Tipo de cuenta. Banco, caja, monedero y procesador de pagos tienen fondos. Tarjeta, línea de crédito y préstamo son importes adeudados. |
| Número de cuenta | accountNumber | Texto | Número de cuenta que asigna la institución, si aplica. Opcional para cuentas bancarias en México cuando solo se usa CLABE. | |
| Tipo de identificador bancario | bankIdentifierScheme | Constante | Opción fija del conjunto permitido para este campo. | |
| Identificador bancario | bankIdentifier | Texto | ||
| IBAN | iban | Texto | Identificador bancario internacional cuando aplica. No se usa en cuentas bancarias mexicanas. | |
| Últimos 4 dígitos | cardLast4 | Texto | Últimos cuatro dígitos de la tarjeta. No almacene el número completo. | |
| Fecha de inicio | dateStart | Fecha | Fecha de vigencia de la línea de crédito o inicio del plazo del préstamo. | |
| Fecha de fin | dateEnd | Fecha | Vencimiento opcional de la línea de crédito; vencimiento obligatorio del préstamo a plazo. Si ambas fechas están definidas, la de fin debe ser igual o posterior a la de inicio. | |
| Tasa nominal anual | interestRate | Porcentaje | Tasa nominal anual de referencia en tarjeta, línea o préstamo. No calcula cargos por sí sola. | |
| Capital del préstamo | amountPrincipal | Moneda | Importe original del préstamo en la moneda de la cuenta. El calendario de parcialidades debe sumar este importe. | |
| Tasa efectiva anual | effectiveRate | Porcentaje | Tasa anual con capitalización mensual. No es el CAT. | |
| Límite de crédito | creditLimit | Moneda | Límite contractual en moneda de la cuenta. Obligatorio en tarjeta y línea de crédito. | |
| Saldo | balance | Importe con signo | Sí | Saldo en la moneda de la cuenta. En una tarjeta, línea de crédito o préstamo, un saldo negativo es el importe adeudado. |
| Crédito disponible | creditAvailable | Importe con signo | Límite de crédito menos el importe adeudado. No baja de cero. | |
| Tags | tagIds | Tags | ||
| Datos | data | Datos | ||
| Creado por | createdBy | Usuario | ||
| Creado el | createdAt | Fecha y Hora | Sí | |
| Actualizado por | updatedBy | Usuario | ||
| Actualizado el | updatedAt | Fecha y Hora | Sí | |
| Publicado por | publishedBy | Usuario | ||
| Publicado el | publishedAt | Fecha y Hora | ||
| Deshabilitado por | disabledBy | Usuario | ||
| Deshabilitado el | disabledAt | Fecha y Hora | ||
| Bloqueado por | blockedBy | Usuario | ||
| Bloqueado el | blockedAt | Fecha y Hora | ||
| Archivado por | archivedBy | Usuario | ||
| Archivado el | archivedAt | Fecha y Hora |
Relaciones
Los registros poseídos (línea sólida) se eliminan con su dueño. Los registros agrupados (línea punteada) pueden existir solos.
| Campo | Apunta a | Tipo |
|---|---|---|
Cuenta contable accountingledgeraccountId | Catálogo de cuentas | referencia |
Tags tagIds | Tags | referencia |
Acciones
Lo que puedes hacer con un registro. Cada acción también envía el evento de webhook treasuryaccounts.<acción>. Las lecturas (find, get, count) funcionan en toda tabla.
| Nombre | Nombre API | Descripción | Dónde |
|---|---|---|---|
| Crear | create | Crea una cuenta. | App · WebMCP · API · MCP · CLI |
| Editar | update | Guarda los cambios de la cuenta. | App · WebMCP · API · MCP · CLI |
| Deshabilitar | disable | Desactiva la cuenta para usos nuevos. Las referencias existentes se mantienen. Actívala de nuevo para usarla. | App · WebMCP · API · MCP · CLI |
| Habilitar | undisable | Vuelve a activar la cuenta para usos nuevos. | App · WebMCP · API · MCP · CLI |
| Publicar | publish | Publica la disponibilidad para que pueda usarse. | App · WebMCP · API · MCP · CLI |
| Bloquear | block | Impide editar y eliminar la cuenta. Sigue visible y puede seguir en documentos existentes. Desbloquéala para volver a cambiarla. | App · WebMCP · API · MCP · CLI |
| Desbloquear | unblock | Permite de nuevo editar y eliminar la cuenta. | App · WebMCP · API · MCP · CLI |
| Archivar | archive | Retira la cuenta del uso diario. Sale de las listas y los selectores activos, y la mayoría de las acciones se detienen. Desarchívala para restaurarla. | App · WebMCP · API · MCP · CLI |
| Restaurar | unarchive | Devuelve la cuenta a las listas y las acciones activas. | App · WebMCP · API · MCP · CLI |
| Eliminar | delete | Elimina la cuenta y los datos que le pertenecen. No se puede deshacer. | App · WebMCP · API · MCP · CLI |
Estados
Cómo pasa un registro de un estado a otro. Archivar y bloquear pueden ocurrir en cualquier estado.