TalkAndPick Connector - Käyttöohjeet

1. Yleiskatsaus

TalkAndPick Connector on Fellowmind Finlandin kehittämä Business Central -laajennus, joka yhdistää Microsoft Dynamics 365 Business Centralin Devoca Talk and Pick -puheohjatuun keräilyratkaisuun. Laajennus mahdollistaa varastohenkilöstön keräily- ja hyllytystoimintojen suorittamisen puheohjattujen ohjeiden avulla, korvaten manuaaliset paperi- tai lukijapohjaisten työnkulut.

Mikä on Devoca Talk and Pick?

Devoca Talk and Pick on puheohjattu varastonhallintaratkaisu. Varastotyöntekijät käyttävät kuulokkeita ja saavat puhuttuja ohjeita, jotka opastavat heitä keräily- ja hyllytystehtävissä — kertoen minne mennä, mitä kerätä ja kuinka paljon kerätä. Työntekijät vahvistavat toiminnot puheella, jolloin kädet ja silmät jäävät vapaaksi itse tehtävään. Tämä johtaa nopeampaan, tarkempaan ja turvallisempaan varastotyöskentelyyn.

Mitä Connector tekee?

TalkAndPick Connector yhdistää Business Centralin ja Devoca-järjestelmän seuraavasti:

Keräily- ja hyllytystehtävien luominen Business Centralin lähdeasiakirjoista (myyntitilaukset, ostotilaukset, varastotoimintoasiakirjat) ja niiden lähettäminen Devocaan puheohjattua suorittamista varten.
Nimiketietojen synkronointi Devocaan, jotta tuotetiedot ovat käytettävissä varastotoimintojen aikana.
Tilapäivitysten ja tulosten vastaanottaminen Devocasta takaisin Business Centraliin, mukaan lukien kerätyt määrät, tehtävien tilat ja sarja-/eränumeroiden vahvistukset.
Nimikeseurannan hallinta validoimalla ja varaamalla varastokeräilyssä raportoidut sarjanumerot suoraan Business Centralin varausjärjestelmässä.

Keskeiset ominaisuudet

Ominaisuus	Kuvaus
Keräilytehtävien luominen	Luo keräilytehtävät myyntitilauksista, ryhmiteltynä sijainnin mukaan. Jokainen tehtävä sisältää keräilyyn tarvittavat nimikkeet, määrät, varastopaikat ja nimikeseurantatiedot.
Hyllytystehtävien luominen	Luo hyllytystehtävät ostotilauksista puheohjatulle vastaanotolle ja hyllytykselle.
Nimikesynkronointi	Synkronoi nimiketiedot (tuotekoodi, kuvaus, paino, tilavuus) Devocaan, jotta tuotteet tunnistetaan varastotoimintojen aikana.
Sarjanumeroseuranta	Sarjanumeroseuratut nimikkeet jaetaan automaattisesti yksittäisille riveille. Varastossa kerätyt sarjanumerot validoidaan ja varataan Business Centralissa reaaliajassa.
Jäljellä olevan määrän käsittely	Järjestelmä seuraa aktiivisiin keräilytehtäviin jo sitoutettuja määriä estäen päällekkäiset keräilyt ja varmistaen, että vain jäljellä oleva määrä lähetetään Devocaan.
Tilaseuranta	Tehtävien koko elinkaaren seuranta luomisesta lähettämisen, suorittamisen ja valmistumisen kautta, tilapäivitysten kulkiessa molempien järjestelmien välillä.
Sijaintikohtainen konfigurointi	Puhekeräily otetaan käyttöön sijaintikohtaisesti, ja jokainen sijainti yhdistetään Devoca-varastokoodiin. Validointi varmistaa, että sijainnit on määritetty oikein ennen tehtävien luomista.

Toimintaperiaate

Integraatio noudattaa selkeää kulkua:

Asennus — Määritä yhteys Devoca-rajapintaan (URL ja tunnukset) ja ota puhekeräily käyttöön asianmukaisissa varastosijainneissa.
Nimikesynkronointi — Synkronoi nimikkeet Devocaan, jotta järjestelmä tunnistaa tuotteesi. Tämä tehdään automaattisesti keräilytehtävän luonnin yhteydessä, mutta voidaan suorittaa myös manuaalisesti.
Tehtävän luominen — Luo keräily- tai hyllytystehtäviä lähdeasiakirjoista Business Centralissa. Connector validoi sijainnit, ryhmittelee rivit, käsittelee nimikeseurannan ja rakentaa tehtävärakenteen.
Lähetys Devocaan — Tehtävät lähetetään Devoca-rajapintaan rakenteisina JSON-sanomina. Devoca jakaa ne varastotyöntekijöille puheohjeiden muodossa.
Suoritus — Varastotyöntekijät suorittavat tehtävät puhekomennoin. Devoca seuraa edistymistä ja tuloksia.
Tila ja tulokset — Devoca lähettää tilapäivitykset ja kerätyt määrät takaisin Business Centraliin saapuvien rajapintapäätepisteiden kautta pitäen BC-asiakirjat synkronoituna varaston todellisen tilanteen kanssa.

