transdesk-importer-python-sdk 1.0.0__tar.gz → 1.1.0__tar.gz

{transdesk_importer_python_sdk-1.0.0 → transdesk_importer_python_sdk-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: transdesk-importer-python-sdk
-Version: 1.0.0
+Version: 1.1.0
 Summary: SDK de leitura/transformacao de planilhas de apolices Transdesk para o formato interno 77seg
 Author-email: FMConsult <contato@fmconsult.com.br>
 License: MIT License
@@ -112,6 +112,21 @@ Helpers: `result.to_dict()` e `result.to_json(**kwargs)`.
 cobertura e de risco estao sempre presentes; os que nao se aplicam ao tipo do
 item (ex.: campos de vida num veiculo) vem como `null`.
 
+Campos adicionais de veiculo/reboque (colunas apos `CHAVE_PIX` na planilha):
+
+| Coluna planilha | Campo `InternalItem` | Observacao |
+| --------------- | -------------------- | ---------- |
+| `EMPRESA_RASTREAMENTO` | `vehicle_tracker_company` | Somente quando `has_vehicle_tracker` |
+| `CATEGORIA` | `vehicle_classification` | Classificacao do veiculo (int) |
+| `MARCA` | `brand_name` / `brand` | Veiculo; reboque usa `MARCA_REBOQUE` |
+| `MODELO` | `model_description` / `model` | Veiculo; reboque usa `MODELO_REBOQUE` |
+| `RENAVAM` | `renavam` | |
+| `COR` | `color` | |
+| `ANO` | `model_year`, `manufacture_year` | Mesmo valor nos dois campos |
+| `EIXOS` | `axles` | |
+| `CAMBIO` | `transmission` | |
+| `ALIENADO` | `is_alienated` | `N/A` ou vazio = `false` |
+
 ### Validacao
 
 O `ValidationError` cobre tres tipos:

{transdesk_importer_python_sdk-1.0.0 → transdesk_importer_python_sdk-1.1.0}/README.md

@@ -69,6 +69,21 @@ Helpers: `result.to_dict()` e `result.to_json(**kwargs)`.
 cobertura e de risco estao sempre presentes; os que nao se aplicam ao tipo do
 item (ex.: campos de vida num veiculo) vem como `null`.
 
+Campos adicionais de veiculo/reboque (colunas apos `CHAVE_PIX` na planilha):
+
+| Coluna planilha | Campo `InternalItem` | Observacao |
+| --------------- | -------------------- | ---------- |
+| `EMPRESA_RASTREAMENTO` | `vehicle_tracker_company` | Somente quando `has_vehicle_tracker` |
+| `CATEGORIA` | `vehicle_classification` | Classificacao do veiculo (int) |
+| `MARCA` | `brand_name` / `brand` | Veiculo; reboque usa `MARCA_REBOQUE` |
+| `MODELO` | `model_description` / `model` | Veiculo; reboque usa `MODELO_REBOQUE` |
+| `RENAVAM` | `renavam` | |
+| `COR` | `color` | |
+| `ANO` | `model_year`, `manufacture_year` | Mesmo valor nos dois campos |
+| `EIXOS` | `axles` | |
+| `CAMBIO` | `transmission` | |
+| `ALIENADO` | `is_alienated` | `N/A` ou vazio = `false` |
+
 ### Validacao
 
 O `ValidationError` cobre tres tipos:

{transdesk_importer_python_sdk-1.0.0 → transdesk_importer_python_sdk-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "transdesk-importer-python-sdk"
-version = "1.0.0"
+version = "1.1.0"
 description = "SDK de leitura/transformacao de planilhas de apolices Transdesk para o formato interno 77seg"
 readme = "README.md"
 requires-python = ">=3.11"

{transdesk_importer_python_sdk-1.0.0 → transdesk_importer_python_sdk-1.1.0}/src/transdesk/importer/models/canonical.py

@@ -36,6 +36,16 @@ class VeiculoRisco:
     placa: Optional[str] = None
     chassi: Optional[str] = None
     codigo_fipe: Optional[str] = None
+    empresa_rastreamento: Optional[str] = None
+    categoria: Optional[str] = None
+    modelo: Optional[str] = None
+    renavam: Optional[str] = None
+    marca: Optional[str] = None
+    cor: Optional[str] = None
+    ano: Optional[str] = None
+    eixos: Optional[str] = None
+    cambio: Optional[str] = None
+    alienado: Optional[str] = None
 
 
 @dataclass
@@ -44,6 +54,14 @@ class ReboqueRisco:
     chassi: Optional[str] = None
     marca: Optional[str] = None
     modelo: Optional[str] = None
+    empresa_rastreamento: Optional[str] = None
+    categoria: Optional[str] = None
+    renavam: Optional[str] = None
+    cor: Optional[str] = None
+    ano: Optional[str] = None
+    eixos: Optional[str] = None
+    cambio: Optional[str] = None
+    alienado: Optional[str] = None
 
 
 @dataclass

{transdesk_importer_python_sdk-1.0.0 → transdesk_importer_python_sdk-1.1.0}/src/transdesk/importer/models/internal.py

@@ -23,22 +23,25 @@ class Broker:
 
 @dataclass
 class CustomerInfo:
+    cpf: Optional[str] = None
     cnpj: Optional[str] = None
     principal_name: Optional[str] = None
     secondary_name: Optional[str] = None
     email_address: Optional[str] = None
+    enrollment_number: Optional[str] = None
+    custom_fields: Optional[Dict[str, Any]] = None
 
 
 @dataclass
 class Telephone:
-    telphone_type_code: str
+    type_code: str
     ddd: str
     number: str
 
 
 @dataclass
 class Mobile:
-    telphone_type_code: str
+    type_code: str
     ddd: str
     number: str
     allow_sms: bool = True
@@ -85,7 +88,7 @@ class InternalItem:
 
     # RCF
     has_rcf: bool = False
-    property_damage_value: float = 0
+    material_damage_value: float = 0
     property_damage_premium: float = 0
     bodily_injury_value: float = 0
     bodily_injury_premium: float = 0
@@ -102,12 +105,13 @@ class InternalItem:
     towing_premium: float = 0
 
     # Vidros
-    glass_coverage_type: Optional[str] = None
+    glass_coverage_level: Optional[str] = None
     glass_premium: float = 0
 
     # Rastreador
     has_vehicle_tracker: bool = False
     vehicle_tracker_premium: float = 0
+    vehicle_tracker_company: Optional[str] = None
 
     # Juridica
     has_legal_assistance: bool = False
@@ -124,6 +128,16 @@ class InternalItem:
     body_description: Optional[str] = None
     brand: Optional[str] = None
     model: Optional[str] = None
+    brand_name: Optional[str] = None
+    model_description: Optional[str] = None
+    vehicle_classification: Optional[int] = None
+    renavam: Optional[str] = None
+    color: Optional[str] = None
+    model_year: Optional[int] = None
+    manufacture_year: Optional[int] = None
+    axles: Optional[int] = None
+    transmission: Optional[str] = None
+    is_alienated: bool = False
 
     # Vida
     name: Optional[str] = None

{transdesk_importer_python_sdk-1.0.0 → transdesk_importer_python_sdk-1.1.0}/src/transdesk/importer/shared/data_normalizer.py

@@ -41,7 +41,27 @@ class DataNormalizer:
 
     @staticmethod
     def to_int(value):
+        if value in (None, ""):
+            return None
+
         try:
-            return int(value)
+            return int(str(value).strip())
         except Exception:
             return None
+
+    @staticmethod
+    def to_bool(value, na_values=("N/A", "n/a", "")):
+        if value is None:
+            return False
+
+        normalized = str(value).strip()
+        if normalized in na_values:
+            return False
+
+        upper = normalized.upper()
+        if upper in ("SIM", "S", "TRUE", "1", "YES", "Y"):
+            return True
+        if upper in ("NÃO", "NAO", "N", "FALSE", "0", "NO"):
+            return False
+
+        return False

{transdesk_importer_python_sdk-1.0.0 → transdesk_importer_python_sdk-1.1.0}/src/transdesk/importer/transformers/canonical/apolice_builder.py

@@ -188,6 +188,7 @@ class ApoliceBuilder:
                 chassi=row.get("CHASSI"),
                 marca=row.get("MARCA_REBOQUE"),
                 modelo=row.get("MODELO_REBOQUE"),
+                **self._read_vehicle_detail_fields(rows, include_brand_model=False),
             ),
             coberturas=CoberturaBuilder(rows).build(),
         )
