AxiaFrakt integrasjon

Oppsett og konfigurasjon av AxiaFrakt integrasjon med BxLogistics Pro

I denne manualen tar vi for det meste opp hvordan integrasjonen skal settes opp og fungerer mot VismaNet, dog vil mye av de samme prinsippene fortsatt gjelde for andre ERP systemer. 

Innholdsfortegnelse

  1. Forberedelser
    1. Printere
    2. AxiaFrakt
    3. ERP System
  2. AxiaFrakt
  3. BxAdmin
    1. Installation
    2. Imports from ERP
    3. Export to ERP
    4. Configuration
    5. Data
    6. SQL Integration
  4. Ekstra
    1. Sporingsnummer og fraktpris
    2. Etikett orientering

1. Forberedelser

Printere

Sørg for at etikettprinter og eventuell A4 printer som benyttes for AxiaFrakt utskrifter er installert på server tilgjengelig for BxEngine tjenesten (med andre ord, printkø på samme server som BxEngine). 
Dersom det ikke er mulig å installere printkø på BxEngine serveren (pga. begrensninger i nettet eller hos ASP) kan man installere BxSmartPrintPro som en printproxy på f.eks. en lager-PC eller lokal server hvor det er lettere å få installert etikettprintere. 
Vi anbefaler å installere printkø lokalt på Bx server/PC, fremfor delt fra printserver etc., da det både er mer stabilt og utskrifter går raskere. 
Det vi mener med lokal printkø er at printkøen ligger under Control Panel -> Devices and Printers -> og heter noe som "Printer" fremfor "Printer on servername" eller "\\servername\Printer". Bør se ca. slik ut: 

Velger dere likevel å bruke en printer delt fra printserver eller lignende er det viktig at printeren er tilgjengelig for BxEngine og/eller BxSmartPrintPro tjenestene våre. Local System som er standard servicebruker på disse to tjenestene har i de fleste tilfellene ikke tilgang til delte nettverksprintere. I vårt oppsett i BxAdmin må også printernavnet legges inn med UNC stien, som f.eks. "\\servername\Printername". 

Printere som inneholder (Redirected) vil ikke fungere da dette er printere som er med over via en RDP eller Citrix sesjon, så fort sesjonen lukkes forsvinner også printkøen. 

AxiaFrakt

Alt oppsett i AxiaFrakt vedr. transportavtaler, fraktselskaper etc. i seg selv må også være ferdig satt opp, vi regner med at dere eller Axia sørger for at dette er i orden. BxSoftware tar ikke på seg ansvaret for å sette opp dette. 

ERP system

Alle leveringsmetoder må være lagt opp i ERP systemet. Det må legges opp én metode pr. leveringsprodukt i AxiaFrakt 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 Axia.
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. AxiaFrakt

For å integrere mot Axia krever det API-nøkkel, ImportID og ConsignorID. Dette får man fra Axia ved å kontakte de på servicedesk@axia-asp.no. Om dere ikke får ImportID og ConsignorID kan dette hentes ut ved hjelp av API nøkkelen på AxiaFrakt sine API sider.
Trykk Client -> Post -> lim inn api nøkkel i X-ApiKey feltet nederst -> Trykk så Try it out! ImportId og Id under Consignors er de to IDene du må hente ut, som skal inn i BxAdmin oppsettet. 

3. BxAdmin

Installation - gjelder vanligvis bare hvis ERP ikke er skybasert

Med VismaNet eller andre skybaserte ERP systemer kan man hoppe over dette steget. Skal man sette opp mot Visma Business og andre onprem ERPer er dette steget nødvendig. 

Under Installation i BxAdmin må man legge opp en ekstra Database connection, dette skal være BxEngine databasen da det er BxEngine databasen vi laster ned data til fra AxiaFrakt. Dersom det settes opp mot VismaNet eller andre skybaserte ERPer trenger man ikke gjøre noe med dette da BxEngine koblingen allerede skal være satt opp.

Imports from ERP

  1. Opprett ny importer under Imports from ERP ved å trykke New import. Fyll ut Import type = axia, Module = deliverymethods, Enabled = Ja.
  2. Field mapping trykker du Add missing defaults for å legge til alle import parameterne.
  3. Import config trykker du Add missing defaults for å legge til konfigurasjons parameterne.
    1. 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). 
    2. I serverkey legger du inn API nøkkelen fått fra Axia.

Export to ERP

  1. Vi skal også legge opp en exporter for AxiaFrakt under Export to ERP. Export type = axia, Module = axia, Action = create, Enabled = Ja
  2. Field mapping trykker du Add missing defaults for å legge til alle export parameterne.

Configuration

  1. I Configuration -> Client profile -> Velg korrekt profil: Aktiver disse parameterne under Area: consignor 
    1. actorid = ImportID fra Axia.
    2. axia = true
    3. enabled = true
    4. senderid = ConsignorID fra Axia.
    5. shipmentlabelprinter = navn på printerkøen som skal printe etikettene.


  2. Under Area: pickinglist, aktiver disse parameterne
    1. deliverymethod = true
    2. shipment = true
  3. Hvis printproxy oppsett skal benyttes, følg disse punktene. Ignorer dette punktet hvis printproxy oppsett ikke er relevant.
    Under Area: consignor, fyll ut printproxy med firmakoden til BxSmartPrintPro lisensen, printproxylicensekey fylles ut med lisensnøkkel til BxSmartPrintPro. 
    1. printproxy = firmakode/AppCode
    2. printproxylicensekey = lisensnøkkelimage-png-May-23-2022-01-30-36-11-PM.png (1178×200)

Data

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

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 AxiaFrakt skal linje 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 kolonnen når man kjører spørringen fylles ut med korrekt ID fra AxiaFrakt. 
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 AxiaFrakt 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

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