@innvoid/getmarket-contracts 0.1.6 → 0.1.8

package/dist/auth.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/auth.ts"],"sourcesContent":["// packages/contracts/src/auth.ts\nimport type {UID, Code, RefBase, BulkUidsRequest, BulkRefsResponse} from \"./common\";\n\n/**\n * AUTH is SoT for identity, org structure and access.\n */\n\nexport type AuthUserRef = RefBase & {\n    uid: UID; // auth_user_uid\n    document_value?: string | null;\n    document_type_id?: number | null;\n};\n\nexport type AuthEmployeeRef = RefBase & {\n    uid: UID; // auth_employee_uid\n    user_uid?: UID | null;\n    email?: string | null;\n};\n\nexport type AuthCustomerRef = RefBase & {\n    uid: UID; // auth_customer_uid\n    user_uid?: UID | null;\n    email?: string | null;\n};\n\nexport type AuthCompanyRef = RefBase & {\n    uid: UID; // auth_company_uid\n    document_value?: string | null;\n    document_type_id?: number | null;\n    fantasy_name?: string | null;\n    status?: number | null;\n};\n\nexport type AuthBranchRef = RefBase & {\n    uid: UID; // auth_branch_uid\n    company_uid: UID;\n    status?: number | null;\n};\n\nexport type AuthRoleRef = RefBase & {\n    uid: UID;\n    slug?: Code;\n};\n\nexport type AuthPermissionRef = RefBase & {\n    uid: UID;\n    slug?: Code;\n};\n\n// Bulk refs endpoints (internal)\nexport type AuthEmployeesRefsRequest = BulkUidsRequest;\nexport type AuthEmployeesRefsResponse = BulkRefsResponse<AuthEmployeeRef>;\n\nexport type AuthUsersRefsRequest = BulkUidsRequest;\nexport type AuthUsersRefsResponse = BulkRefsResponse<AuthUserRef>;\n\nexport type AuthCustomersRefsRequest = BulkUidsRequest;\nexport type AuthCustomersRefsResponse = BulkRefsResponse<AuthCustomerRef>;\n\nexport type AuthCompaniesRefsRequest = BulkUidsRequest;\nexport type AuthCompaniesRefsResponse = BulkRefsResponse<AuthCompanyRef>;\n\nexport type AuthBranchesRefsRequest = BulkUidsRequest;\nexport type AuthBranchesRefsResponse = BulkRefsResponse<AuthBranchRef>;\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../src/auth.ts"],"sourcesContent":["// packages/contracts/src/auth.ts\nimport type {UID, Code, RefBase, BulkUidsRequest, BulkRefsResponse} from \"./common\";\n\n/**\n * AUTH is SoT for identity, org structure and access.\n *\n * ✅ Estándar NO-LEGACY:\n * - Los otros microservicios SOLO referencian por `uid` (externo, estable).\n * - `id` numérico existe en DB interna de AUTH, pero NO se expone como FK cross-service.\n * - Si necesitas tipos externos (p.ej. document_type), se referencian por UID de su SoT (MD o FIS),\n *   nunca por *_id cross-service.\n */\n\n// ----------------------------\n// Users / People\n// ----------------------------\nexport type AuthUserRef = RefBase & {\n  uid: UID; // auth_user_uid\n\n  // Si se usa identificación tributaria/ID nacional:\n  document_value?: string | null;\n\n  /**\n   * ✅ Recomendado: UID hacia FIS (document types / identity types)\n   * Ej: fis_document_type_uid\n   */\n  fis_document_type_uid?: UID | null;\n\n  /**\n   * ⚠️ Legacy (evitar en nuevo código):\n   * document_type_id?: number | null;\n   */\n};\n\nexport type AuthEmployeeRef = RefBase & {\n  uid: UID; // auth_employee_uid\n  user_uid?: UID | null;\n  email?: string | null;\n  status?: number | null;\n};\n\nexport type AuthCustomerRef = RefBase & {\n  uid: UID; // auth_customer_uid\n  user_uid?: UID | null;\n  email?: string | null;\n  status?: number | null;\n};\n\n// ----------------------------\n// Org structure\n// ----------------------------\nexport type AuthCompanyRef = RefBase & {\n  uid: UID; // auth_company_uid\n\n  document_value?: string | null;\n  fis_document_type_uid?: UID | null;\n\n  fantasy_name?: string | null;\n  status?: number | null;\n};\n\nexport type AuthBranchRef = RefBase & {\n  uid: UID; // auth_branch_uid\n  company_uid: UID;\n  status?: number | null;\n};\n\n// ----------------------------\n// Access control (RBAC/Permissions)\n// ----------------------------\nexport type AuthRoleRef = RefBase & {\n  uid: UID;        // auth_role_uid\n  code?: Code;     // ej: \"SYS_ADMIN\" (si lo defines)\n  slug?: Code;     // si ya lo ocupas como \"code\" humano\n  status?: number | null;\n};\n\nexport type AuthPermissionRef = RefBase & {\n  uid: UID;        // auth_permission_uid\n  code?: Code;     // ej: \"company.read\"\n  slug?: Code;     // si ya lo ocupas como \"code\" humano\n  status?: number | null;\n};\n\n// ----------------------------\n// Bulk refs endpoints (internal)\n// ----------------------------\nexport type AuthEmployeesRefsRequest = BulkUidsRequest;\nexport type AuthEmployeesRefsResponse = BulkRefsResponse<AuthEmployeeRef>;\n\nexport type AuthUsersRefsRequest = BulkUidsRequest;\nexport type AuthUsersRefsResponse = BulkRefsResponse<AuthUserRef>;\n\nexport type AuthCustomersRefsRequest = BulkUidsRequest;\nexport type AuthCustomersRefsResponse = BulkRefsResponse<AuthCustomerRef>;\n\nexport type AuthCompaniesRefsRequest = BulkUidsRequest;\nexport type AuthCompaniesRefsResponse = BulkRefsResponse<AuthCompanyRef>;\n\nexport type AuthBranchesRefsRequest = BulkUidsRequest;\nexport type AuthBranchesRefsResponse = BulkRefsResponse<AuthBranchRef>;\n\nexport type AuthRolesRefsRequest = BulkUidsRequest;\nexport type AuthRolesRefsResponse = BulkRefsResponse<AuthRoleRef>;\n\nexport type AuthPermissionsRefsRequest = BulkUidsRequest;\nexport type AuthPermissionsRefsResponse = BulkRefsResponse<AuthPermissionRef>;\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/auth.d.cts

