Kirjaudu sisään

Ship Help Center

Tulostaminen lähtölähetyksille ja PDF-tarrojen tallentaminen palautuslähetyksille

Avatar
Simon Schrader Springer
Päivitetty

Kuinka tulostaa lähtölähetyksen tarrat suoraan Zebra-tulostimelle samalla kun palautustarrat luodaan PDF-tiedostoina, jotka tallennetaan kansioon.

Tämä voidaan toteuttaa käyttämällä Shipment Serveriä yhdessä DropZonen kanssa.

Mukana oleva Postman-kokoelma havainnollistaa sekä perinteisen Shipment Server API:n että Shipment Server REST API:n, sekä DropZonen vaatiman konfiguraation.

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

Ympäristömuuttujat

Postman-kokoelma käyttää seuraavia ympäristömuuttujia:

Muuttuja Tarkoitus
ActorID Shipment Serverin Actor ID
KEY Shipment Serverin API-avain
Username Shipment Serverin käyttäjätunnus
Password Shipment Serverin salasana
TicketUserName DropZonen käyttäjä, joka vastaanottaa tulostustyöt
WorkstationID DropZonen työaseman asennus-ID
DropZoneLabelPrinterKey DropZonen tulostinavain, jota käytetään palautustarrojen reititykseen
SSAPIBaseURL Ship API:n perus-URL (v1)
SSRESTAPIBaseURL Ship REST API:n perus-URL (v2)

Ero kahden Shipment Server API:n välillä

Kokoelma esittelee kaksi erilaista tapaa luoda lähetyksiä.

Perinteinen Shipment Server API

Päätepiste:

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

Ominaisuudet:

  • Käyttää multipart/form-data -muotoa.
  • Autentikointi annetaan pyyntöparametrien kautta.
  • Komento-parametri määrittää toiminnon:
"command": "SubmitShipment"
  • Lähetysdata ja asetukset lähetetään JSON-merkkijonoina.

Shipment Server REST API

Päätepiste:

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

Ominaisuudet:

  • Käyttää application/json -muotoa.
  • Käyttää Basic Authenticationia tai OAuthia.
  • Actor ID on osa URL-osoitetta.
  • Data ja asetukset lähetetään natiivina JSON-objekteina.

Toiminnallinen ero

Liiketoiminnan näkökulmasta molemmat API:t suorittavat saman toiminnon:

  • Luo lähetys.
  • Luo tarrat.
  • Reitittää tarrat DropZonen kautta.

Erona on vain API-tyyli, autentikointimekanismi ja tietomuoto.

DropZonen konfigurointi

Ennen kuin API-pyyntöjä voidaan käyttää, DropZone on asennettava ja konfiguroitava työasemalle, joka vastaanottaa tulostustyöt.

1. Kirjaudu sisään DropZoneen

Kirjaudu sisään samalla tilillä, joka on määritelty API-pyynnöissä.

Esimerkki:

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

DropZonessa näytetty työaseman asennus-ID:n on vastattava API-pyynnöissä käytettyä arvoa.

Esimerkki:

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

2. Konfiguroi Zebra-tulostin

Siirry kohtaan:

Tulostimet → Uusi

Valitse Zebra-tulostin, joka tulostaa lähtölähetyksen tarrat.

Esimerkki:

Tulostimen nimi: ZDesigner GK420d
Tulostimen tyyppi: GK240
Oletustarratulostin: Tosi

Tämä tulostin vastaanottaa tarrat Zebra-muodossa.

3. Konfiguroi PDF-tulostin palautustarroille

Luo DropZoneen tiedostotulostin.

Esimerkki:

Tulostimen nimi: ZDesigner GK420d
Tulostuskansio: C:\Data\PrintToFile
Tulostimen tyyppi: PDF Label
Oletustarratulostin: Epätosi
Import Key: return-labels

Import Key on tärkeä, koska siihen viitataan suoraan API-pyynnöstä.

Esimerkki:

"DropZoneLabelPrinterKey": "return-labels"

Kun Shipment Server saa tämän arvon, DropZone reitittää luodun PDF-tarran tähän tulostinkonfiguraatioon.

4. Aktivoi Cloud Print

Avaa Cloud Print -välilehti DropZonessa ja ota palvelu käyttöön.

Ilman Cloud Printin käyttöönottoa Shipment Server ei voi toimittaa tarroja DropZone-asiakkaalle.

Tapaus 1 – Lähtölähetys tulostetaan Zebra-tulostimelle

Lähtölähetyksille API-pyyntö määrittelee:

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

Prosessin kulku

  1. Shipment Server luo lähetyksen.
  2. Luodaan Zebra (ZPL) -tarra.
  3. Tarra lähetetään Cloud Printin kautta.
  4. DropZone vastaanottaa tulostustyön.
  5. Zebra-tulostin tulostaa lähetys tarran automaattisesti.

Tulos

Varaston työntekijä saa fyysisen tarran välittömästi ja voi kiinnittää sen pakettiin.

Tapaus 2 – Palautuslähetys luodaan PDF-muodossa

Palautuslähetyksille API-pyyntö määrittelee:

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

Prosessin kulku

  1. Shipment Server luo palautuslähetyksen.
  2. Luodaan PDF-tarra.
  3. PDF lähetetään Cloud Printin kautta.
  4. DropZone reitittää dokumentin tulostinkonfiguraatioon, jonka avain on return-labels.
  5. PDF tallennetaan määriteltyyn kansioon.

Tulos

Asiakaspalvelutiimi voi hakea PDF:n ja liittää sen asiakkaalle lähetettävään sähköpostiin.

 

Kaavio

flowchart TD
    A[Asiakassysteemi / Postman-kokoelma] --> B{Lähetyksen tyyppi}

    B -->|Normaali lähtölähetys| C[Lähetä lähetyspyyntö]
    C --> C1[Asetukset: Labels = ZPLGK]
    C1 --> C2[TicketUserName tunnistaa DropZonen käyttäjän]
    C2 --> C3[WorkstationID tunnistaa DropZonen asennuksen]
    C3 --> D[Shipment Server luo lähetyksen]
    D --> E[Shipment Server luo Zebra ZPL -tarran]
    E --> F[Cloud Print lähettää tarran DropZoneen]
    F --> G[DropZone reitittää työn Zebra-tulostimelle]
    G --> H[Fyysinen tarra tulostetaan]

    B -->|Palautuslähetys| I[Lähetä palautuslähetyspyyntö]
    I --> I1[Asetukset: Labels = PDF]
    I1 --> I2[DropZoneLabelPrinterKey = return-labels]
    I2 --> I3[TicketUserName tunnistaa DropZonen käyttäjän]
    I3 --> I4[WorkstationID tunnistaa DropZonen asennuksen]
    I4 --> J[Shipment Server luo palautuslähetyksen]
    J --> K[Shipment Server luo PDF-tarran]
    K --> L[Cloud Print lähettää PDF:n DropZoneen]
    L --> M[DropZone reitittää PDF:n ReturnLabels-tulostimelle]
    M --> N[PDF tallennetaan määriteltyyn kansioon]
    N --> O[PDF voidaan liittää asiakkaalle lähetettävään sähköpostiin]

Aiheeseen liittyvät artikkelit