Tuetut lähdeasiakirjat

Asiakirja	Tehtävätyyppi	Tila
Myyntitilaus	Keräilytehtävä	Tuettu (v1.0)
Ostotilaus	Hyllytystehtävä	Tuettu (v1.0)
Varastokeräily	Keräilytehtävä	Tuettu (v1.0)
Varastohyllytys	Hyllytystehtävä	Tuettu (v1.0)
Siirtotilaus	Keräilytehtävä	Suunnitteilla
Kokoonpanotilaus	Keräilytehtävä	Suunnitteilla

2. Asennus

Ennen TalkAndPick Connectorin käyttöä sinun tulee määrittää yhteys Devocaan, asettaa numerosarjat, konfiguroida varastosijainnit ja synkronoida nimikkeet.

2.1 Talk&Pick-asetussivu

Avaa Talk&Pick Setup -sivu Business Centralin hakupalkista. Tämä on connectorin keskitetty asetussivu.

Yhteysasetukset

Kenttä	Kuvaus
Name	Kuvaileva nimi yhteydelle (esim. "Tuotanto" tai "Testi").
Connection URL	Devoca-rajapinnan osoite. Esimerkki: `https://test2-api.devoca.fi:3001/api/`
Username	Käyttäjätunnus Devoca-rajapinnan todennukseen.
Password	Salasana Devoca-rajapinnan todennukseen. Arvo on peitetty turvallisuussyistä.

Yhteysparametrit (URL ja tunnukset) saat Devocalta.

Kaikki yhteyskenttät (URL, Username, Password) tulee olla täytettynä ennen kuin mitään toimintoja voidaan suorittaa. Jos asetukset ovat puutteelliset, järjestelmä näyttää virheilmoituksen: "Connection setup is missing or incomplete. Please fill in the connection details in the Talk&Pick Setup page before proceeding."

Asetukset

Kenttä	Kuvaus
Register Picks on completion	Kun käytössä, varastokeräilyt rekisteröidään automaattisesti Business Centralissa, kun varastokeräily merkitään valmistuneeksi.

Numerointi

Kenttä	Kuvaus
Pick Task Nos.	Keräilytehtävien asiakirjanumeroiden numerosarja.
Putaway Task Nos.	Hyllytystehtävien asiakirjanumeroiden numerosarja.

Molemmille numerosarjoille tulee olla käytettävissä olevia numeroita ennen kuin keräily- tai hyllytystehtäviä voidaan luoda.

Yhteyden testaus

Käytä Test connection -toimintoa asetussivulla varmistaaksesi, että yhteys Devocaan toimii oikein määritetyillä tunnuksilla.

2.2 Sijaintien konfigurointi

Jokainen puhekeräilyä käyttävä varastosijainti tulee konfiguroida erikseen. Avaa kyseisen sijainnin Location Card.

Talk & Pick -ryhmä

Sijaintikorttiin on lisätty uusi Talk & Pick -ryhmä seuraavilla kentillä:

Kenttä	Kuvaus
Voice Pick Location	Ota käyttöön merkitäksesi sijainnin puhekeräilysijainnniksi. Tämän tulee olla päällä ennen kuin keräily- tai hyllytystehtäviä voidaan luoda sijainnille.
Warehouse Code	Sijainnille määritetty Devoca-varastokoodi. Kenttä on muokattavissa vain kun Voice Pick Location on käytössä. Koodin tulee vastata Devocan järjestelmässä konfiguroitua varastokoodia.

Käytettävissä olevat varastokoodit Devocasta näet käyttämällä Show possible warehouse codes -toimintoa sijaintikortin Talk & Pick -toimintoryhmässä. Tämä vaatii valmiin yhteysasetuksen (edellinen osio).

Sijaintivaatimukset

Connector noudattaa seuraavia sääntöjä sijainneille:

Keräilytehtäville (myyntitilaukset): - Sijainnilla tulee olla Voice Pick Location käytössä. - Sijainnilla tulee olla Warehouse Code määritettynä. - Sijainnilla ei saa olla Require Shipment käytössä. Jos varastotoimitus vaaditaan, käytä sen sijaan standardia varastokeräily-integraatiota.

Hyllytystehtäville (ostotilaukset): - Sijainnilla tulee olla Voice Pick Location käytössä. - Sijainnilla tulee olla Warehouse Code määritettynä. - Sijainnilla ei saa olla Require Receive käytössä. Jos varastovastaanotto vaaditaan, käytä sen sijaan standardia varastohyllytys-integraatiota.

Jos mikä tahansa näistä ehdoista ei täyty, järjestelmä näyttää kuvaavan virheilmoituksen ja linkin sijaintikortin avaamiseen korjausta varten.

2.3 Nimikesynkronointi

