Integrează-ți Sistemele și Automatizează Fluxurile cu API-ul Enlivy

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/invoices?page=1&limit=20&include=invoice_prefix,tag_ids,line_items,taxes&include_meta=navigation`, {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  }
});

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/invoices/${invoiceId}?include=invoice_prefix,tag_ids,line_items,taxes`, {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  }
});

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/invoices`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: 'your_payload'  
});

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/invoices/${invoiceId}`, {
  method: 'PUT',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: 'your_payload'
});

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/billing-schedules?page=1&limit=20` +
    // status: pending | active | payment_method_required | paused | cancelling | completed | cancelled
    `&status=active&direction=outbound` +
    `&include=receiver_user,phases,payments` +
    `&include_meta=navigation`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/billing-schedules/${scheduleId}` +
    // includes: sender_user, receiver_user, contract, billing_package,
    // subscription_term, phases, payments, deleted_by_user
    `?include=phases,payments,receiver_user,billing_package`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/billing-schedules`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    management_type: "app_managed",   // this reference only covers app_managed
    direction: "outbound",            // outbound = you bill a customer; inbound = you are billed
    status: "active",                 // start billing right away

    organization_sender_user_id: "org_user_sender_id",     // the biller (you)
    organization_receiver_user_id: "org_user_receiver_id", // the customer (required for outbound)

    currency: "EUR",
    payment_method: "stripe_card_payment", // bank_transfer | card_payment | stripe_card_payment | paypal | cash | paid_by_personal_funds
    organization_user_payment_method_id: "payment_method_id", // saved card to auto-charge (must belong to the receiver)

    name_lang_map: { en: "Monthly Retainer" },   // per-locale maps, not plain strings
    note_lang_map: { en: "Includes support and hosting." },

    is_email_notifications_active: true,
    email_notifications_to: "billing@acme.example",

    // customer self-service toggles (what the recipient may do from the portal)
    customer_can_reconfigure: false,
    customer_can_cancel: true,
    customer_can_pause: false,

    // totals + dates (total, paid_total, starts_at, ends_at, next_payment_create_at)
    // are computed by the engine, do NOT send them.

    // phases are valid ONLY for app_managed (stripe_hosted rejects them). Max 20.
    phases: [
      {
        frequency: "monthly",           // weekly | biweekly | monthly | yearly
        execute_after: "2026-08-01",    // first run date for this phase
        max_occurrences: 12,            // stop after N invoices (omit for open-ended)
        due_date_type: "custom_days",   // immediate | end_of_month | custom_days
        due_date_days: 14,              // required only when due_date_type = custom_days
        order: 0,
        line_items: [
          {
            name_lang_map: { en: "Retainer" }, // required unless organization_product_id is set
            quantity: 1,
            price: 500.00,                     // money: signed decimal in MAJOR units (not cents)
            organization_tax_class_id: "tax_class_id"
          },
          {
            organization_product_id: "product_id", // pulls name / tax defaults from the product
            quantity: 2,
            price: 49.90
          }
        ]
      }
    ]
  })
});

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/billing-schedules`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    management_type: "app_managed",   // package-managed requires app_managed
    direction: "outbound",            // package-managed requires outbound
    status: "active",
    organization_sender_user_id: "org_user_sender_id",
    organization_receiver_user_id: "org_user_receiver_id",
    organization_user_payment_method_id: "payment_method_id",

    // attach a SUBSCRIPTION package, it defines the phases & line items
    organization_billing_package_id: "billing_package_id",

    // optional: pick the cadence variant; omit to use the package default
    organization_billing_package_subscription_term_id: "subscription_term_id",

    // optional: choose which package group items (and quantities) to include
    selected_group_items: [
      { id: "group_item_id_1", quantity: 1 },
      { id: "group_item_id_2", quantity: 3 }
    ]

    // NOTE: mutually exclusive with `phases`, the package supplies them.
  })
});

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/billing-schedules/${scheduleId}`, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // lifecycle: active <-> paused; set "cancelling" to stop at the end of the cycle
    status: "paused",
    note_lang_map: { en: "Paused at customer request." },
    is_email_notifications_active: false,
    customer_can_cancel: true

    // to change WHAT gets billed on a package-managed schedule,
    // use /reconfigure below rather than editing here.
  })
});

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

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

const changes = {
  organization_billing_package_id: "billing_package_id",
  organization_billing_package_subscription_term_id: "subscription_term_id",
  selected_group_items: [
    // price_override + pricing_currency let you deviate from the package price
    { id: "group_item_id", quantity: 2, price_override: 39.00, pricing_currency: "EUR" }
  ],
  custom_line_items: [
    { name_lang_map: { en: "One-off setup" }, quantity: 1, price: 150.00 }
  ],
  // how the switch is billed: none | prorate_immediately | prorate_next_invoice
  // (prorate_immediately requires an active schedule)
  proration_mode: "prorate_next_invoice"
};

// 1. Preview, no changes are applied; returns the new composition + proration
await fetch(
  `https://api.enlivy.com/organizations/${organizationId}/billing-schedules/${scheduleId}/preview-reconfigure`,
  { method: "POST", headers, body: JSON.stringify(changes) }
);

