v1.13.0 — Paritat de contracte

23 d'agost de 2026 — aquesta versió canvia comportament i documentació sense afegir endpoints públics ni tools MCP; la superfície pública no canvia respecte de la versió anterior.

Escriptures de producte

• Les peticions de creació/actualització de producte documenten specifications com un objecte complet de parells nom/valor. En actualitzar, null la buida i ometre-la en conserva el valor.
• PUT /v1/products/{product} continua sent una actualització parcial. stock és un objectiu absolut: l'API registra només la diferència com a moviment; repetir el mateix valor no fa res i null significa zero. stock i low_stock_threshold conserven quatre decimals.
• Crear amb un external_id existent actualitza aquell producte de manera idempotent. El metadata de producte manté la compatibilitat heretada: admet llistes i converteix valors escalars a strings.
• El contracte OpenAPI també alinea els camps actualitzables series_id nullable i l'àlies iban acceptat en comptes bancaris de proveïdor.

OAuth i MCP

El consentiment OAuth suma sis scopes: price_lists.read, price_lists.write, facturae.read, facturae.write, tax_reports.read i tax_reports.write. Així, 24 tools existents passen a estar disponibles per a apps OAuth: 343 assolibles per OAuth i 81 exclusives d'API key.

El catàleg assignable a API keys continua sent deliberadament més estret que el registre només additiu: els quatre scopes reservats d'autofacturació GoCardless i MONEI encara no es poden assignar.

Capacitat de Developer API derivada del pla

La capacitat API segueix directament el pla actiu de Factuarea: Trial/Free, Emprendedor/Starter, Empresario/Pro i Enterprise/Scale. No hi ha cap add-on Developer API ni cap boost de capacitat per contractar. Una migració històrica grandfathered_addon pot conservar un tier superior mentre continuï actiu un pla vàlid.

Els errors de capacitat de webhooks reflecteixen aquest model: addon_required significa que el pla actual concedeix zero endpoints; addon_not_active, que no hi ha cap pla actiu vàlid; i superar un topall positiu retorna business_rule_violation amb subcode: max_webhook_endpoints_reached.

PDFs de documents

Les notes i condicions multilínia conserven ara els salts i s'apilen línia a línia als PDFs generats.