# 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='' 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