// 2. Apply
await fetch(
  `https://api.enlivy.com/organizations/${organizationId}/billing-schedules/${scheduleId}/reconfigure`,
  { method: "PUT", headers, body: JSON.stringify(changes) }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/billing-schedules/analytics/summary` +
    // analyticsType: summary | history_monthly
    `?direction=outbound&convert_to_currency=EUR`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

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

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

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

// 1. Discover eligible institutions for this invoice.
//    invoice.peppol_exchange_push_options lists the institution ids you may push to;
//    invoice.peppol_exchanges_pushed lists the ones already sent.
const invoice = await fetch(
  `https://api.enlivy.com/organizations/${organizationId}/invoices/${invoiceId}`,
  { method: "GET", headers }
).then((r) => r.json());

// 2. Push to a specific institution. The id is a string, e.g. "anaf" (Romania / ANAF).
const institution = "anaf";

const exchange = await fetch(
  `https://api.enlivy.com/organizations/${organizationId}/invoices/${invoiceId}/peppol/${institution}`,
  { method: "POST", headers } // no request body, the invoice is the document
).then((r) => r.json());

// The response is the network-exchange record. Poll its `status`:
// pending | processing | success | success_in_exchange_queue | success_pending_archive
// | change_required | rejected | rejected_at_exchange | failed | failed_credentials_expired
// A transport/connectivity failure to the institution returns HTTP 503.

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/invoices/network-exchanges?page=1&limit=20` +
    // filters: status, organization_invoice_id, invoice_state (the linked invoice's state),
    // created_at_from/to, updated_at_from/to, ids
    `&status=success` +
    `&include=invoice`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/invoices/network-exchanges/${exchangeId}` +
    // includes: organization, invoice, parsed_data (the parsed UBL as structured data), tag_ids
    `?include=parsed_data,invoice`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/invoices/network-exchanges/${institutionId}/pull` +
    `?date_from=2026-07-01`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

const authOnly = { Authorization: `Bearer ${token}` };
const url = `https://api.enlivy.com/organizations/${organizationId}/invoices/network-exchanges/${exchangeId}`;

