Zoho CRM Systemdokumentation

Trigger: Når feltet CVR/VAT Nr. ændres.
Formål: Slår virksomhedsdata op via CVR API og udfylder felter automatisk i realtid.

Logik

1. Hvis værdien er 8 cifre eller starter med "DK": Dansk CVR-opslag med fuld data (stamdata, finans, adresse)
2. Hvis værdien starter med 2 bogstaver (ikke DK): EU VIES-opslag med basisdata (navn, adresse)
3. Ellers: Vis fejlbesked til brugeren

Felter der udfyldes (dansk CVR)

Telefon, Hjemmeside, Selskabstype, Branchekode, Branchetekst, Medarbejdere, P-nummer, Virksomheds Status, Gade, Postnummer, By, Land, Regnskabsdata fra år, Bruttofortjeneste, Årets resultat, Egenkapital, Statusbalance, Seneste Regnskab

// Eksempel: CVR-opslag og feltmapping
var cvr = ZDK.Apps.CRM.Connections.invoke(
    "cvrintegration",
    "http://api.cvrintegration.dk/fetchdata?query=" + value,
    "GET", 1, {}, {}
);
// Udfyld felter
phone_field.setValue(phone);
website_field.setValue(website);
company_type_field.setValue(company_type);
// ... osv.

Trigger: Når redigeringssiden indlæses.
Formål: Gør CVR-feltet skrivebeskyttet hvis det allerede har en værdi, så det ikke kan ændres.

var cvr_field = ZDK.Page.getField("CVR_VAT_Nr");
var cvr_field_value = cvr_field.getValue();
if (cvr_field_value != null) {
    cvr_field.setReadOnly(true);
}

Trigger: Når redigeringssiden indlæses ELLER når Kæde-feltet ændres.
Formål: Hvis den tilknyttede kæde har Benyt Kæde Bonus = "Ja", låses Bonussats og Vederlagssats så de ikke kan redigeres manuelt.

var chain_field = ZDK.Page.getField("K_de");
if (chain_field && chain_field.getValue()) {
    var lookupId = chain_field.getValue().id;
    if (lookupId) {
        var chain_record = ZDK.Apps.CRM.Chains.fetchById(lookupId);
        if (chain_record.Benyt_K_de_Bonus == "Ja") {
            ZDK.Page.getField("Bonussats").setReadOnly(true);
            ZDK.Page.getField("Vederlagssats").setReadOnly(true);
        }
    }
}

Trigger: Når bruger åbner detalje- eller redigeringssiden for en kæde med status "Lukket".
Formål: Viser en advarselsdialog om at alle partnere i kæden vil blive deaktiveret.

var chain_status_field = ZDK.Page.getField("Type");
var chain_status_value = chain_status_field ? chain_status_field.getValue() : null;

if (chain_status_value === "Lukket") {
    ZDK.Client.showConfirmation(
        "Vær opmærksom: Dette vil deaktivere alle partnere i denne kæde. " +
        "Fjern først de partnere, som ikke skal deaktiveres.",
        "Forstået", "Fortryd",
        function(confirmed) { /* ... */ }
    );
}

Formål: Forhindrer kloning af kæder. Klon-knappen deaktiveres på detaljesiden, og på klon-siden deaktiveres både Gem og Gem-og-ny knapperne.

// Detalje-side: Deaktiver klon-knap
var save_btn = ZDK.Page.getButton('clone');
save_btn.disable();

// Klon-side: Deaktiver gem-knapper
var save_btn = ZDK.Page.getButton('record_save');
var other_save_btn = ZDK.Page.getButton('record_save_and_new');
other_save_btn.disable();
save_btn.disable();

Betingelse: CVR/VAT Nr. ændret til ikke-tom værdi.
Handling: Custom Function - identisk logik som ved oprettelse.

Betingelse: Harmoninr, CVR/VAT Nr., Kort Nummer eller Cpr ændres.
Handling: Custom Function

Funktionalitet: Synkroniserer CVR, Website og Ownership fra partneren til alle tilknyttede kontakter. Sætter synkroniseringsfelterne på kontakterne.

