Urmărește abonamentele, onorariile lunare și plățile în rate într-un singur loc

# status: pending | active | payment_method_required | paused | cancelling | completed | cancelled
curl -G 'https://api.enlivy.com/organizations/<organization_id>/billing-schedules' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=20' \
  --data-urlencode 'status=active' \
  --data-urlencode 'direction=outbound' \
  --data-urlencode 'include=receiver_user,phases,payments' \
  --data-urlencode 'include_meta=navigation' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";

// status: pending | active | payment_method_required | paused | cancelling | completed | cancelled
const query = new URLSearchParams({
  page: "1",
  limit: "20",
  status: "active",
  direction: "outbound",
  include: "receiver_user,phases,payments",
  include_meta: "navigation",
});
const result = await fetch(`${baseUrl}/organizations/${organizationId}/billing-schedules?${query}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

# includes: sender_user, receiver_user, contract, billing_package,
# subscription_term, phases, payments, deleted_by_user
curl -G 'https://api.enlivy.com/organizations/<organization_id>/billing-schedules/<billing_schedule_id>' \
  --data-urlencode 'include=phases,payments,receiver_user,billing_package' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";
const billingScheduleId = "<billing_schedule_id>";

// includes: sender_user, receiver_user, contract, billing_package,
// subscription_term, phases, payments, deleted_by_user
const query = new URLSearchParams({
  include: "phases,payments,receiver_user,billing_package",
});
const result = await fetch(`${baseUrl}/organizations/${organizationId}/billing-schedules/${billingScheduleId}?${query}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

curl -X POST 'https://api.enlivy.com/organizations/<organization_id>/billing-schedules' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "management_type": "app_managed",
  "direction": "outbound",
  "status": "active",
  "organization_sender_user_id": "<org_user_sender_id>",
  "organization_receiver_user_id": "<org_user_receiver_id>",
  "currency": "EUR",
  "payment_method": "stripe_card_payment",
  "organization_user_payment_method_id": "<payment_method_id>",
  "name_lang_map": {
    "en": "Monthly Retainer"
  },
  "note_lang_map": {
    "en": "Includes support and hosting."
  },
  "is_email_notifications_active": true,
  "email_notifications_to": "billing@acme.example",
  "customer_can_reconfigure": false,
  "customer_can_cancel": true,
  "customer_can_pause": false,
  "phases": [
    {
      "frequency": "monthly",
      "execute_after": "2026-08-01",
      "max_occurrences": 12,
      "due_date_type": "custom_days",
      "due_date_days": 14,
      "order": 0,
      "line_items": [
        {
          "name_lang_map": {
            "en": "Retainer"
          },
          "quantity": 1,
          "price": 500,
          "organization_tax_class_id": "<tax_class_id>"
        },
        {
          "organization_product_id": "<product_id>",
          "quantity": 2,
          "price": 49.9
        }
      ]
    }
  ]
}'

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";

const result = await fetch(`${baseUrl}/organizations/${organizationId}/billing-schedules`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    // exemplul acoperă doar app_managed
    management_type: "app_managed",
    // outbound = tu facturezi un client; inbound = tu ești facturat
    direction: "outbound",
    // facturarea începe imediat
    status: "active",
    // cel care facturează (tu)
    organization_sender_user_id: "<org_user_sender_id>",
    // clientul (obligatoriu pentru outbound)
    organization_receiver_user_id: "<org_user_receiver_id>",
    currency: "EUR",
    // bank_transfer | card_payment | stripe_card_payment | paypal | cash | paid_by_personal_funds
    payment_method: "stripe_card_payment",
    // cardul salvat de pe care se încasează automat (trebuie să fie al destinatarului)
    organization_user_payment_method_id: "<payment_method_id>",
    name_lang_map: {
      // hărți pe limbi, nu texte simple
      en: "Monthly Retainer",
    },
    note_lang_map: { en: "Includes support and hosting." },
    is_email_notifications_active: true,
    email_notifications_to: "billing@acme.example",
    // ce poate face singur clientul din portal
    customer_can_reconfigure: false,
    customer_can_cancel: true,
    customer_can_pause: false,
    // totalurile și datele (total, paid_total, starts_at, ends_at, next_payment_create_at)
    // sunt calculate de Enlivy, NU le trimiți.
    // phases sunt valabile DOAR pentru app_managed (stripe_hosted le respinge). Maximum 20.
    phases: [
      {
        // weekly | biweekly | monthly | yearly
        frequency: "monthly",
        // data primei rulări pentru această fază
        execute_after: "2026-08-01",
        // se oprește după N facturi (lipsă = fără sfârșit)
        max_occurrences: 12,
        // immediate | end_of_month | custom_days
        due_date_type: "custom_days",
        // obligatoriu doar când due_date_type = custom_days
        due_date_days: 14,
        order: 0,
        line_items: [
          {
            name_lang_map: {
              // obligatoriu dacă nu trimiți organization_product_id
              en: "Retainer",
            },
            quantity: 1,
            // suma: zecimal cu semn, în unități ÎNTREGI (nu în cenți)
            price: 500,
            organization_tax_class_id: "<tax_class_id>",
          },
          {
            // preia numele și taxele implicite din produs
            organization_product_id: "<product_id>",
            quantity: 2,
            price: 49.9,
          },
        ],
      },
    ],
  }),
}).then((response) => response.json());

