Logistra Cargonizer integrasjon
Oppsett og konfigurasjon av Logistra Cargonizer integrasjon med BxLogistics Pro
Denne manualen beskriver oppsett av Logistra Cargonizer mot BxLogistics Pro. Oppsettet er litt ulikt for BxCloud og BxOnPrem:
- BxCloud (VismaNet, Business NXT og andre sky-ERP): Dette er hovedfokuset i manualen. Alle steg som ikke er merket On-premises, gjelder for BxCloud.
- BxOnPrem (lokal BxEngine mot ERP med egen database, f.eks. Visma Business, Visma Global og Uni Micro V3): Her kreves det noen ekstra steg. Disse er merket On-premises i manualen, se særlig 3.1 Installation og 3.6 SQL Integration.
1. Forberedelser
1.1 Printere
Kommunikasjon med printer foregår via Logistra APIet, dette krever at man har DirectPrint boksen Logistra leverer, og at denne er ferdig konfigurert opp: Logistra DirectPrint.
Dette er standard (callprintservice = true), og gjelder både BxCloud og on-premises. Uten DirectPrint kan BxEngine skrive ut etikettene selv, se 3.2. I BxCloud går utskriften da via BxSmartPrintPro (printproxy).
1.2 Logistra
Alt oppsett i Logistra vedr. transportavtaler, fraktselskaper etc. i seg selv må også være ferdig satt opp, vi regner med at dere eller Logistra sørger for at dette er i orden. BxSoftware tar ikke på seg ansvaret for å sette opp dette. Vær obs på at alle fremtidige endringer i Logistra vedrørende fraktavtaler, enten nye eller eksisterende, må utføres i oppsettet til den kontoen ID og API-nøkkel hentes fra beskrevet i punkt 2.
1.3 ERP system
Alle leveringsmetoder må være lagt opp i ERP systemet. Det må legges opp én metode pr. leveringsprodukt i Logistra dere ønsker å benytte fra håndterminalene. For å ta noen eksempler:
Bring Ekspress neste dag, Bring Pakke til bedrift, Bring Stykkgods til bedrift, Bring Pakke levert hjem, Bring Pakke til hentested, Schenker Stykkgods osv., alle disse må ha én leveringsmetode pr. produkt i ERPet. Vi anbefaler også å legge opp et "Henter selv" valg eller tilsvarende som kan benyttes for å sende ordren uten at det bestilles frakt via Logistra.
Eksempel på hvordan leveringsmetoder legges opp under.
Visma.net: Leveringsmetoder Visma.net
Visma Business: Snakk med partner
Business Nxt: Snakk med partner
2. Logistra
For å integrere mot Logistra krever det en aktør ID og API-nøkkel. Dette kan dere finne ved å logge inn på http://cargonizer.no/ -> Innstillinger, ID under avsender er aktør ID. API-nøkkel ligger under API key. Obs! Viktig at man velger korrekt avsender som skal benyttes med integrasjonen, forskjellige avsendere kan ha forskjellige transport-avtaler med forskjellige transport-IDer, som kan føre til problemer om man ikke tar høyde for dette i oppsettet.

2.1 Hente ut printer ID fra Logistra
For å hente ut korrekt DirectPrint printer ID fra Logistra kan man hente ut dette fra Innstillinger -> Skrivere
Deretter er det IDen på venstre side som er korrekt ID å hente ut. Navn er vanligvis det DirectPrint boksen fra Logistra er merket med, det skal ikke inn i oppsettet. ID er det som skal inn i BxAdmin -> Configuration -> shipmentlabelprinter feltet.
3. BxAdmin
3.1 Installation
BxCloud (VismaNet, Business NXT og andre sky-ERP): Her trengs ingen ekstra Database connection. Leveringsmetodene fra Logistra lagres i system-databasen, som alltid er dbconnection 0. Gå videre til neste punkt.
On-premises (f.eks. Visma Business, Visma Global, Uni Micro): Legg opp en ekstra database-kobling under Installation -> Database connections. Denne må peke mot BxEngine-databasen, siden dataene fra Logistra lagres der. ID til databasekoblingen er IDen som skal inn i dbconnection parameteret senere i oppsettet.
3.2 Configuration -> Client Profiles
- I Configuration -> Client profile -> Velg korrekt profil: Aktiver disse parameterne under Area: consignor
- actorid = aktør-id/avsender ID hentet fra cargonizer.no ref. punkt 2.
- enabled = true
- logistra = true
- callprintservice = true (standard). Logistra skriver da ut etikettene via DirectPrint
- senderaddress = avsender adresse
- sendercity = avsender poststed
- sendername = avsender navn
- senderpostcode = avsender postkode
- serverkey = api nøkkel hentet fra cargonizer.no ref. punkt 2.
- shipmentlabelprinter = printer ID hentet via Cargonizer APIet ref. punkt 2.
- Dersom man ikke får tak i printboks fra Logistra kan man alternativt endre callprintservice = false, og fylle ut navn på printkøen i shipmentlabelprinter i stedet. Dette vil for BxCloud kreve at man også knytter BxSmartPrintPro proxyen i printproxy og printproxylicensekey
- shipmentpageprinter = valgfritt, kun hvis det er nødvendig med A4 utskrift av fraktbrev (ikke etikett). Fylles ut med navn på printkø tilgjengelig for BxEngine (on-premises) eller BxSmartPrintPro (BxCloud).
- url = la denne være blank, alle nye installasjoner og oppsett mot Logistra trenger ikke URL da dette er bakt inn i koden. Trenger kun endres dersom det skal settes opp mot en spesifikk sandbox URL (krever et sandbox miljø hos Logistra).
- Under Area: pickinglist, aktiver disse parameterne
- deliverymethod = true
- shipment = true
- showpackagetype = true - valgfritt, mest avhengig av hva fraktleverandørene krever ved innsending. Aktiveres vanligvis alltid
- downloadpackagetypes = true (hvis showpackagetype = true)
- showdeliveryservices = true - valgfritt, kun hvis man skal velge transportør-tjenester fra terminalen
- downloaddeliveryservices = true (hvis showdeliveryservices = true)
3.3 Export to ERP
- Under Export to ERP, trykk Add Missing defaults:

