fix(email-api): Implement robust content upload and activity-based workaround

connector-superoffice/create_email_test.py

@@ -97,18 +97,35 @@ RoboPlanet"""
             print(f"✅ Document Created Successfully!")
             print(f"   ID: {doc_id}")
             print(f"   Recipient: {email_address}")
-            print(f"   Subject: {subject}")
+            print(f"   Template: {doc.get('DocumentTemplate', {}).get('Name')}")
             
+            # 3b. Upload Content (Critical Step to avoid 'Checkout Error')
+            print(f"📤 Uploading content stream to Document {doc_id}...")
+            try:
+                content_bytes = body.encode('utf-8')
+                
+                # Manual request because _request_with_retry assumes JSON
+                headers = client.headers.copy()
+                headers["Content-Type"] = "application/octet-stream" 
+                
+                res = requests.put(
+                    f"{client.base_url}/Document/{doc_id}/Content",
+                    data=content_bytes,
+                    headers=headers
+                )
+                if res.status_code in [200, 204]:
+                    print("✅ Content uploaded successfully.")
+                else:
+                    print(f"⚠️ Content upload failed: {res.status_code} {res.text}")
+                    
+            except Exception as e:
+                print(f"⚠️ Content upload error: {e}")
+
             # Construct direct link
             env = settings.SO_ENVIRONMENT
             cust_id = settings.SO_CONTEXT_IDENTIFIER
-            link = f"https://{env}.superoffice.com/{cust_id}/default.aspx?document_id={doc_id}"
-            print(f"\n--- WICHTIG ---")
-            print(f"Das Dokument wurde im Archiv von {contact.get('Name')} angelegt.")
-            print(f"Da der automatisierte Versand via API in diesem Mandanten (500 Error) blockiert ist,")
-            print(f"muss der Versand aktuell MANUELL über diesen Link gestartet werden:")
-            print(f"🔗 {link}")
-            print(f"----------------\n")
+            
+            doc_link = f"https://{env}.superoffice.com/{cust_id}/default.aspx?document_id={doc_id}"
 
             # 4. Create Linked Appointment (Activity)
             print("📅 Creating Linked Appointment (Email Sent Activity)...")
@@ -123,7 +140,19 @@ RoboPlanet"""
             try:
                 appt = client._post("Appointment", appt_payload)
                 if appt:
-                     print(f"✅ Appointment Created: {appt.get('AppointmentId')}")
+                     appt_id = appt.get('AppointmentId')
+                     print(f"✅ Appointment Created: {appt_id}")
+                     
+                     appt_link = f"https://{env}.superoffice.com/{cust_id}/default.aspx?appointment_id={appt_id}"
+                     
+                     print(f"\n--- WICHTIG: NUTZEN SIE DIESEN LINK ---")
+                     print(f"Da das Dokument selbst ('Cannot check out') oft blockiert,")
+                     print(f"öffnen Sie bitte die AKTIVITÄT. Dort steht der Text im Beschreibungsfeld:")
+                     print(f"🔗 {appt_link}")
+                     print(f"---------------------------------------\n")
+                     
+                     print(f"(Backup Link zum Dokument: {doc_link})")
+
                 else:
                      print("⚠️ Failed to create appointment (None response).")
             except Exception as e: