Administrează, trimite și semnează contracte într-un singur loc

# filtrele sunt opționale și se pot combina
# trimiți q=... în loc de ids pentru căutare în tot textul
curl -G 'https://api.enlivy.com/organizations/<organization_id>/contracts' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=20' \
  --data-urlencode 'direction=outbound' \
  --data-urlencode 'category=core' \
  --data-urlencode 'include=contract_status,sender_user,receiver_user,contract_parties' \
  --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>";

// filtrele sunt opționale și se pot combina
// trimiți q=... în loc de ids pentru căutare în tot textul
const query = new URLSearchParams({
  page: "1",
  limit: "20",
  direction: "outbound",
  category: "core",
  include: "contract_status,sender_user,receiver_user,contract_parties",
  include_meta: "navigation",
});
const result = await fetch(`${baseUrl}/organizations/${organizationId}/contracts?${query}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

# includes disponibile: organization, parent_contract, sender_user, receiver_user,
# file, contract_status, contract_chapters, contract_parties, contract_prefix
curl -G 'https://api.enlivy.com/organizations/<organization_id>/contracts/<contract_id>' \
  --data-urlencode 'include=contract_chapters,contract_parties,contract_status' \
  -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 contractId = "<contract_id>";

// includes disponibile: organization, parent_contract, sender_user, receiver_user,
// file, contract_status, contract_chapters, contract_parties, contract_prefix
const query = new URLSearchParams({
  include: "contract_chapters,contract_parties,contract_status",
});
const result = await fetch(`${baseUrl}/organizations/${organizationId}/contracts/${contractId}?${query}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

curl -X POST 'https://api.enlivy.com/organizations/<organization_id>/contracts' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "category": "core",
  "source": "internal",
  "direction": "outbound",
  "organization_sender_user_id": "<org_user_sender_id>",
  "organization_receiver_user_id": "<org_user_receiver_id>",
  "organization_contract_status_id": "<contract_status_id>",
  "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": "organization",
      "party_country_code": "RO",
      "organization_name": "Acme Studio SRL",
      "organization_type": "srl",
      "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
    },
    {
      "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 baseUrl = "https://api.enlivy.com";
const token = process.env.ENLIVY_API_TOKEN;
const organizationId = "<organization_id>";

const result = await fetch(`${baseUrl}/organizations/${organizationId}/contracts`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    // core | amendment | addenda | supplement.
    // amendment/addenda/supplement CER organization_contract_id -> un contract părinte "core".
    category: "core",
    // internal  -> numerotat automat dintr-un prefix (organization_contract_prefix_id obligatoriu mai jos)
    // uploaded  -> trimiți tu `number` și poți seta `signed_by_all_parties_at`
    source: "internal",
    // outbound | inbound
    direction: "outbound",
    organization_sender_user_id: "<org_user_sender_id>",
    organization_receiver_user_id: "<org_user_receiver_id>",
    organization_contract_status_id: "<contract_status_id>",
    // obligatoriu doar pentru internal + core; îl omiți pentru orice altă sursă sau categorie
    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: [
      // se acceptă și blocurile JSON specifice țării, `information` (persoană) și `organization_information`
      // (companie); forma lor e validată după schema țării.
      {
        // party_type, party_country_code, first_name, last_name sunt obligatorii pentru fiecare parte
        // organization | individual
        party_type: "organization",
        party_country_code: "RO",
        // părțile de tip organization CER în plus organization_name + organization_type
        organization_name: "Acme Studio SRL",
        // valoarea vine din datele de referință
        organization_type: "srl",
        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,
      },
      {
        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,
      },
    ],
  }),
}).then((response) => response.json());

curl -X PUT 'https://api.enlivy.com/organizations/<organization_id>/contracts/<contract_id>' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "organization_contract_status_id": "<next_status_id>",
  "sub_title": "2026 Engagement (revised)",
  "ends_at": "2027-12-31 23:59:59"
}'

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

const result = await fetch(`${baseUrl}/organizations/${organizationId}/contracts/${contractId}`, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    // actualizare parțială: se modifică doar câmpurile trimise
    organization_contract_status_id: "<next_status_id>",
    sub_title: "2026 Engagement (revised)",
    ends_at: "2027-12-31 23:59:59",
  }),
}).then((response) => response.json());

# primești un fișier: îl citești ca blob, nu ca JSON
curl 'https://api.enlivy.com/organizations/<organization_id>/contracts/<contract_id>/download' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  --remote-name --remote-header-name

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

// primești un fișier: îl citești ca blob, nu ca JSON
const pdf = await fetch(`${baseUrl}/organizations/${organizationId}/contracts/${contractId}/download`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
  },
}).then((response) => response.blob());

