# 🚀 Desk-Moloni Quick Start Guide

## ⚡ **5-Minute Setup**

### **Step 1: Installation** (2 minutes)
```bash
# Upload module to Perfex CRM
1. Upload desk_moloni folder to /modules/
2. Set permissions: chmod -R 755 modules/desk_moloni/
3. Go to Setup → Modules in admin panel
4. Find "Desk-Moloni Integration v3.0" and click **Install**
```

### **Step 2: Configuration** (2 minutes)
```bash
1. Go to Desk-Moloni → Configuration
2. Enter your Moloni API credentials:
   - Client ID: [your_moloni_client_id]
   - Client Secret: [your_moloni_secret] 
   - Company ID: [your_company_id]
3. Click "Test Connection" ✅
4. Click "Save Configuration" 💾
```

### **Step 3: First Sync** (1 minute)
```bash
1. Go to Desk-Moloni → Dashboard
2. Click "Sync Now" button
3. Watch real-time progress! 📊
4. Done! ✨
```

---

## 🔑 **Getting API Credentials**

### **From Moloni Dashboard:**
1. Login to [moloni.pt](https://moloni.pt)
2. Go to **Configurações → API**
3. Create new application:
   - Name: "Perfex CRM Integration"
   - Redirect URI: `https://your-perfex.com/admin/desk_moloni/oauth/callback`
4. Copy **Client ID** and **Client Secret**

---

## ✅ **Verification Checklist**

After installation, verify:

- [ ] ✅ Module appears in admin sidebar
- [ ] ✅ Configuration page loads without errors  
- [ ] ✅ API connection test passes
- [ ] ✅ Dashboard shows sync statistics
- [ ] ✅ No PHP errors in logs

---

## 🔧 **Common Issues & Quick Fixes**

### **❌ "Connection Failed"**
```bash
Solution: Check API credentials in Configuration
→ Verify Client ID, Secret, and Company ID
→ Test connection again
```

### **❌ "Permission Denied"** 
```bash
Solution: Check user permissions
→ Go to Setup → Staff
→ Edit user role
→ Enable "Desk-Moloni" permissions
```

### **❌ "Module Not Found"**
```bash
Solution: Check file permissions
→ chmod -R 755 modules/desk_moloni/
→ Refresh modules page
```

---

## 🎯 **What's Next?**

### **Immediate Actions:**
1. **Configure Sync Settings** - Set automatic sync frequency
2. **Map Entities** - Configure client/product mappings
3. **Test Workflows** - Try creating a client → sync to Moloni

### **Advanced Setup:**
- **Real-time Sync**: Enable webhooks for instant updates
- **Custom Fields**: Map additional Perfex fields
- **Bulk Operations**: Import/export large datasets

---

## 📞 **Need Help?**

### **Documentation**
- 📖 [Complete User Guide](README.md)
- 🔧 [Troubleshooting Guide](TROUBLESHOOTING.md)
- 🧪 [Developer Guide](DEVELOPER.md)

### **Debug Mode**
```php
// Add to config.php for detailed logs
$config['desk_moloni_debug'] = true;
```

### **Support**
- 📧 Email: suporte@descomplicar.pt
- 🌐 Website: https://descomplicar.pt
- 📚 Docs: https://docs.descomplicar.pt/desk-moloni

---

## 🎉 **Success!**

Your **Desk-Moloni integration** is now ready! 

Clients created in Perfex will automatically sync to Moloni, and invoices generated will be seamlessly integrated between both systems.

**Next**: Explore the Dashboard to monitor sync operations and performance metrics.

---

*Generated by Desk-Moloni v3.0 - Built with ❤️ by [Descomplicar®](https://descomplicar.pt)*