@@ -2,26 +2,38 @@ import { RefBase, UID, BulkUidsRequest, BulkRefsResponse, Code } from './common.
 
 /**
  * AUTH is SoT for identity, org structure and access.
+ *
+ * ✅ Estándar NO-LEGACY:
+ * - Los otros microservicios SOLO referencian por `uid` (externo, estable).
+ * - `id` numérico existe en DB interna de AUTH, pero NO se expone como FK cross-service.
+ * - Si necesitas tipos externos (p.ej. document_type), se referencian por UID de su SoT (MD o FIS),
+ *   nunca por *_id cross-service.
  */
 type AuthUserRef = RefBase & {
     uid: UID;
     document_value?: string | null;
-    document_type_id?: number | null;
+    /**
+     * ✅ Recomendado: UID hacia FIS (document types / identity types)
+     * Ej: fis_document_type_uid
+     */
+    fis_document_type_uid?: UID | null;
 };
 type AuthEmployeeRef = RefBase & {
     uid: UID;
     user_uid?: UID | null;
     email?: string | null;
+    status?: number | null;
 };
 type AuthCustomerRef = RefBase & {
     uid: UID;
     user_uid?: UID | null;
     email?: string | null;
+    status?: number | null;
 };
 type AuthCompanyRef = RefBase & {
     uid: UID;
     document_value?: string | null;
-    document_type_id?: number | null;
+    fis_document_type_uid?: UID | null;
     fantasy_name?: string | null;
     status?: number | null;
 };
@@ -32,11 +44,15 @@ type AuthBranchRef = RefBase & {
 };
 type AuthRoleRef = RefBase & {
     uid: UID;
+    code?: Code;
     slug?: Code;
+    status?: number | null;
 };
 type AuthPermissionRef = RefBase & {
     uid: UID;
+    code?: Code;
     slug?: Code;
+    status?: number | null;
 };
 type AuthEmployeesRefsRequest = BulkUidsRequest;
 type AuthEmployeesRefsResponse = BulkRefsResponse<AuthEmployeeRef>;
@@ -48,5 +64,9 @@ type AuthCompaniesRefsRequest = BulkUidsRequest;
 type AuthCompaniesRefsResponse = BulkRefsResponse<AuthCompanyRef>;
 type AuthBranchesRefsRequest = BulkUidsRequest;
 type AuthBranchesRefsResponse = BulkRefsResponse<AuthBranchRef>;
+type AuthRolesRefsRequest = BulkUidsRequest;
+type AuthRolesRefsResponse = BulkRefsResponse<AuthRoleRef>;
+type AuthPermissionsRefsRequest = BulkUidsRequest;
+type AuthPermissionsRefsResponse = BulkRefsResponse<AuthPermissionRef>;
 
-export type { AuthBranchRef, AuthBranchesRefsRequest, AuthBranchesRefsResponse, AuthCompaniesRefsRequest, AuthCompaniesRefsResponse, AuthCompanyRef, AuthCustomerRef, AuthCustomersRefsRequest, AuthCustomersRefsResponse, AuthEmployeeRef, AuthEmployeesRefsRequest, AuthEmployeesRefsResponse, AuthPermissionRef, AuthRoleRef, AuthUserRef, AuthUsersRefsRequest, AuthUsersRefsResponse };
+export type { AuthBranchRef, AuthBranchesRefsRequest, AuthBranchesRefsResponse, AuthCompaniesRefsRequest, AuthCompaniesRefsResponse, AuthCompanyRef, AuthCustomerRef, AuthCustomersRefsRequest, AuthCustomersRefsResponse, AuthEmployeeRef, AuthEmployeesRefsRequest, AuthEmployeesRefsResponse, AuthPermissionRef, AuthPermissionsRefsRequest, AuthPermissionsRefsResponse, AuthRoleRef, AuthRolesRefsRequest, AuthRolesRefsResponse, AuthUserRef, AuthUsersRefsRequest, AuthUsersRefsResponse };

package/dist/auth.d.ts

@@ -2,26 +2,38 @@ import { RefBase, UID, BulkUidsRequest, BulkRefsResponse, Code } from './common.
 
 /**
  * AUTH is SoT for identity, org structure and access.
+ *
+ * ✅ Estándar NO-LEGACY:
+ * - Los otros microservicios SOLO referencian por `uid` (externo, estable).
+ * - `id` numérico existe en DB interna de AUTH, pero NO se expone como FK cross-service.
+ * - Si necesitas tipos externos (p.ej. document_type), se referencian por UID de su SoT (MD o FIS),
+ *   nunca por *_id cross-service.
  */
 type AuthUserRef = RefBase & {
     uid: UID;
     document_value?: string | null;
-    document_type_id?: number | null;
+    /**
+     * ✅ Recomendado: UID hacia FIS (document types / identity types)
+     * Ej: fis_document_type_uid
+     */
+    fis_document_type_uid?: UID | null;
 };
 type AuthEmployeeRef = RefBase & {
     uid: UID;
     user_uid?: UID | null;
     email?: string | null;
+    status?: number | null;
 };
 type AuthCustomerRef = RefBase & {
     uid: UID;
     user_uid?: UID | null;
     email?: string | null;
+    status?: number | null;
 };
 type AuthCompanyRef = RefBase & {
     uid: UID;
     document_value?: string | null;
-    document_type_id?: number | null;
+    fis_document_type_uid?: UID | null;
     fantasy_name?: string | null;
     status?: number | null;
 };
