Impostos propis de l'empresa

9 d'octubre de 2026 — Els impostos ara són de dues classes. El catàleg de Factuarea (global) és comú a totes les empreses i és de només lectura, i cada empresa pot crear els seus propis impostos (company), que només veu aquesta empresa. Els predeterminats s'escullen per empresa, de manera que escollir-ne un mai canvia el que veuen les altres.

• Els teus propis impostos — Crear un impost crea un impost de l'empresa de la clau d'API. Pots editar-lo amb Actualitzar un impost, activar-lo o desactivar-lo amb Alternar l'estat actiu de l'impost i eliminar-lo amb Eliminar un impost.
• Un camp nou, ownership — cada impost de les respostes porta ownership: global (catàleg de Factuarea) o company (creat per la teva empresa). Llistar tots els impostos accepta ownership=global o ownership=company; si ho omets, es llisten tots dos. Qualsevol altre valor respon 422 amb error.param igual a ownership.
• Visibilitat — veus el catàleg global i els teus propis impostos. Un impost d'una altra empresa respon 404 tax_not_found, igual que un que no existeix.
• Codis — el codi d'un impost ha de ser únic entre el catàleg global i els teus propis impostos (409 tax_code_already_exists en cas contrari). Altres empreses poden fer servir el mateix codi.
• Predeterminats per empresa — Marcar un impost com a predeterminat del seu tipus i Fixar l'impost predeterminat d'un tipus de document funcionen amb qualsevol impost visible i només canvien l'empresa de la clau d'API. Sense document, set-default escriu únicament en els documents compatibles on aquesta categoria d'impost (IVA, retenció o recàrrec) està activada per a la teva empresa. is_default i default_for_documents són sempre els predeterminats efectius de la teva empresa, i default_for_documents també s'accepta en crear o actualitzar un impost. recurring_invoice hereta el predeterminat d'invoice.
• Comprovació d'ús — Comprovar si un impost està en ús compta només els documents, productes, contactes i predeterminats de la teva empresa. used_by afegeix supplier_profiles (fitxes de proveïdor amb l'impost per defecte) i recurring_invoices (plantilles recurrents amb alguna línia que el fa servir, cadascuna una vegada), documenta company_tax_defaults, i total_count suma els nou comptadors. L'eina MCP check_tax_in_use retorna les mateixes claus.
• Webhooks — els esdeveniments tax.metadata_changed, tax.validity_changed i tax.external_reference_changed es lliuren per als impostos de la teva empresa. Els impostos del catàleg no emeten esdeveniments.
• MCP — dues eines noves, update_tax (taxes:write) i delete_tax (taxes:delete, irreversible, per la qual cosa accepta idempotency_key). search_taxes retorna ownership i filtra per aquest camp. El scope OAuth taxes.delete, que equival a taxes:delete, permet a un client OAuth fer servir delete_tax.

Codis d'error

• global_tax_read_only (403) — vas intentar modificar, activar o desactivar, o eliminar un impost del catàleg de Factuarea. Crea un impost propi o fixa els predeterminats de la teva empresa.
• tax_not_defaultable_for_document (422) — l'impost no pot ser el predeterminat d'aquest document: el seu tipus és other, el seu applies_to no cobreix el document o el document és recurring_invoice.
• tax_default_axis_disabled (422, business_rule_violation) — la categoria de l'impost (IVA, retenció o recàrrec) està desactivada per a la teva empresa en el document demanat, o en tots els documents on set-default escriuria. El retornen crear, actualitzar, set-default i set-default/{docType}. Activa la categoria a la configuració de l'empresa o tria un document on estigui activada.

Els dos primers codis substitueixen custom_tax_creation_disabled i system_tax_default_modification_forbidden, que l'API ja no retorna. system_tax_immutable_field, system_tax_undeletable, tax_in_use i tax_inactive_cannot_be_default mantenen el seu significat. Consulta el catàleg d'errors.

Totes les operacions ja existien. Els seus scopes no canvien.