Skip to main content
Artikkelikoodi näkyy varastoartikkelilla

Inventaario > Varastoartikkelit > [Artikkeli] > Yleiset

Määritelmä

Varastokoodi (myös artikkelikoodi) on tenantin sisällä yksilöllinen merkkijono, joka tunnistaa yhden varastoartikkelin. Varastoartikkelilla on codes-taulukko — siihen voi liittää yhden tai useamman koodin, minkä ansiosta yksi fyysinen artikkeli tukee useita skannausprosesseja samanaikaisesti (sisäinen omaisuuskoodi, painettu viivakoodi, valmistajan sarjanumero).
Vertauskuva: Varastokoodi on artikkelin henkilötunnus — se seuraa fyysistä esinettä koko sen elinkaaren ajan, ja sen kautta jokainen muu TWICEn tietue viittaa siihen.
Useita koodeja artikkelia kohden. TWICEn codes-kenttä on taulukko. Voit liittää samaan varastoartikkeliin valmistajan sarjanumeron, painetun omaisuustarran ja sisäisen koodin ja löytää artikkelin skannaamalla minkä tahansa niistä.

Varastokoodi vs. SKU-koodi

Nämä ovat eri tason tunnisteita. Pyörä B-1 (varastokoodi) on yksi tietty kappale tuotetta BIK-S (SKU-koodi). Kaksikymmentä saman mallin pyörää = kaksikymmentä varastokoodia, jotka osoittavat yhteen SKU-koodiin.

Missä sitä käytetään?

Varastokoodeja käytetään koko TWICEssä:
  • Yksilöivä tunnistaminen — viittaaminen tiettyihin artikkeleihin tilauksissa, raporteissa ja toiminnassa.
  • Viivakoodi- ja QR-skannaus — fyysiset tarrat linkittyvät suoraan digitaaliseen tietueeseen.
  • Joukkokeräily — artikkelien skannaus ulos ja sisään noudossa ja palautuksessa.
  • Datan eheys — yksilöllisyysvaatimus estää päällekkäiset tietueet.
  • API-toiminnot — ohjelmallinen työskentely tiettyjen varastoartikkelien kanssa.
  • Jäljitysketjut — tilaushistoria ja tapahtumalokit viittaavat sillä hetkellä käytössä olleisiin koodeihin.

Keskeiset ominaisuudet

Järjestelmän luomat vs. omat koodit

Koodit voi asettaa kolmella tavalla:

Automaattisesti luotu

Jätä codes pois artikkelia luodessasi. TWICE luo 8-merkkisen satunnaisen tunnuksen (esim. LF93HXB1). Hyvä nopeaan käyttöönottoon, kun tarkoilla arvoilla ei ole väliä.

Käsin syötetty

Anna codes luonnissa tai päivityksessä. Käytä mitä tahansa toimintaasi sopivaa muotoa — lyhyitä omaisuustarroja (B-1), sarjanumeroita (SN-2024-00123) tai sijaintietuliitteellisiä koodeja (HEL-BIK-001). Tarkista ennen tallennusta kutsulla POST /articles/validate-code tai eränä kutsulla POST /articles/validate-codes.

Joukkorekisteröinti kaavalla

Hallinnan Register stock items -dialogissa voit luoda automaattisesti sarjan (B-1, B-2, …, B-N), kun luot useita kappaleita kerralla. Tämä on tavallisin tapa vastaanottaa uusi erä identtisiä kappaleita.

Useita koodeja artikkelia kohden

Yhdellä varastoartikkelilla voi olla useita arvoja codes-taulukossaan. Tämä on tarkoituksellista ja tukee käytännön skannausprosesseja:
  • SKI-001 — sisäinen omaisuustarra, joka on painettu tarraan.
  • SN240501234 — valmistajan sarjanumero, joka on painettu sukseen.
  • 9783161484100 — alkuperäispakkauksen viivakoodi.
Minkä tahansa näistä skannaus johtaa samaan varastoartikkeliin. Kaikki kolme pysyvät synkronissa, joten yhden poistaminen tai korvaaminen ei riko muita.

Koodien muotosäännöt

  • Tyyppi: merkkijono. Pituusrajaa ei valvota; automaattisesti luodun koodin oletuspituus on 8.
  • Merkit: mitkä tahansa tulostuvat merkit. Useimmat pitäytyvät kirjaimissa, numeroissa, väliviivoissa ja alaviivoissa, jotta koodit toimivat tarratulostimissa ja viivakoodinlukijoissa.
  • Yksilöllisyys: tenantin sisällä. Tarkistetaan luonnissa ja päivityksessä.
  • Kirjainkoko: koodit tallennetaan kirjainkoko huomioiden, mutta useimmat skannausprosessit käsittelevät niitä kirjainkoosta riippumatta — valitse yksi käytäntö ja pitäydy siinä.
  • Välilyönnit: poista alku- ja loppuvälilyönnit ennen tallennusta. Sisällä olevat välilyönnit toimivat mutta tekevät skannauksesta epävarmaa.
Hyviä käytäntöjä:

QR-koodit ja viivakoodien skannaus