Nimikkeet tulee synkronoida Devocaan ennen kuin niitä voidaan sisällyttää keräily- tai hyllytystehtäviin. Synkronointi lähettää nimikkeen tuotekoodin, kuvauksen, painon ja tilavuuden Devocaan.

Huomio: Nimikkeet synkronoidaan myös automaattisesti keräilytehtävän luonnin yhteydessä, joten manuaalinen synkronointi on tarpeen vain jos haluat esitäyttää tuotteet Devocaan tai päivittää tuotetietoja.

Nimikkeen manuaalinen synkronointi

Avaa synkronoitavan nimikkeen Item Card.
Etsi Warehouse-osiosta TAP-ryhmä. Ryhmä näyttää nykyisen synkronointitilan.
Napsauta Sync item with Devoca -toimintoa TAP-toimintoryhmässä.
Järjestelmä luo tai päivittää tuotteen Devocassa:
Uusi nimike (ei Devoca Product ID:tä): Luo uuden tuotteen Devocaan rajapinnan kautta ja tallentaa palautetun Product ID:n nimikkeelle.
Olemassa oleva nimike (on Devoca Product ID): Päivittää olemassa olevan tuotteen Devocassa nykyisillä nimiketiedoilla.
Onnistumisesta näytetään vahvistusviesti.

TAP-kentät nimikekortissa

Seuraavat vain luku -kentät näytetään nimikekortin TAP-ryhmässä:

Kenttä	Kuvaus
Synched with Devoca	Ilmaisee, onko nimike synkronoitu onnistuneesti Devocaan.
Devoca Product ID	Devocan antama tuotetunnus. Täytetään automaattisesti synkronoinnin yhteydessä.
Devoca Last Sync	Viimeisimmän onnistuneen synkronoinnin päivämäärä ja aika.

Devocaan lähetettävät tiedot

Business Central -kenttä	Devoca-kenttä
No.	productCode
Description	name
Gross Weight	weight
Unit Volume	volume

2.4 Käyttöoikeusjoukko

Laajennus sisältää TAPAdmin-käyttöoikeusjoukon, joka antaa täydet käyttöoikeudet kaikkiin TalkAndPick Connector -objekteihin, mukaan lukien taulut, sivut, codeunitit ja kyselyt.

Määritä tämä käyttöoikeusjoukko kaikille käyttäjille, jotka tarvitsevat: - Talk&Pick-asetusten konfigurointia - Keräily- ja hyllytystehtävien luomista ja hallintaa - Nimikkeiden synkronointia Devocaan - Tehtävien tilojen ja tulosten tarkastelua

2.5 Asennuksen tarkistuslista

Käytä seuraavaa tarkistuslistaa varmistaaksesi, että connector on täysin konfiguroitu:

[ ] Avaa Talk&Pick Setup -sivu ja syötä Devoca-rajapinnan Connection URL, Username ja Password.
[ ] Käytä Test connection -toimintoa yhteyden toimivuuden varmistamiseen.
[ ] Määritä Pick Task Nos.- ja Putaway Task Nos. -numerosarjat.
[ ] Jokaiselle puhekeräilyä käyttävälle varastosijainnille:
[ ] Ota käyttöön Voice Pick Location sijaintikortissa.
[ ] Syötä Devocan Warehouse Code.
[ ] Varmista, ettei sijainnilla ole Require Shipment (keräilyille) tai Require Receive (hyllytyksille) käytössä.
[ ] Synkronoi tarvittavat nimikkeet Devocaan käyttäen Sync item with Devoca -toimintoa nimikekortissa (tai anna järjestelmän synkronoida automaattisesti tehtävän luonnin yhteydessä).
[ ] Määritä TAPAdmin-käyttöoikeusjoukko käyttäjille, jotka työskentelevät connectorin kanssa.

3. Keräilytehtävät

Keräilytehtäviä käytetään keräilyohjeiden lähettämiseen Business Centralista Devoca Talk and Pick -järjestelmään. Connector tukee kahta tapaa keräilytehtäville: niiden luominen myyntitilauksista (sijainneille ilman edistynyttä varastonhallintaa) ja olemassa olevien varastokeräilyjen lähettäminen (sijainneille, jotka käyttävät standardia BC-varastokeräilytoiminnallisuutta).

3.1 Keräilytehtävät myyntitilauksista

Tämä menetelmä on suunniteltu sijainneille, joissa Require Shipment ei ole käytössä — connector luo omat keräilytehtäväasiakirjansa, jotka ovat riippumattomia standardista varastonhallinnan työnkulusta.

Keräilytehtävän luominen

Avaa myyntitilaus, jonka haluat kerätä.
Varmista, että myyntiriveillä on nimikkeitä, joiden Qty. to Ship on suurempi kuin nolla.
Napsauta Create Pick Task -toimintoa Talk and Pick -toimintoryhmässä.
Järjestelmä suorittaa automaattisesti seuraavat:
Validoi jokaisen sijainnin myyntiriveillä (puhekeräily käytössä, varastokoodi määritetty, varastotoimitus ei vaadita).
Laskee jäljellä olevat määrät vähentämällä aktiivisiin keräilytehtäviin jo sitoutetut määrät.
Ryhmittelee rivit sijainnin mukaan — yksi keräilytehtävä luodaan per sijainti.
Sarjanumeroseuratuille nimikkeille jakaa rivit yksittäisiksi riveiksi, joissa Määrä = 1.
Vahvistusviesti näytetään kertoen kuinka monta tehtävää luotiin ja jätettiinkö sijainteja ohittamatta.