# Pachetul comercial aduce fazele și elementele, așa că nu le trimiți aici.
curl -X POST 'https://api.enlivy.com/organizations/<organization_id>/billing-schedules/from-billing-package' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "organization_billing_package_id": "<billing_package_id>",
  "organization_billing_package_subscription_term_id": "<subscription_term_id>",
  "selected_group_items": [
    {
      "id": "<group_item_id>",
      "quantity": 1
    },
    {
      "id": "<other_group_item_id>",
      "quantity": 3
    }
  ],
  "organization_sender_user_id": "<org_user_sender_id>",
  "organization_receiver_user_id": "<org_user_receiver_id>",
  "status": "active",
  "payment_method": "bank_transfer",
  "currency": "EUR",
  "start_at": "2026-11-01",
  "is_email_notifications_active": true
}'

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";

// Pachetul comercial aduce fazele și elementele, așa că nu le trimiți aici.
const result = await fetch(`${baseUrl}/organizations/${organizationId}/billing-schedules/from-billing-package`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    // atașezi un pachet comercial cu ABONAMENT; el definește fazele și elementele
    organization_billing_package_id: "<billing_package_id>",
    // opțional: alegi varianta de recurență; lipsă = cea implicită a pachetului
    organization_billing_package_subscription_term_id: "<subscription_term_id>",
    // opțional: alegi ce elemente din grupurile pachetului intră (și cantitățile)
    selected_group_items: [
      { id: "<group_item_id>", quantity: 1 },
      { id: "<other_group_item_id>", quantity: 3 },
    ],
    organization_sender_user_id: "<org_user_sender_id>",
    organization_receiver_user_id: "<org_user_receiver_id>",
    // pending | active
    status: "active",
    payment_method: "bank_transfer",
    currency: "EUR",
    start_at: "2026-11-01",
    is_email_notifications_active: true,
  }),
}).then((response) => response.json());

# ca să schimbi CE se facturează într-un plan de plată creat din pachet,
# folosești /reconfigure de mai jos, nu editarea de aici.
curl -X PUT 'https://api.enlivy.com/organizations/<organization_id>/billing-schedules/<billing_schedule_id>' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "status": "paused",
  "note_lang_map": {
    "en": "Paused at customer request."
  },
  "is_email_notifications_active": false,
  "customer_can_cancel": true
}'

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";
const billingScheduleId = "<billing_schedule_id>";

// ca să schimbi CE se facturează într-un plan de plată creat din pachet,
// folosești /reconfigure de mai jos, nu editarea de aici.
const result = await fetch(`${baseUrl}/organizations/${organizationId}/billing-schedules/${billingScheduleId}`, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    // ciclu de viață: active <-> paused; setezi "cancelling" ca să se oprească la finalul ciclului
    status: "paused",
    note_lang_map: { en: "Paused at customer request." },
    is_email_notifications_active: false,
    customer_can_cancel: true,
  }),
}).then((response) => response.json());

# 1. Previzualizare: nu se aplică nimic; primești noua componență și proratarea
curl -X POST 'https://api.enlivy.com/organizations/<organization_id>/billing-schedules/<billing_schedule_id>/preview-reconfigure' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "organization_billing_package_id": "<billing_package_id>",
  "organization_billing_package_subscription_term_id": "<subscription_term_id>",
  "selected_group_items": [
    {
      "id": "<group_item_id>",
      "quantity": 2,
      "price_override": 39,
      "pricing_currency": "EUR"
    }
  ],
  "custom_line_items": [
    {
      "name_lang_map": {
        "en": "One-off setup"
      },
      "quantity": 1,
      "price": 150
    }
  ],
  "proration_mode": "prorate_next_invoice"
}'