void automation.updatePartnerContactFields(Int partner_id) {
    account = zoho.crm.getRecordById("Partnere", partner_id);
    cvr = account.get("CVR_VAT_Nr");
    website = account.get("Website");
    if (website == null) { website = account.get("Kerne_Website"); }

    mp = Map();
    if (cvr != null) { mp.put("CVR_VAT_Nr", cvr); mp.put("Show_Fields", true); }
    if (website != null) { mp.put("Websted_1", website); mp.put("Show_Website", true); }

    related_contact_list = zoho.crm.getRelatedRecords("Contacts2", "Partnere", partner_id);
    for each contact in related_contact_list {
        zoho.crm.updateRecord("Contacts", contact.get("id"), mp);
    }
}

Betingelse: Status ændret til "Aktiv", Internal Merchant ID er TOM.
Handlinger:

• Custom Function: Opret partner i LS
• Custom Function: Opret kunde i Business Central (POST)
• Planlagt handling: Sæt Partnernummer (2 min. efter, sætter Partnernummer = record ID)

Betingelse: Status = "Aktiv", Internal Merchant ID er IKKE TOM, Kommunenummer ≠ 1 (tag).
Handling: Custom Function (Opdater Partner i LS)

Funktionalitet (change detection):

1. Hent Old Record Data (snapshot fra sidste sync)
2. Hent aktuelle data fra CRM-recorden
3. Sammenlign felt for felt - kun ændrede felter sendes
4. Særregel: Hvis Visa CAID, Visa BIN eller MC MID ændres, sendes alle tre
5. PATCH til LS med kun ændrede felter
6. Ved succes: Opdater Old Record Data med nye værdier
7. Ved fejl: Gem fejlrespons i LS Error Data

Betingelse: Loyalty Solutions Fejlbesked ændret til ikke-tom.
Handling: Custom Function

Funktionalitet: Sender fejlbeskeden til OpenAI GPT-5 med en dansk prompt der beder om en brugervenlig oversættelse (maks 255 tegn). Resultatet gemmes i Chat Message.

Regel 6: Kæde ændret til ikke-tom -> Faktureres gennem sættes til "Kæde"
Regel 7: Kæde ændret til tom -> Faktureres gennem sættes til "Selvstændigt"

Betingelse: Status ændret til "Lukket", Ophør(Afviklet/Opsagt) = "Opsagt".
Handling: Opretter en Opgave:

Betingelse: Debitor Nummer er IKKE TOM.
Handling: Custom Function (Synkroniser til BC)

Funktionalitet: Synkroniserer partnerdata til Business Central via SMART API. Mapper CRM-felter til BC Customer-felter og sender PUT-request. Adresserne hentes i prioriteret rækkefølge: Adresse 3 -> Adresse 2 -> Adresse 1.

Betingelse: Skift Bonussats Dato er IKKE NULL, Tidspunkt: på dato.
Handling: Custom Function

Funktionalitet: Henter Ny Bonussats, sender PATCH til LS med den nye sats, og rydder planlægningsfelterne.

void automation.skiftBonussats(Int partner_id) {
    partner_response = zoho.crm.getRecordById("Partnere", partner_id);
    crm_new_bonus = partner_response.get("Ny_Bonussats");
    new_bonus = crm_new_bonus.remove("%").replaceAll(",", ".");
    mp = Map();
    mp.put("rewardRate", new_bonus);
    internal_merchant_id = partner_response.get("internal_Merchant_ID");
    ls_response = invokeurl
    [
        url: "https://fbf-loyaltfacts-api.loyaltfacts.com/merchants/" + internal_merchant_id
        type: PATCH
        parameters: mp
        connection: "loyalty solutions"
    ];
    // Ryd planlægningsfelter og opdater aktuel sats:
    quick_mp = Map();
    quick_mp.put("Ny_Bonussats", null);
    quick_mp.put("Bonussats", crm_new_bonus);
    quick_mp.put("Skift_Bonussats_Dato", null);
    zoho.crm.updateRecord("Partnere", partner_id, quick_mp);
}

Betingelse: Skift Vederlagssats Dato er IKKE NULL, Tidspunkt: på dato.
Handling: Custom Function - identisk logik som bonussats, men med vederlagssatsen.