@@ -205,6 +206,7 @@ class ApoliceBuilder:
                 placa=row.get("PLACA_VEICULO"),
                 chassi=row.get("CHASSI"),
                 codigo_fipe=row.get("CODE_FIPE"),
+                **self._read_vehicle_detail_fields(rows, include_brand_model=True),
             ),
             complementos=self.build_complementos(rows),
             coberturas=CoberturaBuilder(rows).build(),
@@ -214,6 +216,36 @@ class ApoliceBuilder:
 
         return item
 
+    def _read_vehicle_detail_fields(self, rows, include_brand_model=False):
+        column_map = {
+            "empresa_rastreamento": "EMPRESA_RASTREAMENTO",
+            "categoria": "CATEGORIA",
+            "renavam": "RENAVAM",
+            "cor": "COR",
+            "ano": "ANO",
+            "eixos": "EIXOS",
+            "cambio": "CAMBIO",
+            "alienado": "ALIENADO",
+        }
+
+        if include_brand_model:
+            column_map["marca"] = "MARCA"
+            column_map["modelo"] = "MODELO"
+
+        fields = {}
+        for field_name, column_name in column_map.items():
+            fields[field_name] = self._first_non_empty(rows, column_name)
+
+        return fields
+
+    @staticmethod
+    def _first_non_empty(rows, column_name):
+        for row in rows:
+            value = row.get(column_name)
+            if value is not None and str(value).strip() != "":
+                return value
+        return None
+
     # ---------------------------------------------------------
     # COMPLEMENTOS
     # ---------------------------------------------------------

