transdesk-importer-python-sdk 1.0.0__py3-none-any.whl

transdesk/importer/transformers/internal/towing_parser.py

@@ -0,0 +1,13 @@
+import re
+
+
+class TowingParser:
+
+    def parse(self, produto):
+        produto = produto or ""
+        match = re.search(r"(\d+)", produto)
+
+        if not match:
+            return 0
+
+        return int(match.group(1))

transdesk/importer/validators/__init__.py

@@ -0,0 +1,3 @@
+from .internal_policy_validator import InternalPolicyValidator
+
+__all__ = ["InternalPolicyValidator"]

transdesk/importer/validators/internal_policy_validator.py

@@ -0,0 +1,75 @@
+from dataclasses import asdict
+
+from transdesk.importer.models.internal import ValidationError
+
+
+class InternalPolicyValidator:
+
+    def validate(self, canonical_policies, internal_policies):
+        errors = []
+
+        if len(canonical_policies) != len(internal_policies):
+            errors.append(ValidationError(
+                type="policy_count",
+                canonical=len(canonical_policies),
+                internal=len(internal_policies),
+            ))
+
+        for canonical, internal in zip(canonical_policies, internal_policies):
+            self._validate_policy(canonical, internal, errors)
+
+        return errors
+
+    def _validate_policy(self, canonical, internal, errors):
+        canonical_items = canonical.itens
+        internal_items = internal.data.items
+
+        if len(canonical_items) != len(internal_items):
+            errors.append(ValidationError(
+                policy=canonical.cod_agrupador_apolice,
+                type="item_count",
+                canonical=len(canonical_items),
+                internal=len(internal_items),
+            ))
+
+        for index, (canonical_item, internal_item) in enumerate(
+            zip(canonical_items, internal_items), start=1
+        ):
+            self._validate_item(
+                canonical.cod_agrupador_apolice,
+                index,
+                canonical_item,
+                internal_item,
+                errors,
+            )
+
+    def _validate_item(self, policy_id, item_number, canonical_item, internal_item, errors):
+        canonical_premium = self._calculate_canonical_premium(canonical_item)
+        internal_premium = self._calculate_internal_premium(internal_item)
+
+        if round(canonical_premium, 2) != round(internal_premium, 2):
+            errors.append(ValidationError(
+                policy=policy_id,
+                item=item_number,
+                type="premium",
+                canonical=canonical_premium,
+                internal=internal_premium,
+                difference=(canonical_premium - internal_premium),
+            ))
+
+    def _calculate_canonical_premium(self, canonical_item):
+        total = 0
+
+        for coverage in canonical_item.coberturas:
+            total += (coverage.valor_mensalidade or 0)
+
+        return total
+
+    def _calculate_internal_premium(self, internal_item):
+        total = 0
+
+        for key, value in asdict(internal_item).items():
+            if key.endswith("_premium"):
+                total += (value or 0)
+
+        return total

transdesk_importer_python_sdk-1.0.0.dist-info/METADATA