Betingelse: Status ændres.
Handling: Custom Function (Opdater Partnere)

Funktionalitet: Når en kædes status ændres, kaskaderes statusændringen til alle tilknyttede partnere.

void automation.opdaterPartnere(Int chain_id) {
    chain_response = zoho.crm.getRecordById("Chains", chain_id);
    chain_status = chain_response.get("Type");
    partner_list = zoho.crm.getRelatedRecords("Partnere", "Chains", chain_id);
    mp = Map();
    mp.put("Partner_Status", chain_status);
    for each partner in partner_list {
        zoho.crm.updateRecord("Partnere", partner.get("id"), mp);
    }
}

Betingelse: Status ændret, Internal Chain ID er TOM, status ≠ "Lukket".
Handlinger: Identisk med oprettelses-reglen (inkl. BC POST).

Betingelse: Status = "Aktiv", felter ændret.
Handling: Custom Function (Opdater Kæde i LS)

Funktionalitet: Identisk change-detection logik som partnere. Sammenligner Old Record Data med aktuelle værdier og sender kun ændringer via PATCH.

Betingelse: Type ændret til "Lukket".
Handling: Feltopdatering - sætter Is Closed til True

Betingelse: Status ændret til "Lukket", Ophør(Afviklet/Opsagt) = "Opsagt".
Handling: Opretter Opgave: "Sæt kæde til inaktiv i LS" med forfald = Udløsningsdato + 3 dage, prioritet Højeste.

Betingelse: Debitor Nummer er IKKE TOM.
Handling: Custom Function (Synkroniser Kæde til BC)

Identisk logik som Partner BC-sync, men mapper fra Kæde-felter.

Betingelse: Skift Bonussats Dato er IKKE NULL, Tidspunkt: på dato.
Handling: Custom Function - sender PATCH med ny bonussats til LS for kæden.

Betingelse: Skift Vederlagssats Dato er IKKE NULL, Tidspunkt: på dato.
Handling: Custom Function - sender PATCH med ny vederlagssats til LS for kæden.

Betingelse: CVR/VAT Nr. ændret til ikke-tom værdi.
Handling: Identisk logik som ved oprettelse.

Betingelse: Organisations Status ændret til "Godkendt Partner".
Handling: Custom Function (Aktiver Partner)

void automation.aktiverPartner(Int account_id) {
    account_response = zoho.crm.getRecordById("Accounts", account_id);
    partner_number = account_response.get("Partner_nummer");
    mp = Map();
    mp.put("businessId", partner_number);
}

Betingelse: CVR/VAT Nr. eller Harmoninr ændres.
Handling: Custom Function (Opdater Kontakt Felter)

Funktionalitet: Synkroniserer CVR og Website fra organisationen til alle tilknyttede kontakter. Sætter visibility-flags.

void automation.updateContactFields(String account_id) {
    account = zoho.crm.getRecordById("Accounts", account_id);
    cvr = account.get("CVR_VAT_Nr");
    website = account.get("Website");

    mp = Map();
    if (cvr != null) { mp.put("CVR_VAT_Nr", cvr); mp.put("Show_Fields", true); }
    if (website != null) { mp.put("Websted_1", website); mp.put("Show_Website", true); }

    contacts = zoho.crm.searchRecords("Contacts",
        "(Account_Name:equals:" + account.get("Account_Name") + ")");
    for each contact in contacts {
        zoho.crm.updateRecord("Contacts", contact.get("id"), mp);
    }
}

Betingelse: Fusioneres sammen med ændret til ikke-tom værdi.
Handling: Custom Function (Organisations Fusionering)

Funktionalitet: Overfører alle kontakter fra den aktuelle organisation til målorganisationen.

void automation.organisationsFusionering(Int org_id) {
    org_response = zoho.crm.getRecordById("Accounts", org_id);
    new_org_id = org_response.get("Fusioneres_sammen_med").get("id");
    // Transfer contacts
    contact_list = zoho.crm.getRelatedRecords("Contacts", "Accounts", org_id);
    for each contact in contact_list {
        zoho.crm.updateRecord("Contacts", contact.get("id"),
            {"Account_Name": new_org_id});
    }
}