@@ -32,11 +44,15 @@ type AuthBranchRef = RefBase & {
 };
 type AuthRoleRef = RefBase & {
     uid: UID;
+    code?: Code;
     slug?: Code;
+    status?: number | null;
 };
 type AuthPermissionRef = RefBase & {
     uid: UID;
+    code?: Code;
     slug?: Code;
+    status?: number | null;
 };
 type AuthEmployeesRefsRequest = BulkUidsRequest;
 type AuthEmployeesRefsResponse = BulkRefsResponse<AuthEmployeeRef>;
@@ -48,5 +64,9 @@ type AuthCompaniesRefsRequest = BulkUidsRequest;
 type AuthCompaniesRefsResponse = BulkRefsResponse<AuthCompanyRef>;
 type AuthBranchesRefsRequest = BulkUidsRequest;
 type AuthBranchesRefsResponse = BulkRefsResponse<AuthBranchRef>;
+type AuthRolesRefsRequest = BulkUidsRequest;
+type AuthRolesRefsResponse = BulkRefsResponse<AuthRoleRef>;
+type AuthPermissionsRefsRequest = BulkUidsRequest;
+type AuthPermissionsRefsResponse = BulkRefsResponse<AuthPermissionRef>;
 
-export type { AuthBranchRef, AuthBranchesRefsRequest, AuthBranchesRefsResponse, AuthCompaniesRefsRequest, AuthCompaniesRefsResponse, AuthCompanyRef, AuthCustomerRef, AuthCustomersRefsRequest, AuthCustomersRefsResponse, AuthEmployeeRef, AuthEmployeesRefsRequest, AuthEmployeesRefsResponse, AuthPermissionRef, AuthRoleRef, AuthUserRef, AuthUsersRefsRequest, AuthUsersRefsResponse };
+export type { AuthBranchRef, AuthBranchesRefsRequest, AuthBranchesRefsResponse, AuthCompaniesRefsRequest, AuthCompaniesRefsResponse, AuthCompanyRef, AuthCustomerRef, AuthCustomersRefsRequest, AuthCustomersRefsResponse, AuthEmployeeRef, AuthEmployeesRefsRequest, AuthEmployeesRefsResponse, AuthPermissionRef, AuthPermissionsRefsRequest, AuthPermissionsRefsResponse, AuthRoleRef, AuthRolesRefsRequest, AuthRolesRefsResponse, AuthUserRef, AuthUsersRefsRequest, AuthUsersRefsResponse };

package/dist/common.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/common.ts"],"sourcesContent":["// packages/contracts/src/common.ts\n\n// primitives (small, reusable)\nexport type UID = string;\nexport type Code = string;\n\nexport type RefBase = {\n    uid: UID;\n    code?: Code;\n    name?: string;\n};\n\n/**\n * Common bulk request/response for internal refs endpoints.\n *\n * Convention:\n *  - Request: { uids: [...] }\n *  - Response: { ok:true, refs:[...] }\n */\nexport type BulkUidsRequest = {\n    uids: UID[];\n};\n\n/**\n * Standard response for internal/bulk refs endpoints.\n *\n * Canonical field is `refs`.\n * - `items` is kept as an optional alias for backward compatibility.\n */\nexport type BulkRefsResponse<T> = {\n    ok: true;\n\n    /** Canonical payload */\n    refs: T[];\n\n    /** Backward-compatible alias (avoid using in new code) */\n    items?: T[];\n\n    /** Optional diagnostics */\n    meta?: {\n        requested?: number;\n        returned?: number;\n        missing?: UID[];\n    };\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../src/common.ts"],"sourcesContent":["// packages/contracts/src/common.ts\n\n// primitives (small, reusable)\nexport type UID = string;\nexport type Code = string;\n\nexport type RefBase = {\n    uid: UID;\n    code?: Code;\n    name?: string;\n};\n\n/**\n * Common bulk request/response for internal refs endpoints.\n *\n * Convention:\n *  - Request: { uids: [...] }\n *  - Response: { ok:true, refs:[...] }\n */\nexport type BulkUidsRequest = {\n    uids: UID[];\n};\n\n/**\n * Standard response for internal/bulk refs endpoints.\n *\n * Canonical field is `refs`.\n * - `items` is kept as an optional alias for backward compatibility.\n */\nexport type BulkRefsResponse<T> = {\n    ok: true;\n\n    /** Canonical payload */\n    refs: T[];\n\n    /** Backward-compatible alias (avoid using in new code) */\n    items?: T[];\n\n    /** Optional diagnostics */\n    meta?: {\n        requested?: number;\n        returned?: number;\n        missing?: UID[];\n    };\n};\n\n// common.ts\nexport type ISODateTime = string; // ISO-8601, ej: \"2026-03-04T12:34:56.000Z\"\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/common.d.cts

@@ -34,5 +34,6 @@ type BulkRefsResponse<T> = {
         missing?: UID[];
     };
 };
+type ISODateTime = string;
 
-export type { BulkRefsResponse, BulkUidsRequest, Code, RefBase, UID };
+export type { BulkRefsResponse, BulkUidsRequest, Code, ISODateTime, RefBase, UID };

package/dist/common.d.ts

@@ -34,5 +34,6 @@ type BulkRefsResponse<T> = {
         missing?: UID[];
     };
 };
+type ISODateTime = string;
 
-export type { BulkRefsResponse, BulkUidsRequest, Code, RefBase, UID };
+export type { BulkRefsResponse, BulkUidsRequest, Code, ISODateTime, RefBase, UID };