Jäljellä olevan määrän käsittely

Connector estää päällekkäiset keräilyt seuraamalla aktiivisiin keräilytehtäviin jo sitoutettuja määriä. Kun luot keräilytehtäviä, vain jäljellä oleva määrä sisällytetään:

Jäljellä oleva määrä = Qty. to Ship - Määrä aktiivisissa keräilytehtävissä

Aktiivisia keräilytehtäviä ovat ne, joiden tila on Unsent, New, Started, Paused tai Suspended. Valmistuneet ja peruutetut tehtävät eivät sisälly tähän laskentaan.

Esimerkki: - Myyntirivi: Qty. to Ship = 100 - Olemassa oleva aktiivinen keräilytehtävä: Määrä = 60 - Uusi keräilytehtävä luodaan määrällä: 40

Jos kaikki määrät ovat jo katettuna, järjestelmä näyttää: "All quantities on this order are already covered by existing pick tasks."

Keräilytehtävien tarkastelu

Napsauta View Pick Tasks -toimintoa myyntitilauksessa nähdäksesi kaikki tilauksesta luodut keräilytehtävät.
Qty. on Pick Tasks -sarake myyntitilausriveillä näyttää kunkin rivin aktiivisiin keräilytehtäviin sitoutetun kokonaismäärän. Kenttä on vain luku ja päivittyy automaattisesti.

Sarjanumeroseuratut nimikkeet

Luotaessa keräilytehtäviä sarjanumeroseuratuille nimikkeille:

Jokainen yksikkö jaetaan erilliselle keräilytehtäväriville, jonka Määrä = 1.
Esimerkki: Nimike, jonka Qty. to Ship = 5, luo 5 erillistä keräilytehtäväriviä.
Sarjanumerot määritetään keräilyprosessin aikana Devocassa ja raportoidaan takaisin Business Centraliin.
Kun sarjanumero raportoidaan, järjestelmä vahvistaa sen olemassaolon varastossa tehtävän sijainnissa ja ettei sitä ole jo varattu, ja luo sitten varausmerkinnän Business Centraliin välittömästi.

3.2 Keräilytehtäväkortti

Keräilytehtäväkortti-sivu näyttää yksittäisen keräilytehtävän kaikki tiedot.

Yleinen-ryhmä

Kenttä	Kuvaus
Pick Task No.	Yksilöllinen tunniste, määritetään automaattisesti numerosarjasta.
Source Type	Lähdeasiakirjan tyyppi (esim. myyntitilaus).
Source No.	Lähdeasiakirjan numero. Napsauta navigoidaksesi lähdeasiakirjaan.
Location Code	Varastosijainti tälle keräilytehtävälle.
Warehouse Code	Devoca-varastokoodi (vain luku, täytetään sijainnista).

Tehtävän tiedot -ryhmä

Kenttä	Kuvaus
Task Type	Tehtävätyypin koodi, tyypillisesti "PIC" keräilytehtäville.
Assignment Date	Tehtävän luontipäivämäärä (oletus työpäivä).
Assignment Time	Tehtävän luontiaika (oletus nykyinen aika).
Delivery Date	Odotettu valmistumispäivämäärä, johdettu lähdeasiakirjan toimituspäivästä.

Talk and Pick System -ryhmä

Kenttä	Kuvaus
Task ID	Devoca-järjestelmän antama tunniste. Tyhjä kunnes tehtävä on lähetetty.
Devoca Task Status	Tehtävän nykyinen tila Devocassa (katso Tehtävätilat).
Sent Date-Time	Milloin tehtävä lähetettiin Devocaan.
Completed Date-Time	Milloin tehtävä merkittiin valmistuneeksi.
Error Message	Näyttää virhetiedot, jos tehtävässä ilmeni ongelma. Näkyvissä vain kun virhe on olemassa.

Keräilytehtävärivit

Rivien alinäkymä näyttää kaikki kerättävät nimikkeet:

Sarake	Kuvaus
Item No.	Kerättävä nimike.
Description	Nimikkeen kuvaus.
Quantity	Keräilyyn pyydetty määrä.
Quantity Picked	Devocan raportoima todellinen kerätty määrä. Näytetään oranssina, jos ei vastaa pyydettyä määrää (osoittaa vajaakerailua).
Unit of Measure	Yksikön koodi.
Bin Code	Varastopaikan koodi (tarvittaessa).
Lot No.	Eränumero (eräseuratuille nimikkeille).
Serial No.	Sarjanumero (sarjanumeroseuratuille nimikkeille).
Devoca Task Status	Tämän yksittäisen rivin tila.