Varastokoodit on suunniteltu koodattaviksi fyysisiin tarroihin. Yleisiä käyttötapoja:
  • Tulosta vastaanotossa. Kun uutta varastoa saapuu, rekisteröi varastoartikkelit automaattisesti luoduilla tai käsin syötetyillä koodeilla ja tulosta tarrat suoraan hallinnasta.
  • Skannaa noudossa. Työntekijä skannaa artikkelin koodin kohdistaessaan sen vuokratilaukselle — TWICE tarkistaa koodin, löytää artikkelin ja liittää sen tilausriville.
  • Skannaa palautuksessa. Sama skannaus toimii toiseen suuntaan: artikkelit merkitään palautetuiksi ja tila vaihtuu arvosta Out arvoon In.
  • Skannaa haussa. Nopea haku hallinnassa: skannaa koodi ja siirry suoraan artikkelin tietoihin.
Koska codes on taulukko, artikkelin voi skannata kummasta tarrasta tahansa, jos sillä on sekä sisäinen omaisuustarra että valmistajan viivakoodi. Työntekijän ei tarvitse tietää, kumpaa hän katsoo.

Yksilöllisyyden laajuus

Yksilöllisyysvaatimus on tenantkohtainen (TWICE Commerce -tilisi). Kahdella eri tenantilla voi kummallakin olla varastoartikkeli B-1. Tenantin sisällä:
  • Jokaisen artikkelin codes-taulukossa olevan koodin on oltava yksilöllinen kaikkien varastoartikkelien kesken.
  • Tarkistus tehdään palvelimella luonnissa ja päivityksessä articleCodes-taulun avulla.
  • Käytä kutsua POST /articles/validate-code (yksi) tai POST /articles/validate-codes (erä) ennen lähetystä, jotta virhe havaitaan heti selkeästi.

Suhteet

Elinkaari

1

Luonti

Koodit annetaan varastoartikkelin luonnissa.
Jos lähetät codes: ["..."], arvoja käytetään sellaisenaan. Jos jätät codes-kentän pois, TWICE luo 8-merkkisen satunnaisen koodin. Myös Register stock items -joukkodialogi voi luoda sarjan.
Kyllä. POST /articles/validate-code arvolla { code } palauttaa { isUnique }. POST /articles/validate-codes arvolla { codes: [...] } palauttaa listan virheellisistä koodeista ja niiden syyn (existing).
2

Käyttö

Koodit ovat varastoartikkelin arkinen käyttökahva.
Varastoartikkelin tiedoissa, taulukon sarakkeessa, artikkelin sisältävissä tilauksissa, tulostamissasi tarroissa, skannausprosesseissa ja jokaisessa API-vastauksessa, joka sisältää Article-resurssin.
Kyllä. Varastoartikkelitaulukon haku ja hallinnan yleishaku löytävät koodia vastaavan varastoartikkelin. API tukee filters.code-suodatinta täsmälliseen ja osittaiseen hakuun.
3

Muokkaus

Koodeja voi lisätä, poistaa tai korvata.
Muokkaa artikkelia ja lisää arvo codes-taulukkoon tai kutsu PUT /articles/:id uudella täydellä taulukolla. Muutos kirjataan identifiers_changed-tapahtumana, jossa näkyvät edellinen ja uusi taulukko.
Kyllä — korvaa taulukko uudella arvolla. Vanha koodi irrotetaan ja se vapautuu välittömästi käytettäväksi toisella artikkelilla.
Tilausrivit ja reskontramerkinnät viittaavat varastoartikkeliin sen id-kentällä, eivät koodilla. Koodin muuttaminen tai poistaminen ei riko aiempia linkkejä.

Usein kysytyt kysymykset

Kyllä. Koodit eivät ole muuttumattomia — voit lisätä, poistaa tai korvata niitä milloin tahansa. Muutos kirjataan tapahtumalokiin nimellä identifiers_changed. Aiemmat tilaukset ja reskontramerkinnät linkittyvät artikkelin tunnuksella eivätkä koodilla, joten ne pysyvät voimassa.
Ne ovat sama asia. ”Varastokoodi” korostaa varastonseurantaa; ”artikkelikoodi” korostaa, että se tunnistaa tietyn fyysisen artikkelin. API:ssa kenttä on codes resurssilla Article.
Ei — koodit ovat yksilöllisiä kaikkien tenantin varastoartikkelien kesken. Jos yrität luoda tai päivittää päällekkäisellä koodilla, toiminto epäonnistuu ja tarkistuksen syyksi tulee existing.
Kyllä. codes-kenttä on taulukko. Voit liittää samaan varastoartikkeliin sisäisen koodin, valmistajan sarjanumeron ja pakkauksen viivakoodin — minkä tahansa niistä skannaus johtaa kyseiseen artikkeliin.
Sitä, mikä sopii toimintaasi. Useimmat käyttävät kirjaimia ja numeroita väliviivojen tai alaviivojen kanssa, jotta koodit toimivat tarratulostimissa ja viivakoodinlukijoissa. Järjestelmä luo 8-merkkisiä satunnaisia koodeja, kun arvo jätetään antamatta.
Tenantkohtainen. Koodi on yksilöllinen koko tililläsi, ei vain yhden palvelusijainnin sisällä. Kahdella saman TWICE-tenantin sijainnilla ei voi kummallakin olla koodia B-1.

Kehittäjän viitetiedot

Varastokoodeja hallitaan articles-päätepisteillä. Tarkista yksilöllisyys ennen luontia kutsulla validate-code.

API: Articles

Avaa päätepiste API-viitteessä.

Aiheeseen liittyvät käsitteet

Varastoartikkelit

Tietueet, jotka koodit tunnistavat

SKU:t

SKU-koodi vs. artikkelikoodi

Varastonseuranta

Koodit toimivat eri tavoin sarjanumeroidussa ja yhteisvarastossa