package/dist/fis.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/fis.ts"],"sourcesContent":["// packages/contracts/src/fis.ts\nimport type {UID, Code, RefBase, BulkUidsRequest, BulkRefsResponse} from \"./common\";\n\n/**\n * FISCAL is SoT for taxes/compliance.\n * Must reference md_country_code/region codes from master-data.\n */\n\nexport type FisTaxRef = RefBase & {\n    uid: UID;                // fis_tax_uid\n    code?: Code;             // IVA_CL, VAT, etc.\n    name?: string;\n    rate?: number;           // 0.19\n    md_country_code?: Code;  // CL\n    md_region_code?: Code;   // optional\n    status?: \"ACTIVE\" | \"INACTIVE\" | string;\n};\n\nexport type FisTaxesRefsRequest = BulkUidsRequest;\nexport type FisTaxesRefsResponse = BulkRefsResponse<FisTaxRef>;\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../src/fis.ts"],"sourcesContent":["// packages/contracts/src/fis.ts\nimport type {UID, Code, RefBase, BulkUidsRequest, BulkRefsResponse, ISODateTime} from \"./common\";\n\n/**\n * FISCAL is SoT for taxes/compliance.\n * References master-data by md_*_uid.\n */\n\n// -------------------------------------------------------------------------------------------------\n// Enums / Core types\n// -------------------------------------------------------------------------------------------------\n\nexport type FisStatus = \"ACTIVE\" | \"INACTIVE\" | \"DRAFT\" | \"ARCHIVED\" | string;\n\nexport type FisDirection = \"SALE\" | \"PURCHASE\" | string;\n\nexport type FisTaxType =\n  | \"VAT\"\n  | \"WITHHOLDING\"\n  | \"EXEMPTION\"\n  | \"FEE\"\n  | \"OTHER\"\n  | string;\n\nexport type FisRoundingMode = \"HALF_UP\" | \"HALF_EVEN\" | \"DOWN\" | \"UP\" | string;\n\n// rate representation best-practice\nexport type FisRate = {\n  rate?: number | null;     // 0.19\n  rate_bp?: number | null;  // 1900\n};\n\n// -------------------------------------------------------------------------------------------------\n// References (Refs)\n// -------------------------------------------------------------------------------------------------\n\nexport type FisTaxRef = RefBase & {\n  uid: UID; // fis_tax_uid\n  code?: Code;\n  name?: string;\n\n  type?: FisTaxType;\n\n  // ✅ SIN SPREAD: mergeamos como intersección\n} & FisRate & {\n  // SoT location scoping (MD)\n  md_country_uid?: UID | null;\n  md_region_uid?: UID | null;\n  md_commune_uid?: UID | null;\n\n  // flags\n  is_included_in_price?: boolean | null;\n  is_compound?: boolean | null;\n  status?: FisStatus;\n};\n\nexport type FisTaxesRefsRequest = BulkUidsRequest;\nexport type FisTaxesRefsResponse = BulkRefsResponse<FisTaxRef>;\n\n// -------------------------------------------------------------------------------------------------\n// Tax Rules\n// -------------------------------------------------------------------------------------------------\n\nexport type FisTaxRuleTarget = {\n  auth_company_uid?: UID | null;\n  auth_branch_uid?: UID | null;\n\n  md_country_uid?: UID | null;\n  md_region_uid?: UID | null;\n  md_commune_uid?: UID | null;\n\n  counterparty_uid?: UID | null;\n\n  res_resource_uid?: UID | null;\n  res_category_uid?: UID | null;\n  res_variety_uid?: UID | null;\n\n  tags?: Code[] | null;\n};\n\nexport type FisTaxRule = {\n  uid: UID; // fis_tax_rule_uid\n  code?: Code;\n  name?: string;\n  status?: FisStatus;\n\n  priority?: number;\n  direction?: FisDirection;\n\n  fis_tax_uid: UID;\n\n  rounding_mode?: FisRoundingMode;\n  min_amount?: number | null;\n  max_amount?: number | null;\n\n  target?: FisTaxRuleTarget;\n\n  valid_from?: ISODateTime | null;\n  valid_to?: ISODateTime | null;\n};\n\n// -------------------------------------------------------------------------------------------------\n// Calculation Snapshot\n// -------------------------------------------------------------------------------------------------\n\nexport type FisTaxLineSnapshot = {\n  fis_tax_uid: UID;\n\n  tax_code?: Code | null;\n  tax_name?: string | null;\n\n  rate?: number | null;\n  rate_bp?: number | null;\n\n  base_amount: number;\n  tax_amount: number;\n\n  md_country_uid?: UID | null;\n  md_region_uid?: UID | null;\n\n  meta?: Record<string, any> | null;\n};\n\nexport type FisDocumentTotalsSnapshot = {\n  currency_uid?: UID | null;   // md_currency_uid\n  currency_code?: Code | null; // display\n\n  net_amount?: number | null;\n  exempt_amount?: number | null;\n  tax_amount?: number | null;\n  total_amount: number;\n\n  rounding_amount?: number | null;\n\n  taxes: FisTaxLineSnapshot[];\n};\n\nexport type FisTaxCalculationSnapshot = {\n  uid: UID; // fis_tax_snapshot_uid\n  status?: FisStatus;\n\n  idempotency_key?: string | null;\n  request_id?: string | null;\n\n  auth_company_uid?: UID | null;\n  auth_branch_uid?: UID | null;\n  auth_employee_uid?: UID | null;\n\n  direction: FisDirection;\n  md_country_uid?: UID | null;\n  md_region_uid?: UID | null;\n  md_commune_uid?: UID | null;\n\n  source_service?: Code | null;\n  source_uid?: UID | null;\n\n  totals: FisDocumentTotalsSnapshot;\n\n  created_at?: ISODateTime;\n};\n\n// -------------------------------------------------------------------------------------------------\n// Requests: Tax Calculate\n// -------------------------------------------------------------------------------------------------\n\nexport type FisLineForTaxCalc = {\n  line_uid?: UID | null;\n\n  res_variety_uid?: UID | null;\n  res_resource_uid?: UID | null;\n  res_category_uid?: UID | null;\n\n  description?: string | null;\n\n  quantity?: number | null;\n  unit_price?: number | null;\n\n  md_measure_uid?: UID | null;\n  md_measure_code?: Code | null;\n\n  discount_amount?: number | null;\n  discount_percent?: number | null;\n\n  tags?: Code[] | null;\n  meta?: Record<string, any> | null;\n};\n\nexport type FisTaxCalculateRequest = {\n  idempotency_key: string;\n\n  auth_company_uid?: UID | null;\n  auth_branch_uid?: UID | null;\n  auth_employee_uid?: UID | null;\n\n  direction: FisDirection;\n\n  md_country_uid: UID;\n  md_region_uid?: UID | null;\n  md_commune_uid?: UID | null;\n\n  md_currency_uid?: UID | null;\n\n  counterparty_uid?: UID | null;\n\n  source_service?: Code | null;\n  source_uid?: UID | null;\n\n  lines: FisLineForTaxCalc[];\n\n  rounding_mode?: FisRoundingMode;\n  prices_include_tax?: boolean | null;\n\n  meta?: Record<string, any> | null;\n};\n\nexport type FisTaxCalculateResponse = {\n  ok: boolean;\n  snapshot: FisTaxCalculationSnapshot;\n};\n\n// -------------------------------------------------------------------------------------------------\n// Fiscal Documents\n// -------------------------------------------------------------------------------------------------\n\nexport type FisDocType =\n  | \"INVOICE\"\n  | \"RECEIPT\"\n  | \"CREDIT_NOTE\"\n  | \"DEBIT_NOTE\"\n  | \"DISPATCH_GUIDE\"\n  | \"OTHER\"\n  | string;\n\nexport type FisDocLifecycleStatus =\n  | \"DRAFT\"\n  | \"PENDING_SUBMISSION\"\n  | \"SUBMITTED\"\n  | \"ACCEPTED\"\n  | \"REJECTED\"\n  | \"CANCELLED\"\n  | \"VOIDED\"\n  | string;\n\nexport type FisFiscalDocumentRef = RefBase & {\n  uid: UID; // fis_document_uid\n\n  auth_company_uid?: UID | null;\n  auth_branch_uid?: UID | null;\n\n  direction?: FisDirection;\n  doc_type?: FisDocType;\n\n  series?: string | null;\n  folio?: number | null;\n  external_uuid?: string | null;\n\n  md_country_uid?: UID | null;\n\n  status?: FisDocLifecycleStatus;\n\n  issued_at?: ISODateTime | null;\n  created_at?: ISODateTime | null;\n};\n\nexport type FisIssueRequest = {\n  idempotency_key: string;\n\n  auth_company_uid: UID;\n  auth_branch_uid?: UID | null;\n  auth_employee_uid?: UID | null;\n\n  direction: FisDirection;\n  doc_type: FisDocType;\n\n  md_country_uid: UID;\n  md_region_uid?: UID | null;\n  md_commune_uid?: UID | null;\n\n  source_service?: Code | null;\n  source_uid?: UID | null;\n\n  fis_tax_snapshot_uid: UID;\n\n  counterparty_uid?: UID | null;\n\n  attachments?: { kind: Code; file_uid: UID }[] | null;\n\n  meta?: Record<string, any> | null;\n};\n\nexport type FisIssueResponse = {\n  ok: boolean;\n  document: FisFiscalDocumentRef;\n};\n\nexport type FisCancelRequest = {\n  idempotency_key: string;\n  fis_document_uid: UID;\n  reason?: string | null;\n\n  auth_employee_uid?: UID | null;\n  meta?: Record<string, any> | null;\n};\n\nexport type FisCancelResponse = {\n  ok: boolean;\n  document: FisFiscalDocumentRef;\n};\n\n// -------------------------------------------------------------------------------------------------\n// Submissions\n// -------------------------------------------------------------------------------------------------\n\nexport type FisSubmissionStatus =\n  | \"PENDING\"\n  | \"SENT\"\n  | \"ACKED\"\n  | \"ACCEPTED\"\n  | \"REJECTED\"\n  | \"ERROR\"\n  | string;\n\nexport type FisSubmissionRef = RefBase & {\n  uid: UID; // fis_submission_uid\n\n  auth_company_uid?: UID | null;\n  md_country_uid?: UID | null;\n\n  status?: FisSubmissionStatus;\n  external_tracking_id?: string | null;\n\n  created_at?: ISODateTime | null;\n  updated_at?: ISODateTime | null;\n};\n\nexport type FisSubmitRequest = {\n  idempotency_key: string;\n\n  fis_document_uids: UID[];\n\n  auth_company_uid?: UID | null;\n  md_country_uid?: UID | null;\n\n  meta?: Record<string, any> | null;\n};\n\nexport type FisSubmitResponse = {\n  ok: boolean;\n  submission: FisSubmissionRef;\n};\n\nexport type FisSubmissionStatusResponse = {\n  ok: boolean;\n  submission: FisSubmissionRef;\n  items?: {\n    fis_document_uid: UID;\n    status: FisSubmissionStatus;\n    message?: string | null;\n    external_tracking_id?: string | null;\n  }[];\n};\n\n// -------------------------------------------------------------------------------------------------\n// Bulk refs\n// -------------------------------------------------------------------------------------------------\n\nexport type FisDocumentsRefsRequest = BulkUidsRequest;\nexport type FisDocumentsRefsResponse = BulkRefsResponse<FisFiscalDocumentRef>;\n\nexport type FisSubmissionsRefsRequest = BulkUidsRequest;\nexport type FisSubmissionsRefsResponse = BulkRefsResponse<FisSubmissionRef>;\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/fis.d.cts