Toiminnot

Toiminto	Kuvaus
Send to Pick System	Lähettää tehtävän Devocaan. Käytettävissä vain kun tila on Unsent. Onnistuessa tila muuttuu tilaan New ja Task ID täyttyy.
Delete Task	Poistaa tehtävän Devocasta. Edellyttää tehtävän olevan lähetetty (Task ID on oltava olemassa). Poiston jälkeen tila palaa tilaan Unsent ja Task ID tyhjennetään. Vahvistusikkuna näytetään ennen jatkamista.
Post Shipment	Kirjaa toimituksen Business Centralissa. Käytettävissä vain kun tehtävä on Completed-tilassa.
Show Source Document	Avaa lähdemyyntitilauksen.

3.3 Keräilytehtävälista

TAP Pick Tasks -luettelosivu näyttää kaikki keräilytehtävät seuraavilla sarakkeilla:

Sarake	Kuvaus
No.	Keräilytehtävän numero.
Source Type	Lähdeasiakirjan tyyppi.
Source No.	Lähdeasiakirjan numero.
Location Code	Keräilysijainti.
Devoca Task Status	Tehtävän nykyinen tila.
Task ID	Devocan tehtävätunnus.
Assignment Date	Tehtävän luontipäivämäärä.
Sent Date-Time	Milloin lähetetty Devocaan.
Completed Date-Time	Milloin merkitty valmistuneeksi.

Listaa voi suodattaa lähdeasiakirjan, sijainnin, tilan tai päivämäärän mukaan aktiivisten keräilyjen hallintaa varten.

3.4 Keräilytehtävien tilat

Tila	Kuvaus	Aktiivinen?
Unsent	Tehtävä luotu Business Centralissa, mutta ei vielä lähetetty Devocaan.	Kyllä
New	Tehtävä lähetetty Devocaan ja kuitattu vastaanotetuksi.	Kyllä
Started	Varastotyöntekijä on aloittanut tehtävän keräilyn.	Kyllä
Paused	Keräily on tilapäisesti keskeytetty.	Kyllä
Suspended	Tehtävä on keskeytetty, mutta sen odotetaan jatkuvan.	Kyllä
Completed	Kaikki nimikkeet on kerätty ja tehtävä on valmis.	Ei
Cancelled	Tehtävä on peruutettu eikä sitä suoriteta.	Ei

Tilasiirtymät etenevät seuraavasti:

Unsent — Alkutila luonnin jälkeen Business Centralissa.
Unsent → New — Käyttäjä napsauttaa Send to Pick System.
New → Started — Varastotyöntekijä aloittaa keräilyn Devocassa.
Started → Paused — Työntekijä keskeyttää tehtävän (voi jatkaa takaisin Started-tilaan).
Started → Completed — Työntekijä saa kaikki nimikkeet kerättyä.
Mikä tahansa → Cancelled — Tehtävä peruutetaan käyttäjän tai Devoca-järjestelmän toimesta.

Tilat päivittyvät automaattisesti, kun Devoca lähettää päivityksiä saapuvan rajapinnan kautta. Manuaalista toimenpidettä ei tarvita tilamuutosten vastaanottamiseen — ne näkyvät kun päivität tai navigoit keräilytehtävään.

3.5 Keräilytehtävien lähettäminen ja poistaminen

Keräilytehtävän lähettäminen Devocaan

Avaa keräilytehtäväkortti.
Varmista, että rivit ovat oikein (nimikkeet, määrät, sarjanumerot tarvittaessa).
Napsauta Send to Pick System.
Järjestelmä lähettää tehtävän Devoca-rajapintaan JSON-sanomana, joka sisältää varastokoodin, tehtävän tiedot ja kaikki rivinimikkeet.
Nimikkeet, joita ei ole synkronoitu Devocaan, synkronoidaan automaattisesti lähetysprosessin osana.
Onnistuessa Task ID täyttyy ja tila muuttuu tilaan New.

Keräilytehtävän poistaminen Devocasta

Avaa keräilytehtäväkortti.
Napsauta Delete Task.
Vahvista poisto valintaikkunassa.
Järjestelmä lähettää DELETE-pyynnön Devoca-rajapintaan.
Onnistuessa Task ID tyhjennetään ja tila palaa tilaan Unsent. Tehtävä säilyy Business Centralissa ja voidaan lähettää uudelleen tarvittaessa.

3.6 Varastokeräilyt

Sijainneille, jotka käyttävät Require Shipment -asetusta (edistynyt varastonhallinta), connector integroituu standardin Business Central -varastokeräilyasiakirjojen kanssa sen sijaan, että loisi omia keräilytehtäväasiakirjoja.

Toimintaperiaate

Kun varastokeräily luodaan standardin varastotoimitusprosessin kautta, voit lähettää sen Devocaan suoraan varastokeräilysivulta. Järjestelmä lähettää olemassa olevat varastotoimintorivit Devocaan — erillistä keräilytehtäväasiakirjaa ei luoda.

