bmc_hub/docs/SIMPLY_CRM_SETUP.md

# Simply-CRM Integration Setup

## Status
⚠️ **Simply-CRM credentials ikke konfigureret** - Salgsordre fra det gamle system vises ikke

## Hvad er Simply-CRM?

Simply-CRM er et **separat CRM system** (VTiger fork) der bruges til at hente **historiske salgsordre** med `recurring_frequency`.

⚠️ **Vigtigt:** Simply-CRM er IKKE det samme som:
- vTiger Cloud (https://bmcnetworks.od2.vtiger.com) 
- Det gamle on-premise vTiger (http://crm.bmcnetworks.dk)

Simply-CRM har sin egen URL, credentials og API endpoint (`/webservice.php`).

## Hvorfor vises ingen Simply-CRM data?

3 grunde:
1. ⚠️ **OLD_VTIGER_URL, OLD_VTIGER_USERNAME, OLD_VTIGER_API_KEY er tomme** i `.env` filen
2. Koden leder efter `OLD_VTIGER_API_KEY` men kan ikke finde credentials
3. Serveren er tilgængelig (301 response), men authentication mangler

## Sådan finder du credentials

### Option 1: Hvis I stadig bruger det gamle system

1. **Log ind på Simply-CRM:**
   - URL: http://crm.bmcnetworks.dk
   - Brug din normale bruger

2. **Find Access Key:**
   - Gå til **Settings** (tandhjul øverst til højre)
   - Klik på **My Preferences**
   - Under **Webservices** vil du se din **Access Key**
   - Kopier access key'en

3. **Tilføj til .env:**
   ```bash
   # Simply-CRM (separat system)
   SIMPLYCRM_URL=http://your-simplycrm-server.com
   SIMPLYCRM_USERNAME=din_email@domain.dk
   SIMPLYCRM_API_KEY=din_access_key_herfra
   
   # ELLER hvis det er samme som gamle vTiger (fallback):
   OLD_VTIGER_URL=http://crm.bmcnetworks.dk
   OLD_VTIGER_USERNAME=din_email@bmcnetworks.dk
   OLD_VTIGER_API_KEY=din_access_key_herfra
   ```

4. **Genstart API:**
   ```bash
   docker restart bmc-hub-api
   ```

### Option 2: Hvis I ikke længere bruger det gamle system

Hvis alle kunder er migreret til vTiger Cloud og Simply-CRM ikke længere bruges:

1. **Kommenter linjerne ud i .env:**
   ```bash
   # OLD_VTIGER_URL=
   # OLD_VTIGER_USERNAME=
   # OLD_VTIGER_API_KEY=
   ```

2. Simply-CRM vil automatisk blive sprunget over og der vises kun:
   - vTiger Cloud subscriptions ✅
   - BMC Office subscriptions ✅

## Test After Setup

```bash
# Test med en kunde
curl http://localhost:8001/api/v1/customers/327/subscriptions | jq '.sales_orders | length'

# Check logs
docker logs bmc-hub-api --tail=30 | grep -i simply
```

## Hvad henter Simply-CRM?

Koden henter **kun salgsordre med `recurring_frequency`** - altså abonnementer:

```sql
SELECT * FROM SalesOrder 
WHERE account_id='<kunde_id>' 
AND recurring_frequency IS NOT NULL
AND sostatus NOT IN ('closed', 'cancelled')
```

For hver ordre:
- Henter line items (produkter)
- Grupperer efter ordre ID
- Viser i "Salgsordre" sektionen på kunde-siden

## Hvorfor er det vigtigt?

Uden Simply-CRM credentials kan I ikke se:
- Gamle abonnementer oprettet før cloud migrationen
- Historiske recurring orders
- Kunder der stadig har aktive ordrer i det gamle system

**Men** I kan stadig se:
- ✅ vTiger Cloud subscriptions
- ✅ BMC Office subscriptions
- ✅ Nye vTiger Cloud sales orders

## Current Status

```
✅ vTiger Cloud - Virker (2 subscriptions for Maskinsikkerhed)
✅ BMC Office - Virker (16 subscriptions for Maskinsikkerhed)
⚠️ Simply-CRM - Mangler credentials
```

## Troubleshooting

### "Simply-CRM credentials not configured"
→ Tilføj OLD_VTIGER_* settings til `.env` og genstart

### "Not logged in to Simply-CRM"
→ Access key er forkert eller expired

### "No Simply-CRM account found for 'Kunde Navn'"
→ Kundens navn matcher ikke præcist mellem systemer (vTiger Cloud vs Simply-CRM)

### Server timeout
→ Check at `http://crm.bmcnetworks.dk` er tilgængelig fra Docker containeren