{transdesk_importer_python_sdk-1.0.0 → transdesk_importer_python_sdk-1.1.0}/src/transdesk/importer/transformers/internal/coverage_mapper.py

@@ -93,7 +93,7 @@ class CoverageMapper:
         item.vehicle_tracker_premium += (coverage.valor_mensalidade or 0)
 
     def _apply_glass(self, item, coverage):
-        item.glass_coverage_type = "completo"
+        item.glass_coverage_level = "completo"
         item.glass_premium += (coverage.valor_mensalidade or 0)
 
     def _apply_rcf(self, item, coverage):
@@ -104,13 +104,13 @@ class CoverageMapper:
         premiums = self._allocate_premium(
             coverage.valor_mensalidade or 0,
             {
-                "property_damage": parsed["property_damage_value"],
+                "property_damage": parsed["material_damage_value"],
                 "bodily_injury": parsed["bodily_injury_value"],
                 "moral_damage": parsed["moral_damage_value"],
             },
         )
 
-        item.property_damage_value += (parsed["property_damage_value"])
+        item.material_damage_value += (parsed["material_damage_value"])
         item.property_damage_premium += (premiums["property_damage"])
 
         item.bodily_injury_value += (parsed["bodily_injury_value"])

{transdesk_importer_python_sdk-1.0.0 → transdesk_importer_python_sdk-1.1.0}/src/transdesk/importer/transformers/internal/internal_mapper.py

@@ -10,6 +10,7 @@ from transdesk.importer.models.internal import (
     ResellerData,
     Telephone,
 )
+from transdesk.importer.shared.data_normalizer import DataNormalizer
 from transdesk.importer.transformers.internal.coverage_mapper import CoverageMapper
 
 
@@ -44,19 +45,61 @@ class InternalMapper:
         customer = policy.cliente
 
         email = next((e for e in customer.emails if e), None)
