Taxes

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/tax-classes` +
    // filters: name, description, ids
    `?page=1&limit=20` +
    // include tax_rates_overview for a per-class summary of the rate set
    `&include=tax_rates_overview`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

// Create one class per product CATEGORY you sell (Standard goods & services, Books,
// Foodstuffs, Accommodation, Digital services / SaaS, Exempt). A class is a category,
// not a country and not a single rate; the country rows live underneath it.
fetch(`https://api.enlivy.com/organizations/${organizationId}/tax-classes`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // the category, not a rate: per-locale maps
    name_lang_map: { en: "Books & publications", ro: "Cărți și publicații" },
    description_lang_map: { en: "Reduced-rate category for books and periodicals." }
  })
});

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";
const taxClassId = "your_tax_class_id";

const headers = { Authorization: `Bearer ${token}`, "Content-Type": "application/json" };
const url = `https://api.enlivy.com/organizations/${organizationId}/tax-classes/${taxClassId}`;

// Update a category's labels
fetch(url, {
  method: "PUT",
  headers,
  body: JSON.stringify({ name_lang_map: { en: "Books & publications (2026)" } })
});

// soft delete; restore via POST /tax-classes/restore/{taxClassId}
fetch(url, { method: "DELETE", headers });

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/tax-rates` +
    `?page=1&limit=50` +
    // includes: organization, organization_tax_class, locations
    `&include=organization_tax_class,locations`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";
const headers = { Authorization: `Bearer ${token}`, "Content-Type": "application/json" };
const classId = "standard_goods_class_id";

// A tax rate is ONE ROW in a class's rate set, not a standalone tax. Each row declares a
// scope (locations and/or buyer conditions), an EN16931 VAT category (eu_vat_class), and a
// priority. At invoice time Enlivy takes the highest-priority row whose scope + buyer match.
const common = {
  organization_tax_class_id: classId,
  has_eu_vat_properties: true,
  is_compound: false,
  is_shipping: false,
  is_inclusive: false
};

// The canonical rate set for one category (home country = Romania): four archetypes.
const rateSet = [
  {
    // Home-country domestic: the default when selling within Romania
    name: "RO Domestic 21%", rate: 21, priority: 1000,
    eu_vat_class: "S", // Standard-rated, stamped on the invoice line
    has_locations: true, locations: [{ country_code: "RO" }]
  },
  {
    // EU B2B reverse charge: 0%, matches ONLY VAT-registered businesses in other EU states
    name: "EU B2B Reverse Charge", rate: 0, priority: 900,
    eu_vat_class: "AE", vatex_code: "VATEX-EU-AE", // exemption reason (PEPPOL)
    is_business_entity: true, is_eu_vat_registered: true, // buyer-qualification gates
    has_locations: true, locations: [{ country_code: "DE" }, { country_code: "FR" }]
  },
  {
    // Per-country EU domestic (B2C digital / OSS): charge the buyer's own country rate
    name: "DE Domestic 19%", rate: 19, priority: 800,
    eu_vat_class: "S",
    has_locations: true, locations: [{ country_code: "DE" }]
  },
  {
    // Rest of world: outside scope, 0%, no locations = catch-all fallback
    name: "Rest of World (Outside Scope)", rate: 0, priority: 100,
    eu_vat_class: "O", vatex_code: "VATEX-EU-O",
    has_locations: false
  }
];

for (const row of rateSet) {
  await fetch(`https://api.enlivy.com/organizations/${organizationId}/tax-rates`, {
    method: "POST",
    headers,
    body: JSON.stringify({ ...common, ...row })
  });
}

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";
const taxRateId = "your_tax_rate_id";

// Adjust a single row: its percentage, VAT category, scope, or priority in the ladder.
// Send only the fields you are changing.
fetch(`https://api.enlivy.com/organizations/${organizationId}/tax-rates/${taxRateId}`, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    rate: 20, // e.g. the RO domestic rate changes
    display_name: "VAT 20%"
  })
});

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";
const taxRateId = "your_tax_rate_id";

// soft delete; restore via POST /tax-rates/restore/{taxRateId}
fetch(`https://api.enlivy.com/organizations/${organizationId}/tax-rates/${taxRateId}`, {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  }
});