@@ -1,19 +1,220 @@
-import { RefBase, UID, Code, BulkUidsRequest, BulkRefsResponse } from './common.cjs';
+import { UID, RefBase, ISODateTime, Code, BulkUidsRequest, BulkRefsResponse } from './common.cjs';
 
 /**
  * FISCAL is SoT for taxes/compliance.
- * Must reference md_country_code/region codes from master-data.
+ * References master-data by md_*_uid.
  */
+type FisStatus = "ACTIVE" | "INACTIVE" | "DRAFT" | "ARCHIVED" | string;
+type FisDirection = "SALE" | "PURCHASE" | string;
+type FisTaxType = "VAT" | "WITHHOLDING" | "EXEMPTION" | "FEE" | "OTHER" | string;
+type FisRoundingMode = "HALF_UP" | "HALF_EVEN" | "DOWN" | "UP" | string;
+type FisRate = {
+    rate?: number | null;
+    rate_bp?: number | null;
+};
 type FisTaxRef = RefBase & {
     uid: UID;
     code?: Code;
     name?: string;
-    rate?: number;
-    md_country_code?: Code;
-    md_region_code?: Code;
-    status?: "ACTIVE" | "INACTIVE" | string;
+    type?: FisTaxType;
+} & FisRate & {
+    md_country_uid?: UID | null;
+    md_region_uid?: UID | null;
+    md_commune_uid?: UID | null;
+    is_included_in_price?: boolean | null;
+    is_compound?: boolean | null;
+    status?: FisStatus;
 };
 type FisTaxesRefsRequest = BulkUidsRequest;
 type FisTaxesRefsResponse = BulkRefsResponse<FisTaxRef>;
