››› Wipex
WARASTO INTEGRATION PLATFORM EXTERNAL

Me integroimme kaiken.

Wipex on Waraston ulkoinen integraatioalusta, joka vastaanottaa, käsittelee, auditoi ja välittää varastologistiikan sanomat yhden yhtenäisen rajapinnan kautta.

Aloita integraatio Developer Documentation
  • Yksi integraatiokanava riippumatta käytettävästä WMS:stä
  • Audit trail, alkuperäisen sanoman säilytys ja replay virhetilanteisiin
  • Tuki webhooks-, API-, FTP/SFTP- ja tuleville EDI-muodoille
Ympäristöt
Development https://dev.wipex.warasto.fi
Production https://wipex.warasto.fi

Kehitä ja testaa aina ensin development-ympäristöä vasten.

YLEISKUVA

Yksi integraatiokerros asiakkaan ja varaston väliin

Wipex erottaa asiakasintegraatiot käytössä olevasta varastonhallintajärjestelmästä. Jos asiakas toimii useassa lokaatiossa, vaihtaa lokaatioita tai taustalla oleva WMS vaihtuu, ulkoinen integraatiokanava säilyy samana.

Vastaanotto ja muunnos

Saapuvat sanomat validoidaan, tallennetaan alkuperäisessä muodossa ja muunnetaan kohdejärjestelmän vaatimaan malliin.

Auditointi ja replay

Kaikki alkuperäinen aineisto säilytetään. Virhetilanteissa sanoma voidaan jäljittää ja käsitellä uudelleen hallitusti.

Extranet valmiina

Myöhemmässä vaiheessa Wipex toimii myös yhtenäisenä extranet-palveluna asiakkaille ja palvelupyynnöille.

QUICK REFERENCE

Miten integraatio toimii

Inbound (you → Wipex)

Lähetät rakenteiset JSON-sanomat Wipexille webhook-endpointiin. Wipex validoi, jonottaa ja välittää sanoman eteenpäin varastojärjestelmään.

POST /webhook/{tenantCode}/{docType}
X-Api-Key: your-api-key
Content-Type: application/json
webhook-id: unique-message-id

Outbound (Wipex → you)

Kun varastossa tapahtuu jotain, Wipex toimittaa sanoman rekisteröityyn webhook-osoitteeseesi HMAC-allekirjoituksella suojattuna.

POST /your-endpoint
X-Webhook-Signature: base64-hmac-sha256
X-Webhook-Id: unique-delivery-id
Huom: 202 Accepted tarkoittaa, että sanoma vastaanotettiin ja jonotettiin. Varsinainen liiketoimintavalidointi tapahtuu asynkronisesti.
SANOMATYYPIT

Tuetut dokumentit ja rajapinnan entiteetit

Inbound

  • SalesOrder – myyntitilaus varaston keräilyyn, pakkaamiseen ja lähetykseen
  • PurchaseOrder – ostotilaus / ennakkoilmoitus saapuvasta tavarasta
  • ASN / DESADV – saapumisilmoitus pakkaus- ja SSCC-tasoiseen vastaanottoon
  • ProductMaster – tuoterekisteri, tunnisteet, mitat, pakkaushierarkia ja jäljitettävyys

Outbound

  • ShippingAdvice – lähetevahvistus ja seurantatiedot
  • InventoryBalance – saldolistaus / varastosnapshot
  • InventoryAdjustment – inventaario- ja muutosviestit
  • Tuleva poll-API – vaihtoehto webhookeille, jos vastaanottoa ei voi avata ulospäin
ARKKITEHTUURI

Asiakasviestistä kohdejärjestelmäksi

Wipex yhdistää viestiväylän, sanomamuunnoksen, asiakaskohtaiset mappaukset, jakelukanavat ja liiketoimintalogiikan yhdeksi hallituksi palveluksi.

Jakelukanava
Webhook, FTP, API
→
Viestimuunnos
EDIFACT, X12, XML, JSON
→
Asiakaskohtainen muunnos
kenttämappaukset, säännöt
→
JSON API & liiketoimintalogiikka
audit trail, validointi, replay
→
Kohdejärjestelmät
Logmaster, Leanware, other
TIETOTURVA / SUOJA

Rakennettu jatkuvuus ja jäljitettävyys edellä

Käyttöympäristö

  • Waraston omat datacenterit kahdessa fyysisessä lokaatiossa
  • Ratkaisu toteutetaan N+1-vikasietoisuudella
  • Tavoitesaatavuus 99,9 %

Datan hallinta

  • Saapuva ja lähtevä data säilytetään 30 vrk selailutietokannoissa
  • Arkistotietona säilytys 180 vrk
  • Automaattinen valvonta ja hälytykset häiriöistä IT-tiimille
Henkilötietoja ei lähtökohtaisesti käsitellä kolmansissa maissa. Huomioi kuitenkin, että valittu taustalla oleva WMS voi vaikuttaa kokonaisuuteen.
ONBOARDING

Mitä tarvitset aloitukseen

  • Tenant code TANOMAlta
  • API key jokaiselle sovitulle integraatioreitille
  • Sovitut dokumenttityypit (lähetys / vastaanotto)
  • ProductMaster ennen tilaussanomien käyttöä
  • Webhook-endpoint ja HMAC secret outbound-liikenteelle

Seuraavat askeleet

  1. Käy sanomatyypit ja kentät läpi asiakkaan kanssa
  2. Testaa development-ympäristöä vasten
  3. Varmista idempotency ja HMAC-signatuurin verifiointi
  4. Sovi go-live tuotantoon
Avaa Developer Documentation it-support@tanoma.fi