# 2. Aplici
curl -X PUT 'https://api.enlivy.com/organizations/<organization_id>/billing-schedules/<billing_schedule_id>/reconfigure' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "organization_billing_package_id": "<billing_package_id>",
  "organization_billing_package_subscription_term_id": "<subscription_term_id>",
  "selected_group_items": [
    {
      "id": "<group_item_id>",
      "quantity": 2,
      "price_override": 39,
      "pricing_currency": "EUR"
    }
  ],
  "custom_line_items": [
    {
      "name_lang_map": {
        "en": "One-off setup"
      },
      "quantity": 1,
      "price": 150
    }
  ],
  "proration_mode": "prorate_next_invoice"
}'

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";
const billingScheduleId = "<billing_schedule_id>";

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

// 1. Previzualizare: nu se aplică nimic; primești noua componență și proratarea
const result1 = await fetch(`${baseUrl}/organizations/${organizationId}/billing-schedules/${billingScheduleId}/preview-reconfigure`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    organization_billing_package_id: "<billing_package_id>",
    organization_billing_package_subscription_term_id: "<subscription_term_id>",
    selected_group_items: [
      // price_override + pricing_currency îți permit un preț diferit de cel din pachet
      {
        id: "<group_item_id>",
        quantity: 2,
        price_override: 39,
        pricing_currency: "EUR",
      },
    ],
    custom_line_items: [{ name_lang_map: { en: "One-off setup" }, quantity: 1, price: 150 }],
    // cum se facturează schimbarea: none | prorate_immediately | prorate_next_invoice
    // (prorate_immediately cere un plan de plată activ)
    proration_mode: "prorate_next_invoice",
  }),
}).then((response) => response.json());

// 2. Aplici
const result2 = await fetch(`${baseUrl}/organizations/${organizationId}/billing-schedules/${billingScheduleId}/reconfigure`, {
  method: "PUT",
  headers,
  body: JSON.stringify({
    organization_billing_package_id: "<billing_package_id>",
    organization_billing_package_subscription_term_id: "<subscription_term_id>",
    selected_group_items: [
      // price_override + pricing_currency îți permit un preț diferit de cel din pachet
      {
        id: "<group_item_id>",
        quantity: 2,
        price_override: 39,
        pricing_currency: "EUR",
      },
    ],
    custom_line_items: [{ name_lang_map: { en: "One-off setup" }, quantity: 1, price: 150 }],
    // cum se facturează schimbarea: none | prorate_immediately | prorate_next_invoice
    // (prorate_immediately cere un plan de plată activ)
    proration_mode: "prorate_next_invoice",
  }),
}).then((response) => response.json());

# analyticsType: summary | history_monthly
curl -G 'https://api.enlivy.com/organizations/<organization_id>/billing-schedules/analytics/summary' \
  --data-urlencode 'start_date=2026-01-01T00:00:00Z' \
  --data-urlencode 'end_date=2026-12-31T23:59:59Z' \
  --data-urlencode 'direction=outbound' \
  --data-urlencode 'convert_to_currency=EUR' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";
const analyticsType = "summary";

// analyticsType: summary | history_monthly
const query = new URLSearchParams({
  start_date: "2026-01-01T00:00:00Z",
  end_date: "2026-12-31T23:59:59Z",
  direction: "outbound",
  convert_to_currency: "EUR",
});
const result = await fetch(`${baseUrl}/organizations/${organizationId}/billing-schedules/analytics/${analyticsType}?${query}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

# ștergere reversibilă; restaurezi cu POST /billing-schedules/restore/{scheduleId}
curl -X DELETE 'https://api.enlivy.com/organizations/<organization_id>/billing-schedules/<billing_schedule_id>' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json'

const baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";
const billingScheduleId = "<billing_schedule_id>";

// ștergere reversibilă; restaurezi cu POST /billing-schedules/restore/{scheduleId}
const result = await fetch(`${baseUrl}/organizations/${organizationId}/billing-schedules/${billingScheduleId}`, {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());