Toiminnot varastokeräilysivulla

Connector lisää Talk'n'Pick-toimintoryhmän varastokeräilysivulle:

Toiminto	Kuvaus
Send Devoca Pick json	Lähettää varastokeräilyn Devocaan uutena tehtävänä. Jos tehtävä on jo lähetetty, näytetään vahvistus uuden tehtävän luomisesta.
Delete Devoca Pick json	Poistaa tehtävän Devocasta ja tyhjentää Task ID- ja tilakentät, mahdollistaen keräilyn uudelleenlähettämisen.
Register Pick	Rekisteröi varastokeräilyn Business Centralissa standardin varastorekisteröintiprosessin mukaisesti.
Test Devoca Pick json	Näyttää JSON-sanoman, joka lähetettäisiin Devocaan, ilman varsinaista lähetystä. Hyödyllinen vianmäärityksessä.

Lisäkentät varastokeräilysivulla

Kenttä	Kuvaus
TAP Task ID	Devocan tehtävätunnus (vain luku). Näytetään otsikko- ja rivitasolla.
TAP Devoca Task Status	Nykyinen Devoca-tila (vain luku). Näytetään otsikko-, rivi- ja luettelonäkymissä.

Varastokeräilyn lähettäminen

Luo varastotoimitus ja sitten varastokeräily standardin Business Central -prosessin mukaisesti.
Avaa varastokeräilykortti.
Napsauta Send Devoca Pick json Talk'n'Pick-toimintoryhmässä.
Järjestelmä validoi sijainnin, generoi JSON-sanoman varastotoimintoriveiltä (vain "Take"-toimintorivit sisällytetään) ja lähettää sen Devocaan.
Onnistuessa TAP Task ID- ja TAP Devoca Task Status -kentät päivittyvät.

Automaattinen rekisteröinti valmistumisen yhteydessä

Jos Register Picks on completion -asetus on käytössä Talk&Pick-asetuksissa, varastokeräily rekisteröidään automaattisesti Business Centralissa, kun Devoca raportoi tehtävän valmistuneeksi. Tämä poistaa tarpeen napsauttaa Register Pick manuaalisesti.

Poistosuojaus

Connector sisältää turvatoimenpiteitä puhekeräilysijaintien varastokeräilyille:

Manuaalisen rekisteröinnin varoitus: Jos yrität rekisteröidä varastokeräilyn manuaalisesti (käyttäen standardia BC-rekisteröintiä) puhekeräilysijainnissa, vahvistusikkuna varoittaa, että keräily tulisi rekisteröidä rajapinnan kautta.
Rivin poistosuojaus: Varastotoimintorivejä ei voida poistaa, kun Devoca-tehtävä on aktiivisesti käynnissä (tila ei ole Unsent, New tai Cancelled). Tehtävä on peruttava ensin.
Otsikon poiston synkronointi: Jos varastokeräilyasiakirja poistetaan Business Centralista Devoca-tehtävän ollessa olemassa, järjestelmä ilmoittaa automaattisesti Devocalle vastaavan tehtävän poistosta.

Erot keräilytehtävien ja varastokeräilyjen välillä

Näkökulma	Keräilytehtävät (myyntitilaukset)	Varastokeräilyt
Lähde	Myyntitilausrivit	Varastotoimintoasiakirjat
Sijaintivaatimus	Require Shipment tulee olla POIS	Require Shipment on PÄÄLLÄ
Asiakirja	Erillinen TAP-keräilytehtäväotsikko/-rivit	Standardi BC:n varastotoimintootsikko/-rivit
Ryhmittely	Yksi tehtävä per sijainti per myyntitilaus	Yksi tehtävä per varastokeräily
Varastopaikat	Ei sisällytetä (ei varastopaikkamääritystä)	Sisällytetään varastopaikkakonfiguraatiosta
Rekisteröinti	Kirjaa toimituksen valmistumisen yhteydessä	Rekisteröi varastokeräilyn valmistumisen yhteydessä
Nimikesynkronointi	Automaattinen lähetyksen yhteydessä	Automaattinen lähetyksen yhteydessä

4. Hyllytystehtävät

Hyllytystehtäviä käytetään vastaanotto- ja hyllytysohjeiden lähettämiseen Business Centralista Devoca Talk and Pick -järjestelmään. Keräilytehtävien tavoin connector tukee hyllytystehtävien luomista ostotilauksista (sijainneille ilman edistynyttä varastonhallintaa) sekä integraatiota standardien varastohyllytysasiakirjojen kanssa.

4.1 Hyllytystehtävät ostotilauksista

Tämä menetelmä hyllytystehtävien luomiseen on suunniteltu sijainneille, joissa Require Receive ei ole käytössä.

Hyllytystehtävän luominen