+type FisTaxRuleTarget = {
+    auth_company_uid?: UID | null;
+    auth_branch_uid?: UID | null;
+    md_country_uid?: UID | null;
+    md_region_uid?: UID | null;
+    md_commune_uid?: UID | null;
+    counterparty_uid?: UID | null;
+    res_resource_uid?: UID | null;
+    res_category_uid?: UID | null;
+    res_variety_uid?: UID | null;
+    tags?: Code[] | null;
+};
+type FisTaxRule = {
+    uid: UID;
+    code?: Code;
+    name?: string;
+    status?: FisStatus;
+    priority?: number;
+    direction?: FisDirection;
+    fis_tax_uid: UID;
+    rounding_mode?: FisRoundingMode;
+    min_amount?: number | null;
+    max_amount?: number | null;
+    target?: FisTaxRuleTarget;
+    valid_from?: ISODateTime | null;
+    valid_to?: ISODateTime | null;
+};
+type FisTaxLineSnapshot = {
+    fis_tax_uid: UID;
+    tax_code?: Code | null;
+    tax_name?: string | null;
+    rate?: number | null;
+    rate_bp?: number | null;
+    base_amount: number;
+    tax_amount: number;
+    md_country_uid?: UID | null;
+    md_region_uid?: UID | null;
+    meta?: Record<string, any> | null;
+};
+type FisDocumentTotalsSnapshot = {
+    currency_uid?: UID | null;
+    currency_code?: Code | null;
+    net_amount?: number | null;
+    exempt_amount?: number | null;
+    tax_amount?: number | null;
+    total_amount: number;
+    rounding_amount?: number | null;
+    taxes: FisTaxLineSnapshot[];
+};
+type FisTaxCalculationSnapshot = {
+    uid: UID;
+    status?: FisStatus;
+    idempotency_key?: string | null;
+    request_id?: string | null;
+    auth_company_uid?: UID | null;
+    auth_branch_uid?: UID | null;
+    auth_employee_uid?: UID | null;
+    direction: FisDirection;
+    md_country_uid?: UID | null;
+    md_region_uid?: UID | null;
+    md_commune_uid?: UID | null;
+    source_service?: Code | null;
+    source_uid?: UID | null;
+    totals: FisDocumentTotalsSnapshot;
+    created_at?: ISODateTime;
+};
+type FisLineForTaxCalc = {
+    line_uid?: UID | null;
+    res_variety_uid?: UID | null;
+    res_resource_uid?: UID | null;
+    res_category_uid?: UID | null;
+    description?: string | null;
+    quantity?: number | null;
+    unit_price?: number | null;
+    md_measure_uid?: UID | null;
+    md_measure_code?: Code | null;
+    discount_amount?: number | null;
+    discount_percent?: number | null;
+    tags?: Code[] | null;
+    meta?: Record<string, any> | null;
+};
+type FisTaxCalculateRequest = {
+    idempotency_key: string;
+    auth_company_uid?: UID | null;
+    auth_branch_uid?: UID | null;
+    auth_employee_uid?: UID | null;
+    direction: FisDirection;
+    md_country_uid: UID;
+    md_region_uid?: UID | null;
+    md_commune_uid?: UID | null;
+    md_currency_uid?: UID | null;
+    counterparty_uid?: UID | null;
+    source_service?: Code | null;
+    source_uid?: UID | null;
+    lines: FisLineForTaxCalc[];
+    rounding_mode?: FisRoundingMode;
+    prices_include_tax?: boolean | null;
+    meta?: Record<string, any> | null;
+};
+type FisTaxCalculateResponse = {
+    ok: boolean;
+    snapshot: FisTaxCalculationSnapshot;
+};
+type FisDocType = "INVOICE" | "RECEIPT" | "CREDIT_NOTE" | "DEBIT_NOTE" | "DISPATCH_GUIDE" | "OTHER" | string;
+type FisDocLifecycleStatus = "DRAFT" | "PENDING_SUBMISSION" | "SUBMITTED" | "ACCEPTED" | "REJECTED" | "CANCELLED" | "VOIDED" | string;
+type FisFiscalDocumentRef = RefBase & {
+    uid: UID;
+    auth_company_uid?: UID | null;
+    auth_branch_uid?: UID | null;
+    direction?: FisDirection;
+    doc_type?: FisDocType;
+    series?: string | null;
+    folio?: number | null;
+    external_uuid?: string | null;
+    md_country_uid?: UID | null;
+    status?: FisDocLifecycleStatus;
+    issued_at?: ISODateTime | null;
+    created_at?: ISODateTime | null;
+};
+type FisIssueRequest = {
+    idempotency_key: string;
+    auth_company_uid: UID;
+    auth_branch_uid?: UID | null;
+    auth_employee_uid?: UID | null;
+    direction: FisDirection;
+    doc_type: FisDocType;
+    md_country_uid: UID;
+    md_region_uid?: UID | null;
+    md_commune_uid?: UID | null;
+    source_service?: Code | null;
+    source_uid?: UID | null;
+    fis_tax_snapshot_uid: UID;
+    counterparty_uid?: UID | null;
+    attachments?: {
+        kind: Code;
+        file_uid: UID;
+    }[] | null;
+    meta?: Record<string, any> | null;
+};
+type FisIssueResponse = {
+    ok: boolean;
+    document: FisFiscalDocumentRef;
+};
+type FisCancelRequest = {
+    idempotency_key: string;
+    fis_document_uid: UID;
+    reason?: string | null;
+    auth_employee_uid?: UID | null;
+    meta?: Record<string, any> | null;
+};
+type FisCancelResponse = {
+    ok: boolean;
+    document: FisFiscalDocumentRef;
+};
+type FisSubmissionStatus = "PENDING" | "SENT" | "ACKED" | "ACCEPTED" | "REJECTED" | "ERROR" | string;
+type FisSubmissionRef = RefBase & {
+    uid: UID;
+    auth_company_uid?: UID | null;
+    md_country_uid?: UID | null;
+    status?: FisSubmissionStatus;
+    external_tracking_id?: string | null;
+    created_at?: ISODateTime | null;
+    updated_at?: ISODateTime | null;
+};
+type FisSubmitRequest = {
+    idempotency_key: string;
+    fis_document_uids: UID[];
+    auth_company_uid?: UID | null;
+    md_country_uid?: UID | null;
+    meta?: Record<string, any> | null;
+};
+type FisSubmitResponse = {
+    ok: boolean;
+    submission: FisSubmissionRef;
+};
+type FisSubmissionStatusResponse = {
+    ok: boolean;
+    submission: FisSubmissionRef;
+    items?: {
+        fis_document_uid: UID;
+        status: FisSubmissionStatus;
+        message?: string | null;
+        external_tracking_id?: string | null;
+    }[];
+};
+type FisDocumentsRefsRequest = BulkUidsRequest;
+type FisDocumentsRefsResponse = BulkRefsResponse<FisFiscalDocumentRef>;
+type FisSubmissionsRefsRequest = BulkUidsRequest;
+type FisSubmissionsRefsResponse = BulkRefsResponse<FisSubmissionRef>;
 
