Hvordan skrive ut utgående fraktetiketter direkte på en Zebra-skriver samtidig som returetiketter genereres som PDF-filer som lagres i en mappe.

Dette kan oppnås ved å bruke Shipment Server sammen med DropZone.

Den medfølgende Postman-samlingen demonstrerer både den klassiske Shipment Server API og Shipment Server REST API, samt konfigurasjonen som kreves i DropZone.

https://nshiftship.helpcenter.nshift.com/hc/en-us/article_attachments/28207250192156

Miljøvariabler

Postman-samlingen bruker følgende miljøvariabler:

Forskjellen mellom de to Shipment Server API-ene

Samlingen demonstrerer to forskjellige måter å opprette forsendelser på.

Klassisk Shipment Server API

Endepunkt:

POST https://demo.shipmentserver.com/ship

Egenskaper:

• Bruker multipart/form-data.
• Autentisering gis gjennom forespørselsparametere.
• En kommando-parameter spesifiserer handlingen:

"command": "SubmitShipment"

• Forsendelsesdata og alternativer sendes som JSON-strenger.

Shipment Server REST API

Endepunkt:

POST https://demo.shipmentserver.com:8080/shipServer/{ActorID}/shipments

Egenskaper:

• Bruker application/json.
• Bruker Basic Authentication eller OAuth.
• Actor ID er en del av URL-en.
• Data og alternativer sendes som native JSON-objekter.

Funksjonell forskjell

Fra et forretningsperspektiv utfører begge API-ene samme operasjon:

• Opprette en forsendelse.
• Generere etiketter.
• Rute etiketter gjennom DropZone.

Forskjellen er kun API-stil, autentiseringsmekanisme og format på nyttelasten.

DropZone-konfigurasjon

Før API-forespørslene kan brukes, må DropZone installeres og konfigureres på arbeidsstasjonen som skal motta utskriftsjobbene.

1. Logg inn i DropZone

Logg inn med samme konto som er spesifisert i API-forespørslene.

Eksempel:

"TicketUserName": "first.last.company.owner"

Arbeidsstasjonens installasjons-ID som vises i DropZone må samsvare med verdien som brukes i API-forespørslene.

Eksempel:

"WorkstationID": "014AFB70-1234-1234-1234-9CB1A646C6D0"

2. Konfigurer Zebra-skriveren

Naviger til:

Printers → New

Velg Zebra-skriveren som skal skrive ut utgående forsendelsesetiketter.

Eksempel:

Skriver navn: ZDesigner GK420d
Skriver type: GK240
Standard etikett-skriver: True

Denne skriveren vil motta etiketter generert i Zebra-format.

3. Konfigurer en PDF-skriver for returetiketter

Opprett en filskrivertype i DropZone.

Eksempel:

Skriver navn: ZDesigner GK420d
Utdata-mappe: C:\Data\PrintToFile
Skriver type: PDF Label
Standard etikett-skriver: False
Importnøkkel: return-labels

Importnøkkelen er viktig fordi den refereres direkte fra API-forespørselen.

Eksempel:

"DropZoneLabelPrinterKey": "return-labels"

Når Shipment Server mottar denne verdien, ruter DropZone den genererte PDF-etiketten til denne skriverkonfigurasjonen.

4. Aktiver Cloud Print

Åpne fanen Cloud Print i DropZone og aktiver tjenesten.

Uten at Cloud Print er aktivert, kan ikke Shipment Server levere etiketter til DropZone-klienten.

Scenario 1 – Utgående forsendelse skrevet ut på Zebra-skriver

For utgående forsendelser spesifiserer API-forespørselen:

{
    "Labels": "ZPLGK",
    "TicketUserName": "first.last.customer.owner",
    "WorkstationID": "014AFB70-1234-1234-1234-9CB1A646C6D0"
}

Prosessflyt

1. Shipment Server oppretter forsendelsen.
2. En Zebra (ZPL) etikett genereres.
3. Etiketten sendes via Cloud Print.
4. DropZone mottar utskriftsjobben.
5. Zebra-skriveren skriver ut fraktetiketten automatisk.

Resultat

Lageroperatøren mottar en fysisk etikett umiddelbart og kan feste den til pakken.

Scenario 2 – Returforsendelse generert som PDF

For returforsendelser spesifiserer API-forespørselen:

{
    "Labels": "PDF",
    "TicketUserName": "first.last.customer.owner",
    "WorkstationID": "014AFB70-1234-1234-1234-9CB1A646C6D0",
    "DropZoneLabelPrinterKey": "return-labels"
}

Prosessflyt

1. Shipment Server oppretter returforsendelsen.
2. En PDF-etikett genereres.
3. PDF-en sendes via Cloud Print.
4. DropZone ruter dokumentet til skriverkonfigurasjonen med nøkkelen return-labels.
5. PDF-en lagres i den konfigurerte mappen.

Resultat

Kundeserviceteamet kan hente PDF-en og legge den ved en e-post som sendes til sluttkunden.

Diagram

flowchart TD
    A[Customer system / Postman collection] --> B{Shipment type}

    B -->|Normal outbound shipment| C[Submit shipment request]
    C --> C1[Options: Labels = ZPLGK]
    C1 --> C2[TicketUserName identifies DropZone user]
    C2 --> C3[WorkstationID identifies DropZone installation]
    C3 --> D[Shipment Server creates shipment]
    D --> E[Shipment Server generates Zebra ZPL label]
    E --> F[Cloud Print sends label to DropZone]
    F --> G[DropZone routes job to Zebra printer]
    G --> H[Physical label is printed]

    B -->|Return shipment| I[Submit return shipment request]
    I --> I1[Options: Labels = PDF]
    I1 --> I2[DropZoneLabelPrinterKey = return-labels]
    I2 --> I3[TicketUserName identifies DropZone user]
    I3 --> I4[WorkstationID identifies DropZone installation]
    I4 --> J[Shipment Server creates return shipment]
    J --> K[Shipment Server generates PDF label]
    K --> L[Cloud Print sends PDF to DropZone]
    L --> M[DropZone routes PDF to ReturnLabels printer]
    M --> N[PDF is saved to configured folder]
    N --> O[PDF can be attached to customer email]