Kun AICC huolehtii asiakkaiden ja yhteyshenkilöiden (Contact) luomisesta, päivityksestä ja linkityksestä Lemonsoft-ERP:hen, kauppiaan ei tarvitse ylläpitää samoja tietoja kahteen kertaan. Oikeat henkilötiedot näkyvät aina tilausrivillä ja asiakaskortilla, joten laskutus, toimitus ja asiakaspalvelu toimivat sujuvasti.

Synkronoinnin peruslogiikka askel askelmalta

1. Tilaus saapuu AICC:hen
   AICC ottaa talteen tilauksen asiakas- ja kontaktitiedot.
2. Asiakas (Customer) tarkistetaan
   • AICC hakee Lemonsoftista ensin Y-tunnuksella/VAT-numerolla (filter.vat).
   • Ellei osumaa löydy, haku jatkuu yrityksen nimellä (filter.name).
   • Kuluttajat haetaan sähköpostilla (filter.email).
   Ensimmäinen täsmäävä rivi riittää.
   • Jos asiakasta ei ole, AICC luo sen Lemonsoftiin ja tallettaa palautuneen customers_api_id-arvon.
3. Kontakti (Contact) tarkistetaan
   • Haku tehdään ensin sähköpostilla, sitten koko nimellä.
   • Jos kumpikaan ei löydy, AICC luo kontaktin Lemonsoftiin, tallentaa id:n ja palaa tilaukseen.
4. Mahdolliset päivitykset jonoon
   Jo olemassa olevat asiakkaat ja kontaktit päivitetään taustalla (Queue), jotta kauppiaan arki ei hidastu.
5. Tilaus siirtyy ERP:hen
   Lemonsoftin Order-rajapinta ei vielä tue contact_id:tä, joten AICC täyttää kontaktin nimen ja sähköpostin order-payloadiin (taulukko 2).
    

Keskeiset kentät ja niiden vastinparit

Mitä kontaktihenkilön kenttiä AICC lähettää tilaukselle?

Reunatapaukset & suositukset

• Duplikaatit: VAT-haku minimoi, mutta historiassa voi olla päällekkäisiä asiakkaita – sulauttaminen Lemonsoftissa.
• Tuleva parannus: Kun Lemonsoft lisää contact_id:n tilausrajapintaan, tuki lisätään AICC:n OrderRepository::getOrderParams()-metodiin.

Yhteenveto – seuraavat askeleet

Kun yllä olevat asetukset on tarkistettu ja testi onnistuu, voit luottaa siihen, että AI Commerce Cloud pitää Lemonsoft-asiakastietosi ajan tasalla jokaisen tilauksen yhteydessä.

Tekninen taustatieto

+-------------+            +-----------------+            +--------------+
| AICC (DB)    | --HTTP-->  | Lemonsoft API   | <--HTTP--  | Lemonsoft UI |
+-------------+            +-----------------+            +--------------+

sequenceDiagram
AICC→>Lemonsoft: GET /api/contacts/{customer_id}?filter.email={email}
Lemonsoft-->>AICC: 200 OK results[]
AICC->>AICC: if result → käytä contact_id
AICC→>Lemonsoft: (fallback) GET /api/contacts/{customer_id}
AICC->>AICC: loop & vertaa name → contact_id
AICC->>Lemonsoft: (ei löytynyt) POST /api/contacts/{customer_id}

JSON-esimerkki kontaktin luontiin:
{
  "id": 0,
  "customer_id": <customer_id>,
  "name": "Etunimi Sukunimi",
  "email": "user@firma.fi",
  "gsm": "+358…"
}