Avaa ostotilaus, jonka haluat vastaanottaa.
Varmista, että ostoriveil lä on nimikkeitä, joiden Qty. to Receive on suurempi kuin nolla.
Napsauta Create Putaway Task -toimintoa Talk and Pick -toimintoryhmässä.
Järjestelmä suorittaa automaattisesti seuraavat:
Validoi jokaisen sijainnin ostoriveillä (puhekeräily käytössä, varastokoodi määritetty, varastovastaanotto ei vaadita).
Laskee jäljellä olevat määrät vähentämällä aktiivisiin hyllytystehtäviin jo sitoutetut määrät.
Ryhmittelee rivit sijainnin mukaan — yksi hyllytystehtävä luodaan per sijainti.
Sarjanumeroseuratuille nimikkeille jakaa rivit yksittäisiksi riveiksi, joissa Määrä = 1.
Vahvistusviesti näytetään kertoen kuinka monta tehtävää luotiin ja jätettiinkö sijainteja ohittamatta.

Jäljellä olevan määrän käsittely

Connector estää päällekkäiset hyllytykset seuraamalla aktiivisiin hyllytystehtäviin jo sitoutettuja määriä:

Jäljellä oleva määrä = Qty. to Receive - Määrä aktiivisissa hyllytystehtävissä

Aktiivisia hyllytystehtäviä ovat ne, joiden tila ei ole Completed tai Cancelled.

Qty. on Putaway Tasks -sarake ostotilausriveillä näyttää kunkin rivin aktiivisiin hyllytystehtäviin sitoutetun kokonaismäärän. Kenttä on vain luku ja päivittyy automaattisesti.

Jos kaikki määrät ovat jo katettuna, järjestelmä näyttää: "All quantities on this order are already covered by existing putaway tasks."

Hyllytystehtävien tarkastelu

Napsauta View Putaway Tasks -toimintoa ostotilauksessa nähdäksesi kaikki tilauksesta luodut hyllytystehtävät.

Sarjanumeroseuratut nimikkeet

Sarjanumeroseuratut nimikkeet käsitellään samoin kuin keräilytehtävissä — jokainen yksikkö jaetaan erilliselle hyllytystehtäväriville, jonka Määrä = 1. Sarjanumerot määritetään hyllytysprosessin aikana Devocassa ja raportoidaan takaisin Business Centraliin, jossa ne validoidaan ja varataan.

4.2 Hyllytystehtäväkortti

Hyllytystehtäväkortti-sivu näyttää yksittäisen hyllytystehtävän kaikki tiedot.

Yleinen-ryhmä

Kenttä	Kuvaus
No.	Yksilöllinen tunniste, määritetään automaattisesti hyllytystehtävien numerosarjasta.
Source Type	Lähdeasiakirjan tyyppi (esim. ostotilaus).
Source No.	Lähdeasiakirjan numero. Napsauta navigoidaksesi lähdeasiakirjaan.
Location Code	Varastosijainti tälle hyllytystehtävälle.
Warehouse Code	Devoca-varastokoodi (vain luku, täytetään sijainnista).

Tehtävän tiedot -ryhmä

Kenttä	Kuvaus
Task Type	Tehtävätyypin koodi, aina "PUT" hyllytystehtäville.
Assignment Date	Tehtävän luontipäivämäärä.
Assignment Time	Tehtävän luontiaika.
Expected Receipt Date	Odotettu vastaanottopäivämäärä, johdettu ostotilauksesta.

Talk and Pick System -ryhmä

Kenttä	Kuvaus
Task ID	Devoca-järjestelmän antama tunniste. Tyhjä kunnes tehtävä on lähetetty.
Devoca Task Status	Tehtävän nykyinen tila. Värikoodattu: vihreä valmistuneille, keltainen aloitetuille, punainen peruutetuille.
Sent Date-Time	Milloin tehtävä lähetettiin Devocaan.
Completed Date-Time	Milloin tehtävä merkittiin valmistuneeksi.
Error Message	Näyttää virhetiedot, jos tehtävässä ilmeni ongelma. Näkyvissä vain kun virhe on olemassa.

Hyllytystehtävärivit

Rivien alinäkymä näyttää kaikki hyllytettävät nimikkeet:

Sarake	Kuvaus
Item No.	Hyllytettävä nimike.
Description	Nimikkeen kuvaus.
Quantity	Hyllytykseen pyydetty määrä.
Quantity Put Away	Devocan raportoima todellinen hyllytetty määrä. Näytetään oranssina, jos ei vastaa pyydettyä määrää.
Unit of Measure	Yksikön koodi.
Bin Code	Kohdevarastopaikan koodi (tarvittaessa).
Lot No.	Eränumero (eräseuratuille nimikkeille).
Serial No.	Sarjanumero (sarjanumeroseuratuille nimikkeille).
Devoca Task Status	Tämän yksittäisen rivin tila.

Toiminnot

