attime-star-api-python-sdk 1.9.0__tar.gz → 1.9.3__tar.gz

{attime_star_api_python_sdk-1.9.0/src/attime_star_api_python_sdk.egg-info → attime_star_api_python_sdk-1.9.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: attime-star-api-python-sdk
-Version: 1.9.0
+Version: 1.9.3
 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.9.0 → attime_star_api_python_sdk-1.9.3}/pyproject.toml

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

{attime_star_api_python_sdk-1.9.0 → attime_star_api_python_sdk-1.9.3}/src/attime/star/apis/attime001.py

@@ -187,9 +187,15 @@ class Attime001Api(ATTimeStarApi):
     )
 
   def importar_ecommerce(
-    self, item: ApiAttime001ImportarEcommerceDTO | dict
+    self,
+    item: ApiAttime001ImportarEcommerceDTO | dict,
+    *,
+    request_timeout: int = 600,
   ) -> ApiAttime001ImportarEcommerceDTO:
-    """POST /btc/ABTP0004/ApiAttime001/ImportarEcommerce."""
+    """POST /btc/ABTP0004/ApiAttime001/ImportarEcommerce.
+
+    Timeout default 600s: frota grande pode demorar vários minutos no STAR.
+    """
     logging.info('importing ecommerce via ApiAttime001 ImportarEcommerce...')
     if isinstance(item, ApiAttime001ImportarEcommerceDTO):
       payload = item.to_dict()
@@ -213,6 +219,7 @@ class Attime001Api(ATTimeStarApi):
       http_method=HTTPMethod.POST,
       request_url=url,
       payload=payload,
+      request_timeout=request_timeout,
     )
     res = jsonpickle.decode(res)
     return _parse_attime001_object_response(

{attime_star_api_python_sdk-1.9.0 → attime_star_api_python_sdk-1.9.3}/src/attime/star/dtos/ecommerce.py

@@ -3,7 +3,8 @@
 
 POST /btc/ABTP0004/ApiAttime001/ImportarEcommerce
 
-``formaPagamento.dadosPagamento`` permanece ``dict`` até a STAR tipar o schema.
+``formaPagamento.dadosPagamento`` é ``dict`` livre:
+boleto → ``{EnderecoCobranca: ""}``; cartão/PIX tipagem ainda pendente.
 """
 from __future__ import annotations
 
@@ -67,6 +68,18 @@ class EcommerceTelefoneDto:
     return from_dataclass(cls, data)
 
 
+# Alinhamento STAR Homol: para PJ estes campos devem ir no JSON como null
+# (não omitidos). PF continua com omit_none quando vazios.
+# ``nomeSocial`` em PJ vai como string vazia (``""``), não null.
+_PJ_NULL_WIRE_FIELDS = (
+  'codigoSexo',
+  'codigoEstadoCivil',
+  'tipoDocumentoIdentificacao',
+  'numeroDocumento',
+  'codigoProfissao',
+)
+
+
 @dataclass
 class EcommerceClienteDto:
   cpfCnpj: Optional[str] = None
@@ -82,8 +95,13 @@ class EcommerceClienteDto:
   endereco: Optional[list[EcommerceEnderecoDto]] = None
   telefone: Optional[list[EcommerceTelefoneDto]] = None
 
+  @staticmethod
+  def _is_cnpj(cpf_cnpj: Optional[str]) -> bool:
+    digits = ''.join(ch for ch in str(cpf_cnpj or '') if ch.isdigit())
+    return len(digits) >= 14
+
   def to_dict(self) -> dict:
-    return omit_none({
+    data = omit_none({
       'cpfCnpj': self.cpfCnpj,
       'nomeCompleto': self.nomeCompleto,
       'dataNascimentoFundacao': self.dataNascimentoFundacao,
@@ -97,6 +115,11 @@ class EcommerceClienteDto:
       'endereco': to_wire(self.endereco),
       'telefone': to_wire(self.telefone),
     })
+    if self._is_cnpj(self.cpfCnpj):
+      for key in _PJ_NULL_WIRE_FIELDS:
+        data[key] = None
+      data['nomeSocial'] = ''
+    return data
 
   @classmethod
   def from_dict(cls, data: dict | EcommerceClienteDto | None):

{attime_star_api_python_sdk-1.9.0 → attime_star_api_python_sdk-1.9.3/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.9.0
+Version: 1.9.3
 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.9.0 → attime_star_api_python_sdk-1.9.3}/tests/test_attime001_importar_ecommerce.py

@@ -68,7 +68,7 @@ def _minimal_payload() -> ApiAttime001ImportarEcommerceDTO:
         tipoItem=TipoItem.AUTOMOVEL,
         formaPagamento=EcommerceFormaPagamentoDto(
           diaVencimentoParcelaFatura=10,
-          dadosPagamento={'forma': 'boleto'},  # tipagem pendente STAR
+          dadosPagamento={'EnderecoCobranca': ''},
         ),
         itens=[
           EcommerceItemDto(
@@ -102,13 +102,44 @@ class TestApiAttime001ImportarEcommerceDTO(unittest.TestCase):
     )
     self.assertEqual(data['emissao']['contratos']['tipoItem'], 20)
     self.assertEqual(
-      data['emissao']['contratos']['formaPagamento']['dadosPagamento']['forma'],
-      'boleto',
+      data['emissao']['contratos']['formaPagamento']['dadosPagamento'],
+      {'EnderecoCobranca': ''},
     )
     again = ApiAttime001ImportarEcommerceDTO.from_dict(data)
     self.assertEqual(again.emissao.clientes.cpfCnpj, '12345678901')
     self.assertEqual(again.emissao.contratos.itens[0].caracteristicas[0].codigo, 39)
 
+  def test_pj_cliente_wires_pf_attrs_as_null(self):
+    """STAR Homol: PJ deve enviar as chaves PF com null (não omitir)."""
+    cliente = EcommerceClienteDto(
+      cpfCnpj='41413609000170',
+      nomeCompleto='RMA TRANSPORTE',
+      dataNascimentoFundacao='2020-01-01T00:00:00',
+    )
+    data = cliente.to_dict()
+    for key in (
+      'codigoSexo',
+      'codigoEstadoCivil',
+      'tipoDocumentoIdentificacao',
+      'numeroDocumento',
+      'codigoProfissao',
+    ):
+      self.assertIn(key, data)
+      self.assertIsNone(data[key])
+    self.assertIn('nomeSocial', data)
+    self.assertEqual(data['nomeSocial'], '')
+
+  def test_pf_cliente_omits_empty_optional_pf_attrs(self):
+    cliente = EcommerceClienteDto(
+      cpfCnpj='12345678901',
+      nomeCompleto='JOAO',
+      codigoSexo=Sexo.MASCULINO,
+    )
+    data = cliente.to_dict()
+    self.assertEqual(data['codigoSexo'], 'M')
+    self.assertNotIn('tipoDocumentoIdentificacao', data)
+    self.assertNotIn('numeroDocumento', data)
+
   def test_dados_pagamento_must_be_dict(self):
     with self.assertRaises(TypeError):
       EcommerceFormaPagamentoDto.from_dict({
@@ -149,8 +180,8 @@ class TestAttime001ApiImportarEcommerce(unittest.TestCase):
       self.assertEqual(
         kwargs['payload']['emissao']['contratos']['formaPagamento'][
           'dadosPagamento'
-        ]['forma'],
-        'boleto',
+        ],
+        {'EnderecoCobranca': ''},
       )