Rajaa Tisma-asiakasrekisterin tehtävä

Tisma-integraation customers_api-taulu on ERP-koodien ja Tismasta tuotujen asiakastietojen paikallinen rekisteri. Se ei ole sama asia kuin AI Commercen varsinainen asiakastili. Tisma-tuonti lisää, muuttaa tai poistaa tästä integraatiorekisteristä rivin, ja vienti käyttää rekisterin asiakaskoodi-arvoa paikallisen asiakkaan sekä tilauksen kohdistamiseen.

Ota virrat käyttöön vain, kun Tisma: synkronoi asiakkaat ja Tisma: synkronoi tilaukset vastaavat hyväksyttyä omistajuutta. Päätä erikseen, saako kuluttajia viedä, luodaanko puuttuva asiakas automaattisesti, millä tiedoilla yritys kohdistetaan ja mitä tilauksen asiakaskoodia käytetään ilman pysyvää Tisma-linkkiä. Nämä valinnat ovat nykyisessä toteutuksessa ympäristökohtaisia.

Älä käsittele integraatiorekisteriä asiakasrekisterin täydellisenä peilinä. Tuonti ottaa vastaan vain customers_api-taulussa olemassa olevat sarakkeet, ja vienti muodostaa rajatun XML-sanoman. Ennen käyttöönottoa nimeä kummankin kentän omistaja, säilytys, poistovaikutus ja ristiriidan ratkaisu.

Käsittele Tismasta saapuva asiakas-XML

Tisman asiakas-sanomasta luetaan asiakaskoodi ja toimintoattribuutti lismuu. Toiminnot ovat L eli lisää, M eli muuta ja P eli poista. Sanoman muut elementit hyväksytään vain, jos saman niminen sarake kuuluu customers_api-tauluun. Tunnetut numerokentät muunnetaan pilkusta pisteeseen, tyhjä numerokenttä saa arvon 0 ja ytunnus puhdistetaan pelkiksi numeroiksi.

Toiminnon vaikutus on rajattu:

Lisäys olemassa olevalle koodille, muutos tai poisto puuttuvalle koodille sekä tuntematon lismuu tallennetaan Tisma-lokiin. P ei poista AI Commerce -asiakastiliä, tilausta tai muuta asiakasdataa; se poistaa vain Tisma-kytkennän integraatiorekisteristä. Tarkista poistojen vaikutus tuleviin tilauksiin ennen aineiston käsittelyä.

Tisma-tuonti käsittelee yhdellä pyynnöllä enintään 100 XML-tiedostoa aakkosjärjestyksessä. XML luetaan ISO-8859-15-merkistöllä, onnistunut tai käsitelty lähtötiedosto siivotaan ja virheellinen aineisto kopioidaan virhekansioon. Seuraa käsiteltyjen, hylättyjen ja jonoon jääneiden tiedostojen määriä; yksittäinen lokimerkintä ei yksin todista rekisterin täsmäystä.

Muodosta AI Commerce -asiakkaan vienti

AI Commerce -asiakkaan Tisma-vienti pysähtyy, jos paikallinen asiakastunniste puuttuu. Ympäristökohtainen sääntö voi lisäksi estää kuluttajan viennin. Jos pysyvää Tisma-koodia ei ole, toteutus yrittää kohdistaa asiakkaan customers_api-rekisteriin. Joissakin ympäristöissä yritys haetaan sähköpostin ja numeroiksi puhdistetun Y-tunnuksen yhdistelmällä; muissa käytetään yleistä ERP-kohdistusta.

Jos pysyvä koodi löytyy, se tallennetaan paikallisen asiakkaan ERP-linkiksi. Jos automaattinen luonti ei ole sallittu eikä koodia löydy, asiakasryhmätieto päivitetään mutta XML-tiedostoa ei luoda. XML-vienti tehdään vain uudelle asiakkaalle tai verkkokaupan väliaikaisella V-koodilla olevalle asiakkaalle. Pysyvällä muulla Tisma-koodilla linkitetyn asiakkaan tavallinen muutos ei nykyisessä toteutuksessa tee uutta asiakas-XML:ää.