+        cpf, cnpj = self._route_document(customer.documento, customer.tipo_pessoa)
 
         return Lead(
             customer_info=CustomerInfo(
-                cnpj=customer.documento,
-                principal_name=(customer.razao_social or customer.nome_fantasia),
-                secondary_name="",
+                cpf=cpf,
+                cnpj=cnpj,
+                principal_name=customer.razao_social or customer.nome_fantasia,
+                secondary_name=customer.nome_fantasia or "",
                 email_address=email,
+                enrollment_number=customer.matricula,
+                custom_fields=self._build_bank_custom_fields(customer),
             ),
             telphone_info=self._build_phone(customer),
             celphone_info=self._build_mobile(customer),
             address_info=self._build_address(customer),
         )
 
+    def _build_bank_custom_fields(self, customer):
+        bank = customer.dados_bancarios
+
+        if bank is None:
+            return None
+
+        bank_info = {
+            'bank_code': bank.banco,
+            'agency': bank.agencia,
+            'account': bank.conta,
+            'pix_key': bank.chave_pix,
+            'holder_name': bank.titular,
+            'holder_document': bank.documento_titular,
+        }
+
+        if not any(bank_info.values()):
+            return None
+
+        return {'bank_info': bank_info}
+
+    def _route_document(self, documento, tipo_pessoa=None):
+        digits = "".join(filter(str.isdigit, str(documento or "")))
+
+        if not digits:
+            return None, None
+
+        tipo = str(tipo_pessoa or "").strip().upper()
+
+        if tipo in ("F", "PF", "FISICA", "FÍSICA"):
+            return digits, None
+        if tipo in ("J", "PJ", "JURIDICA", "JURÍDICA"):
+            return None, digits
+
+        if len(digits) <= 11:
+            return digits.zfill(11), None
+
+        return None, digits.zfill(14)
+
     def build_items(self, policy):
         return [
             self.map_item(item, index)
@@ -77,7 +120,7 @@ class InternalMapper:
 
             if not numero.startswith("9"):
                 return Telephone(
-                    telphone_type_code="03",
+                    type_code="03",
                     ddd=digits[:2],
                     number=numero,
                 )
@@ -98,7 +141,7 @@ class InternalMapper:
 
             if numero.startswith("9"):
                 return Mobile(
-                    telphone_type_code="02",
+                    type_code="02",
                     ddd=digits[:2],
                     number=numero,
                     allow_sms=True,
@@ -154,6 +197,36 @@ class InternalMapper:
         if item.tipo_item == "reboque":
             internal_item.brand = getattr(risco, "marca", None)
             internal_item.model = getattr(risco, "modelo", None)
+            internal_item.brand_name = internal_item.brand
+            internal_item.model_description = internal_item.model
+        elif item.tipo_item == "veiculo":
+            marca = getattr(risco, "marca", None)
+            modelo = getattr(risco, "modelo", None)
+            internal_item.brand = marca
+            internal_item.model = modelo
+            internal_item.brand_name = marca
+            internal_item.model_description = modelo
+
+        internal_item.vehicle_classification = DataNormalizer.to_int(
+            getattr(risco, "categoria", None)
+        )
+        internal_item.renavam = DataNormalizer.clean_doc(
+            getattr(risco, "renavam", None)
+        )
+        internal_item.color = getattr(risco, "cor", None) or None
+        year = DataNormalizer.to_int(getattr(risco, "ano", None))
+        internal_item.model_year = year
+        internal_item.manufacture_year = year
+        internal_item.axles = DataNormalizer.to_int(getattr(risco, "eixos", None))
+        internal_item.transmission = getattr(risco, "cambio", None) or None
+        internal_item.is_alienated = DataNormalizer.to_bool(
+            getattr(risco, "alienado", None)
+        )
+
+        if internal_item.has_vehicle_tracker:
+            internal_item.vehicle_tracker_company = (
+                getattr(risco, "empresa_rastreamento", None) or None
+            )
 
     def _build_body_description(self, item):
         parts = []

{transdesk_importer_python_sdk-1.0.0 → transdesk_importer_python_sdk-1.1.0}/src/transdesk/importer/transformers/internal/rcf_parser.py

@@ -10,7 +10,7 @@ class RCFParser:
         dmo = self.extract_dmo(produto)
 
         return {
-            "property_damage_value": dma_dc,
+            "material_damage_value": dma_dc,
             "bodily_injury_value": dma_dc,
             "moral_damage_value": dmo,
         }

{transdesk_importer_python_sdk-1.0.0 → transdesk_importer_python_sdk-1.1.0}/src/transdesk_importer_python_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: transdesk-importer-python-sdk
-Version: 1.0.0
+Version: 1.1.0
 Summary: SDK de leitura/transformacao de planilhas de apolices Transdesk para o formato interno 77seg
 Author-email: FMConsult <contato@fmconsult.com.br>
 License: MIT License
@@ -112,6 +112,21 @@ Helpers: `result.to_dict()` e `result.to_json(**kwargs)`.
 cobertura e de risco estao sempre presentes; os que nao se aplicam ao tipo do
 item (ex.: campos de vida num veiculo) vem como `null`.
 
+Campos adicionais de veiculo/reboque (colunas apos `CHAVE_PIX` na planilha):
+
+| Coluna planilha | Campo `InternalItem` | Observacao |
+| --------------- | -------------------- | ---------- |
+| `EMPRESA_RASTREAMENTO` | `vehicle_tracker_company` | Somente quando `has_vehicle_tracker` |
+| `CATEGORIA` | `vehicle_classification` | Classificacao do veiculo (int) |
+| `MARCA` | `brand_name` / `brand` | Veiculo; reboque usa `MARCA_REBOQUE` |
+| `MODELO` | `model_description` / `model` | Veiculo; reboque usa `MODELO_REBOQUE` |
+| `RENAVAM` | `renavam` | |
+| `COR` | `color` | |
+| `ANO` | `model_year`, `manufacture_year` | Mesmo valor nos dois campos |
+| `EIXOS` | `axles` | |
+| `CAMBIO` | `transmission` | |
+| `ALIENADO` | `is_alienated` | `N/A` ou vazio = `false` |
+
 ### Validacao
 
 O `ValidationError` cobre tres tipos:

{transdesk_importer_python_sdk-1.0.0 → transdesk_importer_python_sdk-1.1.0}/src/transdesk_importer_python_sdk.egg-info/SOURCES.txt

@@ -29,6 +29,8 @@ src/transdesk_importer_python_sdk.egg-info/SOURCES.txt
 src/transdesk_importer_python_sdk.egg-info/dependency_links.txt
 src/transdesk_importer_python_sdk.egg-info/requires.txt
 src/transdesk_importer_python_sdk.egg-info/top_level.txt
+tests/test_data_normalizer.py
 tests/test_excel_reader.py
 tests/test_importer.py
-tests/test_validator.py
+tests/test_validator.py
+tests/test_vehicle_details.py

transdesk_importer_python_sdk-1.1.0/tests/test_data_normalizer.py

@@ -0,0 +1,26 @@
+import pytest
+
+from transdesk.importer.shared.data_normalizer import DataNormalizer
+
+
+@pytest.mark.parametrize(
+    "value,expected",
+    [
+        ("N/A", False),
+        ("n/a", False),
+        ("", False),
+        (None, False),
+        ("SIM", True),
+        ("sim", True),
+        ("S", True),
+        ("1", True),
+        ("true", True),
+        ("NÃO", False),
+        ("NAO", False),
+        ("N", False),
+        ("0", False),
+        ("false", False),
+    ],
+)
+def test_to_bool(value, expected):
+    assert DataNormalizer.to_bool(value) is expected

{transdesk_importer_python_sdk-1.0.0 → transdesk_importer_python_sdk-1.1.0}/tests/test_importer.py

@@ -35,6 +35,7 @@ def test_policy_structure(apolices_bytes):
     assert broker.principal_name == "TRANSDESK UNIDADE CURITIBA"
 
     assert policy.data.lead.customer_info.principal_name == "ALM TRANSPORTES E LOGISTICA LTDA"
+    assert policy.data.lead.customer_info.cnpj
 
     item = policy.data.items[0]
     assert item.item_number == 1

transdesk_importer_python_sdk-1.1.0/tests/test_vehicle_details.py

@@ -0,0 +1,87 @@
+import pandas as pd
+
+from transdesk.importer.transformers.canonical.apolice_builder import ApoliceBuilder
+from transdesk.importer.transformers.internal.internal_mapper import InternalMapper
+
+
+def _base_row(**overrides):
+    row = {
+        "COD_AGRUPADOR_APOLICE": "99",
+        "DIA_VCTO": "10",
+        "ID_UNITY": "1",
+        "SUB_ESTIPULANTE_CNPJ": "12345678000199",
+        "SUB_ESTIPULANTE_FANTASIA": "CORRETORA TESTE",
+        "SUB_ESTIPULANTE_RAZAO_SOCIAL": "CORRETORA TESTE LTDA",
+        "PESSOA": "J",
+        "CNPJ_CPF_CLIENTE": "98765432000188",
+        "NOME_FANTASIA_CLIENTE": "CLIENTE TESTE",
+        "RAZAO_SOCIAL_CLIENTE": "CLIENTE TESTE LTDA",
+        "PLACA_VEICULO": "ABC1D23",
+        "CHASSI": "9BWZZZ377VT004251",
+        "CODE_FIPE": "005541-7",
+        "NME_BENEFICIO": "Casco PT (VEÍCULO)",
+        "VALOR_MENSALIDADE": "100.00",
+        "IMPORTANCIA_SEGURADA": "50000",
+        "EMPRESA_RASTREAMENTO": "TRACKERLOG",
+        "CATEGORIA": "3",
+        "MODELO": "FH 540",
+        "RENAVAM": "12345678901",
+        "MARCA": "VOLVO",
+        "COR": "BRANCO",
+        "ANO": "2022",
+        "EIXOS": "3",
+        "CAMBIO": "AUTOMATICO",
+        "ALIENADO": "SIM",
+    }
+    row.update(overrides)
+    return row
+
+
+def _build_item(rows):
+    df = pd.DataFrame(rows)
+    canonical = ApoliceBuilder().build(df)[0]
+    return InternalMapper().map(canonical).data.items[0]
+
+
+def test_vehicle_details_mapped_from_spreadsheet_columns():
+    item = _build_item([_base_row()])
+
+    assert item.item_type == "veiculo"
+    assert item.brand_name == "VOLVO"
+    assert item.model_description == "FH 540"
+    assert item.brand == "VOLVO"
+    assert item.model == "FH 540"
+    assert item.vehicle_classification == 3
+    assert item.renavam == "12345678901"
+    assert item.color == "BRANCO"
+    assert item.model_year == 2022
+    assert item.manufacture_year == 2022
+    assert item.axles == 3
+    assert item.transmission == "AUTOMATICO"
+    assert item.is_alienated is True
+    assert item.has_vehicle_tracker is False
+    assert item.vehicle_tracker_company is None
+
+
+def test_vehicle_tracker_company_only_when_has_tracker():
+    with_tracker = _build_item([
+        _base_row(NME_BENEFICIO="Casco PT (VEÍCULO)", VALOR_MENSALIDADE="100.00"),
+        _base_row(
+            NME_BENEFICIO="Rastreador p/ Veículo",
+            VALOR_MENSALIDADE="15.00",
+            EMPRESA_RASTREAMENTO="TRACKERLOG",
+        ),
+    ])
+    without_tracker = _build_item([_base_row()])
+
+    assert with_tracker.has_vehicle_tracker is True
+    assert with_tracker.vehicle_tracker_company == "TRACKERLOG"
+
+    assert without_tracker.has_vehicle_tracker is False
+    assert without_tracker.vehicle_tracker_company is None
+
+
+def test_alienado_na_is_false():
+    item = _build_item([_base_row(ALIENADO="N/A")])
+
+    assert item.is_alienated is False