-export type { FisTaxRef, FisTaxesRefsRequest, FisTaxesRefsResponse };
+export type { FisCancelRequest, FisCancelResponse, FisDirection, FisDocLifecycleStatus, FisDocType, FisDocumentTotalsSnapshot, FisDocumentsRefsRequest, FisDocumentsRefsResponse, FisFiscalDocumentRef, FisIssueRequest, FisIssueResponse, FisLineForTaxCalc, FisRate, FisRoundingMode, FisStatus, FisSubmissionRef, FisSubmissionStatus, FisSubmissionStatusResponse, FisSubmissionsRefsRequest, FisSubmissionsRefsResponse, FisSubmitRequest, FisSubmitResponse, FisTaxCalculateRequest, FisTaxCalculateResponse, FisTaxCalculationSnapshot, FisTaxLineSnapshot, FisTaxRef, FisTaxRule, FisTaxRuleTarget, FisTaxType, FisTaxesRefsRequest, FisTaxesRefsResponse };

package/dist/fis.d.ts

@@ -1,19 +1,220 @@
-import { RefBase, UID, Code, BulkUidsRequest, BulkRefsResponse } from './common.js';
+import { UID, RefBase, ISODateTime, Code, BulkUidsRequest, BulkRefsResponse } from './common.js';
 
 /**
  * FISCAL is SoT for taxes/compliance.
- * Must reference md_country_code/region codes from master-data.
+ * References master-data by md_*_uid.
  */
+type FisStatus = "ACTIVE" | "INACTIVE" | "DRAFT" | "ARCHIVED" | string;
+type FisDirection = "SALE" | "PURCHASE" | string;
+type FisTaxType = "VAT" | "WITHHOLDING" | "EXEMPTION" | "FEE" | "OTHER" | string;
+type FisRoundingMode = "HALF_UP" | "HALF_EVEN" | "DOWN" | "UP" | string;
+type FisRate = {
+    rate?: number | null;
+    rate_bp?: number | null;
+};
 type FisTaxRef = RefBase & {
     uid: UID;
     code?: Code;
     name?: string;
-    rate?: number;
-    md_country_code?: Code;
-    md_region_code?: Code;
-    status?: "ACTIVE" | "INACTIVE" | string;
+    type?: FisTaxType;
+} & FisRate & {
+    md_country_uid?: UID | null;
+    md_region_uid?: UID | null;
+    md_commune_uid?: UID | null;
+    is_included_in_price?: boolean | null;
+    is_compound?: boolean | null;
+    status?: FisStatus;
 };
 type FisTaxesRefsRequest = BulkUidsRequest;
 type FisTaxesRefsResponse = BulkRefsResponse<FisTaxRef>;