@@ -0,0 +1,228 @@
+Metadata-Version: 2.4
+Name: transdesk-importer-python-sdk
+Version: 1.0.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
+        
+        Copyright (c) 2026 FMConsult
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/fmconsult/77seg-transdesk-importer
+Project-URL: Bug Tracker, https://github.com/fmconsult/77seg-transdesk-importer/issues
+Keywords: sdk,transdesk,importer,apolices,77seg
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=2.0
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: xlrd>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# transdesk-importer-python-sdk
+
+SDK Python para leitura e transformacao de planilhas de apolices da **Transdesk**
+no formato interno consumido pela `77seg-core-api`.
+
+O SDK e **puro**: ele apenas **le, transforma e valida** a planilha, devolvendo
+modelos tipados. Ele **nao** grava no banco, nao cadastra leads/corretoras e nao
+gera link de assinatura -- essas responsabilidades ficam na core-api
+(ver [Referencia de enrichment](#referencia-de-enrichment-core-api)).
+
+## Instalacao
+
+```bash
+pip install transdesk-importer-python-sdk
+```
+
+Requer Python >= 3.11.
+
+## Uso
+
+A entrada pode ser `bytes` (upload em memoria), um objeto file-like binario ou
+um caminho de arquivo. O formato (`.xls`/`.xlsx`) e detectado automaticamente
+por magic bytes -- nao depende da extensao.
+
+```python
+from transdesk.importer import TransdeskImporter
+
+# 1) a partir de bytes (ex.: upload de um endpoint)
+file_bytes = request.files["file"].file.read()
+result = TransdeskImporter().import_policies(file_bytes)
+
+# 2) a partir de um caminho
+result = TransdeskImporter().import_policies("apolices.xls")
+
+if not result.is_valid:
+    # result.errors -> list[ValidationError]
+    for err in result.errors:
+        print(err)
+else:
+    for policy in result.policies:        # list[InternalPolicy]
+        print(policy.reference_id, len(policy.data.items))
+
+# serializacao pronta para JSON
+payload = result.to_dict()   # dict
+as_json = result.to_json()   # str (ensure_ascii=False)
+```
+
+## Retorno
+
+`import_policies(file)` devolve um `ImportResult`:
+
+| Campo      | Tipo                    | Descricao                                  |
+| ---------- | ----------------------- | ------------------------------------------ |
+| `policies` | `list[InternalPolicy]`  | Apolices ja no formato interno             |
+| `errors`   | `list[ValidationError]` | Divergencias encontradas na validacao      |
+| `is_valid` | `bool`                  | `True` quando `errors` esta vazio          |
+
+Helpers: `result.to_dict()` e `result.to_json(**kwargs)`.
+
+### Principais modelos
+
+- Saida (EN): `InternalPolicy`, `PolicyData`, `ResellerData`, `Broker`, `Lead`,
+  `CustomerInfo`, `Telephone`, `Mobile`, `Address`, `InternalItem`.
+- Canonico (PT, em `InternalPolicy.original_data`): `CanonicalPolicy`,
+  `CanonicalItem`, `Subestipulante`, `Cliente`, `Endereco`, `DadosBancarios`,
+  `UnidadeVenda`, `Cobertura`, `Complemento`.
+
+`InternalItem` tem um schema "achatado" e **consistente**: todos os campos de
+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`.
+
+### Validacao
+
+O `ValidationError` cobre tres tipos:
+
+- `policy_count` -- divergencia na contagem de apolices;
+- `item_count` -- divergencia na contagem de itens de uma apolice;
+- `premium` -- divergencia (apos arredondamento) entre o premio somado no
+  canonico e o premio somado no formato interno de um item.
+
+## Arquitetura
+
+```
+planilha (bytes/file-like/path)
+        |
+        v
+   ExcelReader            -> DataFrame
+        |
+        v
+   ApoliceBuilder         -> list[CanonicalPolicy]   (camada canonica, PT)
+        |
+        v
+   InternalMapper         -> list[InternalPolicy]    (camada interna, EN)
+        |
+        v
+   InternalPolicyValidator-> list[ValidationError]
+        |
+        v
+   ImportResult (policies + errors)
+```
+
+## Desenvolvimento
+
+```bash
+python -m venv venv && source venv/bin/activate
+pip install -e ".[dev]"
+pytest
+```
+
+Publicacao: criar uma tag `vX.Y.Z` dispara o workflow de publish no PyPI
+(`.github/workflows/publish.yml`).
+
+## Referencia de enrichment (core-api)
+
+> Esta secao **nao** faz parte do SDK. Ela preserva, como referencia, a logica
+> de "enrichment" e persistencia que **saiu** do importer e deve ser portada
+> para a `77seg-core-api`.
+
+Apos obter as `InternalPolicy` do SDK, a core-api deve:
+
+1. **Completar os dados** de cada apolice (cadastrar lead e unidade/corretora,
+   injetar `enterprise_id`/`reseller_id` e os defaults da venda);
+2. **Persistir** os registros das vendas no banco;
+3. **Gerar o link de assinatura** (Paperless) e atualizar o status para
+   `pending_signature`.
+
+Codigo original (removido do SDK), que serve de base para a implementacao na
+core-api:
+
+```python
+class InternalImportPipeline:
+
+    def __init__(self, enterprise_id, reseller_id):
+        self.enterprise_id = enterprise_id
+        self.reseller_id = reseller_id
+
+    def execute(self, policies):
+        policies = [self._complete_data(policy) for policy in policies]
+        policies = self._create_db_records(policies)
+        policies = self._generate_signature_link(policies)
+        return policies
+
+    def _complete_data(self, policy):
+        lead = policy.get('data').get('lead')
+        # TODO: gerar o cadastro do lead no BD
+
+        broker = policy.get('data').get('reseller').get('broker')
+        # TODO: gerar o cadastro da unidade (corretora) no BD
+        # TODO: gerar o cadastro do vendedor padrao da unidade (corretora) no BD
+
+        # preencher os dados faltantes
+        policy.update({
+            'enterprise': {'id': self.enterprise_id},
+            'reseller': {'id': self.reseller_id, 'person': broker},
+            'lead': lead,
+            'status': 'quotation_completed',
+            'payment_method': 'bank_slip',
+            'multi': True,
+            'active': True,
+            'deleted': False
+        })
+        return policy
+
+    def _create_db_records(self, policies):
+        # TODO: insere os registros no BD
+        return policies
+
+    def _generate_signature_link(self, policies):
+        # TODO: gera o link de assinatura (via Paperless) para cada venda
+        # TODO: atualiza o status da venda p/ pending_signature
+        return policies
+```
+
+Ponto de integracao na core-api (esboco):
+
+```python
+from transdesk.importer import TransdeskImporter
+
+result = TransdeskImporter().import_policies(file_bytes)
+if not result.is_valid:
+    ...  # retornar result.errors
+
+policies = [p.to_dict() if hasattr(p, "to_dict") else p for p in result.policies]
+# aplicar _complete_data / _create_db_records / _generate_signature_link aqui
+```

transdesk_importer_python_sdk-1.0.0.dist-info/RECORD

@@ -0,0 +1,28 @@
+transdesk/importer/__init__.py,sha256=6nf9-HeOgrulFPQxFDYcNKd6Y5X_2pTtO8dI2RmxwVs,1435
+transdesk/importer/client.py,sha256=rHzptkSn7agaPunSZLkVuPGTjRmSUWCzhUk4Mk68BAY,1569
+transdesk/importer/exporters/__init__.py,sha256=XXU75zMDpCp2h6fqUMSdGfhUWCGntY17FZwXlEsxUO0,68
+transdesk/importer/exporters/json_exporter.py,sha256=mMa5p42jo42p5E5MxllKLj-lfzEIkslLoZiLH67jReQ,787
+transdesk/importer/models/__init__.py,sha256=soABNzXnVo956_CnTb2N5YouIBT51nx-KeznUyDd2NE,979
+transdesk/importer/models/canonical.py,sha256=3XWBOeS34i6_dZYkrybWeuBGhzXTvDSVLm0lDOV-yoQ,3198
+transdesk/importer/models/internal.py,sha256=5TezR_ZqxKzBWlQs2BE7ws7RX0XTfM4qqY4vPx4pzoU,4298
+transdesk/importer/readers/__init__.py,sha256=bBObYifSLerg5GEdwV_So7G355YfofM5LgtYryz4WGo,125
+transdesk/importer/readers/excel_reader.py,sha256=_PQE6qpKCrbNRzw0Ij2gbmdGcpIoEYs61FvLuZJJD5k,2330
+transdesk/importer/shared/__init__.py,sha256=DFisoxirzEy5T6xQCYVRv4b_CSyYxpI8turMqyD1imE,74
+transdesk/importer/shared/data_normalizer.py,sha256=1FVdSevmt61dJFePh49sAJ28Y29t_5IrGWIkUrsRqwE,993
+transdesk/importer/transformers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+transdesk/importer/transformers/canonical/__init__.py,sha256=VEgS-NX_Dj2gJSPbSprZLTGTpQ-kZxRCP-61xLlKWd0,204
+transdesk/importer/transformers/canonical/apolice_builder.py,sha256=FtAmvYp0tugy5LXuFdPmZ9EpFqPZphqKUcCWQmRkKuM,8812
+transdesk/importer/transformers/canonical/cobertura_builder.py,sha256=7fR7HJjW605J_TkYD3dmg67fPh65-dB4knRgumVDTkg,1371
+transdesk/importer/transformers/canonical/item_classifier.py,sha256=HTuEqwTTm82CQFy5qt966RyIAehgJWQDvaB0IqTt3z0,517
+transdesk/importer/transformers/internal/__init__.py,sha256=tkWbDHd_EeCZ_eUeXDJa4DfcOPlYadbam9KusiwLUek,239
+transdesk/importer/transformers/internal/coverage_mapper.py,sha256=nj6vxM8vdbBlmdA5TGfXQR-D5qdUxKl80_5c3Z5wmF8,4677
+transdesk/importer/transformers/internal/internal_mapper.py,sha256=H9DcfOdbMY7i8uysG3WAiG_L5cYbsTicz3GTaL9pzGQ,5092
+transdesk/importer/transformers/internal/rcf_parser.py,sha256=0H93sg5zl9OtA3EGeTeTGMmvh16ca2Pd-EkUqzhlvdo,1053
+transdesk/importer/transformers/internal/towing_parser.py,sha256=pFf207O9Aya4zchfZR0o8bmuuP2otVKWXOJL7c49XgA,220
+transdesk/importer/validators/__init__.py,sha256=jUoCZ4Zw33E86MbkltNItD3ljsnKAzFnILgHWOc7piw,102
+transdesk/importer/validators/internal_policy_validator.py,sha256=P7BFEQjZAoVPn35vljxFAJwzHZ8hfwOwQcqKhARi6zM,2501
+transdesk_importer_python_sdk-1.0.0.dist-info/licenses/LICENSE,sha256=9nhX2zixjTq8LCzy28lfTKJRo-ro7DibBvuv0BexpmI,1066
+transdesk_importer_python_sdk-1.0.0.dist-info/METADATA,sha256=Vk9qVbgVPQoCNFDOT4Kj9alsznTYOFE-0mXQT_BZ4Uw,8190
+transdesk_importer_python_sdk-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+transdesk_importer_python_sdk-1.0.0.dist-info/top_level.txt,sha256=TWPAu9KRvDN40kbqCQBedaeYnHkuwSg8RNDYg8GfIxU,10
+transdesk_importer_python_sdk-1.0.0.dist-info/RECORD,,

transdesk_importer_python_sdk-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

transdesk_importer_python_sdk-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FMConsult
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

transdesk_importer_python_sdk-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+transdesk