Tilgang til printere for BxLogistics og BxLabels
BxLogistics og BxLabels krever tilgang til printere for at utskrifts-funksjonaliteten skal fungere
For at utskrifter skal fungere ordentlig, er det viktig at BxLogistics/BxLabels alltid har tilgang til en eller flere printkøer.
Vanligvis er det kundens IT-avdeling/drift som må sikre kommunikasjon med printere fra serveren. Hvis løsningen er hos en ASP-leverandør, må de sørge for kommunikasjon mellom ASP-leverandøren og kundens nettverk, f.eks. via VPN.
Typiske "Redirect" printere via RDP/Citrix og lignende løsninger vil aldri fungere optimalt da printkønavn både endrer seg, og printkø forsvinner, så snart en sesjon lukkes. Printkøen må være tilgjengelig på server utenom slike løsninger for å få utskrifter til å fungere.
Dersom printkøer deles ut fra en printserver/pc etc. til applikasjonsserveren hvor BxLogistics/BxLabels ligger installert er det nødvendig å sette en servicebruker på BxEngine og BxSmartPrintProService servicene for at vi skal få kommunisert med printerne. Local System holder ikke i de fleste tilfellene. Stort sett anbefaler vi alltid "lokal" printkø direkte på appserver om det ikke er noen grunner til å ikke tillate dette.
Printkøene installeres oftest på appserveren til ERPet vi integrerer med, alternativt på en PC lokalt på lageret hvor vi da også må installere BxSmartPrintPro for å få kommunisert med printere. Det er forskjellig fra ERP til ERP hvordan utskrifts-oppsettet kan konfigureres, så vil ikke nødvendigvis fungere selv om vi kan benytte printproxy via BxSmartPrintPro.
Hvordan utskrifter settes opp i BxLogistics varierer ifht hva slags utskrift det er snakk om. Skal det printes pakksedler/mottakskvittering er det ofte ERPet som kjører selve utskriften hvis det er et OnPrem ERP. Skal det printes fraktetiketter og medfølgende fraktbrev varierer det fra TA-system til TA-system hvordan det settes opp. Mot de fleste Cloud ERPer så henter vi ut en PDF eller lignende via APIet, så i de tilfellene er det vi som kjører selve utskriften, så lenge vi har tilgang til å hente utskrift fra APIet.
Innhold1. ERP-systemer
1.1 VismaNet
Bx henter PDF-dokumentet fra VismaNet API-et og sender det til en definert printkø. Printkøen må være tilgjengelig på maskinen der BxSmartPrintPro er installert.
Referanser: Pakkseddel utskrift Visma.net og Pakkseddel Visma.net feiler.
1.2 Business NXT
Bx henter PDF-dokumentet fra Business NXT API-et og sender det til den definerte printkøen. Printkøen må være tilgjengelig på maskinen der BxSmartPrintPro er installert.
Referanser: Utskrift av dokumenter fra Business NXT og Business Nxt App oppsett - Plukkliste generering og utskrift.
1.3 Visma Business
Utskriftsmåten styres av printFromVB i VBS-rapportoppsettet.
- printFromVB=true: Visma Business skriver ut rapporten selv. VBS bruker printeren fra rapportparameteren hvis den er angitt, ellers vbPrinterName. VBS-tjenesten må kunne bruke den valgte printkøen.
- printFromVB=false: VBS returnerer rapporten som PDF. Bx skriver PDF-en via PdfPrinter til printkøen i printer og bruker printcopies for antall kopier. Utskriften kan sendes via BxSmartPrintPro med printproxy og printproxylicensekey.
Også i PDF-modus sendes vbPrinterName til VBS når verdien er satt. Ved bruk av printproxy, der den faktiske printeren ikke finnes på Visma Business-serveren, anbefales det derfor å opprette en dummy printkø med port "nul" på Visma Business-serveren og bruke den som vbPrinterName. VBS kan da lage dokumentet uten å skrive det ut fysisk, mens BxSmartPrintPro sender PDF-en til den faktiske printeren angitt i printer.
For PDF-utskrift kan PrintMailTo brukes til å sende dokumentet på e-post. PrintMailSubject angir emnefeltet.
Disse verdiene settes i Export to ERP → Export Config for VBS-pakkseddelrapporten. SendPickinglist henter rapportinnstillingene fra området pickinglist / report for valgt exporterId. VBS-pakkseddel-eksportøren er vbs / pickinglist / create.
| Felt | Forklaring |
|---|---|
| printFromVB | true lar Visma Business skrive ut gjennom VBS. false lar VBS returnere PDF som Bx skriver ut. |
| vbPrinterName | VBS-printerkø. En printer angitt i rapportparameteren brukes hvis den finnes; ellers brukes denne verdien. VBS får også verdien i PDF-modus når den er satt. |
| printer | Printerkøen som Bx bruker for PDF-utskrift. |
| printcopies | Antall PDF-kopier; hvis verdien ikke er et positivt tall, brukes én kopi. |
| printproxy | Brukes til å rute PDF-utskrift via BxSmartPrintPro. |
| printproxylicensekey | Lisensnøkkel som kreves når printproxy brukes. |
| PrintMailTo | E-postmottaker for PDF-dokumentet. |
| PrintMailSubject | Emne på e-posten med PDF-dokumentet. |
Referanser: Automatisk pakkseddel og mottak utskrift med BxLogistics fra Visma Business - VBS og Avanserte utskriftsvalg i Visma Business.
1.4 Multicase OnPrem og Multicase Cloud
Det finnes to måter å utløse utskrift av pakkseddel på:
1. Utskrift via integrasjonstabeller: I standardoppsettet er raden i export Multicase / pickinglist / create mappet til tabellen og feltet BXVareUt.SkrivPakkseddel. Standardverdien i Static Text er 1. Multicase må være satt opp til å behandle integrasjonsraden og skrive til riktig printer. Avtal feltverdi og printeroppsett med Multicase.
2. API-basert utskrift (kalt «Multicase Cloud»): Sett Print=true i Export Config for Multicase / PickingList / Create. Bx henter PDF-pakkseddelen via Multicase API og skriver den til angitt Printer. Denne API-baserte metoden er implementert i OnPrem-eksportøren og kan derfor også brukes med Multicase OnPrem.
Følgende innstillinger brukes for API-metoden i Export to ERP → Export Config:
| Felt | Forklaring |
|---|---|
| true aktiverer uthenting og utskrift av pakkseddel-PDF fra Multicase API. | |
| MulticaseApiBaseUrl | Baseadresse for Multicase API. Standard er http://localhost:9000. |
| MulticaseApiUsername | Brukernavn for API-tilkoblingen. |
| MulticaseApiPassword | Passord for API-tilkoblingen. Ikke del passord i artikkelen eller i eksempler. |
| McReportTypeID | Rapporttype-ID for pakkseddelrapporten. Standardverdi er 10. |
| Printer | Navnet på printkøen som skal brukes. |
| printcopies | Antall kopier. Hvis verdien ikke er et positivt tall, skrives én kopi ut. |
| printproxy | Ruter PDF-utskriften via BxSmartPrintPro-printproxy når dette er konfigurert. |
| printproxylicensekey | Lisensnøkkel som kreves når printproxy brukes. |
1.5 Business Central
Business Central-eksportøren kan skrive ut PDF-dokumenter etter at eksporten er utført. Når print er aktivert, henter Bx dokumentet fra konfigurert URL-service, leser den angitte egenskapen med base64-kodet PDF og sender dokumentet til valgt printer. Hvis URL-servicen returnerer en liste, kan eksportøren hente PDF-en fra det første elementet.
| Felt | Forklaring |
|---|---|
| true aktiverer PDF-utskrift etter eksporten. | |
| printer | Navnet på printkøen. |
| printUrlService | URL-service som returnerer dokumentet. Flere URL-er kan skilles med komma. |
| printBase64PdfProperty | Navnet på egenskapen i URL-svaret som inneholder PDF-en kodet som base64. |
| printResponseIsArray | Angir at URL-servicen returnerer en liste. Da brukes PDF-egenskapen fra det første elementet. |
| printCopies | Antall kopier. Standard er én kopi. |
2. TA-systemer
2.1 AxiaFrakt
Bx henter etiketten som PDF fra AxiaFrakt API-et og skriver den ut på printeren angitt i shipmentLabelPrinter. Fraktbrev kan skrives til printeren angitt i shipmentPagePrinter. Utskrift kan gå via BxEngine-maskinens printkø (OnPrem) eller BxSmartPrintPro-printproxy (oftest Cloud).
Referanser: AxiaFrakt integrasjon.
2.2 Logistra Cargonizer
Etiketter kan skrives ut gjennom Logistra sin DirectPrint-tjeneste via API-et. Da brukes printer-ID-en fra Logistra sin printboks i shipmentLabelPrinter. Alternativt kan Bx hente PDF-etiketten fra API-et og skrive den ut lokalt; i dette oppsettet settes callprintservice til false og shipmentLabelPrinter angir printkøen. Fraktbrev sendes til printeren i shipmentPagePrinter.
Referanser: Logistra Cargonizer integrasjon.
2.3 nShift Shipment Server
Bx henter etikettinnhold fra Shipment Server API-et og sender det til printeren angitt i shipmentLabelPrinter. Serveren kan returnere PDF- eller ZPL-etiketter. Etikettformatet kan angis i shipmentoptions, for eksempel {"Labels":"ZPLGK"}. Dokumenterte formatverdier omfatter ZPL, ZPLGK, EPL, DATAMAXLP2, PDF og PNG.
Fraktdokumenter kan hentes fra Shipment Server og sendes til printeren i shipmentPagePrinter.
Referanser: nShift Shipment Server integrasjon.
2.4 Unifaun Online / nShift Delivery
Bx henter etiketter fra Unifaun API-et og skriver dem ut på printeren angitt i shipmentLabelPrinter. Fraktbrev bruker shipmentPagePrinter. Utskriften kan sendes via BxEngine-maskinens printkø eller BxSmartPrintPro-printproxy.
Referanser: Unifaun Online integrasjon.
2.5 Consignor OnPremises
Consignor skriver ut etiketter selv når Autoprint i CarrierPreSettings er konfigurert der. Bx kan også eksportere etikettfiler. Vi kan styre hvilken printer utskrifter skal gå til, men avhengig av import keys pr. printer i Consignor Server Printers. Printproxy kan brukes når filene skal sendes til en server utenfor BxEngine-maskinens nettverk eller når man benytter BxCloud.
Referanser: Consignor OnPremises installasjon.
2.6 LogiSnap
Når callprintservice=true, sender Bx utskriftsforespørselen til LogiSnap, som bruker printeren konfigurert der. Hvis denne funksjonen ikke brukes, henter Bx PDF-etiketten fra API-et og skriver den ut via BxSmartPrintPro på printeren angitt i shipmentLabelPrinter.
2.7 Profrakt
Bx henter PDF-etiketten fra Profrakt API-et og sender den til BxSmartPrintPro for utskrift. Etikettformatet kan konfigureres med shipmentPaperWidth og shipmentPaperHeight, for eksempel 102 × 192 mm.
2.8 SendIt
Bx mottar ZPL-etiketten fra SendIt API-et og sender den via BxSmartPrintPro til printeren angitt i shipmentLabelPrinter.
2.9 Shipmondo
Standard etikett hentes som PDF i formatet 10 × 19 fra API-et. Etikettformatet kan endres til 10x19_zpl. Bx skriver etiketten ut på printeren i shipmentLabelPrinter; i Cloud-oppsett kan dette gå via printproxy. Fraktbrev kan skrives ut på A4 med printFreightDocument og shipmentPagePrinter. Hvis utskriften feiler, kan etiketten skrives ut på nytt fra Shipmondo.