+type FisTaxRuleTarget = {
+    auth_company_uid?: UID | null;
+    auth_branch_uid?: UID | null;
+    md_country_uid?: UID | null;
+    md_region_uid?: UID | null;
+    md_commune_uid?: UID | null;
+    counterparty_uid?: UID | null;
+    res_resource_uid?: UID | null;
+    res_category_uid?: UID | null;
+    res_variety_uid?: UID | null;
+    tags?: Code[] | null;
+};
+type FisTaxRule = {
+    uid: UID;
+    code?: Code;
+    name?: string;
+    status?: FisStatus;
+    priority?: number;
+    direction?: FisDirection;
+    fis_tax_uid: UID;
+    rounding_mode?: FisRoundingMode;
+    min_amount?: number | null;
+    max_amount?: number | null;
+    target?: FisTaxRuleTarget;
+    valid_from?: ISODateTime | null;
+    valid_to?: ISODateTime | null;
+};
+type FisTaxLineSnapshot = {
+    fis_tax_uid: UID;
+    tax_code?: Code | null;
+    tax_name?: string | null;
+    rate?: number | null;
+    rate_bp?: number | null;
+    base_amount: number;
+    tax_amount: number;
+    md_country_uid?: UID | null;
+    md_region_uid?: UID | null;
+    meta?: Record<string, any> | null;
+};
+type FisDocumentTotalsSnapshot = {
+    currency_uid?: UID | null;
+    currency_code?: Code | null;
+    net_amount?: number | null;
+    exempt_amount?: number | null;
+    tax_amount?: number | null;
+    total_amount: number;
+    rounding_amount?: number | null;
+    taxes: FisTaxLineSnapshot[];
+};
+type FisTaxCalculationSnapshot = {
+    uid: UID;
+    status?: FisStatus;
+    idempotency_key?: string | null;
+    request_id?: string | null;
+    auth_company_uid?: UID | null;
+    auth_branch_uid?: UID | null;
+    auth_employee_uid?: UID | null;
+    direction: FisDirection;
+    md_country_uid?: UID | null;
+    md_region_uid?: UID | null;
+    md_commune_uid?: UID | null;
+    source_service?: Code | null;
+    source_uid?: UID | null;
+    totals: FisDocumentTotalsSnapshot;
+    created_at?: ISODateTime;
+};
+type FisLineForTaxCalc = {
+    line_uid?: UID | null;
+    res_variety_uid?: UID | null;
+    res_resource_uid?: UID | null;
+    res_category_uid?: UID | null;
+    description?: string | null;
+    quantity?: number | null;
+    unit_price?: number | null;
+    md_measure_uid?: UID | null;
+    md_measure_code?: Code | null;
+    discount_amount?: number | null;
+    discount_percent?: number | null;
+    tags?: Code[] | null;
+    meta?: Record<string, any> | null;
+};
+type FisTaxCalculateRequest = {
+    idempotency_key: string;
+    auth_company_uid?: UID | null;
+    auth_branch_uid?: UID | null;
+    auth_employee_uid?: UID | null;
+    direction: FisDirection;
+    md_country_uid: UID;
+    md_region_uid?: UID | null;
+    md_commune_uid?: UID | null;
+    md_currency_uid?: UID | null;
+    counterparty_uid?: UID | null;
+    source_service?: Code | null;
+    source_uid?: UID | null;
+    lines: FisLineForTaxCalc[];
+    rounding_mode?: FisRoundingMode;
+    prices_include_tax?: boolean | null;
+    meta?: Record<string, any> | null;
+};
+type FisTaxCalculateResponse = {
+    ok: boolean;
+    snapshot: FisTaxCalculationSnapshot;
+};
+type FisDocType = "INVOICE" | "RECEIPT" | "CREDIT_NOTE" | "DEBIT_NOTE" | "DISPATCH_GUIDE" | "OTHER" | string;
+type FisDocLifecycleStatus = "DRAFT" | "PENDING_SUBMISSION" | "SUBMITTED" | "ACCEPTED" | "REJECTED" | "CANCELLED" | "VOIDED" | string;
+type FisFiscalDocumentRef = RefBase & {
+    uid: UID;
+    auth_company_uid?: UID | null;
+    auth_branch_uid?: UID | null;
+    direction?: FisDirection;
+    doc_type?: FisDocType;
+    series?: string | null;
+    folio?: number | null;
+    external_uuid?: string | null;
+    md_country_uid?: UID | null;
+    status?: FisDocLifecycleStatus;
+    issued_at?: ISODateTime | null;
+    created_at?: ISODateTime | null;
+};
+type FisIssueRequest = {
+    idempotency_key: string;
+    auth_company_uid: UID;
+    auth_branch_uid?: UID | null;
+    auth_employee_uid?: UID | null;
+    direction: FisDirection;
+    doc_type: FisDocType;
+    md_country_uid: UID;
+    md_region_uid?: UID | null;
+    md_commune_uid?: UID | null;
+    source_service?: Code | null;
+    source_uid?: UID | null;
+    fis_tax_snapshot_uid: UID;
+    counterparty_uid?: UID | null;
+    attachments?: {
+        kind: Code;
+        file_uid: UID;
+    }[] | null;
+    meta?: Record<string, any> | null;
+};
+type FisIssueResponse = {
+    ok: boolean;
+    document: FisFiscalDocumentRef;
+};
+type FisCancelRequest = {
+    idempotency_key: string;
+    fis_document_uid: UID;
+    reason?: string | null;
+    auth_employee_uid?: UID | null;
+    meta?: Record<string, any> | null;
+};
+type FisCancelResponse = {
+    ok: boolean;
+    document: FisFiscalDocumentRef;
+};
+type FisSubmissionStatus = "PENDING" | "SENT" | "ACKED" | "ACCEPTED" | "REJECTED" | "ERROR" | string;
+type FisSubmissionRef = RefBase & {
+    uid: UID;
+    auth_company_uid?: UID | null;
+    md_country_uid?: UID | null;
+    status?: FisSubmissionStatus;
+    external_tracking_id?: string | null;
+    created_at?: ISODateTime | null;
+    updated_at?: ISODateTime | null;
+};
+type FisSubmitRequest = {
+    idempotency_key: string;
+    fis_document_uids: UID[];
+    auth_company_uid?: UID | null;
+    md_country_uid?: UID | null;
+    meta?: Record<string, any> | null;
+};
+type FisSubmitResponse = {
+    ok: boolean;
+    submission: FisSubmissionRef;
+};
+type FisSubmissionStatusResponse = {
+    ok: boolean;
+    submission: FisSubmissionRef;
+    items?: {
+        fis_document_uid: UID;
+        status: FisSubmissionStatus;
+        message?: string | null;
+        external_tracking_id?: string | null;
+    }[];
+};
+type FisDocumentsRefsRequest = BulkUidsRequest;
+type FisDocumentsRefsResponse = BulkRefsResponse<FisFiscalDocumentRef>;
+type FisSubmissionsRefsRequest = BulkUidsRequest;
+type FisSubmissionsRefsResponse = BulkRefsResponse<FisSubmissionRef>;
 
-export type { FisTaxRef, FisTaxesRefsRequest, FisTaxesRefsResponse };
+export type { FisCancelRequest, FisCancelResponse, FisDirection, FisDocLifecycleStatus, FisDocType, FisDocumentTotalsSnapshot, FisDocumentsRefsRequest, FisDocumentsRefsResponse, FisFiscalDocumentRef, FisIssueRequest, FisIssueResponse, FisLineForTaxCalc, FisRate, FisRoundingMode, FisStatus, FisSubmissionRef, FisSubmissionStatus, FisSubmissionStatusResponse, FisSubmissionsRefsRequest, FisSubmissionsRefsResponse, FisSubmitRequest, FisSubmitResponse, FisTaxCalculateRequest, FisTaxCalculateResponse, FisTaxCalculationSnapshot, FisTaxLineSnapshot, FisTaxRef, FisTaxRule, FisTaxRuleTarget, FisTaxType, FisTaxesRefsRequest, FisTaxesRefsResponse };