Uuden asiakkaan XML käyttää tiedostonimeä asiakas-<customers_id>.xml, asiakaskoodia V{customers_id} ja toimintoa lismuu="L". Väliaikaisella koodilla jo oleva asiakas käyttää samaa koodia ja toimintoa M. Sanomaan sisältyvät tilanteen mukaan nimi, toinen nimi, kahdelle riville jaettu katuosoite, postinumero ja kaupunki, maakoodi, Y-tunnus, puhelin, sähköposti, asiakasryhmä, myyjä, kielikoodi, hakuavain ja käsittelijä.

XML tallennetaan Tisma-viennin ympäristökohtaiseen hakemistoon ISO-8859-15-merkistössä. Integraatioagentin tai muun siirtokerroksen pitää siirtää tiedosto Tismaan; pelkkä paikallisen XML:n syntyminen ei todista vastaanottoa, hyväksyntää tai Tisman asiakaskortin muodostumista.

Ratkaise tilauksen Tisma-asiakaskoodi

Tisma-tilaus-XML sisältää erikseen toimitus_kdi- ja asiakaskoodi-arvot. Oletuspolulla pysyvä customerApiId voittaa. Jos sitä ei ole, ympäristökohtainen kuluttajakoodi tai muu varakoodi voi tulla käyttöön; viimeisenä vaihtoehtona muodostetaan V{customerId}. Siksi sama väliaikainen V-koodi ei ole kaikkien Tisma-ympäristöjen ainoa sääntö.

Yhdessä nykyisessä ympäristöpolitiikassa Nets-maksukoodi käyttää aina V{customerId}-arvoa, laskumaksu käyttää customerApiBillingId-arvoa sen ollessa saatavilla ja muut maksut käyttävät tavallista ERP-linkkiä tai väliaikaista koodia. Toisessa ympäristössä kuluttaja- ja yritystilauksille käytetään Suomen ja ulkomaan mukaan koodeja WEB001, WEB001E, WEB999 tai WEB999E. Älä kopioi näitä sääntöjä tenantista toiseen.

Tilauksen asiakastiedot eivät siirrä automaattisesti kaikkia asiakasrekisterin alennuksia, maksuehtoja, kieliä tai ryhmiä. Tilaus-XML muodostaa maksuehdon, valuutan, Y-tunnuksen, maan, yhteystiedot ja toimitustiedot omilla ratkaisimillaan. Asiakaskohtainen hinnoittelu tai muu Tisma-käytös riippuu siitä, mihin asiakaskoodiin tilaus lopulta kohdistuu.

Täsmäytä tuonti, vienti ja tilaus

Testaa Tisma-asiakassynkronointi vähintään lisäys-, muutos-, poisto- ja tuntematon toiminto -sanomilla. Tarkista jokaisesta customers_api-rivi, alkuperäinen XML, käsittelyloki ja se, ettei varsinainen AI Commerce -asiakastili muuttunut odottamatta. Testaa tyhjät numerokentät, pilkkudesimaali, Y-tunnuksen puhdistus, tuntematon sarake ja jo olemassa oleva asiakaskoodi.

Testaa viennissä erikseen uusi kuluttaja, uusi yritys, olemassa oleva pysyvä Tisma-koodi, väliaikainen V-koodi, automaattisen luonnin esto sekä yrityksen sähköposti–Y-tunnus-kohdistus. Tarkista muodostunut asiakas-<id>.xml, merkistö, lismuu, asiakaskoodi, osoitteen katkaisu, maa, kieli, ryhmä ja myyjä. Varmista siirtokerroksesta vastaanotto ja Tismasta lopullinen asiakaskoodi.

Luo lopuksi tilaukset jokaisella käytössä olevalla maksu- ja asiakastyypillä. Vertaa toimitus_kdi, asiakaskoodi, maksuehto, valuutta, Y-tunnus, toimitusosoite ja Tismaan syntynyt asiakkuus. Uudelleenajo ei saa luoda duplikaattiasiakasta tai kohdistaa tilausta toisen asiakkaan koodille. Keskeytä käyttöönotto, jos pysyvän koodin palautuminen väliaikaisen koodin tilalle tai kuittauksen idempotenssi ei ole todistettu.