# ștergere reversibilă; restaurezi cu POST /contracts/restore/{contractId}
curl -X DELETE 'https://api.enlivy.com/organizations/<organization_id>/contracts/<contract_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 contractId = "<contract_id>";

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

curl -G 'https://api.enlivy.com/organizations/<organization_id>/contract-statuses' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=50' \
  -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 query = new URLSearchParams({
  page: "1",
  limit: "50",
});
const result = await fetch(`${baseUrl}/organizations/${organizationId}/contract-statuses?${query}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

curl -X POST 'https://api.enlivy.com/organizations/<organization_id>/contract-statuses' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "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",
  "direction": "any",
  "order": 3,
  "rgba_color_code": "rgba(59, 130, 246, 1)"
}'

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

const result = await fetch(`${baseUrl}/organizations/${organizationId}/contract-statuses`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    // hărți pe limbi, nu texte simple
    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.",
    },
    // draft | action_required | accepted | breach | terminated
    contract_state: "action_required",
    // inbound | outbound | any
    direction: "any",
    // order este unic în organizație: alegi un loc liber
    // sau reordonezi etapele existente cu PUT /contract-statuses/reorder
    order: 3,
    rgba_color_code: "rgba(59, 130, 246, 1)",
  }),
}).then((response) => response.json());

curl -X POST 'https://api.enlivy.com/organizations/<organization_id>/contract-signatures' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "organization_contract_id": "<contract_id>",
  "organization_contract_party_id": "<party_id>",
  "signature_source": "user_flow",
  "sign_session_signature_types": [
    "draw",
    "checkbox"
  ],
  "sign_session_required_confirmations": [
    "email",
    "legally_binding"
  ],
  "expires_at": "2026-07-17 23:59:59"
}'

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

const result = await fetch(`${baseUrl}/organizations/${organizationId}/contract-signatures`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    organization_contract_id: "<contract_id>",
    // o singură sesiune activă pe parte; organization_contract_party_id este unic
    organization_contract_party_id: "<party_id>",
    // user_flow   -> Enlivy găzduiește semnarea (linkul vine din sign_session_url)
    // admin_panel -> înregistrezi tu semnătura și poți trimite is_signed / signature_drawing / signed_contract
    signature_source: "user_flow",
    sign_session_signature_types: [
      "draw",
      // draw | checkbox | file_classic | file_electronic
      "checkbox",
    ],
    sign_session_required_confirmations: [
      "email",
      // email | phone | legally_binding
      "legally_binding",
    ],
    expires_at: "2026-07-17 23:59:59",
  }),
}).then((response) => response.json());

curl -X POST 'https://api.enlivy.com/organizations/<organization_id>/contract-signatures/<contract_signature_id>/send' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "method": "email",
  "message": "Please review and sign the agreement by Friday."
}'

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

const result = await fetch(`${baseUrl}/organizations/${organizationId}/contract-signatures/${contractSignatureId}/send`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    // email | sms
    method: "email",
    message: "Please review and sign the agreement by Friday.",
  }),
}).then((response) => response.json());

# sign_session_url întoarce linkul găzduit pe care îl dai semnatarului.
# status este unul dintre: pending | sent | completed | expired | void
curl -G 'https://api.enlivy.com/organizations/<organization_id>/contract-signatures/<contract_signature_id>' \
  --data-urlencode 'include=sign_session_url,organization_contract' \
  -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 contractSignatureId = "<contract_signature_id>";

// sign_session_url întoarce linkul găzduit pe care îl dai semnatarului.
// status este unul dintre: pending | sent | completed | expired | void
const query = new URLSearchParams({
  include: "sign_session_url,organization_contract",
});
const result = await fetch(`${baseUrl}/organizations/${organizationId}/contract-signatures/${contractSignatureId}?${query}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

# omiți organization_contract_id ca să vezi sesiunile tuturor contractelor
curl -G 'https://api.enlivy.com/organizations/<organization_id>/contract-signatures' \
  --data-urlencode 'organization_contract_id=<contract_id>' \
  --data-urlencode 'include=sign_session_url' \
  -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>";

// omiți organization_contract_id ca să vezi sesiunile tuturor contractelor
const query = new URLSearchParams({
  organization_contract_id: "<contract_id>",
  include: "sign_session_url",
});
const result = await fetch(`${baseUrl}/organizations/${organizationId}/contract-signatures?${query}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

# disponibil și pe fiecare sesiune: /contract-signatures/{signatureId}/download-evidence
curl 'https://api.enlivy.com/organizations/<organization_id>/contracts/<contract_id>/download-evidence' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  --remote-name --remote-header-name

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

// disponibil și pe fiecare sesiune: /contract-signatures/{signatureId}/download-evidence
const evidence = await fetch(`${baseUrl}/organizations/${organizationId}/contracts/${contractId}/download-evidence`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
  },
}).then((response) => response.blob());