fix: parse Checko API response fields

src/apps/parsers/clients/checko/client.py

@@ -234,6 +234,14 @@ def _map_ru_keys(data: dict | None) -> dict | None:
     return result
 
 
+def _first_present(data: dict, *keys: str, default: Any = None) -> Any:
+    """Return the first explicitly present value from normalized Checko data."""
+    for key in keys:
+        if key in data:
+            return data[key]
+    return default
+
+
 @dataclass
 class CheckoClient:
     """
@@ -471,7 +479,7 @@ class CheckoClient:
     def _parse_bankruptcy_message(self, data: dict) -> BankruptcyMessage:
         """Парсинг сообщения о банкротстве."""
         return BankruptcyMessage(
-            type=data.get("type", ""),
+            type=_first_present(data, "type", "type_name", default=""),
             date=data.get("date", ""),
             case_number=data.get("case_number"),
         )
@@ -1183,37 +1191,54 @@ class CheckoClient:
             ogrn=data.get("ogrn"),
             inn=data.get("inn"),
             kpp=data.get("kpp"),
-            name=data.get("name"),
+            name=_first_present(data, "name", "short_name", "full_name"),
             region_code=data.get("region_code"),
         )
 
     def _parse_contract(self, data: dict) -> Contract:
         """Парсинг контракта."""
+        suppliers = _first_present(data, "suppliers", "постав", default=[])
+        if isinstance(suppliers, dict):
+            suppliers = [suppliers]
+        objects = _first_present(data, "objects", "объекты", default=[])
+        subject = data.get("subject")
+        if not subject and isinstance(objects, list):
+            subject = (
+                "; ".join(
+                    str(item.get("name") or item.get("наим"))
+                    for item in objects
+                    if isinstance(item, dict) and (item.get("name") or item.get("наим"))
+                )
+                or None
+            )
         return Contract(
-            registry_number=data.get("registry_number", ""),
-            publish_date=data.get("publish_date"),
-            sign_date=data.get("sign_date"),
-            execution_date=data.get("execution_date"),
-            price=data.get("price"),
+            registry_number=_first_present(
+                data, "registry_number", "регномер", default=""
+            ),
+            publish_date=_first_present(data, "publish_date", "date"),
+            sign_date=_first_present(data, "sign_date", "date"),
+            execution_date=_first_present(data, "execution_date", "датаисп"),
+            price=_first_present(data, "price", "цена"),
             currency_code=data.get("currency_code"),
             status=data.get("status"),
-            subject=data.get("subject"),
+            subject=subject,
             law=data.get("law"),
             purchase_number=data.get("purchase_number"),
-            customer=self._parse_contract_party(data.get("customer")),
-            suppliers=tuple(
-                self._parse_contract_party(s) for s in data.get("suppliers", []) if s
+            customer=self._parse_contract_party(
+                _first_present(data, "customer", "заказ")
             ),
-            url=data.get("url"),
+            suppliers=tuple(self._parse_contract_party(s) for s in suppliers if s),
+            url=_first_present(data, "url", "стреис"),
         )
 
     def _parse_contracts_data(self, data: dict | None) -> ContractsData | None:
         """Парсинг данных о контрактах."""
         if not data:
             return None
+        records = _first_present(data, "contracts", "records", default=[])
         return ContractsData(
-            contracts=tuple(self._parse_contract(c) for c in data.get("contracts", [])),
-            pagination=self._parse_pagination(data.get("pagination")),
+            contracts=tuple(self._parse_contract(c) for c in records),
+            pagination=self._parse_pagination(data.get("pagination") or data),
             total_sum=data.get("total_sum"),
         )
 
@@ -1278,32 +1303,52 @@ class CheckoClient:
 
     def _parse_inspection(self, data: dict) -> Inspection:
         """Парсинг проверки."""
+        authority = _first_present(data, "authority", "оргконтр", default={})
+        objects = _first_present(data, "objects", "объекты", default=[])
+        results = [
+            str(item.get("результ"))
+            for item in objects
+            if isinstance(item, dict) and item.get("результ")
+        ]
         return Inspection(
-            id=data.get("id"),
-            erp_id=data.get("erp_id"),
-            plan_date_from=data.get("plan_date_from"),
-            plan_date_to=data.get("plan_date_to"),
+            id=_first_present(data, "id", "number"),
+            erp_id=_first_present(data, "erp_id", "number"),
+            plan_date_from=_first_present(data, "plan_date_from", "start_date"),
+            plan_date_to=_first_present(data, "plan_date_to", "датаоконч"),
             actual_date_from=data.get("actual_date_from"),
             actual_date_to=data.get("actual_date_to"),
-            type=data.get("type"),
-            form=data.get("form"),
+            type=_first_present(data, "type", "типпров"),
+            form=_first_present(data, "form", "типрасп"),
             status=data.get("status"),
-            authority_name=data.get("authority_name"),
-            authority_ogrn=data.get("authority_ogrn"),
-            subject=data.get("subject"),
-            result=data.get("result"),
-            violations_found=data.get("violations_found", False),
+            authority_name=_first_present(
+                data,
+                "authority_name",
+                default=authority.get("name") if isinstance(authority, dict) else None,
+            ),
+            authority_ogrn=_first_present(
+                data,
+                "authority_ogrn",
+                default=authority.get("ogrn") if isinstance(authority, dict) else None,
+            ),
+            subject=_first_present(data, "subject", "цель"),
+            result=_first_present(
+                data,
+                "result",
+                default="; ".join(results) or None,
+            ),
+            violations_found=bool(
+                _first_present(data, "violations_found", "наруш", default=False)
+            ),
         )
 
     def _parse_inspections_data(self, data: dict | None) -> InspectionsData | None:
         """Парсинг данных о проверках."""
         if not data:
             return None
+        records = _first_present(data, "inspections", "records", default=[])
         return InspectionsData(
-            inspections=tuple(
-                self._parse_inspection(i) for i in data.get("inspections", [])
-            ),
-            pagination=self._parse_pagination(data.get("pagination")),
+            inspections=tuple(self._parse_inspection(i) for i in records),
+            pagination=self._parse_pagination(data.get("pagination") or data),
         )
 
     def get_inspections(self, request: InspectionsRequest) -> InspectionsResponse:
@@ -1465,20 +1510,26 @@ class CheckoClient:
     def _parse_legal_case(self, data: dict) -> LegalCase:
         """Парсинг арбитражного дела."""
         return LegalCase(
-            case_number=data.get("case_number", ""),
-            court_name=data.get("court_name"),
-            type=data.get("type"),
+            case_number=_first_present(data, "case_number", "number", default=""),
+            court_name=_first_present(data, "court_name", "суд"),
+            type=_first_present(data, "type", "type_name"),
             category=data.get("category"),
-            status=data.get("status"),
-            filing_date=data.get("filing_date"),
+            status=_first_present(
+                data,
+                "status",
+                default="active" if data.get("практив") else None,
+            ),
+            filing_date=_first_present(data, "filing_date", "date"),
             result_date=data.get("result_date"),
-            claim_amount=data.get("claim_amount"),
+            claim_amount=_first_present(data, "claim_amount", "суммиск"),
             awarded_amount=data.get("awarded_amount"),
             plaintiffs=tuple(
-                self._parse_case_party(p) for p in data.get("plaintiffs", [])
+                self._parse_case_party(p)
+                for p in _first_present(data, "plaintiffs", "ист", default=[])
             ),
             defendants=tuple(
-                self._parse_case_party(d) for d in data.get("defendants", [])
+                self._parse_case_party(d)
+                for d in _first_present(data, "defendants", "ответ", default=[])
             ),
             third_parties=tuple(
                 self._parse_case_party(t) for t in data.get("third_parties", [])
@@ -1486,17 +1537,18 @@ class CheckoClient:
             instances=tuple(
                 self._parse_case_instance(i) for i in data.get("instances", [])
             ),
-            url=data.get("url"),
+            url=_first_present(data, "url", "стркад"),
         )
 
     def _parse_legal_cases_data(self, data: dict | None) -> LegalCasesData | None:
         """Парсинг данных о делах."""
         if not data:
             return None
+        records = _first_present(data, "cases", "records", default=[])
         return LegalCasesData(
-            cases=tuple(self._parse_legal_case(c) for c in data.get("cases", [])),
-            pagination=self._parse_pagination(data.get("pagination")),
-            total_claim_amount=data.get("total_claim_amount"),
+            cases=tuple(self._parse_legal_case(c) for c in records),
+            pagination=self._parse_pagination(data.get("pagination") or data),
+            total_claim_amount=_first_present(data, "total_claim_amount", "общсуммиск"),
         )
 
     def get_legal_cases(self, request: LegalCasesRequest) -> LegalCasesResponse: