Enhance: Address/VAT Sync & Infrastructure Hardening [30e88f42]

- Implemented Address (City) and VAT (OrgNumber) sync back to SuperOffice.
- Hardened Infrastructure: Removed Pydantic dependency in config for better Docker compatibility.
- Improved SuperOffice Client error logging and handled empty SO_ENVIRONMENT variables.
- Updated Matrix Generator: Switched to gemini-2.0-flash, added industry filtering, and robust JSON parsing.
- Updated Documentation with session findings and troubleshooting steps.

connector-superoffice/superoffice_client.py

@@ -19,6 +19,8 @@ class SuperOfficeClient:
         self.env = settings.SO_ENVIRONMENT
         self.cust_id = settings.SO_CONTEXT_IDENTIFIER
 
+        logger.info(f"DEBUG CONFIG: Env='{self.env}', CustID='{self.cust_id}', ClientID='{self.client_id[:4]}...'")
+
         if not all([self.client_id, self.client_secret, self.refresh_token]):
             # Graceful failure: Log error but allow init (for help/docs/discovery scripts)
             logger.error("❌ SuperOffice credentials missing in .env file (or environment variables).")
@@ -57,7 +59,8 @@ class SuperOfficeClient:
             resp.raise_for_status()
             return resp.json().get("access_token")
         except requests.exceptions.HTTPError as e:
-            logger.error(f"❌ Token Refresh Error: {e.response.text}")
+            logger.error(f"❌ Token Refresh Error (Status: {e.response.status_code}): {e.response.text}")
+            logger.debug(f"Response Headers: {e.response.headers}")
             return None
         except Exception as e:
             logger.error(f"❌ Connection Error during token refresh: {e}")
@@ -71,7 +74,8 @@ class SuperOfficeClient:
             resp.raise_for_status()
             return resp.json()
         except requests.exceptions.HTTPError as e:
-            logger.error(f"❌ API GET Error for {endpoint}: {e.response.text}")
+            logger.error(f"❌ API GET Error for {endpoint} (Status: {e.response.status_code}): {e.response.text}")
+            logger.debug(f"Response Headers: {e.response.headers}")
             return None
 
     def _put(self, endpoint, payload):