bmc_hub/docs/VTIGER_SETUP.md

# vTiger & Simply-CRM Integration Setup

## Status
✅ **BMC Office Abonnementer** - Virker nu! (fix applied: changed `execute_query_single` to `execute_query`)  
⚠️ **vTiger Cloud Abonnementer** - Kræver credentials  
⚠️ **Simply-CRM Salgsordre** - Kræver credentials  

## Problem
Abonnementer & Salgsordre fanen viste ingen data fra vTiger og Simply-CRM fordi:

1. **BMC Office query brugte `execute_query_single()`** - returnerede kun 1 række i stedet for alle
2. **vTiger Cloud credentials mangler** - VTIGER_URL, VTIGER_USERNAME, VTIGER_ACCESS_KEY
3. **Simply-CRM credentials mangler** - OLD_VTIGER_URL, OLD_VTIGER_USERNAME, OLD_VTIGER_ACCESS_KEY

## Løsning

### 1. BMC Office Subscriptions (✅ Fixed)
Changed from `execute_query_single()` to `execute_query()` in `app/customers/backend/router.py` line 554.

Nu vises alle BMC Office abonnementer korrekt:
- Kunde 327 (Maskinsikkerhed): 16 abonnementer
- Kunde 372 (Norva24 Danmark A/S): 12 abonnementer

### 2. vTiger Cloud Integration (⚠️ Requires Credentials)

Tilføj følgende til `.env` filen:

```bash
# vTiger Cloud Integration
VTIGER_URL=https://bmcnetworks.od2.vtiger.com
VTIGER_USERNAME=din_vtiger_bruger
VTIGER_ACCESS_KEY=din_vtiger_access_key
```

**Sådan finder du credentials:**
1. Log ind på vTiger Cloud (https://bmcnetworks.od2.vtiger.com)
2. Gå til **Settings** (tandhjul øverst til højre)
3. Vælg **Integration** → **Webservices**
4. Kopier **Access Key** for din bruger
5. Username er din vTiger login email

### 3. Simply-CRM / Old vTiger Integration (⚠️ Requires Credentials)

Hvis I stadig bruger den gamle on-premise vTiger installation:

```bash
# Simply-CRM (Old vTiger On-Premise)
OLD_VTIGER_URL=http://crm.bmcnetworks.dk
OLD_VTIGER_USERNAME=din_gamle_vtiger_bruger
OLD_VTIGER_ACCESS_KEY=din_gamle_access_key
```

**Note:** Simply-CRM bruges til at hente salgsordre med `recurring_frequency` fra det gamle system.

## Test Efter Setup

1. Genstart API containeren:
   ```bash
   docker restart bmc-hub-api
   ```

2. Test en kunde med vTiger ID:
   ```bash
   curl http://localhost:8001/api/v1/customers/39/subscriptions | jq
   ```

3. Check logs for fejl:
   ```bash
   docker logs bmc-hub-api --tail=50 | grep -i "vtiger\|simply"
   ```

## Forventet Output

Med credentials konfigureret skulle du se:

```json
{
  "status": "success",
  "recurring_orders": [...],      // vTiger recurring sales orders
  "sales_orders": [...],           // Simply-CRM orders med recurring_frequency
  "subscriptions": [...],          // vTiger Subscriptions module
  "expired_subscriptions": [...],  // Expired/cancelled subscriptions
  "bmc_office_subscriptions": [...] // Local BMC Office subscriptions (✅ works now)
}
```

## Frontend Display

Abonnementer & Salgsordre fanen viser nu 3 sektioner:

1. **vTiger Abonnementer** - Subscriptions module data med lock/unlock funktion
2. **BMC Office Abonnementer** - Lokale abonnementer (✅ virker)
3. **Samlet overblik** - Stats kortene øverst

## Troubleshooting

### "VTIGER_URL not configured"
→ Tilføj credentials til `.env` og genstart containeren

### "No Simply-CRM account found"
→ Kunden findes ikke i det gamle system, eller navnet matcher ikke præcist

### "Not logged in to Simply-CRM"
→ OLD_VTIGER_ACCESS_KEY er forkert eller mangler

### BMC Office subscriptions viser stadig ikke data
→ Tjek at containeren er restartet efter query fix