Oppsett og konfigurasjon av Logistra Cargonizer integrasjon med BxLogistics Pro frakt integrasjon for sending av pakker

I denne veiledningen vil du lære hvordan du setter opp og konfigurerer integrasjonen mellom BxLogistics Pro og Logistra Cargonizer. Guiden fokuserer hovedsakelig på oppsett mot VismaNet, men prinsippene gjelder også for andre ERP-systemer.

1. Forberedelser

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 lisens

Integrasjonen krever et lisens for Logistra Cargonizer, om dere ikke allerede har dette: Logistra Cargonizer.

Ta gjerne kontakt om dere er usikre på noe i denne sammenheng, eller om dere har andre spørsmål i forbindelse med EDI løsning, Cargonizer. Vi har ingen etableringsgebyr, supportkostnader, oppsigelsestider eller andre skjulte kostnader hos oss i Logistra, eneste kostnad er selve abonnementet.

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: Link kommer
Visma Global: Link kommer
Uni Micro: Link kommer
Andre ERP: Link kommer

2. Logistra API

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 logg inn på cargonizer.no klikk på innstillinger -> skrivere og man vil da se hvilken "ID" ønsker skriver har. 

‍

3. BxAdmin

Installation - Gjelder vanligvis bare hvis ERP ikke er skybasert

Dersom Logistra integrasjonen settes opp med et on-prem ERP system som Visma Business, Visma Global eller UniMicro må det legges opp en ekstra database-kobling i BxAdmin under Installation -> Database connections. Denne koblingen må peke mot BxEngine databasen, da data-import fra Logistra må legges i BxEngine databasen.

Configuration -> Client Profiles

1. I Configuration -> Client profile -> Velg korrekt profil: Aktiver disse parameterne under Area: consignor
2. actorid = aktør-id/avsender ID hentet fra cargonizer.no ref. punkt 2. Logistra
3. enabled = true
4. logistra = true
5. senderaddress = avsender adresse
6. sendercity = avsender poststed
7. sendername = avsender navn
8. senderpostcode = avsender postkode
9. serverkey = api nøkkel hentet fra cargonizer.no ref. punkt 2. Logistra
10. shipmentlabelprinter = printer ID hentet via Logistra ref. punkt 2. Logistra
11. shipmentpageprinter = valgfritt, kun hvis det er nødvendig med A4 utskrift av fraktbrev (ikke etikett). Fylles ut med navn på printkø tilgjengelig for BxEngine servicen.
12. url = http://cargonizer.no/consignments (fra versjon 2022 og nyere trengs ikke URL)

1. Under Area: pickinglist, aktiver disse parameterne
2. deliverymethod = true
3. shipment = true
4. showpackagetype = true - valgfritt, mest avhengig av hva fraktleverandørene krever ved innsending. Aktiveres vanligvis alltid
5. downloadpackagetypes = true (hvis showpackagetype = true)
6. showdeliveryservices = true - valgfritt, kun hvis man skal velge transportør-tjenester fra terminalen
7. downloaddeliveryservices = true (hvis showdeliveryservices = true)

Export to ERP

1. Vi skal også legge opp en exporter for Logistra under Export to ERP. Export type = logistra, Module = logistra, Action = create, Enabled = Ja.

1. I Field mapping trykker du Add missing defaults for å legge til alle export parameterne.

Imports from ERP

1. Opprett ny importer under Imports from ERP ved å trykke New import. Fyll ut Import type = logistra, Module = deliverymethods, Enabled = Ja.

1. I Field mapping trykker du Add missing defaults for å legge til alle import parameterne.

1. I Import config trykker du Add missing defaults for å legge til konfigurasjons parameterne.
2. Her passer du også på å legge inn korrekt verdi i dbconnection, som i dette tilfellet er 1. Se punkt Installation hvis dette settes opp mot Visma Business f.eks., BxEngine er da den andre database tilkoblingen som er lagt opp etter Visma Business. Dersom det settes opp mot VismaNet eller andre sky ERP holder det i de aller fleste tilfellene å la det være dbconnection 1 (standard).
3. I actorid og serverkey legger du inn aktør id og api-nøkkelen hentet fra cargonizer.no

Data

Åpne Data i BxAdmin og trykk Run Import for å laste ned leveringsmetodene fra Logistra. Vent et par minutter 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.

SQL Integration

Spørringen for leveringsmetoder ligger under SQL Integration -> Picking -> Delivery Methods. Mot VismaNet har vi standard-spørring for forskjellige TA-systemer. For Logistra skal linje 4 kommenteres ut og linje 10, 11 og 14 kommenteres inn. Her skal ID lagt inn i deliverymethod kolonnen i Data fra forrige punkt matche ID for koden i ERPet. Når dette er gjort korrekt skal externalid og externalproduct kolonnene når man kjører spørringen fylles ut med korrekt ID fra Logistra.
For andre 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.

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 vil etterhvert dokumenteres under Ekstra.

Ekstra

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 - 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.

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. case when bx.deliverymethod in ('xx') then 'true' else 'false' end cfg_shipmentLabelLandscape i DeliveryMethods spørringen.

‍