Clasifică tranzacțiile bancare și leagă-le de facturi și chitanțe

curl -G 'https://api.enlivy.com/organizations/<organization_id>/bank-transaction-cost-types' \
  --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}/bank-transaction-cost-types?${query}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

curl -X POST 'https://api.enlivy.com/organizations/<organization_id>/bank-transaction-cost-types' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "title_lang_map": {
    "en": "Client Payment",
    "ro": "Încasare client"
  },
  "connection_required": true,
  "connection_types": [
    "invoice",
    "receipt"
  ],
  "organization_bank_transaction_cost_type_id": null
}'

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

const result = await fetch(`${baseUrl}/organizations/${organizationId}/bank-transaction-cost-types`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    title_lang_map: {
      en: "Client Payment",
      // hartă pe limbi
      ro: "Încasare client",
    },
    // o tranzacție de acest tip trebuie legată de o entitate de business?
    connection_required: true,
    // de ce tipuri de entități poate fi legată (obligatoriu când connection_required = true)
    // opțiuni: invoice | receipt | payslip | bank_transaction | user
    connection_types: [
      "invoice",
      "receipt",
    ],
    // opțional: tipul de cost părinte, pentru o categorie ierarhică
    organization_bank_transaction_cost_type_id: null,
  }),
}).then((response) => response.json());

# state: backlog | classified | connected | connected_partially | danger | trashed
# pentru tranzacțiile legate de o anumită entitate, trimiți AMBII parametri:
# `&connection_entity_type=invoice&connection_entity_id=invoice_id` +
# căutare în text cu q=... (minimum 3 caractere) în loc de ids
curl -G 'https://api.enlivy.com/organizations/<organization_id>/bank-transactions' \
  --data-urlencode 'page=1' \
  --data-urlencode 'limit=20' \
  --data-urlencode 'state=backlog' \
  --data-urlencode 'direction=inbound' \
  --data-urlencode 'include=cost_type,connection_entities,bank_account' \
  -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>";

// state: backlog | classified | connected | connected_partially | danger | trashed
// pentru tranzacțiile legate de o anumită entitate, trimiți AMBII parametri:
// `&connection_entity_type=invoice&connection_entity_id=invoice_id` +
// căutare în text cu q=... (minimum 3 caractere) în loc de ids
const query = new URLSearchParams({
  page: "1",
  limit: "20",
  state: "backlog",
  direction: "inbound",
  include: "cost_type,connection_entities,bank_account",
});
const result = await fetch(`${baseUrl}/organizations/${organizationId}/bank-transactions?${query}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

# includes: organization, bank_account, cost_type, connection_entities, deleted_by_user, tag_ids
curl -G 'https://api.enlivy.com/organizations/<organization_id>/bank-transactions/<bank_transaction_id>' \
  --data-urlencode 'include=cost_type,connection_entities,bank_account' \
  -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 bankTransactionId = "<bank_transaction_id>";

// includes: organization, bank_account, cost_type, connection_entities, deleted_by_user, tag_ids
const query = new URLSearchParams({
  include: "cost_type,connection_entities,bank_account",
});
const result = await fetch(`${baseUrl}/organizations/${organizationId}/bank-transactions/${bankTransactionId}?${query}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

# starea se stabilește prin clasificare (implicit "backlog"), nu trebuie trimisă.
# opțional, clasifici direct cu organization_bank_transaction_cost_type_id + connection_entities (vezi mai jos).
curl -X POST 'https://api.enlivy.com/organizations/<organization_id>/bank-transactions' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "hash": "unique-dedupe-key",
  "title": "Incoming transfer from Acme Studio",
  "amount": 1200,
  "currency": "EUR",
  "organization_bank_account_id": "<bank_account_id>",
  "sender_label": "ACME STUDIO SRL",
  "note": "Invoice #2026-0142 settlement"
}'

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

// starea se stabilește prin clasificare (implicit "backlog"), nu trebuie trimisă.
// opțional, clasifici direct cu organization_bank_transaction_cost_type_id + connection_entities (vezi mai jos).
const result = await fetch(`${baseUrl}/organizations/${organizationId}/bank-transactions`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    // obligatoriu; unic în cadrul unui cont bancar (cheia de deduplicare la import)
    hash: "unique-dedupe-key",
    title: "Incoming transfer from Acme Studio",
    // suma: zecimal cu semn, în unități ÎNTREGI (nu în cenți)
    amount: 1200,
    // direcția REZULTĂ din semn (pozitiv = încasare, negativ = plată)
    currency: "EUR",
    organization_bank_account_id: "<bank_account_id>",
    // numele contrapartidei, așa cum apare în extrasul băncii
    sender_label: "ACME STUDIO SRL",
    note: "Invoice #2026-0142 settlement",
  }),
}).then((response) => response.json());

curl -X PUT 'https://api.enlivy.com/organizations/<organization_id>/bank-transactions/<bank_transaction_id>' \
  -H "Authorization: Bearer $ENLIVY_API_TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "organization_bank_transaction_cost_type_id": "<cost_type_id>",
  "connection_entities": [
    {
      "connection_entity_type": "invoice",
      "connection_entity_id": "<invoice_id>",
      "amount": 1000
    },
    {
      "connection_entity_type": "receipt",
      "connection_entity_id": "<receipt_id>",
      "amount": 200
    }
  ]
}'

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

const result = await fetch(`${baseUrl}/organizations/${organizationId}/bank-transactions/${bankTransactionId}`, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    // 1. Clasifici: atribui un tip de cost. Starea trece din backlog în classified.
    organization_bank_transaction_cost_type_id: "<cost_type_id>",
    // 2. Reconciliezi: legi tranzacția de ce plătește.
    //    connection_entity_type trebuie să fie unul dintre connection_types permise de tipul de cost.
    //    Lista este un UPSERT:
    //        { connection_entity_type, connection_entity_id, amount }  -> creează o legătură
    //        { id }                                                    -> păstrează o legătură existentă
    //        { id, _deleted: true }                                    -> elimină o legătură
    //    (o legătură existentă lăsată afară NU se șterge)
    //    Sume care acoperă toată tranzacția -> "connected"; parțial -> "connected_partially".
    connection_entities: [
      {
        connection_entity_type: "invoice",
        connection_entity_id: "<invoice_id>",
        amount: 1000,
      },
      {
        connection_entity_type: "receipt",
        connection_entity_id: "<receipt_id>",
        amount: 200,
      },
    ],
  }),
}).then((response) => response.json());

# analyticsType: summary | history_monthly
curl -G 'https://api.enlivy.com/organizations/<organization_id>/bank-transactions/analytics/summary' \
  --data-urlencode 'start_date=2026-01-01' \
  --data-urlencode 'end_date=2026-12-31' \
  --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-01",
  end_date: "2026-12-31",
  direction: "outbound",
  convert_to_currency: "EUR",
});
const result = await fetch(`${baseUrl}/organizations/${organizationId}/bank-transactions/analytics/${analyticsType}?${query}`, {
  method: "GET",
  headers: {
    Authorization: `Bearer ${token}`,
    Accept: "application/json",
  },
}).then((response) => response.json());

# ștergere reversibilă; restaurezi cu POST /bank-transactions/restore/{transactionId}
curl -X DELETE 'https://api.enlivy.com/organizations/<organization_id>/bank-transactions/<bank_transaction_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 bankTransactionId = "<bank_transaction_id>";

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