Täältä löydät kattavan oppaan siitä, miten Skyplanneriin luodaan tilaus ja kaikki siihen liittyvät tiedot. Osa tästä on käsitelty integrointioppaassa, mutta tässä käymme Skyplannerin tietorakenteen ja integrointiprosessin läpi yksityiskohtaisemmin.
Tietorakenne #
Ensin käymme läpi, miten Skyplanner-tilaus rakentuu. Tässä mainittujen tietokokonaisuuksien API-päätteet on korostettu seuraavasti: /phaser-tilaukset
Ylimmällä tasolla meillä on tilaus(/phaser-orders).
Jokaisella tilauksella on oltava asiakas(/customers).
Jokaisella tilauksella voi olla useita tilauskohteita(/phaser-Order-items).
Jokaiseen tilauserään voi liittää tuotteen(/products), mutta se ei ole pakollista. Jokaisella tuotteella on yksi varasto(/saldos). Huomaa, että varasto-olio luodaan automaattisesti, kun tuote luodaan API:n avulla.
Jokaisella tilauserällä voi olla useita tehtäviä (eli prosessin vaiheita)(/phaser-jobs).
Jokaisella työllä on oltava työvaihe(/workstages).
Integroinnin työnkulku #
Tässä on askel askeleelta esimerkki siitä, miten voit rakentaa integraation ERP-järjestelmästäsi Skyplanneriin.
- Hae myynti/työtilaus ERP:stä
- Luo asiakas (saat asiakkaan tunnuksen vastauksessa)
- Luo tilaus asiakastunnuksella (saat tilauksen tunnuksen vastauksessa)
- noutaa myynti-/työtilauksen tilauserätiedot ERP-järjestelmästä.
- Luo tuote (saat tuotteen tunnuksen vastauksessa)
- Luo tilauserä tilaustunnuksella ja muilla tiedoilla (saat tilauserän tunnuksen vastauksessa).
- Hae prosessivaiheen tiedot ERP:stä
- Luo työstövaihe (saat työstövaiheen id:n vastauksessa)
- Luo työ työvaiheen id:llä ja muilla tiedoilla.
Lisää vinkkejä #
Poistettaessa #
Phaser-tilausten, phaser-tilauserien tai phaser-töiden poistaminen API:n kautta (ja käyttöliittymästä) tapahtuu pehmeällä poistolla. Tämä tarkoittaa, että tietoja ei varsinaisesti poisteta tietokannasta, vaan ne merkitään arkistoiduksi. Itse asiassa olion is_archive-attribuutti asetetaan true-arvoon, kun se poistetaan. Arkistoituja/poistettuja entiteettejä voidaan edelleen käyttää API:n avulla include_archived-parametrin avulla. Kun include_archived=true, GET-pyyntö hakee entiteetin, vaikka se olisi arkistoitu.
Huomaa, että pehmeä poisto ei ole käytettävissä kaikissa API-päätepisteissä! Sinun on siis oltava varovainen, sillä esimerkiksi asiakkaiden, henkilöiden jne. poistaminen on pysyvää!
Käyttämällä oletusarvoisia prosessivaiheita tilauskohteellesi #
Jos olet luonut joitakin oletusarvoisia prosessivaiheita tuotteelle, jota tilauserä tuottaa, voit kertoa järjestelmälle, että se tuo oletusarvot tilauserään API:n avulla käyttämällä get_default_steps -attribuuttia.
Materiaalien lisääminen tilauserään #
Jos olet liittänyt materiaaleja tuotettuun tuotteeseen, ne liitetään automaattisesti tilausriville.
Jos et kuitenkaan halua käyttää tuotteeseen liitettyjä materiaaleja (esimerkiksi jos tuote on erikoistilaus ja haluat käyttää eri materiaaleja jne.), voit käyttää määrettä use_custom_materials.