// the signed UBL / XML document
const xml       = await fetch(`${url}/download`,           { headers: authOnly }).then((r) => r.blob());
// the detached digital signature
const signature = await fetch(`${url}/download-signature`, { headers: authOnly }).then((r) => r.blob());
// the human-readable PDF rendering
const pdf       = await fetch(`${url}/download-pdf`,       { headers: authOnly }).then((r) => r.blob());

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/invoices/network-exchanges/${exchangeId}/information`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/bank-transaction-cost-types?page=1&limit=50`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/bank-transaction-cost-types`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    title_lang_map: { en: "Client Payment", ro: "Încasare client" }, // per-locale map

    // does a transaction of this type have to be linked to a business entity?
    connection_required: true,

    // which entity types it may be connected to (required when connection_required = true)
    // options: invoice | receipt | payslip | bank_transaction | user
    connection_types: ["invoice", "receipt"],

    // optional: parent cost type for a nested / hierarchical category
    organization_bank_transaction_cost_type_id: null
  })
});

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/bank-transactions?page=1&limit=20` +
    // state: backlog | classified | connected | connected_partially | danger | trashed
    `&state=backlog&direction=inbound` +
    // find transactions connected to a specific entity, send BOTH params together:
    // `&connection_entity_type=invoice&connection_entity_id=invoice_id` +
    // free-text search with q=... (min 3 chars) instead of ids
    `&include=cost_type,connection_entities,bank_account`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/bank-transactions/${transactionId}` +
    // includes: organization, bank_account, cost_type, connection_entities, deleted_by_user, tag_ids
    `?include=cost_type,connection_entities,bank_account`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/bank-transactions`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    hash: "unique-dedupe-key",       // required; unique within a bank account (import de-dup key)
    title: "Incoming transfer from Acme Studio",
    amount: 1200.00,                 // money: signed decimal in MAJOR units (not cents)
                                     // direction is DERIVED from the sign (positive = inbound, negative = outbound)
    currency: "EUR",
    organization_bank_account_id: "bank_account_id",
    sender_label: "ACME STUDIO SRL", // free-text counterpart name from the bank feed
    note: "Invoice #2026-0142 settlement"

    // state is managed by classification (defaults to "backlog"), no need to set it.
    // optionally classify inline with organization_bank_transaction_cost_type_id + connection_entities (see below).
  })
});

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/bank-transactions/${transactionId}`, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // 1. Classify, assign a cost type. Moves state: backlog -> classified.
    organization_bank_transaction_cost_type_id: "cost_type_id",

    // 2. Reconcile, link the transaction to what it pays for.
    //    connection_entity_type must be one of the cost type's allowed connection_types.
    //    The array is an UPSERT:
    //        { connection_entity_type, connection_entity_id, amount }  -> create a link
    //        { id }                                                    -> keep an existing link
    //        { id, _deleted: true }                                    -> remove a link
    //    (omitting an existing link does NOT delete it)
    //    Amounts covering the full transaction -> "connected"; partial -> "connected_partially".
    connection_entities: [
      { connection_entity_type: "invoice", connection_entity_id: "invoice_id", amount: 1000.00 },
      { connection_entity_type: "receipt", connection_entity_id: "receipt_id", amount: 200.00 }
    ]
  })
});

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/bank-transactions/analytics/summary` +
    // analyticsType: summary | history_monthly
    `?start_date=2026-01-01&end_date=2026-12-31` +
    `&direction=outbound&entity_state=connected&convert_to_currency=EUR`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

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

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"
  }
});

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/prospects?page=1&limit=20&source_type=inbound&include=organization_prospect_status,assigned_organization_user&include_meta=navigation`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/prospects/${prospectId}?include=organization_prospect_status,assigned_organization_user`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/prospects`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    first_name: "Jane",
    last_name: "Doe",
    company_name: "Acme Studio",
    email: "jane@acme.example",
    source_type: "inbound",
    source_channel: "website",
    source_campaign: "summer-launch",
    summary: "Requested a demo from the pricing page.",
    budget: "5000",
    budget_currency: "EUR"
  })
});

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/prospects/${prospectId}`,
  {
    method: "PUT",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      summary: "Budget confirmed, decision expected next week.",
      budget: "8000",
      budget_currency: "EUR"
    })
  }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/prospects/${prospectId}/advance`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      organization_prospect_status_path_id: "status_path_id_here",
      outcome: "Qualified, budget and timeline confirmed.",
      description: "Moved from New to Qualified after the discovery call."
    })
  }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/prospect-activities`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      organization_prospect_id: "prospect_id_here",
      title: "Discovery call",
      description: "Walked through pricing and the onboarding timeline.",
      outcome: "Positive, sending a proposal next week.",
      activity_at: "2026-07-03 15:30:00"
    })
  }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/prospect-activities?page=1&limit=20&include=organization_prospect,performed_by_organization_user&include_meta=navigation`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contracts?page=1&limit=20` +
    // filters are optional and combinable
    `&direction=outbound&category=core` +
    // pass a q=... param instead of ids to run a full-text search
    `&include=contract_status,sender_user,receiver_user,contract_parties` +
    `&include_meta=navigation`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contracts/${contractId}` +
    // available includes: organization, parent_contract, sender_user, receiver_user,
    // file, contract_status, contract_chapters, contract_parties, contract_prefix
    `?include=contract_chapters,contract_parties,contract_status`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/contracts`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // core | amendment | addenda | supplement.
    // amendment/addenda/supplement REQUIRE organization_contract_id -> a "core" parent contract.
    category: "core",

    // internal  -> auto-numbered from a prefix (organization_contract_prefix_id required below)
    // uploaded  -> you supply `number`, and may set `signed_by_all_parties_at`
    source: "internal",

    direction: "outbound",         // outbound | inbound
    organization_sender_user_id: "org_user_sender_id",
    organization_receiver_user_id: "org_user_receiver_id",
    organization_contract_status_id: "contract_status_id",

    // required only for internal + core; omit it for any other source/category
    organization_contract_prefix_id: "contract_prefix_id",

    title: "Master Services Agreement",
    sub_title: "2026 Engagement",
    locale: "en",
    issued_at: "2026-07-03 09:00:00",
    ends_at: "2027-07-03 09:00:00",
    content_introduction: "This agreement is entered into between the parties below.",
    content_signature_disclaimer: "By signing, each party agrees to the terms above.",

    chapters: [
      { title: "Scope of Work",  content: "<p>The Provider will deliver…</p>", order: 1 },
      { title: "Payment Terms",  content: "<p>Fees are due within 14 days…</p>", order: 2 }
    ],

    parties: [
      {
        // party_type, party_country_code, first_name, last_name are required on every party
        party_type: "organization",          // organization | individual
        party_country_code: "RO",

        // organization parties additionally REQUIRE organization_name + organization_type
        organization_name: "Acme Studio SRL",
        organization_type: "srl",            // value comes from reference data

        first_name: "Jane",
        last_name: "Doe",
        role_in_organization: "Administrator",
        referenced_as_within_document: "the Provider",
        appears_as_party: true,
        is_signature_required: true,
        contact_email_address: "jane@acme.example",
        order: 0

        // country-specific `information` (person) and `organization_information` (company)
        // JSON blocks are also accepted; their shape is validated against the country schema.
      },
      {
        party_type: "individual",
        party_country_code: "RO",
        first_name: "John",
        last_name: "Smith",
        referenced_as_within_document: "the Client",
        appears_as_party: true,
        is_signature_required: true,
        contact_email_address: "john@example.com",
        order: 1
      }
    ]
  })
});

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/contracts/${contractId}`, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // partial update, only the fields you send are touched
    organization_contract_status_id: "next_status_id",
    sub_title: "2026 Engagement (revised)",
    ends_at: "2027-12-31 23:59:59"
  })
});

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

// returns a file stream, read it as a blob, not JSON
const pdf = await fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contracts/${contractId}/download`,
  {
    method: "GET",
    headers: { Authorization: `Bearer ${token}` }
  }
).then((r) => r.blob());

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

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

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contract-statuses?page=1&limit=50`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/contract-statuses`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // per-locale maps, not plain strings
    title_lang_map: { en: "Awaiting Signature", ro: "În așteptarea semnării" },
    description_lang_map: {
      en: "Sent to all parties for signing.",
      ro: "Trimis către toate părțile pentru semnare."
    },
    contract_state: "action_required", // draft | action_required | accepted | breach | terminated
    direction: "any",                  // inbound | outbound | any

    // order is unique per organization, pick a free slot,
    // or reorder existing stages via PUT /contract-statuses/reorder
    order: 3,
    rgba_color_code: "rgba(59, 130, 246, 1)"
  })
});

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/contract-signatures`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    organization_contract_id: "contract_id",

    // one active session per party, organization_contract_party_id is unique
    organization_contract_party_id: "party_id",

    // user_flow  -> Enlivy hosts the signer experience (get the link via sign_session_url)
    // admin_panel -> you record the signature yourself and may send is_signed / signature_drawing / signed_contract
    signature_source: "user_flow",

    sign_session_signature_types: ["draw", "checkbox"],      // draw | checkbox | file_classic | file_electronic
    sign_session_required_confirmations: ["email", "legally_binding"], // email | phone | legally_binding
    expires_at: "2026-07-17 23:59:59"
  })
});

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contract-signatures/${signatureId}/send`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      method: "email",  // email | sms
      message: "Please review and sign the agreement by Friday."
    })
  }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contract-signatures/${signatureId}` +
    // sign_session_url returns the hosted link to give to the signer.
    // status is one of: pending | sent | completed | expired | void
    `?include=sign_session_url,organization_contract`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contract-signatures` +
    // omit organization_contract_id to list sessions across every contract
    `?organization_contract_id=contract_id&include=sign_session_url`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

