fizko-cli 0.2.1 → 0.3.0

package/dist/index.js

@@ -128,6 +128,22 @@ async function post(path2, data, overrideKey, overrideUrl) {
     return { status: "ok" };
   }
 }
+async function put(path2, data) {
+  const { apiKey, baseUrl } = getCredentials();
+  const url = `${baseUrl}${path2}`;
+  const res = await fetch(url, {
+    method: "PUT",
+    headers: { "Content-Type": "application/json", "X-API-Key": apiKey },
+    body: JSON.stringify(data ?? {})
+  });
+  const text = await res.text();
+  if (res.status >= 400) handleError(res.status, text);
+  try {
+    return JSON.parse(text);
+  } catch {
+    return { status: "ok" };
+  }
+}
 async function patch(path2, data) {
   const { apiKey, baseUrl } = getCredentials();
   const url = `${baseUrl}${path2}`;
@@ -441,26 +457,41 @@ function registerAccounting(program2) {
       period: opts.period
     }));
   });
-  cmd.command("obligations").description("Listar obligaciones contables (cuentas por pagar/cobrar).").requiredOption("--company <uuid>", "UUID de la empresa").option("--obligation-type <type>", "Tipo: payable o receivable").option("--status <status>", "Estado: pending, partial, paid, overdue").option("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").option("--limit <n>", "L\xEDmite de resultados", (v) => parseInt(v), 30).option("--offset <n>", "Offset de paginaci\xF3n", (v) => parseInt(v), 0).action(async (opts) => {
-    output(await get("/api/accounting/obligations/", {
+  cmd.command("obligations").description("Listar obligaciones contables (cuentas por pagar/cobrar).").requiredOption("--company <uuid>", "UUID de la empresa").option("--obligation-type <type>", "Tipo: payable | receivable").option("--status <status>", "Estado: pending, partial, paid, overdue").option("--source-document-type <type>", "sales_document | purchase_document | honorarios_receipt | payroll_period | form29").option("--search <text>", "B\xFAsqueda libre (n\xFAmero de documento, contrapartida)").option("--from <yyyy-mm-dd>", "Fecha emisi\xF3n desde").option("--to <yyyy-mm-dd>", "Fecha emisi\xF3n hasta").option("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").option("--conciliado <bool>", "true | false").option("--contabilizado <bool>", "true | false").option("--limit <n>", "L\xEDmite de resultados", (v) => parseInt(v), 30).option("--offset <n>", "Offset de paginaci\xF3n", (v) => parseInt(v), 0).action(async (opts) => {
+    const params = {
       company: opts.company,
-      obligation_type: opts.obligationType,
-      status: opts.status,
-      period: opts.period,
       limit: opts.limit,
       offset: opts.offset
-    }));
+    };
+    if (opts.obligationType) params["obligation_type"] = opts.obligationType;
+    if (opts.status) params["status"] = opts.status;
+    if (opts.sourceDocumentType) params["source_document_type"] = opts.sourceDocumentType;
+    if (opts.search) params["search"] = opts.search;
+    if (opts.from) params["issue_date__gte"] = opts.from;
+    if (opts.to) params["issue_date__lte"] = opts.to;
+    if (opts.period) params["period"] = opts.period;
+    if (opts.conciliado !== void 0) params["conciliado"] = opts.conciliado;
+    if (opts.contabilizado !== void 0) params["contabilizado"] = opts.contabilizado;
+    output(await get("/api/accounting/obligations/", params));
   });
   cmd.command("obligation <obligation_id>").description("Obtener detalle de una obligaci\xF3n.").action(async (id) => {
     output(await get(`/api/accounting/obligations/${id}/`));
   });
-  cmd.command("contabilizar <obligation_id>").description("Contabilizar una obligaci\xF3n. Sin --lines, auto-genera el asiento.").option("--lines <json>", 'L\xEDneas del asiento JSON: [{"account_code":"5101","debit":1000,"credit":0}]').option("--account-code <code>", "C\xF3digo de cuenta (modo legacy)").option("--description <text>", "Descripci\xF3n del asiento").action(async (id, opts) => {
+  cmd.command("suggest-lines <obligation_id>").description("Obtener sugerencia de l\xEDneas de asiento para una obligaci\xF3n.").action(async (id) => {
+    output(await get(`/api/accounting/obligations/${id}/suggest-lines/`));
+  });
+  cmd.command("contabilizar <obligation_id>").description("Contabilizar una obligaci\xF3n. Sin --lines, auto-genera el asiento.").option("--lines <json>", 'L\xEDneas del asiento JSON: [{"account_code":"5101","debit":1000,"credit":0}]').option("--account-code <code>", "C\xF3digo de cuenta contrapartida").option("--description <text>", "Descripci\xF3n del asiento").action(async (id, opts) => {
     const body = {};
     if (opts.lines) body["lines"] = JSON.parse(opts.lines);
     if (opts.accountCode) body["account_code"] = opts.accountCode;
     if (opts.description) body["description"] = opts.description;
     output(await post(`/api/accounting/obligations/${id}/contabilizar/`, body));
   });
+  cmd.command("update-journal <obligation_id>").description("Editar las l\xEDneas del asiento contable de una obligaci\xF3n.").requiredOption("--lines <json>", 'L\xEDneas JSON: [{"account_code":"5101","debit":1000,"credit":0}]').option("--description <text>", "Descripci\xF3n del asiento").action(async (id, opts) => {
+    const body = { lines: JSON.parse(opts.lines) };
+    if (opts.description) body["description"] = opts.description;
+    output(await put(`/api/accounting/obligations/${id}/update-journal-entry/`, body));
+  });
   cmd.command("descontabilizar <obligation_id>").description("Eliminar el asiento contable de una obligaci\xF3n.").action(async (id) => {
     output(await post(`/api/accounting/obligations/${id}/descontabilizar/`));
   });
@@ -472,31 +503,89 @@ function registerAccounting(program2) {
       contabilizar: opts.contabilizar !== false
     }));
   });
