Sådan udskrives udgående forsendelsesetiketter direkte på en Zebra-printer, mens returneringsetiketter genereres som PDF-filer, som gemmes i en mappe.

Dette kan opnås ved hjælp af Shipment Server sammen med DropZone.

Den medfølgende Postman-samling demonstrerer både den klassiske Shipment Server API og Shipment Server REST API samt den nødvendige konfiguration i DropZone.

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

Miljøvariabler

Postman-samlingen bruger følgende miljøvariabler:

Forskellen mellem de to Shipment Server API’er

Samlingen demonstrerer to forskellige måder at oprette forsendelser på.

Klassisk Shipment Server API

Endpoint:

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

Egenskaber:

• Bruger multipart/form-data.
• Godkendelse gives via forespørgselsparametre.
• En kommando-parameter specificerer handlingen:

"command": "SubmitShipment"

• Forsendelsesdata og indstillinger sendes som JSON-strenge.

Shipment Server REST API

Endpoint:

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

Egenskaber:

• Bruger application/json.
• Bruger Basic Authentication eller OAuth.
• Actor ID er en del af URL’en.
• Data og indstillinger sendes som native JSON-objekter.

Funktionel forskel

Fra et forretningsperspektiv udfører begge API’er den samme operation:

• Opretter en forsendelse.
• Genererer etiketter.
• Dirigerer etiketter gennem DropZone.

Forskellen er kun API-stilen, godkendelsesmekanismen og dataformatet.

DropZone-konfiguration

Før API-forespørgslerne kan bruges, skal DropZone installeres og konfigureres på den arbejdsstation, der skal modtage printjobbene.

1. Log ind på DropZone

Log ind med den samme konto, som er angivet i API-forespørgslerne.

Eksempel:

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

Arbejdsstationens installations-ID, som vises i DropZone, skal matche den værdi, der bruges i API-forespørgslerne.

Eksempel:

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

2. Konfigurer Zebra-printeren

Gå til:

Printers → New

Vælg den Zebra-printer, som skal udskrive udgående forsendelsesetiketter.

Eksempel:

Printernavn: ZDesigner GK420d
Printertype: GK240
Standard etiketprinter: True

Denne printer modtager etiketter, der genereres i Zebra-format.

3. Konfigurer en PDF-printer til returneringsetiketter

Opret en filprinter i DropZone.

Eksempel:

Printernavn: ZDesigner GK420d
Output-mappe: C:\Data\PrintToFile
Printertype: PDF Label
Standard etiketprinter: False
Importnøgle: return-labels

Importnøglen er vigtig, fordi den refereres direkte fra API-forespørgslen.

Eksempel:

"DropZoneLabelPrinterKey": "return-labels"

Når Shipment Server modtager denne værdi, dirigerer DropZone den genererede PDF-etiket til denne printerkonfiguration.

4. Aktivér Cloud Print

Åbn fanen Cloud Print i DropZone og aktiver tjenesten.

Uden Cloud Print aktiveret kan Shipment Server ikke levere etiketter til DropZone-klienten.

Scenario 1 – Udgående forsendelse udskrevet på Zebra-printer

For udgående forsendelser angiver API-forespørgslen:

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

Procesflow

1. Shipment Server opretter forsendelsen.
2. En Zebra (ZPL) etiket genereres.
3. Etiketten sendes via Cloud Print.
4. DropZone modtager printjobbet.
5. Zebra-printeren udskriver automatisk forsendelsesetiketten.

Resultat

Lageroperatøren modtager en fysisk etiket med det samme og kan vedhæfte den til pakken.

Scenario 2 – Returneringsforsendelse genereret som PDF

For returneringsforsendelser angiver API-forespørgslen:

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

Procesflow

1. Shipment Server opretter returneringsforsendelsen.
2. En PDF-etiket genereres.
3. PDF’en sendes via Cloud Print.
4. DropZone dirigerer dokumentet til printerkonfigurationen med nøglen return-labels.
5. PDF’en gemmes i den konfigurerede mappe.

Resultat

Kundeserviceteamet kan hente PDF’en og vedhæfte den til en e-mail, der sendes til slutkunden.

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]