// also available per session: /contract-signatures/{signatureId}/download-evidence
const evidence = await fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contracts/${contractId}/download-evidence`,
  {
    method: "GET",
    headers: { Authorization: `Bearer ${token}` }
  }
).then((r) => r.blob());

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/products` +
    // filters: name, description, ids (or q=... for full-text search)
    `?page=1&limit=20&name=Consulting` +
    // includes: organization, tax_class, tag_ids, deleted_by_user
    `&include=tax_class`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/products`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    type: "service", // required: digital | physical | service | bonus

    // required: a { currency: amount } map (amounts max 2 decimals).
    // With 2+ currencies, primary_currency becomes required.
    price_map: { EUR: "49.90", USD: "54.00" },
    primary_currency: "EUR",

    // per-locale maps (not plain strings)
    name_lang_map: { en: "Consulting Hour", ro: "Oră de consultanță" },
    unit_lang_map: { en: "hour", ro: "oră" },
    description_lang_map: { en: "One hour of advisory services." },

    alias: "consulting-hour", // optional; unique per organization (alpha-dash)
    organization_tax_class_id: "tax_class_id",
    is_sold: true, // whether it is actively offered

    // optional e-invoicing metadata (used when the product lands on an invoice line)
    invoice_schema_map: {
      classification_identifier_cpv: "79411000-8", // CPV code
      peppol_billing_unit_code: "HUR" // PEPPOL unit code
    },

    // optional identifiers
    ean_number: null,
    upc_number: null,
    stripe_product_id_list: ["prod_XXXXXXXX"] // each id must start with "prod_"
  })
});

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/products/${productId}`, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // reprice: the price_map replaces the stored one
    price_map: { EUR: "59.90", USD: "64.00" },
    primary_currency: "EUR",
    name_lang_map: { en: "Consulting Hour, Senior" },
    is_sold: false
  })
});

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

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

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/users?page=1&limit=20` +
    // filters: email, created_at_from/to, updated_at_from/to, ids, or q=... for free-text search
    `&email=jane@acme.example`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/user-client-portal-sessions`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // reference the exact user identity
    organization_user_id: "org_user_id",

    name: "Jane Doe",                 // required: display name for the session

    // how the user proves identity: email | phone | magic_authentication
    authentication_method: "email",

    // scope what the session may access in the portal
    // options: invoices | receipts | network_exchanges | contracts | reports | payment_methods
    permissions: ["invoices", "receipts", "payment_methods"],

    // lifetime: set validity_hours OR expires_at (bounded by the server maximum)
    validity_hours: 72
  })
});

// Response includes: token, status, magic_authentication_url (for magic_authentication),
// authentication_verification_code (for email / phone), permissions, expires_at.

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

fetch(`https://api.enlivy.com/organizations/${organizationId}/user-client-portal-sessions`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // reference the user by email
    email: "jane@acme.example",

    name: "Jane Doe",                 // required: display name for the session

    // how the user proves identity: email | phone | magic_authentication
    authentication_method: "email",

    // scope what the session may access in the portal
    // options: invoices | receipts | network_exchanges | contracts | reports | payment_methods
    permissions: ["invoices", "receipts", "payment_methods"],

    // lifetime: set validity_hours OR expires_at (bounded by the server maximum)
    validity_hours: 72
  })
});

// Single match  -> the session proceeds to authentication.
// Multiple matches -> status "awaiting_user_selection"; the user picks which
//                     identity to authenticate as in the portal before continuing.

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

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/user-client-portal-sessions/${sessionId}` +
    // includes: organization_user, organization
    `?include=organization_user`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

// status: pending | email_verification_sent | awaiting_user_selection | success | expired