Dokumentation
Dokumentation: kom i gang med WeLabel
WeLabel henter den ordrefil, jeres webshop allerede skriver, opretter forsendelsen i GLS’ nye Label API på jeres egen aftale og printer etiketten på jeres Zebra. Her står, hvad I skal have klar, trinene i rækkefølge, og hvad I gør, når noget driller.
Står I midt i, at Interline udfases? Læs, hvad I skal gøre, og hvornår.
Det skal I have klar
Tre ting. Webshoppen skal ikke ændres, og filen skal ikke flytte.
Ordrefilen, der hvor den ligger i dag
Den Interline-fil, jeres webshop skriver i dag, på en server, der kan nås fra internettet — og et SFTP-, FTPS- eller FTP-login, der må læse mappen. Se Forbind jeres server.
Jeres egen GLS-aftale
I beholder aftalen. WeLabel opretter forsendelserne i GLS’ nye Label API med jeres eget login. Er API-oplysningerne fra GLS ikke kommet endnu, kan I gøre resten klar imens. Se Login til GLS.
En Zebra-printer og en pakke-pc
Printeren skal stå til 203 dpi. På pakke-pc’en kører print-programmet WeLabel Agent, som kun printer — se kravene længere nede og Printer og print-program.
Hjælp
Kom i gang med WeLabel
Seks trin fra en ny konto til den første rigtige etiket fra GLS’ nye Label API, i den rækkefølge I møder dem. Dertil kommer de faldgruber, vi kender fra rigtige opsætninger, og vejledninger til den slags webshop, I har.
Kom i gang, trin for trin
- Forbind jeres serverSæt forbindelsen op til den server, jeres webshop skriver ordrefilerne på, og test den, før WeLabel henter noget.
- Login til GLSGem jeres eget GLS-login på lokationen, så WeLabel kan oprette forsendelserne i GLS’ nye Label API på jeres egen aftale.
- Printer og print-programOpret Zebra-printeren i WeLabel, installer WeLabel Agent på pakke-pc’en, og par de to med en agentnøgle.
- Send en testetiketSe, at vejen fra WeLabel til printeren virker — uden en pakke, uden et kald til GLS, og uden at det tæller med i jeres etiketter.
- Kør en testLad WeLabel hente og læse jeres rigtige filer, uden at noget bliver sendt til GLS eller flyttet på serveren.
- Gå liveAngiv, hvornår Interline holdt op med at printe, og lad WeLabel tage over fra det tidspunkt.
Kendte faldgruber
- Windows SmartScreen og låste pc’erWindows advarer, første gang print-programmet installeres. Sådan kommer I videre — og hvad jeres IT skal vide, hvis pc’en er låst af en politik.
- Server-login med kun læseadgangHvad »Efter hentning« kræver af jeres login: flytning kræver skriveret til en undermappe, og med kun læseadgang lader I filen ligge.
- Vægt og standardvægtWebshoppen skriver 1 kg, når varerne ikke har en vægt. Hvorfor det betyder noget, og hvornår en standardvægt hjælper.
- Printeren skal stå til 203 dpiGLS’ etiketter kommer i 203 dpi. En printer sat til 300 dpi — eller uden oplyst opløsning — får dem ikke, og det sker, før GLS bliver kaldt.
- Levering til pakkeshopPå en pakkeshop-forsendelse står pakkeshoppens adresse i filen, ikke kundens. Det er sådan, det skal være — her er hvorfor.
- Afklaring påkrævet og Kræver handlingHvad det betyder, når en forsendelse venter på jer, hvad I gør ved hver slags, og hvordan I markerer den som håndteret.
Vejledninger
- Magento og Interline-eksportfilen: sådan kommer I videreJeres Magento-modul skriver Interline-filen som altid. Sådan henter WeLabel den, hvad I sætter op og tester, og hvordan pakkenummeret kommer tilbage på ordren.
- Print-programmet ved pakkebordetHvad WeLabel Agent viser ved pakkebordet, hvad I gør, når det melder om et problem, og hvordan én pc printer for flere printere eller virksomheder.
- Ny manuel etiket: en pakke uden ordrefilOpret og print en enkelt etiket i WeLabel til en pakke, der ikke har en ordrefil bag sig — med gemte modtagere og den samme Zebra som resten.
Filen i mappen
WeLabel henter filerne fra den server, jeres system skriver dem på i dag — samme format, samme placering. Print-agenten ser dem aldrig; den printer kun. Felterne står i Interline CSV-format.
Direkte til API’etKommer
Har I en udvikler og rører alligevel ved webshoppen, kan ordren senere sendes direkte. Kaldet er endnu ikke åbnet — WeLabel API viser den form, vi bygger efter.
GLS-oplysninger bliver hos os
Jeres GLS-brugernavn og -kodeord ligger krypteret på jeres konto og bruges kun af WeLabel. Print-agenten kender dem ikke.
Print-agenten ved pakkebordet
Et lille program, der henter printkøen hos WeLabel og sender etiketten direkte til jeres Zebra. Det holder hverken ordrefiler eller GLS-oplysninger.
Windows
- 64-bit Windows.
- Kører som Windows-tjeneste, også når ingen er logget ind.
- Printer til en Zebra på netværket over TCP port 9100 eller gennem Windows’ printerkø.
MacKommer snart
- macOS 13 Ventura eller nyere, på Apple Silicon og Intel.
- Kører som baggrundstjeneste.
- Printer kun til en Zebra på netværket over TCP port 9100. USB-printere understøttes endnu ikke på Mac.
- Går Mac’en i dvale, henter agenten køen, når den vågner igen.
Mac-versionen kommer snart.
Reference
Til den, der vil kende filen helt ned i felterne — eller senere koble sit eget system direkte på.
Interline CSV-format: felterne i eksportfilen forklaret
Interline-eksportfilen felt for felt — tegnsæt, anførselstegn, leveringskoder, vægt og pakkeshop — og hvad hvert felt bliver til i GLS’ nye Label API.
WeLabel API: forsendelser, idempotens og fejlKommer
Den form, WeLabels eget API til forsendelser bygges efter: autentificering, kaldet, idempotens og fejlkoder. Det er endnu ikke åbnet.