attime-star-api-python-sdk 1.3.2__tar.gz → 1.4.0__tar.gz

{attime_star_api_python_sdk-1.3.2/src/attime_star_api_python_sdk.egg-info → attime_star_api_python_sdk-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: attime-star-api-python-sdk
-Version: 1.3.2
+Version: 1.4.0
 Summary: Client HTTP de comunicacao com a API da ATTime Star
 Author-email: Filipe Coelho <filipe@fmconsult.com.br>
 License: MIT License

{attime_star_api_python_sdk-1.3.2 → attime_star_api_python_sdk-1.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "attime-star-api-python-sdk"
-version = "1.3.2"
+version = "1.4.0"
 description = "Client HTTP de comunicacao com a API da ATTime Star"
 readme = "README.md"
 requires-python = ">=3.11"

attime_star_api_python_sdk-1.4.0/src/attime/star/apis/attime001.py

@@ -0,0 +1,76 @@
+# -*- coding: utf-8 -*-
+"""Cliente HTTP ApiAttime001 (ABTP0004)."""
+from __future__ import annotations
+
+import logging
+
+import jsonpickle
+from fmconsult.utils.url import UrlUtil
+from http import HTTPMethod
+
+from attime.star.api import ATTimeStarApi
+from attime.star.dtos.attime001 import ApiAttime001CancelamentoDTO
+
+
+class Attime001Api(ATTimeStarApi):
+  """Rotinas ApiAttime001 — cancelamento de contrato/item/cobertura/serviço/beneficiário."""
+
+  def cancelamento(
+    self, item: ApiAttime001CancelamentoDTO | dict
+  ) -> list[ApiAttime001CancelamentoDTO]:
+    """POST /btc/ABTP0004/ApiAttime001/Cancelamento."""
+    logging.info('cancelling via ApiAttime001 Cancelamento...')
+    try:
+      if isinstance(item, ApiAttime001CancelamentoDTO):
+        payload = item.to_dict()
+      else:
+        payload = dict(item)
+
+      escopo = payload.get('escopoOperacao')
+      numero = payload.get('numeroContrato')
+      if escopo in (None, ''):
+        raise ValueError('escopoOperacao é obrigatório')
+      if numero in (None, ''):
+        raise ValueError('numeroContrato é obrigatório')
+
+      url = UrlUtil().make_url(
+        self.base_url,
+        ['btc', 'ABTP0004', 'ApiAttime001', 'Cancelamento'],
+      )
+      res = self.call_request(
+        http_method=HTTPMethod.POST,
+        request_url=url,
+        payload=payload,
+      )
+      res = jsonpickle.decode(res)
+
+      if isinstance(res, list):
+        return [
+          row
+          for row in (ApiAttime001CancelamentoDTO.from_dict(r) for r in res)
+          if row is not None
+        ]
+
+      if isinstance(res, dict):
+        if 'dados' in res:
+          dados = res['dados']
+          if isinstance(dados, list):
+            return [
+              row
+              for row in (ApiAttime001CancelamentoDTO.from_dict(r) for r in dados)
+              if row is not None
+            ]
+          if isinstance(dados, dict):
+            parsed = ApiAttime001CancelamentoDTO.from_dict(dados)
+            return [parsed] if parsed is not None else []
+          raise Exception(res.get('mensagem', 'Resposta inesperada em dados'))
+
+        if 'codigo' in res:
+          raise Exception(res.get('mensagem', 'Erro desconhecido'))
+
+        parsed = ApiAttime001CancelamentoDTO.from_dict(res)
+        return [parsed] if parsed is not None else []
+
+      raise Exception('Resposta inesperada da API Attime001 Cancelamento')
+    except Exception:
+      raise

attime_star_api_python_sdk-1.4.0/src/attime/star/dtos/attime001.py

@@ -0,0 +1,92 @@
+# -*- coding: utf-8 -*-
+"""DTOs ApiAttime001 (ABTP0004).
+
+Cancelamento: POST /btc/ABTP0004/ApiAttime001/Cancelamento
+Doc: cancelamentos de contrato / item / cobertura / serviço / beneficiário.
+"""
+from __future__ import annotations
+
+from dataclasses import asdict, dataclass
+from typing import Optional
+
+
+class EscopoOperacao:
+  """Valores sugeridos de ``escopoOperacao`` (OpenAPI tipa como string livre).
+
+  Alinhados à descrição do endpoint (contrato/item/cobertura/serviço/beneficiário).
+  Confirmar no homolog se a STAR exigir código diferente.
+  """
+
+  CONTRATO = 'CONTRATO'
+  ITEM = 'ITEM'
+  COBERTURA = 'COBERTURA'
+  SERVICO = 'SERVICO'
+  BENEFICIARIO = 'BENEFICIARIO'
+
+
+@dataclass
+class ApiAttime001CancelamentoDTO:
+  """Payload/resposta de Cancelamento (ApiAttime001CancelamentoDTO)."""
+
+  escopoOperacao: str
+  numeroContrato: str
+  manutencaoUsuarioCpf: Optional[str] = None
+  manutencaoUsuarioDataHora: Optional[str] = None  # ISO date-time
+  identificadorItem: Optional[str] = None
+  caracteristicaCodigo: Optional[int] = None
+  coberturaCodigo: Optional[int] = None
+  servicoCodigo: Optional[int] = None
+  beneficiarioCodigo: Optional[int] = None
+
+  def to_dict(self) -> dict:
+    return {k: v for k, v in asdict(self).items() if v is not None}
+
+  @classmethod
+  def from_dict(
+    cls, data: dict | ApiAttime001CancelamentoDTO | None
+  ) -> ApiAttime001CancelamentoDTO | None:
+    if data is None:
+      return None
+    if isinstance(data, cls):
+      return data
+    if not isinstance(data, dict):
+      raise TypeError(
+        f'ApiAttime001CancelamentoDTO.from_dict espera dict, recebeu {type(data)!r}'
+      )
+    return cls(**{k: data.get(k) for k in cls.__dataclass_fields__})
+
+  @classmethod
+  def for_item(
+    cls,
+    *,
+    numeroContrato: str,
+    identificadorItem: str,
+    manutencaoUsuarioCpf: Optional[str] = None,
+    manutencaoUsuarioDataHora: Optional[str] = None,
+    escopoOperacao: str = EscopoOperacao.ITEM,
+  ) -> ApiAttime001CancelamentoDTO:
+    """Atalho para cancelar um item do contrato (caso típico de saída de vida)."""
+    return cls(
+      escopoOperacao=escopoOperacao,
+      numeroContrato=numeroContrato,
+      identificadorItem=identificadorItem,
+      manutencaoUsuarioCpf=manutencaoUsuarioCpf,
+      manutencaoUsuarioDataHora=manutencaoUsuarioDataHora,
+    )
+
+  @classmethod
+  def for_contrato(
+    cls,
+    *,
+    numeroContrato: str,
+    manutencaoUsuarioCpf: Optional[str] = None,
+    manutencaoUsuarioDataHora: Optional[str] = None,
+    escopoOperacao: str = EscopoOperacao.CONTRATO,
+  ) -> ApiAttime001CancelamentoDTO:
+    """Atalho para cancelar o contrato inteiro."""
+    return cls(
+      escopoOperacao=escopoOperacao,
+      numeroContrato=numeroContrato,
+      manutencaoUsuarioCpf=manutencaoUsuarioCpf,
+      manutencaoUsuarioDataHora=manutencaoUsuarioDataHora,
+    )

{attime_star_api_python_sdk-1.3.2 → attime_star_api_python_sdk-1.4.0/src/attime_star_api_python_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: attime-star-api-python-sdk
-Version: 1.3.2
+Version: 1.4.0
 Summary: Client HTTP de comunicacao com a API da ATTime Star
 Author-email: Filipe Coelho <filipe@fmconsult.com.br>
 License: MIT License

{attime_star_api_python_sdk-1.3.2 → attime_star_api_python_sdk-1.4.0}/src/attime_star_api_python_sdk.egg-info/SOURCES.txt

@@ -3,12 +3,15 @@ README.md
 pyproject.toml
 src/attime/star/api.py
 src/attime/star/apis/__init__.py
+src/attime/star/apis/attime001.py
 src/attime/star/apis/bvix.py
 src/attime/star/apis/infocar.py
 src/attime/star/dtos/__init__.py
+src/attime/star/dtos/attime001.py
 src/attime/star/dtos/bvix.py
 src/attime/star/dtos/infocar.py
 src/attime_star_api_python_sdk.egg-info/PKG-INFO
 src/attime_star_api_python_sdk.egg-info/SOURCES.txt
 src/attime_star_api_python_sdk.egg-info/dependency_links.txt
-src/attime_star_api_python_sdk.egg-info/top_level.txt
+src/attime_star_api_python_sdk.egg-info/top_level.txt
+tests/test_attime001_cancelamento.py

attime_star_api_python_sdk-1.4.0/tests/test_attime001_cancelamento.py

@@ -0,0 +1,87 @@
+# -*- coding: utf-8 -*-
+"""Testes unitários ApiAttime001 Cancelamento (sem HTTP)."""
+from __future__ import annotations
+
+import unittest
+from unittest.mock import MagicMock, patch
+
+from attime.star.dtos.attime001 import (
+  ApiAttime001CancelamentoDTO,
+  EscopoOperacao,
+)
+
+
+class TestApiAttime001CancelamentoDTO(unittest.TestCase):
+  def test_to_dict_omits_none(self):
+    dto = ApiAttime001CancelamentoDTO.for_item(
+      numeroContrato='002501000089',
+      identificadorItem='12345678901',
+    )
+    data = dto.to_dict()
+    self.assertEqual(data['escopoOperacao'], EscopoOperacao.ITEM)
+    self.assertEqual(data['numeroContrato'], '002501000089')
+    self.assertEqual(data['identificadorItem'], '12345678901')
+    self.assertNotIn('coberturaCodigo', data)
+    self.assertNotIn('manutencaoUsuarioCpf', data)
+
+  def test_from_dict_roundtrip(self):
+    raw = {
+      'escopoOperacao': 'ITEM',
+      'numeroContrato': '002501000089',
+      'identificadorItem': '999',
+      'coberturaCodigo': 81,
+    }
+    dto = ApiAttime001CancelamentoDTO.from_dict(raw)
+    self.assertIsNotNone(dto)
+    self.assertEqual(dto.coberturaCodigo, 81)
+    self.assertEqual(dto.to_dict()['coberturaCodigo'], 81)
+
+  def test_for_contrato(self):
+    dto = ApiAttime001CancelamentoDTO.for_contrato(numeroContrato='002501000001')
+    self.assertEqual(dto.escopoOperacao, EscopoOperacao.CONTRATO)
+    self.assertIsNone(dto.identificadorItem)
+
+
+class TestAttime001ApiCancelamento(unittest.TestCase):
+  def test_requires_escopo_and_numero(self):
+    from attime.star.apis.attime001 import Attime001Api
+
+    with patch.object(Attime001Api, '__init__', lambda self: None):
+      api = Attime001Api()
+      with self.assertRaises(ValueError):
+        api.cancelamento({'numeroContrato': '002501000001'})
+      with self.assertRaises(ValueError):
+        api.cancelamento({'escopoOperacao': 'ITEM'})
+
+  def test_posts_to_cancelamento_path(self):
+    from attime.star.apis.attime001 import Attime001Api
+
+    with patch.object(Attime001Api, '__init__', lambda self: None):
+      api = Attime001Api()
+      api.base_url = 'https://starbackhom.attime.inf.br'
+      api.call_request = MagicMock(
+        return_value='[{"escopoOperacao":"ITEM","numeroContrato":"002501000089","identificadorItem":"1"}]'
+      )
+      with patch('attime.star.apis.attime001.jsonpickle.decode') as decode:
+        decode.return_value = [
+          {
+            'escopoOperacao': 'ITEM',
+            'numeroContrato': '002501000089',
+            'identificadorItem': '1',
+          }
+        ]
+        rows = api.cancelamento(
+          ApiAttime001CancelamentoDTO.for_item(
+            numeroContrato='002501000089',
+            identificadorItem='1',
+          )
+        )
+      self.assertEqual(len(rows), 1)
+      self.assertEqual(rows[0].identificadorItem, '1')
+      kwargs = api.call_request.call_args.kwargs
+      self.assertIn('/ABTP0004/ApiAttime001/Cancelamento', kwargs['request_url'])
+      self.assertEqual(kwargs['payload']['escopoOperacao'], 'ITEM')
+
+
+if __name__ == '__main__':
+  unittest.main()