+  cmd.command("payments <obligation_id>").description("Listar los pagos (abonos) registrados en una obligaci\xF3n.").action(async (id) => {
+    output(await get(`/api/accounting/obligations/${id}/payments/`));
+  });
+  cmd.command("reverse-payment <obligation_id>").description("Revertir un pago (abono) de una obligaci\xF3n.").requiredOption("--payment-id <uuid>", "UUID del pago a revertir").action(async (id, opts) => {
+    output(await post(`/api/accounting/obligations/${id}/reverse-payment/`, {
+      payment_id: opts.paymentId
+    }));
+  });
+  cmd.command("set-cost-center <obligation_id>").description("Asignar un centro de costo a una obligaci\xF3n.").requiredOption("--cost-center <uuid>", "UUID del centro de costo").action(async (id, opts) => {
+    output(await post("/api/accounting/obligations/bulk-set-cost-center/", {
+      obligation_ids: [id],
+      cost_center_id: opts.costCenter
+    }));
+  });
+  cmd.command("cost-centers").description("Listar centros de costo disponibles.").requiredOption("--company <uuid>", "UUID de la empresa").action(async (opts) => {
+    output(await get("/api/accounting/cost-centers/", { company_id: opts.company }));
+  });
+  cmd.command("sync").description("Sincronizar obligaciones desde los documentos tributarios.").requiredOption("--company <uuid>", "UUID de la empresa").option("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").option("--obligation-type <type>", "payable | receivable").option("--force", "Forzar re-sincronizaci\xF3n aunque ya existan").action(async (opts) => {
+    const body = { company_id: opts.company };
+    if (opts.period) body["period"] = opts.period;
+    if (opts.obligationType) body["obligation_type"] = opts.obligationType;
+    if (opts.force) body["force_refresh"] = true;
+    output(await post("/api/accounting/obligations/sync", body));
+  });
 }
 
 // src/commands/banking.ts
 function registerBanking(program2) {
   const cmd = program2.command("banking").description("Movimientos bancarios, clasificaci\xF3n y conciliaci\xF3n.");
-  cmd.command("movements").description("Listar movimientos bancarios.").requiredOption("--company <uuid>", "UUID de la empresa").option("--status <status>", "Estado: pending, reconciled, matched, split").option("--classification <text>", "Filtrar por clasificaci\xF3n").option("--period <yyyy-mm>", "Filtrar por mes (prefijo YYYY-MM)").option("--limit <n>", "L\xEDmite de resultados", (v) => parseInt(v), 30).option("--offset <n>", "Offset de paginaci\xF3n", (v) => parseInt(v), 0).action(async (opts) => {
+  cmd.command("movements").description("Listar movimientos bancarios.").requiredOption("--company <uuid>", "UUID de la empresa").option("--status <status>", "Estado: pending, reconciled, matched, split").option("--classification-status <s>", "classified | unclassified").option("--type <type>", "abonos (cr\xE9ditos) | cargos (d\xE9bitos)").option("--search <text>", "B\xFAsqueda libre en descripci\xF3n y clasificaci\xF3n").option("--from <yyyy-mm-dd>", "Fecha desde").option("--to <yyyy-mm-dd>", "Fecha hasta").option("--period <yyyy-mm>", "Filtrar por mes completo (ej: 2026-01)").option("--bank-account <uuid>", "Filtrar por cuenta bancaria").option("--limit <n>", "L\xEDmite de resultados", (v) => parseInt(v), 30).option("--offset <n>", "Offset de paginaci\xF3n", (v) => parseInt(v), 0).action(async (opts) => {
     const params = {
       company: opts.company,
-      status: opts.status,
       limit: opts.limit,
       offset: opts.offset
     };
-    if (opts.classification) params["classification__icontains"] = opts.classification;
-    if (opts.period) params["date__gte"] = `${opts.period}-01`;
+    if (opts.status) params["status"] = opts.status;
+    if (opts.classificationStatus) params["classification_status"] = opts.classificationStatus;
+    if (opts.type) params["type"] = opts.type;
+    if (opts.search) params["search"] = opts.search;
+    if (opts.bankAccount) params["bank_account"] = opts.bankAccount;
+    if (opts.from) params["date__gte"] = opts.from;
+    if (opts.to) params["date__lte"] = opts.to;
+    if (opts.period) {
+      const [y, m] = opts.period.split("-").map(Number);
+      params["date__gte"] = `${opts.period}-01`;
+      params["date__lte"] = `${opts.period}-${String(new Date(y, m, 0).getDate()).padStart(2, "0")}`;
+    }
     output(await get("/api/accounting/bank-movements/", params));
   });
   cmd.command("movement <movement_id>").description("Obtener detalle de un movimiento bancario.").action(async (id) => {
     output(await get(`/api/accounting/bank-movements/${id}/`));
   });
-  cmd.command("classify <movement_id>").description("Clasificar un movimiento bancario.").requiredOption("--classification <text>", "Clasificaci\xF3n (ej: 'Gasto Operacional')").option("--document-type <type>", "Tipo documento (ej: 'Factura')").option("--comment <text>", "Comentario").action(async (id, opts) => {
+  cmd.command("classify <movement_id>").description("Clasificar un movimiento bancario.").requiredOption("--classification <text>", "Clasificaci\xF3n (ej: 'Gasto Operacional')").option("--document-type <type>", "Tipo documento (ej: 'Factura')").option("--contact-id <uuid>", "UUID del contacto relacionado").option("--comment <text>", "Comentario").action(async (id, opts) => {
     const body = { classification: opts.classification };
     if (opts.documentType) body["document_type"] = opts.documentType;
+    if (opts.contactId) body["contact_id"] = opts.contactId;
     if (opts.comment) body["comment"] = opts.comment;
     output(await patch(`/api/accounting/bank-movements/${id}/classify/`, body));
   });
+  cmd.command("update <movement_id>").description("Actualizar campos de un movimiento (categor\xEDa, comentario, centro de costo, pin).").option("--category <text>", "Categor\xEDa del movimiento").option("--comment <text>", "Comentario").option("--cost-center <uuid>", "UUID del centro de costo").option("--pin <bool>", "Anclar: true | false").action(async (id, opts) => {
+    const body = {};
+    if (opts.category !== void 0) body["category"] = opts.category;
+    if (opts.comment !== void 0) body["comment"] = opts.comment;
+    if (opts.costCenter !== void 0) body["cost_center"] = opts.costCenter;
+    if (opts.pin !== void 0) body["pinned"] = opts.pin === "true";
+    output(await patch(`/api/accounting/bank-movements/${id}/`, body));
+  });
+  cmd.command("bulk-classify").description("Clasificar m\xFAltiples movimientos a la vez.").requiredOption("--company <uuid>", "UUID de la empresa").requiredOption("--movement-ids <uuids>", "UUIDs separados por coma").requiredOption("--classification <text>", "Clasificaci\xF3n a aplicar").action(async (opts) => {
+    const ids = opts.movementIds.split(",").map((s) => s.trim());
+    output(await post("/api/accounting/bank-movements/bulk_classify/", {
+      movement_ids: ids,
+      classification: opts.classification
+    }));
+  });
+  cmd.command("split <movement_id>").description("Dividir un movimiento en sub-movimientos (los montos deben sumar el total).").requiredOption(
+    "--splits <json>",
+    'Array JSON: [{"amount":1000,"description":"texto"},...]'
+  ).action(async (id, opts) => {
+    output(await post("/api/accounting/movement-splits/", {
+      original_movement_id: id,
+      splits: JSON.parse(opts.splits)
+    }));
+  });
   cmd.command("contabilizar <movement_id>").description("Crear asiento contable para un movimiento bancario.").requiredOption("--account-code <code>", "C\xF3digo de cuenta contrapartida (ej: '5101')").option("--description <text>", "Descripci\xF3n del asiento").action(async (id, opts) => {
     const body = { account_code: opts.accountCode };
     if (opts.description) body["description"] = opts.description;
@@ -504,13 +593,18 @@ function registerBanking(program2) {
   });
   cmd.command("contabilizar-reconciliaciones <movement_id>").description("Crear un asiento por cada reconciliaci\xF3n del movimiento.").requiredOption(
     "--entries <json>",
-    'Array JSON: [{"reconciliation_id":"UUID","lines":[{"account_code":"5101","debit":1000,"credit":0}],"description":"opcional"}]'
+    'Array JSON: [{"reconciliation_id":"UUID","lines":[{"account_code":"5101","debit":1000,"credit":0}]}]'
   ).action(async (id, opts) => {
     output(await post(
       `/api/accounting/bank-movements/${id}/contabilizar-reconciliaciones/`,
       { entries: JSON.parse(opts.entries) }
     ));
   });
+  cmd.command("update-journal <movement_id>").description("Editar las l\xEDneas del asiento contable de un movimiento.").requiredOption("--lines <json>", 'L\xEDneas JSON: [{"account_code":"5101","debit":1000,"credit":0}]').option("--description <text>", "Descripci\xF3n del asiento").action(async (id, opts) => {
+    const body = { lines: JSON.parse(opts.lines) };
+    if (opts.description) body["description"] = opts.description;
+    output(await put(`/api/accounting/bank-movements/${id}/update_journal_entry/`, body));
+  });
   cmd.command("descontabilizar <movement_id>").description("Eliminar el asiento contable de un movimiento bancario.").action(async (id) => {
     output(await post(`/api/accounting/bank-movements/${id}/descontabilizar/`, {}));
   });
@@ -523,7 +617,7 @@ function registerBanking(program2) {
     if (opts.amount !== void 0) body["amount"] = opts.amount;
     output(await post("/api/accounting/reconciliation/match", body));
   });
-  cmd.command("reconcile-multi").description("Conciliar un movimiento con m\xFAltiples obligaciones (divide el monto autom\xE1ticamente).").requiredOption("--movement-id <uuid>", "UUID del movimiento bancario").requiredOption("--obligation-ids <uuids>", "UUIDs de obligaciones separados por coma").option("--notes <text>", "Notas", "").action(async (opts) => {
+  cmd.command("reconcile-multi").description("Conciliar un movimiento con m\xFAltiples obligaciones.").requiredOption("--movement-id <uuid>", "UUID del movimiento bancario").requiredOption("--obligation-ids <uuids>", "UUIDs de obligaciones separados por coma").option("--notes <text>", "Notas", "").action(async (opts) => {
     const ids = opts.obligationIds.split(",").map((s) => s.trim());
     output(await post("/api/accounting/reconciliation/match-multi", {
       movement_id: opts.movementId,
@@ -531,7 +625,7 @@ function registerBanking(program2) {
       notes: opts.notes
     }));
   });
-  cmd.command("unmatch <reconciliation_id>").description("Deshacer una conciliaci\xF3n (unmatch).").action(async (id) => {
+  cmd.command("unmatch <reconciliation_id>").description("Deshacer una conciliaci\xF3n.").action(async (id) => {
     output(await post("/api/accounting/reconciliation/unmatch", { reconciliation_id: id }));
   });
   cmd.command("list-reconciliations").description("Listar conciliaciones completadas.").requiredOption("--company <uuid>", "UUID de la empresa").option("--period <yyyy-mm>", "Per\xEDodo YYYY-MM").option("--limit <n>", "L\xEDmite de resultados", (v) => parseInt(v), 30).option("--offset <n>", "Offset de paginaci\xF3n", (v) => parseInt(v), 0).action(async (opts) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fizko-cli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "CLI para consultar datos tributarios y contables desde la API de Fizko",
   "license": "MIT",
   "author": "Akashi Labs <hello@fizko.ai>",