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:

   # 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:

   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:

   # 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

# 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:

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