Vista previa del alta y detalles de cuenta

13 de octubre de 2026

Cuando gestionas cuentas para tus clientes, quieres saber cuánto costará un paso antes de darlo y leer las mismas fechas e importes que muestra la app. Esta versión trae las dos cosas. Todo lo de esta página es aditivo: no hemos retirado nada. El único valor existente que cambia es el expires_at de la reemisión del vale, que ahora es siempre una fecha; se describe en Cuentas gestionadas.

Mira cuánto cuesta antes de dar de alta

GET /v1/accounts/provisioning-preview (scope accounts:read) muestra lo que cobraría a tu cuenta dar de alta una cuenta gestionada nueva, sin escribir nada. Pasa el plan que estás valorando (emprendedor, empresario o integral) y recibes lo que se cobra hoy (amount_cents, tax_amount_cents, total_cents y tax_rate), la fecha de la próxima factura y la cuota mensual conjunta que sigue, en los campos recurring_*. Todos los importes son céntimos enteros.

Aplica las mismas reglas que el alta, así que adelanta los mismos errores antes de comprometerte: 422 managed_account_plan_not_self_serve para enterprise, 422 managed_account_provider_in_trial mientras tu cuenta está en prueba y 422 managed_accounts_limit_reached en tu límite. Con una clave de prueba todos los importes son 0. Si en ese momento no podemos resolver el precio, responde 503: reintenta más tarde, un importe no disponible nunca es una compra gratuita. No necesita Idempotency-Key, porque no se cobra ni se crea nada. La tool MCP es preview_managed_account_provisioning.

El IVA puede llegar vacío. Cuando se cobra algo pero la pasarela de pago no devuelve ningún tipo de IVA, no hemos podido calcularlo: tax_rate, tax_amount_cents, total_cents y recurring_total_cents llegan entonces en null. amount_cents es la base imponible, no lo que se cobra, así que no se la muestres a tu cliente como el total: indica que el total no se ha podido calcular y vuelve a intentarlo más tarde. Cuando no hay nada que cobrar (una clave de prueba, o una base de 0) siguen valiendo 0. Lo mismo vale para la tool MCP.

Tiene su propio cupo. La vista previa pertenece a la familia read con un límite propio: 10 peticiones por minuto, contadas por credencial y empresa efectiva. Si lo superas recibes 429 con Retry-After.

Empresas: desde cuándo y dónde

Todas las operaciones de empresa (listar, consultar, crear, actualizar, activar, desactivar y activar en lote) devuelven ahora:

• status_since: cuándo el NIF pasó a su estado actual inactive o archived. Es null para un NIF active y para uno cuyo cambio es anterior a este registro: nunca inventamos la fecha.
• country: el país del domicilio fiscal tal como consta en el perfil de la empresa, o null si no se indicó.

Traspasos de NIF: las fechas

Las cuatro operaciones de traspaso (emitir, listar, aceptar y revocar) devuelven ahora issued_at, consumed_at y revoked_at. consumed_at dice cuándo se aceptó el traspaso, no qué cuenta lo aceptó.

Cuentas gestionadas: vale y pago

Las operaciones de cuentas gestionadas (listar, consultar, dar de alta, cambiar el nivel de acceso, terminar la gestión y cambiar el plan) devuelven ahora:

• claim: el vale de reclamación pendiente sin su secreto, con status (valid o expired), issued_at, expires_at, ttl_days, sent_by_email y masked_email. Es null cuando el titular ya reclamó la cuenta, en una cuenta de pruebas o si no hay vale pendiente. El secreto y el enlace se siguen devolviendo una sola vez, en el alta y en la reemisión.
• payment_assumed_at: cuándo el titular asumió el pago, o null mientras tu cuenta lo sigue pagando.
• plan_renews_at: el fin del periodo de facturación actual del plan, o null cuando la cuenta no se cobra a la tuya.

El alta devuelve además claim_expires_at, que lleva la fecha también cuando el enlace va por correo (la caducidad no es un secreto), y reactivated, que es true cuando la llamada recuperó una gestión que había terminado antes de que el titular reclamara la cuenta.

La reemisión del vale (POST /v1/accounts/{account}/claim-tokens y la tool MCP reissue_managed_account_claim) cambia un valor: expires_at, la caducidad del vale nuevo, era null cuando el vale se enviaba por correo (send_email: true) y ahora es siempre una fecha ISO 8601, porque una reemisión siempre emite un vale nuevo y su caducidad no es un secreto. claim_token y claim_url no cambian: siguen en null con send_email: true y en una repetición idempotente. Si tu código trataba un expires_at en null como «enviado por correo», lee sent_by_email dentro de claim.

Cambio de plan: renovación y qué se apaga

La vista previa del cambio de plan devuelve ahora renews_at, el fin del periodo de facturación actual, también en una mejora. En una bajada, deactivates lista los NIF adicionales (id, name y tax_id) que el cambio desactivaría, para que avises al cliente antes de que ocurra.

Importación masiva: IVA, totales y códigos de error

La vista previa de la importación devuelve cost con IVA y la cuota mensual de cada modalidad y en total, y la importación ejecutada devuelve stats con IVA y el total cobrado de inmediato. Ambos son aditivos: no aparecen en los informes de importaciones guardadas antes. Cada fila lleva ahora name y, en las filas own_nif, el company_id del NIF que registró o conciló.

Cada fila lleva además error_codes, el código estable de cada error de errors, con las mismas claves: {"tax_id": "required"} junto al mensaje en español de tax_id. Usa el código, y no el mensaje, para reaccionar a un error o traducirlo. El mensaje no cambia: errors queda exactamente como estaba. error_codes siempre es un objeto, {} cuando la fila no tiene errores, también en las importaciones guardadas antes y en una fila BLOCKED, cuyo motivo es code. Los códigos son una lista cerrada, en la guía de importación masiva. Está en POST /v1/accounts/imports/preview y en POST /v1/accounts/imports.

Consolidado de RR. HH.: de quién es cada NIF

Cada fila del consolidado de RR. HH. dice ahora a qué cuenta pertenece el NIF (account, con id y name), cómo llega hasta ti (relation_origin: granted o provisioned) y el nivel que tienes sobre él (access_level: view u operate).

UsersRound

Cuentas gestionadas

Wallet

Precio de las cuentas gestionadas y cambio de pagador

FileUp

Importación masiva de cuentas gestionadas