Ajustos del contracte de comptes
Correccions del contracte v1 després de la revisió del 6 d’octubre, compres duradores a l’eix d’empresa i la forma final dels comptes gestionats, el NIF addicional i el topall d’usuaris.
7 d’octubre de 2026
Hem revisat el nou model de comptes línia a línia abans que arribi a les vostres integracions i hem ajustat algunes coses. La majoria fan el contracte més estricte allà on era massa generós, així que convé llegir aquesta pàgina si la vostra integració emet credencials, reintenta escriptures o contracta seients.
El que va corregir la revisió
idempotency_key_reused respon ara sempre 422, sigui quina sigui l’operació que reutilitza la clau. L’empremta d’idempotència ja no exposa secrets: la repetició d’una escriptura que va retornar un secret conserva la resposta original, però el secret mai no queda llegible en el que guardem.
L’scope * no cobreix l’administració de compte (account:owner, members:*, invitations:* i nif_transfers:*), i api_keys:* queda reservat: demaneu-los pel seu nom. Una credencial ja no pot crear, rotar, revocar ni canviar l’àmbit de NIF d’una altra que tingui més poder que ella; la resposta és 403 insufficient_scope, o 403 live_credential_required quan una clau de proves intenta tocar-ne una de producció.
Les operacions v1 de contactes respecten ara la capçalera Factuarea-Version com la resta del contracte. Els webhooks de compte comproven a més, esdeveniment a esdeveniment, que cada endpoint pot continuar veient el que està a punt de rebre.
Les compres duradores passen a l’eix d’empresa
Totes les operacions dels lots d’empleats (employee-batches), els bescanvis d’ofertes de seients d’empleat (employee-seat-offer-redemptions) i els bescanvis d’ofertes de NIF addicional (gestoria-seat-offer-redemptions) viuen ara sota /v1/companies/{company}/…, sense àlies pla. És la mateixa retirada de rutes planes que ha seguit la resta del model de comptes. Els noms d’operació i de tool MCP no canvien: si les crideu amb un SDK, la CLI o MCP, només cal que actualitzeu la versió; si les crideu per URL, afegiu l’empresa a la ruta.
Alta, activació i vista prèvia de NIF
L’alta, l’activació i l’activació en lot de NIF, i la vista prèvia del càrrec, poden respondre ara 409 customer_offer_phase_incompatible quan les condicions que ja teniu no es poden conservar, i 503 gestoria_seat_preview_unavailable quan no podem calcular la vista prèvia en aquell moment. En cap dels dos casos es crea, s’activa ni es cobra res, així que podeu reintentar amb tranquil·litat.
La vista prèvia també explica per què un import és zero, a zero_reason: trial, covered, enterprise_contract, negotiated_free_price o no_immediate_charge. Un motiu desconegut mai no vol dir contracte Enterprise.
Les operacions de seients, empleats, lots i empreses que poden topar amb una operació pendent o amb un canvi de condicions declaren ara el seu 409 amb un exemple, i el 409 external_id_already_exists dels lots d'empleats afegeix row_ids, el row_id estable de cada fila el external_id de la qual ja estava ocupat, perquè corregiu aquestes files i torneu a enviar el lot.
Comptes gestionats, NIF addicional i topall d’usuaris
Com a proveïdor, ja podeu assignar Avanzado (integral) a més d’Esencial i Profesional a un compte gestionat, al preu normal del pla. managed_accounts_by_plan inclou sempre la clau integral. Enterprise continua acordant-se amb nosaltres per contracte.
Un NIF addicional costa 15 € al mes, IVA exclòs. En un compte Profesional o Avanzado, cada NIF addicional té el pla Profesional; només el NIF titular té el pla del compte.
El topall d’usuaris es compta per places del compte, no de cada NIF. Acceptar una invitació amb el topall ple respon 422 business_rule_violation, amb el mateix missatge que veieu a l’aplicació, i no un 402.