Deretter velg logistra -> Confirm
- Trykk så på logistra eksporteren. Sørg for at de forskjellige Field Mappingene er synlig, trykk Reload nede i venstre hjørne dersom det ikke kommer med en gang. Her kan du også deaktivere, aktivere og legge til flere mappinger der hvor det er ønskelig å sende over mer eller mindre data til Logistra.

3.4 Import from ERP
- Opprett importer under Import from ERP ved å trykke Add missing defaults. Dette fungerer på samme måte som ved opprettelse av eksportøren i punkt 3.3.
- Velg så importøren.
- dbconnection angir hvilken database leveringsmetodene lagres i. Standardverdien er 0 (system-databasen). I BxCloud skal den stå på 0. Ved on-premises settes den til ID-en for BxEngine-koblingen fra 3.1 Installation.
- I actorid og serverkey legger du inn aktør id og api-nøkkelen hentet fra cargonizer.no forklart i punkt 2.

3.5 Data
Åpne Data i BxAdmin og trykk Run Import for å laste ned leveringsmetodene fra Logistra. Vent noen sekunder før du prøver en refresh da det innimellom kan ta litt tid å hente ned alle. Når de er ferdig lastet ned burde listen se slik ut. Her har vi også fylt ut DeliveryMethod kolonnen med IDen til forkjellige Send via-koder fra VismaNet, dvs. IDen til leveringsmetoden fra ERPet. Viktig at denne fylles ut med korrekt ID så det fungerer i senere steg.
3.6 SQL Integration
Spørringen for leveringsmetoder ligger under SQL Integration -> Picking -> Delivery Methods. BxCloud (VismaNet, Business NXT): Standardspørringen henter leveringsmetodene fra ERP (BxDeliverymethod), og har en left join mot system.DeliveryMethod (Data -> DeliveryMethods) som er kommentert ut. For Logistra tar du bort kommentaren på left join-linjen og på de to linjene under «AxiaFrakt and Logistra Cargonizer» (bx.carrier som externalid og bx.product som externalproduct), og kommenterer ut den eksisterende externalid-linjen. Ta også bort kommentaren på externalserviceid-linjen hvis det skal sendes med tjenester. Spørringen kjører mot data-databasen der ERP-dataene ligger, og henter Logistra-dataene fra system-databasen via prefikset system. Leveringsmetoder med tom externalid eller 0 blir ikke sendt til Logistra.
On-premises: For ERP systemer som ikke er skybasert må man ofte joine inn tabeller for transportører/leveringsmetoder fra ERPet slik at vår tabell joines med ERPets, deliverymethod ID skal matches med ERPets ID. 
4. Oppsummert
Dette er alt man trenger å gjøre for å sette opp Logistra integrasjonen i BxLogistics Pro. Vanligvis trenger man ikke gjøre mer enn dette. Eventuelt ekstra relevant oppsett ligger under Ekstra.
5. Ekstra
5.1 Sporingsnummer og fraktpris
Logistra sender oss sporingsnummer, sporingsurl og fraktpris sammen med fraktetiketten i det fraktbestillingen sendes fra terminal. Disse verdiene kan vi hente ut og sende med videre til ERPet. Korrekte sourcefields for dette er
shipmentTrackingId - sporingsnummer
shipmentTrackingUrl - sporingslink
shipmentPrice1 - estimert netto fraktpris
shipmentPrice2 - estimert brutto fraktpris
Disse kan sendes videre til ønskede felter i ERPet via pickinglist create exporteren.
Visse ERPer, som VismaNet, har standard-felter for dette allerede lagt opp i standard-exporter, mens andre ERPer er det nødvendig å legge inn mappinger mot korrekt felt i ERPet.
Det kan også være nødvendig å benytte pickinglist addproduct exporteren for fraktpris mot ERPer som ikke har standardfelter for priser, hvor prisen i stedet skal legges på som en ordrelinje.
5.2 Etikett orientering
Ved noen tilfeller, som f.eks. hvis man bruker Postnord MyPack Home Small eller Posten Brevpost, så krever det en justering på hvordan etiketten orienteres når den printes via Bx. Da må det legges et config parameter for dette på de leveringsmetodene som har en annen orientering enn standard. Bruk f.eks. følgende i DeliveryMethods spørringen:
case when bx.deliverymethod in ('xx') then 'true' else 'false' end cfg_shipmentLabelLandscape