Vista prèvia de l'alta i detalls de compte

13 d’octubre de 2026

Quan gestiones comptes per als teus clients, vols saber quant costarà un pas abans de fer-lo i llegir les mateixes dates i imports que mostra l’app. Aquesta versió porta les dues coses. Tot el d’aquesta pàgina és additiu: no hem retirat res. L’únic valor existent que canvia és l’expires_at de la reemissió del val, que ara és sempre una data; es descriu a Comptes gestionats.

Mira quant costa abans de donar d’alta

GET /v1/accounts/provisioning-preview (scope accounts:read) mostra el que cobraria al teu compte donar d’alta un compte gestionat nou, sense escriure res. Passa el plan que estàs valorant (emprendedor, empresario o integral) i reps el que es cobra avui (amount_cents, tax_amount_cents, total_cents i tax_rate), la data de la propera factura i la quota mensual conjunta que segueix, als camps recurring_*. Tots els imports són cèntims enters.

Aplica les mateixes regles que l’alta, així que avança els mateixos errors abans de comprometre’t: 422 managed_account_plan_not_self_serve per a enterprise, 422 managed_account_provider_in_trial mentre el teu compte és en prova i 422 managed_accounts_limit_reached al teu límit. Amb una clau de prova tots els imports són 0. Si en aquest moment no podem resoldre el preu, respon 503: reintenta més tard, un import no disponible mai no és una compra gratuïta. No necessita Idempotency-Key, perquè no es cobra ni es crea res. La tool MCP és preview_managed_account_provisioning.

L’IVA pot arribar buit. Quan es cobra alguna cosa però la passarel·la de pagament no retorna cap tipus d’IVA, no l’hem pogut calcular: tax_rate, tax_amount_cents, total_cents i recurring_total_cents arriben llavors en null. amount_cents és la base imposable, no el que es cobra, així que no la mostris al teu client com a total: indica que el total no s’ha pogut calcular i torna-ho a provar més tard. Quan no hi ha res a cobrar (una clau de prova, o una base de 0) continuen valent 0. El mateix val per a la tool MCP.

Té la seva pròpia quota. La vista prèvia pertany a la família read amb un límit propi: 10 peticions per minut, comptades per credencial i empresa efectiva. Si el superes reps 429 amb Retry-After.

Empreses: des de quan i on

Totes les operacions d’empresa (llistar, consultar, crear, actualitzar, activar, desactivar i activar en lot) retornen ara:

• status_since: quan el NIF va passar al seu estat actual inactive o archived. És null per a un NIF active i per a un el canvi del qual és anterior a aquest registre: mai no inventem la data.
• country: el país del domicili fiscal tal com consta al perfil de l’empresa, o null si no es va indicar.

Traspassos de NIF: les dates

Les quatre operacions de traspàs (emetre, llistar, acceptar i revocar) retornen ara issued_at, consumed_at i revoked_at. consumed_at diu quan es va acceptar el traspàs, no quin compte l’ha acceptat.

Comptes gestionats: val i pagament

Les operacions de comptes gestionats (llistar, consultar, donar d’alta, canviar el nivell d’accés, acabar la gestió i canviar el pla) retornen ara:

• claim: el val de reclamació pendent sense el seu secret, amb status (valid o expired), issued_at, expires_at, ttl_days, sent_by_email i masked_email. És null quan el titular ja ha reclamat el compte, en un compte de proves o si no hi ha cap val pendent. El secret i l’enllaç es continuen retornant una sola vegada, en l’alta i en la reemissió.
• payment_assumed_at: quan el titular va assumir el pagament, o null mentre el teu compte continua pagant-lo.
• plan_renews_at: el final del període de facturació actual del pla, o null quan el compte no es cobra al teu.

L’alta retorna a més claim_expires_at, que porta la data també quan l’enllaç va per correu (la caducitat no és un secret), i reactivated, que és true quan la crida va recuperar una gestió que havia acabat abans que el titular reclamés el compte.

La reemissió del val (POST /v1/accounts/{account}/claim-tokens i la tool MCP reissue_managed_account_claim) canvia un valor: expires_at, la caducitat del val nou, era null quan el val s’enviava per correu (send_email: true) i ara és sempre una data ISO 8601, perquè una reemissió sempre emet un val nou i la seva caducitat no és un secret. claim_token i claim_url no canvien: continuen en null amb send_email: true i en una repetició idempotent. Si el teu codi tractava un expires_at en null com a «enviat per correu», llegeix sent_by_email dins de claim.

Canvi de pla: renovació i què s’apaga

La vista prèvia del canvi de pla retorna ara renews_at, el final del període de facturació actual, també en una millora. En una baixada, deactivates llista els NIF addicionals (id, name i tax_id) que el canvi desactivaria, perquè avisis el client abans que passi.

Importació massiva: IVA, totals i codis d’error

La vista prèvia de la importació retorna cost amb IVA i la quota mensual de cada modalitat i en total, i la importació executada retorna stats amb IVA i el total cobrat de seguida. Tots dos són additius: no apareixen als informes d’importacions desades abans. Cada fila porta ara name i, a les files own_nif, el company_id del NIF que va registrar o conciliar.

Cada fila porta a més error_codes, el codi estable de cada error d’errors, amb les mateixes claus: {"tax_id": "required"} al costat del missatge en castellà de tax_id. Fes servir el codi, i no el missatge, per reaccionar a un error o traduir-lo. El missatge no canvia: errors queda exactament com estava. error_codes sempre és un objecte, {} quan la fila no té errors, també a les importacions desades abans i en una fila BLOCKED, el motiu de la qual és code. Els codis són una llista tancada, a la guia d’importació massiva. Hi és a POST /v1/accounts/imports/preview i a POST /v1/accounts/imports.

Consolidat de RR. HH.: de qui és cada NIF

Cada fila del consolidat de RR. HH. diu ara a quin compte pertany el NIF (account, amb id i name), com arriba fins a tu (relation_origin: granted o provisioned) i el nivell que hi tens (access_level: view o operate).

UsersRound

Comptes gestionats

Wallet

Preu dels comptes gestionats i canvi de pagador

FileUp

Importació massiva de comptes gestionats