Toiminto	Kuvaus
Send to Putaway System	Lähettää tehtävän Devocaan. Käytettävissä vain kun tila on Unsent.
Delete Task	Poistaa tehtävän Devocasta. Edellyttää tehtävän olevan lähetetty (Task ID on oltava olemassa).
Post Receipt	Kirjaa vastaanoton Business Centralissa. Käytettävissä vain kun tehtävä on Completed-tilassa.
Test Payload	Näyttää JSON-sanoman, joka lähetettäisiin Devocaan, ilman varsinaista lähetystä. Hyödyllinen vianmäärityksessä.
Show Source Document	Avaa lähdeostotilauksen.

4.3 Hyllytystehtävälista

TAP Putaway Tasks -luettelosivu näyttää kaikki hyllytystehtävät seuraavilla sarakkeilla:

Sarake	Kuvaus
No.	Hyllytystehtävän numero.
Source Type	Lähdeasiakirjan tyyppi.
Source No.	Lähdeasiakirjan numero.
Location Code	Hyllytyssijainti.
Devoca Task Status	Tehtävän nykyinen tila.
Task ID	Devocan tehtävätunnus.
Assignment Date	Tehtävän luontipäivämäärä.
Sent Date-Time	Milloin lähetetty Devocaan.
Completed Date-Time	Milloin merkitty valmistuneeksi.

4.4 Hyllytystehtävien tilat

Hyllytystehtävät käyttävät samoja tila-arvoja kuin keräilytehtävät (katso osio 3.4). Elinkaari on identtinen:

Unsent — Tehtävä luotu Business Centralissa.
New — Tehtävä lähetetty Devocaan.
Started — Varastotyöntekijä aloittaa hyllytyksen.
Paused / Suspended — Tehtävä väliaikaisesti pysäytetty.
Completed — Kaikki nimikkeet hyllytetty.
Cancelled — Tehtävä peruutettu.

Kun otsikon tila muuttuu, kaikki rivit päivitetään automaattisesti vastaaviksi.

4.5 Varastohyllytykset

Sijainneille, jotka käyttävät Require Receive -asetusta (edistynyt varastonhallinta), connector integroituu standardien Business Central -varastohyllytysasiakirjojen kanssa.

Toiminnot varastohyllytyssivulla

Connector lisää Talk'n'Pick-toimintoryhmän varastohyllytyssivulle:

Toiminto	Kuvaus
Send Devoca Put-away json	Lähettää varastohyllytyksen Devocaan uutena tehtävänä. Jos jo lähetetty, näytetään vahvistus.
Delete Devoca Put-away json	Poistaa tehtävän Devocasta ja tyhjentää tilakentät.
Test Devoca Put-away json	Näyttää JSON-sanoman ilman lähetystä.

Lisäkentät

TAP Task ID- ja TAP Devoca Task Status -kentät näytetään varastohyllytyskortissa, alinäkymäriveillä ja luettelosivulla tilaseurantaa varten.

Varastohyllytyksen lähettäminen

Luo varastovastaanotto ja sitten varastohyllytys standardin Business Central -prosessin mukaisesti.
Avaa varastohyllytyskortti.
Napsauta Send Devoca Put-away json Talk'n'Pick-toimintoryhmässä.
Järjestelmä validoi sijainnin, generoi JSON-sanoman ja lähettää sen Devocaan.
Onnistuessa TAP Task ID- ja TAP Devoca Task Status -kentät päivittyvät.

4.6 Ostotilauksen kirjausrajoitukset

Connector asettaa kirjausrajoituksia estääkseen ristiriidat hyllytystehtävien ja ostotilauksen kirjauksen välillä:

Kirjaus on estetty kun aktiivisia hyllytystehtäviä on olemassa. Jos yrität kirjata ostotilauksen vastaanoton hyllytystehtävien ollessa vielä kesken (tila ei ole Completed tai Cancelled), järjestelmä näyttää: "There are ongoing TAP put-away tasks that have not been completed or cancelled."
Kirjaus on sallittu kun kaikki tilauksen hyllytystehtävät ovat joko Completed- tai Cancelled-tilassa.
Tehtävien siivous: Kun ostotilaus on kokonaan kirjattu (vastaanotettu ja laskutettu) ja poistettu järjestelmästä, kaikki siihen liittyvät hyllytystehtävät siivotaan automaattisesti.

4.7 Erot keräilytehtäviin

Näkökulma	Keräilytehtävät	Hyllytystehtävät
Lähdeasiakirja	Myyntitilaus	Ostotilaus
Suunta	Lähtevä (toimitus)	Saapuva (vastaanotto)
Sijaintivaatimus	Require Shipment tulee olla POIS	Require Receive tulee olla POIS
Tehtävätyypin koodi	PIC	PUT
Päivämääräkenttä	Delivery Date	Expected Receipt Date
Kirjaustoiminto	Post Shipment	Post Receipt
Kirjausrajoitus	Ei ole	Ostotilauksen kirjaus estetty tehtävien ollessa aktiivisia
Sarjanumerokäsittely	Jaetaan riveille Määrä = 1	Jaetaan riveille Määrä = 1
Sijaintiryhmittely	Yksi tehtävä per sijainti	Yksi tehtävä per sijainti