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.