Impuestos propios de la empresa

9 de octubre de 2026 — Los impuestos ahora son de dos clases. El catálogo de Factuarea (global) es común a todas las empresas y es de solo lectura, y cada empresa puede crear sus propios impuestos (company), que solo ve esa empresa. Los predeterminados se eligen por empresa, así que elegir uno nunca cambia lo que ven las demás.

• Tus propios impuestos — Crear un impuesto crea un impuesto de la empresa de la clave de API. Puedes editarlo con Actualizar un impuesto, activarlo o desactivarlo con Alternar el estado activo del impuesto y eliminarlo con Eliminar un impuesto.
• Un campo nuevo, ownership — cada impuesto de las respuestas lleva ownership: global (catálogo de Factuarea) o company (creado por tu empresa). Listar todos los impuestos acepta ownership=global o ownership=company; si lo omites, se listan ambos. Cualquier otro valor responde 422 con error.param igual a ownership.
• Visibilidad — ves el catálogo global y tus propios impuestos. Un impuesto de otra empresa responde 404 tax_not_found, igual que uno que no existe.
• Códigos — el código de un impuesto debe ser único entre el catálogo global y tus propios impuestos (409 tax_code_already_exists en caso contrario). Otras empresas pueden usar el mismo código.
• Predeterminados por empresa — Marcar un impuesto como predeterminado de su tipo y Fijar el impuesto predeterminado de un tipo de documento funcionan con cualquier impuesto visible y solo cambian la empresa de la clave de API. Sin documento, set-default escribe únicamente en los documentos compatibles donde esa categoría de impuesto (IVA, retención o recargo) está activada para tu empresa. is_default y default_for_documents son siempre los predeterminados efectivos de tu empresa, y default_for_documents también se acepta al crear o actualizar un impuesto. recurring_invoice hereda el predeterminado de invoice.
• Comprobación de uso — Comprobar si un impuesto está en uso cuenta solo los documentos, productos, contactos y predeterminados de tu empresa. used_by añade supplier_profiles (fichas de proveedor con el impuesto por defecto) y recurring_invoices (plantillas recurrentes con alguna línea que lo usa, cada una una vez), documenta company_tax_defaults, y total_count suma los nueve contadores. La tool MCP check_tax_in_use devuelve las mismas claves.
• Webhooks — los eventos tax.metadata_changed, tax.validity_changed y tax.external_reference_changed se entregan para los impuestos de tu empresa. Los impuestos del catálogo no emiten eventos.
• MCP — dos tools nuevas, update_tax (taxes:write) y delete_tax (taxes:delete, irreversible, por lo que acepta idempotency_key). search_taxes devuelve ownership y filtra por él. El scope OAuth taxes.delete, que equivale a taxes:delete, permite a un cliente OAuth usar delete_tax.

Códigos de error

• global_tax_read_only (403) — intentaste modificar, activar o desactivar, o eliminar un impuesto del catálogo de Factuarea. Crea un impuesto propio o fija los predeterminados de tu empresa.
• tax_not_defaultable_for_document (422) — el impuesto no puede ser el predeterminado de ese documento: su tipo es other, su applies_to no cubre el documento o el documento es recurring_invoice.
• tax_default_axis_disabled (422, business_rule_violation) — la categoría del impuesto (IVA, retención o recargo) está desactivada para tu empresa en el documento pedido, o en todos los documentos donde set-default escribiría. Lo devuelven crear, actualizar, set-default y set-default/{docType}. Activa la categoría en la configuración de la empresa o elige un documento donde esté activada.

Los dos primeros códigos sustituyen a custom_tax_creation_disabled y system_tax_default_modification_forbidden, que la API ya no devuelve. system_tax_immutable_field, system_tax_undeletable, tax_in_use y tax_inactive_cannot_be_default mantienen su significado. Consulta el catálogo de errores.

Todas las operaciones ya existían. Sus scopes no cambian.