@cbm-common/cbm-types 0.0.364 → 0.0.365

package/lib/domain/models/billing.domain.model.d.ts

@@ -1,3 +1,4 @@
+import { CbmIdentificationModel } from './identification.domain.model';
 export declare namespace CbmBillingModel {
     interface GetRucSriBody {
         ruc: string;
@@ -6,6 +7,8 @@ export declare namespace CbmBillingModel {
         statusCode: number;
         body: string;
         datosRuc?: GetRucSriResponse.Data;
+        /** Respuesta completa de api-scrap (establecimientos, representantes legales, avisos del SRI, etc.). */
+        rawData?: CbmIdentificationModel.SearchRucResponse;
     }
     namespace GetRucSriResponse {
         interface Data {
@@ -28,6 +31,8 @@ export declare namespace CbmBillingModel {
         statusCode: number;
         body: string;
         datosCedula?: GetCedulaResponse.Data;
+        /** Respuesta completa de api-scrap (profesión, padres, fecha de defunción, RUC de la persona, etc.). */
+        rawData?: CbmIdentificationModel.SearchCedulaResponse;
     }
     namespace GetCedulaResponse {
         interface Data {

package/lib/domain/models/identification.domain.model.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Respuestas de api-scrap ("Utilitarios Scraper API", https://api-scrap.cbmerp.com/openapi.json):
+ * `/SRI/search-ruc`, `/SRI/search-cedula`, `/SRI/search-placa` y `/SRI/search-chasis`.
+ * Tipadas según el OpenAPI y respuestas reales. Los campos que el portal no devuelve vienen en `null`.
+ * Los resultados quedan en caché unos minutos en api-scrap.
+ */
+export declare namespace CbmIdentificationModel {
+    interface SearchRucResponse {
+        ruc: string;
+        razon_social: string | null;
+        /** Ej. `ACTIVO`, `SUSPENDIDO`, `CANCELADO`. */
+        estado: string | null;
+        actividad_principal: string | null;
+        /** Ej. `SOCIEDAD`, `PERSONA NATURAL`. */
+        tipo_contribuyente: string | null;
+        regimen: string | null;
+        categoria: string | null;
+        obligado_contabilidad: boolean | null;
+        agente_retencion: boolean | null;
+        contribuyente_especial: boolean | null;
+        contribuyente_fantasma: boolean | null;
+        transacciones_inexistentes: boolean | null;
+        motivo_cancelacion_suspension: string | null;
+        fechas: SearchRucResponse.Fechas;
+        representantes_legales: SearchRucResponse.RepresentanteLegal[];
+        establecimientos: SearchRucResponse.Establecimiento[];
+    }
+    namespace SearchRucResponse {
+        /** Fechas en formato `YYYY-MM-DD`. */
+        interface Fechas {
+            inicio_actividades: string | null;
+            cese: string | null;
+            reinicio_actividades: string | null;
+            actualizacion: string | null;
+        }
+        interface RepresentanteLegal {
+            identificacion: string | null;
+            nombre: string | null;
+        }
+        interface Establecimiento {
+            /** Ej. `001`. La matriz no siempre es el `001`: usar `matriz`. */
+            numero: string | null;
+            nombre_comercial: string | null;
+            /** `MAT` (matriz) u `OFI` (oficina). */
+            tipo: string | null;
+            /** Formato `PROVINCIA / CANTÓN / PARROQUIA / calle`. */
+            direccion: string | null;
+            /** `ABIERTO` o `CERRADO`. */
+            estado: string | null;
+            matriz: boolean;
+        }
+    }
+    interface SearchCedulaResponse {
+        /** Origen del dato (ej. `saccs`, `lr`). */
+        fuente: string;
+        cedula: string;
+        nombre_completo: string | null;
+        nombres: string | null;
+        apellido_paterno: string | null;
+        apellido_materno: string | null;
+        tipo_persona: string | null;
+        existe_registro_civil: boolean | null;
+        /** Formato `DD/MM/YYYY`. */
+        fecha_nacimiento: string | null;
+        lugar_nacimiento: string | null;
+        nacionalidad: string | null;
+        /** `HOMBRE` o `MUJER`. */
+        sexo: string | null;
+        /** Ej. `SOLTERO`, `CASADO`, `VIUDO`, `DIVORCIADO`. */
+        estado_civil: string | null;
+        conyuge: string | null;
+        condicion_cedulado: string | null;
+        /** Formato `DD/MM/YYYY`. */
+        fecha_cedulacion: string | null;
+        /** Formato `DD/MM/YYYY`; `null` si la persona vive. */
+        fecha_defuncion: string | null;
+        instruccion: string | null;
+        profesion: string | null;
+        nombre_madre: string | null;
+        nombre_padre: string | null;
+        /** Formato `PROVINCIA/CANTÓN/PARROQUIA`. */
+        domicilio: string | null;
+        calle: string | null;
+        /** Suele venir `000` cuando no hay número. */
+        numero_casa: string | null;
+        /** Datos del RUC de la persona, si tiene. */
+        ruc: SearchRucResponse | null;
+    }
+    /** Datos del vehículo y rubros de matriculación a pagar. La placa se normaliza a mayúsculas y sin guiones. */
+    interface SearchPlacaResponse {
+        placa: string;
+        vehiculo: SearchPlacaResponse.Vehiculo;
+        rubros: SearchPlacaResponse.Rubro[];
+        total_a_pagar: number;
+    }
+    namespace SearchPlacaResponse {
+        /** Fechas en formato `YYYY-MM-DD`. */
+        interface Vehiculo {
+            codigo_vehiculo: number;
+            placa: string;
+            camv_cpn: string | null;
+            marca: string | null;
+            modelo: string | null;
+            anio: number | null;
+            pais_origen: string | null;
+            color_1: string | null;
+            color_2: string | null;
+            cilindraje: string | null;
+            clase: string | null;
+            servicio: string | null;
+            canton: string | null;
+            ultimo_anio_pagado: number | null;
+            fecha_ultima_matricula: string | null;
+            fecha_caducidad_matricula: string | null;
+            fecha_revision: string | null;
+            fecha_compra_registro: string | null;
+            prohibido_enajenar: boolean | null;
+            exoneracion: boolean | null;
+            aplica_cuota: boolean | null;
+            observacion: string | null;
+        }
+        /** Rubro de matriculación a pagar (impuesto a la propiedad, tasas ANT, SPPAT, etc.). */
+        interface Rubro {
+            codigo: number;
+            descripcion: string | null;
+            beneficiario: string | null;
+            tipo_deuda: string | null;
+            descripcion_tipo_deuda: string | null;
+            valor: number;
+            anio_desde: number | null;
+            anio_hasta: number | null;
+        }
+    }
+    /** Misma respuesta que la consulta por placa, buscando por número de chasis (VIN). */
+    type SearchChasisResponse = SearchPlacaResponse;
+    /**
+     * Cuerpo de error de api-scrap: 400 parámetro inválido, 401 token inválido o ausente,
+     * 404 no existe en el portal, 502 / 504 el portal de origen falló o no respondió.
+     */
+    interface ErrorResponse {
+        detail: string;
+    }
+    /** Cuerpo del 422 (validación de FastAPI): `detail` es un arreglo. */
+    interface HTTPValidationError {
+        detail: ValidationError[];
+    }
+    interface ValidationError {
+        loc: (string | number)[];
+        msg: string;
+        type: string;
+        input?: unknown;
+        ctx?: Record<string, unknown>;
+    }
+}

package/lib/domain/repositories/identification.domain.repository.d.ts

@@ -0,0 +1,11 @@
+import { Observable } from 'rxjs';
+import { ICbmIdentificationInfrastructureRepository } from '../../infrastructure/repositories/identification.infrastructure.repository';
+import { CbmIdentificationModel } from '../models/identification.domain.model';
+export declare class CbmIdentificationDomainRepository implements ICbmIdentificationInfrastructureRepository {
+    private readonly service;
+    constructor(service: ICbmIdentificationInfrastructureRepository);
+    searchRuc(ruc: string): Observable<CbmIdentificationModel.SearchRucResponse>;
+    searchCedula(cedula: string): Observable<CbmIdentificationModel.SearchCedulaResponse>;
+    searchPlaca(placa: string): Observable<CbmIdentificationModel.SearchPlacaResponse>;
+    searchChasis(chasis: string): Observable<CbmIdentificationModel.SearchChasisResponse>;
+}

package/lib/infrastructure/repositories/identification.infrastructure.repository.d.ts

@@ -0,0 +1,8 @@
+import { Observable } from 'rxjs';
+import { CbmIdentificationModel } from '../../domain/models/identification.domain.model';
+export interface ICbmIdentificationInfrastructureRepository {
+    searchRuc(ruc: string): Observable<CbmIdentificationModel.SearchRucResponse>;
+    searchCedula(cedula: string): Observable<CbmIdentificationModel.SearchCedulaResponse>;
+    searchPlaca(placa: string): Observable<CbmIdentificationModel.SearchPlacaResponse>;
+    searchChasis(chasis: string): Observable<CbmIdentificationModel.SearchChasisResponse>;
+}

package/lib/infrastructure/services/billing.infrastructure.service.d.ts

@@ -1,10 +1,31 @@
 import { ICbmBillingInfrastructureRepository } from '../repositories/billing.infrastructure.repository';
-import { HttpClient } from '@angular/common/http';
 import { Observable } from 'rxjs';
 import { CbmBillingModel } from '../../domain/models/billing.domain.model';
+import { CbmIdentificationInfrastructureService } from './identification.infrastructure.service';
+/**
+ * Mantiene el contrato `datosRuc` / `datosCedula` que ya usan todas las pantallas (BILLING_REPOSITORY),
+ * pero obtiene los datos de api-scrap a través de `CbmIdentificationInfrastructureService`.
+ * La respuesta completa de api-scrap (establecimientos, representantes, banderas del SRI, etc.)
+ * va tipada en `rawData`.
+ */
 export declare class CbmBillingInfrastructureService implements ICbmBillingInfrastructureRepository {
-    private readonly http;
-    constructor(http: HttpClient);
+    private readonly identificationService;
+    constructor(identificationService: CbmIdentificationInfrastructureService);
     getRucSri(data: CbmBillingModel.GetRucSriBody): Observable<CbmBillingModel.GetRucSriResponse>;
     getCedula(data: CbmBillingModel.GetCedulaBody): Observable<CbmBillingModel.GetCedulaResponse>;
+    /**
+     * Las pantallas leen el error como `error.error.message` (muchas sin `?.`), igual que respondía ms-util.
+     * api-scrap usa `{ detail }` y un fallo de red no trae cuerpo, así que todo error sale con esa misma forma.
+     */
+    private toLegacyError;
+    private errorMessage;
+    /**
+     * Sin `nombre_completo` se lanza error para que las pantallas caigan en su callback `error`
+     * ("No se pudo extraer los datos") en vez de un falso éxito.
+     */
+    private toDatosCedula;
+    /**
+     * El nombre comercial y la dirección salen del establecimiento con `matriz: true` (no siempre es el 001).
+     */
+    private toDatosRuc;
 }

package/lib/infrastructure/services/identification.infrastructure.service.d.ts

@@ -0,0 +1,20 @@
+import { HttpClient } from '@angular/common/http';
+import { Observable } from 'rxjs';
+import { ICbmIdentificationInfrastructureRepository } from '../repositories/identification.infrastructure.repository';
+import { CbmIdentificationModel } from '../../domain/models/identification.domain.model';
+/**
+ * Consulta directa a api-scrap (`/SRI/search-ruc`, `/SRI/search-cedula`, `/SRI/search-placa`,
+ * `/SRI/search-chasis`).
+ * Se autentica con la cabecera `X-Api-Key`. Errores: `{ detail }` con 400 (parámetro inválido),
+ * 401 (token inválido), 404 (no existe), 422 (validación), 502 / 504 (falla del portal de origen).
+ */
+export declare class CbmIdentificationInfrastructureService implements ICbmIdentificationInfrastructureRepository {
+    private readonly http;
+    constructor(http: HttpClient);
+    private readonly url;
+    private readonly headers;
+    searchRuc(ruc: string): Observable<CbmIdentificationModel.SearchRucResponse>;
+    searchCedula(cedula: string): Observable<CbmIdentificationModel.SearchCedulaResponse>;
+    searchPlaca(placa: string): Observable<CbmIdentificationModel.SearchPlacaResponse>;
+    searchChasis(chasis: string): Observable<CbmIdentificationModel.SearchChasisResponse>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cbm-common/cbm-types",
-  "version": "0.0.364",
+  "version": "0.0.365",
   "main": "index.js",
   "types": "public-api.d.ts",
   "exports": {

package/lib/components/accounting-seat/directives/drop-down-menu.directive.d.ts

@@ -1,13 +0,0 @@
-import { AfterViewInit, ElementRef, OnChanges, Renderer2, SimpleChanges } from '@angular/core';
-export declare class DropdownMenuDirective implements OnChanges, AfterViewInit {
-    private element;
-    private renderer2;
-    hiddenMenu: import("@angular/core").InputSignal<boolean>;
-    hiddenMenuOp: import("@angular/core").WritableSignal<boolean>;
-    constructor(element: ElementRef, renderer2: Renderer2);
-    ngAfterViewInit(): void;
-    ngOnChanges(changes: SimpleChanges): void;
-    toggle(event: Event): void;
-    private toggleMenu;
-    initStyle(): void;
-}

package/lib/components/accounting-seat/directives/drop-down.directive.d.ts

@@ -1,10 +0,0 @@
-import { AfterViewInit, ElementRef, Renderer2 } from '@angular/core';
-export declare class DropdownDirective implements AfterViewInit {
-    private elementRef;
-    private renderer;
-    private isOpen;
-    constructor(elementRef: ElementRef, renderer: Renderer2);
-    ngAfterViewInit(): void;
-    toggleDropdown(event: MouseEvent): void;
-    closeDropdown(event: MouseEvent): void;
-}

package/lib/components/record-detail-metadata/components/options/options.d.ts

@@ -1,13 +0,0 @@
-import { WritableSignal } from '@angular/core';
-import { Router, ActivatedRoute, Params } from '@angular/router';
-import { CbmRecordDetailMetadataModel } from "../../types";
-export declare class OptionsComponent {
-    private router;
-    private route;
-    constructor(router: Router, route: ActivatedRoute);
-    metadata: import("@angular/core").InputSignal<CbmRecordDetailMetadataModel.metadata | null>;
-    options: import("@angular/core").InputSignal<CbmRecordDetailMetadataModel.options[] | undefined>;
-    optionInSignals: WritableSignal<WritableSignal<CbmRecordDetailMetadataModel.options>[]>;
-    executeFunction(option: WritableSignal<CbmRecordDetailMetadataModel.options>): void;
-    navigate(routerLink?: string, queryParams?: Params): void;
-}

package/lib/components/record-detail-metadata/directives/drop-down-menu.directive.d.ts

@@ -1,13 +0,0 @@
-import { AfterViewInit, ElementRef, OnChanges, Renderer2, SimpleChanges } from '@angular/core';
-export declare class DropdownMenuDirective implements OnChanges, AfterViewInit {
-    private element;
-    private renderer2;
-    hiddenMenu: import("@angular/core").InputSignal<boolean>;
-    hiddenMenuOp: import("@angular/core").WritableSignal<boolean>;
-    constructor(element: ElementRef, renderer2: Renderer2);
-    ngAfterViewInit(): void;
-    ngOnChanges(changes: SimpleChanges): void;
-    toggle(event: Event): void;
-    private toggleMenu;
-    initStyle(): void;
-}

package/lib/components/record-detail-metadata/directives/drop-down.directive.d.ts

@@ -1,9 +0,0 @@
-import { ElementRef, Renderer2 } from '@angular/core';
-export declare class DropdownDirective {
-    private elementRef;
-    private renderer;
-    private isOpen;
-    constructor(elementRef: ElementRef, renderer: Renderer2);
-    toggleDropdown(event: MouseEvent): void;
-    closeDropdown(event: MouseEvent): void;
-}

package/lib/domain/models/sales-pending-document.domain.model.d.ts

@@ -1,91 +0,0 @@
-export declare namespace CbmSalesPendingDocumentModel {
-    type TTypeEstablishment = 'matrix' | 'branch';
-    export interface ListParams {
-        page: number;
-        size: number;
-        document_number?: string;
-        date_end?: number;
-        date_begin?: number;
-        client_id?: string;
-        client_branch_id?: string;
-        type?: string;
-    }
-    export interface ListResponse {
-        success: boolean;
-        pageNum: number;
-        pageSize: number;
-        pages: number;
-        total: number;
-        totales: ListResponse.totales;
-        items: ListResponse.Item[];
-    }
-    export namespace ListResponse {
-        interface Item {
-            _id: string;
-            created_at: number;
-            document_nomenclature: string;
-            document_emission_point_number: string;
-            document_sequence: string;
-            balance: number;
-            client_id: string;
-            client_payment_deadline?: number;
-            client_credit_limit?: number;
-            client_business_name: string;
-            client_trade_name: string;
-            client_document_number: string;
-            client_credit_application: boolean;
-            client_price_list_id: string;
-            client_price_list_code: string;
-            client_price_list_name: string;
-            client_document_type_id: string;
-            client_document_type_name: string;
-            client_document_type_code: string;
-            client_category_id: string;
-            client_category_name: string;
-            client_branch_id: string;
-            client_branch_code: string;
-            client_branch_name: string;
-            client_branch_address: string;
-            client_branch_email: string[];
-            client_branch_phone_code?: string;
-            client_branch_phone?: string;
-            client_branch_cellphone?: string;
-            client_branch_type_establishment: `${TTypeEstablishment}`;
-            client_branch_province_id?: string;
-            client_branch_province_code?: string;
-            client_branch_province_name?: string;
-            client_branch_canton_id?: string;
-            client_branch_canton_code?: string;
-            client_branch_canton_name?: string;
-            client_branch_parish_id?: string;
-            client_branch_parish_code?: string;
-            client_branch_parish_name?: string;
-            client_branch_longitude?: number;
-            client_branch_latitude?: number;
-            client_branch_seller_id: string;
-            client_branch_seller_identification_number: string;
-            client_branch_seller_full_name: string;
-            client_branch_seller_address: string;
-            client_branch_seller_email: string[];
-            client_branch_seller_cellphone: string;
-            client_branch_contact_id?: string;
-            client_branch_contact_identification_number?: string;
-            client_branch_contact_full_name?: string;
-            client_branch_contact_cellphone?: string;
-            client_branch_contact_email?: string[];
-            new_document_number: string;
-            date: number;
-            type: string;
-            checked?: boolean;
-        }
-        interface totales {
-            total_retention?: number;
-            total_down_payment?: number;
-            total_credit_note?: number;
-            total_initial_balance_retention?: number;
-            total_initial_balance_down_payment?: number;
-            total_initial_balance_credit_note?: number;
-        }
-    }
-    export {};
-}

package/lib/domain/repositories/sales-pending-document.domain.repository.d.ts

@@ -1,8 +0,0 @@
-import { Observable } from 'rxjs';
-import { CbmSalesPendingDocumentModel } from '../models/sales-pending-document.domain.model';
-import { ICbmSalesPendingDocumentRepository } from '../../infrastructure/repositories/sales-pending-document.infrastructure.repository';
-export declare class CbmSalesPendingDocumentRepository implements ICbmSalesPendingDocumentRepository {
-    private service;
-    constructor(service: ICbmSalesPendingDocumentRepository);
-    list(params: CbmSalesPendingDocumentModel.ListParams): Observable<CbmSalesPendingDocumentModel.ListResponse>;
-}

package/lib/infrastructure/repositories/blanket-agreement-category-service..infrastructure.repository.d.ts

@@ -1,7 +0,0 @@
-import { Observable } from "rxjs";
-import { CbmBlanketAgreementCategoryServiceModel } from "../../domain/models/blanket-agreement-category-service.domain.model";
-export interface ICbmBlanketAgreementCategoryServiceRepository {
-    list(params: CbmBlanketAgreementCategoryServiceModel.ListParams): Observable<CbmBlanketAgreementCategoryServiceModel.ListResponse>;
-    save(data: CbmBlanketAgreementCategoryServiceModel.SaveBody): Observable<CbmBlanketAgreementCategoryServiceModel.ConfirmResponse>;
-    delete(id: string): Observable<CbmBlanketAgreementCategoryServiceModel.ConfirmResponse>;
-}

package/lib/infrastructure/repositories/sales-pending-document.infrastructure.repository.d.ts

@@ -1,5 +0,0 @@
-import { Observable } from 'rxjs';
-import { CbmSalesPendingDocumentModel } from '../../domain/models/sales-pending-document.domain.model';
-export interface ICbmSalesPendingDocumentRepository {
-    list(params: CbmSalesPendingDocumentModel.ListParams): Observable<CbmSalesPendingDocumentModel.ListResponse>;
-}

package/lib/infrastructure/services/sales-pending-document.infrastructure.service.d.ts

@@ -1,9 +0,0 @@
-import { HttpClient } from '@angular/common/http';
-import { Observable } from 'rxjs';
-import { CbmSalesPendingDocumentModel } from '../../domain/models/sales-pending-document.domain.model';
-export declare class CbmSalesPendingDocumentService {
-    private http;
-    constructor(http: HttpClient);
-    private readonly url;
-    list(params: CbmSalesPendingDocumentModel.ListParams): Observable<CbmSalesPendingDocumentModel.ListResponse>;
-}