Ten interfejs API umożliwia utworzenie otwartej przesyłki i dodawanie do niej paczek przez pewien czas zamiast wprowadzania wszystkich informacji o przesyłce i paczkach za jednym razem. Przesyłka pozostaje otwarta przez okres pięciu dni i w tym czasie można dodawać paczki i wprowadzać zmiany. Po potwierdzeniu przesyłki można wygenerować dokumenty wysyłkowe, takie jak etykiety, lotniczy list przewozowy (AWB) lub raporty. Pod koniec piątego dnia przesyłkę należy potwierdzić. W przeciwnym wypadku zostanie wyczyszczona.

Uwaga: otwarte przesyłki są czyszczone, jeśli nie zostają potwierdzone do końca piątego dnia od ich utworzenia.

Interfejsu Open Ship API należy użyć, gdy trzeba dodać wiele paczek do przesyłki na przestrzeni czasu i nie wiadomo dokładnie, ile to będzie paczek lub kiedy przesyłka zostanie zrealizowana. Umożliwia to elastyczne przygotowywanie przesyłki przez cały dzień, aż wszystko będzie gotowe do wysyłki.

Otwarte przesyłki są często przesyłkami wieloczęściowymi, ale mogą być również przesyłkami jednopaczkowymi, czyli jednoczęściowymi.

Aby nadać przesyłkę wieloczęściową (MPS) do jednego odbiorcy, skorzystaj z interfejsu API Open Ship i dodaj do przesyłki poszczególne paczki lub dodaj wiele paczek, jeśli mają trafić do tego samego odbiorcy.

Poniżej przedstawiono usługi związane z otwartą przesyłką:

• FedEx Express^®, krajowa na terenie USA i krajowa na terenie Kanady
• FedEx Ground^®, krajowa na terenie USA i krajowa na terenie Kanady
• FedEx Home Delivery^®
• FedEx International Priority^®
• FedEx International Priority^® Express (IPE)
• FedEx International Economy^®
• FedEx Priority Overnight^TM
• FedEx® Regional Economy
• FedEx® Regional Economy Freight
• FedEx International Connect Plus®
• FedEx® First
• FedEx Priority Express
• FedEx Priority
• FedEx Priority Express Freight
• FedEx Priority Freight
• FedEx Economy (tylko Wielka Brytania)

Poniżej przedstawiono funkcje związane z interfejsem Open Ship API:

Zarządzanie otwartymi przesyłkami

Ta funkcja umożliwia nadawcom tworzenie, modyfikowanie i usuwanie otwartych przesyłek oraz pobieranie danych już utworzonych otwartych przesyłek w celu przeglądu lub weryfikacji. Umożliwia potwierdzenie ukończonej przesyłki, przekazanie jej danych do FedEx oraz wygenerowanie odpowiedniej dokumentacji wysyłkowej. Ponadto identyfikuje i zgłasza ewentualne błędy w transakcji oraz zwraca odpowiedni status.

Kluczowe informacje w tej funkcji to accountNumber, Shipment Data, groupPackageCount oraz index (wskazujący paczkę główną w przesyłce). Dzięki tej funkcji dane przesyłki zostaną przekazane do systemów FedEx oraz zostaną wygenerowane odpowiednie numery śledzenia, etykiety i raporty dotyczące przesyłki.

Zarządzanie paczkami w otwartej przesyłce

Ta funkcja umożliwia dodawanie, modyfikowanie i usuwanie paczek w już utworzonej otwartej przesyłce. Można również pobrać istniejącą paczkę dla istniejącej otwartej przesyłki.

Pobieranie wyników otwartej przesyłki (asynchroniczne)

Ta funkcja umożliwia asynchroniczne pobieranie wyników potwierdzonych przesyłek. Po potwierdzeniu otwartej przesyłki zawierającej co najmniej 40 paczek interfejs API przetwarza tę przesyłkę asynchronicznie.

W przypadku asynchronicznego przetwarzania przesyłki odpowiedź na to żądanie potwierdza jedynie, że żądanie zostało pomyślnie umieszczone w kolejce, ale sama przesyłka mogła zostać pomyślnie przetworzona lub nie. W odpowiedzi zwracany jest identyfikator jobId pozwalający później pobrać wynik. Ta funkcja używa identyfikatora jobId do pobrania wyników OpenShipment (CREATE, MODIFY i CONFIRM), które mogą być etykietami lub raportami dotyczącymi przesyłki. Ponadto identyfikuje i zgłasza ewentualne błędy w przesyłce oraz zwraca odpowiedni status.

Uwaga: jeśli odpowiedź dotycząca przesyłki przetwarzanej asynchronicznie zawiera błędy, popraw te błędy i prześlij nowe żądanie dotyczące przesyłki.

W tej sekcji szczegółowo opisano przepływ pracy interfejsu Open Ship API. Przepływem pracy Open Ship zarządza się na dwa sposoby lub przy użyciu dwóch opcji przetwarzania:

Przepływ pracy dla 40 lub mniej paczek

1. Użyj punktu końcowego Create Open Shipment (Utwórz otwartą przesyłkę), aby utworzyć otwartą przesyłkę ze wszystkimi wymaganymi informacjami o wysyłce i opakowaniu oraz wartościami accountNumber i index.
2. Użyj punktu końcowego Add Open Shipment Packages (Dodaj paczki otwartej przesyłki), aby dodać jedną lub więcej (nie więcej niż 40) paczek do już utworzonej otwartej przesyłki. Kluczowymi danymi wejściowymi są index i accountNumber otwartej przesyłki, do której dodawane są paczki.
3. Użyj punktu końcowego Confirm Open Shipment (Potwierdź otwartą przesyłkę), aby ostatecznie potwierdzić, że wszystkie paczki zostały dodane, a przesyłka jest ukończona. Kluczowymi danymi wejściowymi są index i accountNumber przesyłki do potwierdzenia.

Ten punkt końcowy Confirm Open Shipment (Potwierdź otwartą przesyłkę) jest ostatnim w tym przepływie. Weryfikuje on informacje o przesyłce i paczkach oraz pomyślnie generuje etykiety i wszystkie inne raporty dotyczące przesyłki. Udostępnia również szczegóły błędów zwrócone podczas weryfikacji. Te błędy można poprawić za pomocą punktów końcowych Modify Open Shipment (Modyfikuj otwartą przesyłkę) lub Modify Open Shipment Packages (Modyfikuj paczki otwartej przesyłki), ponownie potwierdzając przesyłkę w celu pomyślnego przesłania żądania.

Przepływ pracy dla ponad 40 paczek

1. Użyj punktu końcowego Create Open Shipment (Utwórz otwartą przesyłkę), aby utworzyć otwartą przesyłkę ze wszystkimi wymaganymi informacjami o wysyłce i opakowaniu oraz wartościami accountNumber i index.
2. Użyj punktu końcowego Add Open Shipment Packages (Dodaj paczki otwartej przesyłki), aby dodać jedną lub więcej (nie więcej niż 40) paczek do już utworzonej otwartej przesyłki. Kluczowymi danymi wejściowymi są index i accountNumber otwartej przesyłki, do której mają zostać dodane paczki.
3. Użyj punktu końcowego Confirm Open Shipment (Potwierdź otwartą przesyłkę), aby potwierdzić, że wszystkie paczki zostały dodane, a przesyłka jest ukończona. Kluczowymi danymi wejściowymi są index i accountNumber przesyłki do potwierdzenia. W tym przypadku, ponieważ paczek jest więcej niż 40, interfejs API przetwarza przesyłkę asynchronicznie i zwraca identyfikator jobId, za pomocą którego później zostanie pobrany status przesyłki. Jeśli odpowiedź zawiera błędy, należy je poprawić za pomocą punktów końcowych Modify Open Shipment (Modyfikuj otwartą przesyłkę) lub Modify Open Shipment Packages (Modyfikuj paczki otwartej przesyłki), a następnie należy potwierdzić przesyłkę za pomocą punktu końcowego Confirm Open Shipment (Potwierdź otwartą przesyłkę).
4. Użyj punktu końcowego Get Open Shipment Results (Pobierz wyniki otwartej przesyłki), aby pobrać wyniki poleceń utworzenia, zmodyfikowania i potwierdzenia otwartej przesyłki, takie jak etykiety i dokumenty wysyłkowe. Kluczowymi danymi wejściowymi są jobId i accountNumber potwierdzonej przesyłki.

Punkt końcowy Get Open Shipment Results (Pobierz wyniki otwartej przesyłki) jest ostatnim punktem końcowym w tym przepływie. Pobiera on wyniki potwierdzonej otwartej przesyłki, takie jak etykiety i wszystkie inne raporty dla potwierdzonej otwartej przesyłki. Jeśli w odpowiedzi zwrócono szczegóły błędu, można te błędy poprawić za pomocą punktu końcowego Modify Open Shipment (Modyfikuj otwartą przesyłkę) lub Modify Open Shipment Packages (Modyfikuj paczki otwartej przesyłki), a następnie potwierdzić przesyłkę za pomocą punktu końcowego Confirm Open Shipment (Potwierdź otwartą przesyłkę) i na koniec użyć punktu końcowego Get Open Shipment Results (Pobierz wyniki otwartej przesyłki), aby pobrać wyniki potwierdzonej otwartej przesyłki dla pomyślnego żądania.

Poniżej przedstawiono funkcje związane z interfejsem Open Ship API:

Create Open Shipment (Utwórz otwartą przesyłkę)

Użyj tego punktu końcowego, aby utworzyć otwartą przesyłkę z wymaganymi informacjami o przesyłce i zdefiniować co najmniej jedną paczkę w przesyłce.

Poniżej podano informacje wejściowe wymagane do utworzenia otwartej przesyłki:

• openShipmentAction — jest to akcja otwarcia przesyłki i w tym przypadku należy użyć wartości w postaci CREATE_PACKAGE.
• accountNumber — jest to numer konta FedEx.
• requestedShipment — szczegóły przesyłki danej otwartej przesyłki.
• index — niepowtarzalna wartość dotycząca otwartej przesyłki. Ta wartość jest przydatna przy modyfikowaniu przesyłki lub paczki. Jest to pozycja opcjonalna. Jeśli nie zostanie podana, do jednoznacznego identyfikowania przesyłki można użyć głównego numeru śledzenia.

Pomyślna odpowiedź na to żądanie spowoduje przetworzenie przesyłki i wygenerowanie numeru śledzenia, który jest głównym numerem śledzenia dla pierwszej paczki. Uwaga: w odpowiedzi nie zostaną wygenerowane żadne etykiety.

Add Open Shipment Packages (Dodaj paczki otwartej przesyłki)

Użyj tego punktu końcowego, aby dodać jedną lub więcej paczek do istniejącego żądania otwartej przesyłki przed potwierdzeniem tej przesyłki. Dla każdej paczki możesz wysłać osobne żądanie dodania paczki podczas przygotowywania przesyłki w ciągu dnia. Możesz również wysłać informacje o wielu paczkach w ramach żądania dodania paczki.

Uwaga: łączna liczba paczek w przesyłce nie może przekraczać limitu paczek dozwolonych przy otwartych przesyłkach.

Poniżej podano informacje wejściowe wymagane do dodawania paczek do otwartej przesyłki:

• index — jest to niepowtarzalna wartość przypisana do już utworzonej otwartej przesyłki. Jeśli ta wartość nie jest dostępna, podaj główny numer śledzenia.
• requestedPackageLineItem — szczegółowe informacje o paczkach do dodania.
• accountNumber — jest to numer konta FedEx.

Pomyślna odpowiedź na to żądanie spowoduje wygenerowanie numeru śledzenia dla nowo dodanej paczki.

Modify Open Shipment Packages (Modyfikuj paczki otwartej przesyłki)

Użyj tego punktu końcowego, aby zmodyfikować jedną lub więcej pozycji szczegółów paczek w już istniejącej przesyłce obsługiwanej przez interfejs Open Ship przed potwierdzeniem przesyłki. Obejmuje to również paczkę główną, czyli pierwszą paczkę dodaną do otwartej przesyłki.

Poniżej znajdują się wymagane informacje wejściowe powiązane z tym żądaniem:

• index — jest to niepowtarzalna wartość przypisana do już utworzonej otwartej przesyłki. Jeśli ta wartość nie jest dostępna, podaj główny numer śledzenia.
• accountNumber — jest to numer konta FedEx.
• trackingId — jeden lub więcej identyfikatorów śledzenia paczek obsługiwanych przez interfejs Open Ship dla paczek, które mają zostać zmodyfikowane.
• requestedPackageLineItem — szczegółowe informacje o paczkach do zmodyfikowania.

Pomyślne żądanie spowoduje zaktualizowanie odpowiednich paczek i zwrócenie zaktualizowanych szczegółów przesyłki.

Delete Open Shipment Packages (Usuń paczki otwartej przesyłki)

Użyj tego punktu końcowego, aby usunąć jedną lub więcej paczek z już utworzonej otwartej przesyłki przed potwierdzeniem wysyłki.

Poniżej znajdują się wymagane informacje wejściowe powiązane z tym żądaniem:

• index — jest to niepowtarzalna wartość przypisana do już utworzonej otwartej przesyłki. Jeśli ta wartość nie jest dostępna, podaj główny numer śledzenia.
• accountNumber — jest to numer konta FedEx.
• trackingId — jeden lub więcej identyfikatorów śledzenia paczek obsługiwanych przez interfejs Open Ship, dla których otrzymano żądanie usunięcia.

Pomyślne żądanie spowoduje usunięcie odpowiednich paczek i zwrócenie statusu elementu deletedPackagesFromOpenshipment o wartości true w danych wyjściowych.

Uwaga: w przypadku usunięcia paczki głównej z przesyłki paczką główną staje się następna w kolejności paczka, zostaje do niej ponownie przypisany główny numer śledzenia, a sekwencja numerów zmniejsza się o liczbę usuniętych paczek.

Retrieve Open Shipment Package (Pobierz paczkę z otwartej przesyłki)

Użyj tego punktu końcowego, aby pobrać jedną lub więcej paczek z już utworzonej otwartej przesyłki w celu przejrzenia lub zweryfikowania.

Poniżej znajdują się wymagane informacje wejściowe powiązane z tym żądaniem:

• index — jest to niepowtarzalna wartość przypisana do już utworzonej otwartej przesyłki. Jeśli ta wartość nie jest dostępna, podaj główny numer śledzenia.
• accountNumber — jest to numer konta FedEx.
• trackingId — jeden lub więcej identyfikatorów śledzenia paczek obsługiwanych przez interfejs Open Ship, dla których mają zostać pobrane szczegóły.

Pomyślne żądanie spowoduje pobranie odpowiednich paczek.

Modify Open Shipment (Modyfikuj otwartą przesyłkę)

Użyj tego punktu końcowego, aby zmodyfikować żądanie otwartej przesyłki za pomocą wymaganych informacji o wysyłce przed potwierdzeniem przesyłki.

Poniżej znajdują się wymagane informacje wejściowe powiązane z tym żądaniem:

• index — jest to niepowtarzalna wartość przypisana do już utworzonej otwartej przesyłki. Jeśli ta wartość nie jest dostępna, podaj główny numer śledzenia.
• accountNumber — jest to numer konta FedEx.
• requestedShipment — szczegóły przesyłki związane z modyfikowaną otwartą przesyłką.

Pomyślne żądanie spowoduje zaktualizowanie szczegółów przesyłki dla już utworzonej otwartej przesyłki i zwrócenie numeru śledzenia zmodyfikowanych paczek oraz zaktualizowanych szczegółów przesyłki transakcji jako danych wyjściowych.

Retrieve Open Shipment (Pobierz otwartą przesyłkę)

Użyj tego punktu końcowego, aby pobrać już utworzoną otwartą przesyłkę w celu przejrzenia lub zweryfikowania.

Poniżej znajdują się wymagane informacje wejściowe powiązane z tym żądaniem:

• index — jest to niepowtarzalna wartość przypisana do już utworzonej otwartej przesyłki. Jeśli ta wartość nie jest dostępna, podaj główny numer śledzenia.
• accountNumber — jest to numer konta FedEx.

Pomyślne żądanie spowoduje pobranie szczegółów odpowiedniej otwartej przesyłki.

Delete Open Shipment (Usuń otwartą przesyłkę)

Użyj tego punktu końcowego, aby usunąć żądanie otwartej przesyłki przed potwierdzeniem tej przesyłki.

Poniżej znajdują się wymagane informacje wejściowe powiązane z tym żądaniem:

• index — jest to niepowtarzalna wartość przypisana do już utworzonej otwartej przesyłki. Jeśli ta wartość nie jest dostępna, podaj główny numer śledzenia.
• accountNumber — jest to numer konta FedEx.

Pomyślne żądanie spowoduje usunięcie otwartej przesyłki i wszystkich powiązanych paczek oraz zwrócenie statusu elementu deletedOpenshipment o wartości true w danych wyjściowych.

Confirm Open Shipment (Potwierdź otwartą przesyłkę)

Użyj tego punktu końcowego, aby zweryfikować i przekazać dane przesyłki obsługiwanej przez interfejs Open Ship do systemów FedEx po dodaniu wszystkich paczek do żądania dotyczącego przesyłki.

Poniżej znajdują się wymagane informacje wejściowe powiązane z tym żądaniem:

• index — jest to niepowtarzalna wartość przypisana do już utworzonej otwartej przesyłki. Jeśli ta wartość nie jest dostępna, podaj główny numer śledzenia.
• accountNumber — jest to numer konta FedEx.
• labelResponseOptions — określ, czy w odpowiedzi ma zostać zwrócony zakodowany kod bajtowy, czy adres URL etykiety.
  Uwaga: element labelResponseOptions jest dostępny tylko w Żądaniu potwierdzenia otwartej przesyłki. Po potwierdzeniu przesyłki generowane są etykiety.

Pomyślna odpowiedź z potwierdzeniem dla 40 lub mniejszej liczby paczek spowoduje przekazanie danych przesyłki do systemów FedEx i wygenerowanie etykiet paczek oraz wszystkich innych raportów dotyczących przesyłki.

Pomyślna odpowiedź z potwierdzeniem dla ponad 40 paczek zawiera informacje o pomyślnym umieszczeniu żądania w kolejce i zwraca jobId na potrzeby późniejszego pobrania wyniku.

Uwaga: przed potwierdzeniem przesyłki otwartej należy dodać do niej co najmniej jedną paczkę.

Get Open Shipment Results (Pobierz wyniki otwartej przesyłki)

Użyj tego punktu końcowego, aby pobrać dane potwierdzonej przesyłki obsługiwanej przez interfejs Open Ship. Tego punktu końcowego należy używać tylko wtedy, gdy przesyłka zawiera więcej niż 40 paczek, a w potwierdzeniu otwartej przesyłki zwrócono jobId.

Poniżej znajdują się wymagane informacje wejściowe powiązane z tym żądaniem:

• resultMethodType — określ wartość jako CREATE.
• accountNumber — jest to numer konta FedEx.
• jobId — jest to jobId odebrany podczas potwierdzania otwartej przesyłki.

Pomyślna odpowiedź na to żądanie spowoduje zwrócenie wyników dotyczących potwierdzonej otwartej przesyłki, takich jak etykiety paczek i wszystkie inne raporty dotyczące przesyłki dla potwierdzonej otwartej przesyłki. Jeśli w odpowiedzi zwrócono szczegóły błędu, można te błędy poprawić za pomocą punktu końcowego Modify Open Shipment (Modyfikuj otwartą przesyłkę) lub Modify Open Shipment Packages (Modyfikuj paczki otwartej przesyłki), a następnie potwierdzić przesyłkę za pomocą punktu końcowego Confirm Open Shipment (Potwierdź otwartą przesyłkę) i na koniec użyć punktu końcowego Get Open Shipment Results (Pobierz wyniki otwartej przesyłki), aby pobrać wyniki potwierdzonej otwartej przesyłki dla pomyślnego żądania.

Otwarta przesyłka wieloczęściowa (Multiple Piece Shipment, MPS) składa się z co najmniej dwóch paczek wysyłanych na ten sam adres odbiorcy. Pierwsza paczka w żądaniu przesyłki jest uważana za paczkę główną.

Aby utworzyć przesyłkę wieloczęściową:

• Należy uwzględnić informacje na poziomie przesyłki, na przykład elementy serviceType, packagingType, totalWeight, totalPackageCount oraz requestedPackageLineItems dla paczki głównej.
  Uwaga: element sequenceNumber dla paczki głównej musi być równy 1.
• Dodaj wszystkie paczki do przesyłki.
• Potwierdź przesyłkę.

Po potwierdzeniu przesyłki używana jest jedna z poniższych opcji przetwarzania:

Synchroniczne przetwarzanie przesyłek

Przetwarzanie synchroniczne to jedna z optymalnych metod przetwarzania. Jest ona używana wewnętrznie, gdy przesyłka zawiera 40 lub mniej paczek (całkowita liczba paczek/grouppackagecount<=40) i zawiera ograniczoną liczbę towarów.

Żądanie przesyłki zawierającej 40 lub mniej paczek w przypadku potwierdzenia jest przetwarzane synchronicznie. Etykiety oraz inne dokumenty/raporty dotyczące przesyłki są generowane natychmiast. Ten proces jest optymalny w przypadku nadawców, u których istnieje ograniczenie czasowe lub etykiety muszą zostać wydrukowane natychmiast po potwierdzeniu przesyłki.

Uwaga: limit 40 paczek ma charakter orientacyjny i nie jest limitem stałym. Zależy on również od liczby paczek i towarów w przesyłce. Aby uzyskać więcej informacji, skontaktuj się z zespołem wsparcia FedEx.

Przykład: żądanie dotyczące otwartej przesyłki obejmuje 10 paczek. W przypadku potwierdzania przesyłki po dodaniu wszystkich 10 paczek przesyłka będzie przetwarzana synchronicznie. W odpowiedzi zostanie wygenerowanych 10 etykiet. Zostaną zwrócone też adresy URL etykiet lub zakodowane etykiety zgodnie z żądaniem.

Poniższy ogólny przepływ pracy ilustruje przetwarzanie synchroniczne otwartej przesyłki:

1. Użyj punktu końcowego Create Open Shipment (Utwórz otwartą przesyłkę).
2. Dodaj 1–40 paczek za pomocą punktu końcowego Add Open Shipment Packages (Dodaj paczki otwartej przesyłki).
3. Użyj punktu końcowego Confirm Open Shipment (Potwierdź otwartą przesyłkę), aby potwierdzić otwartą przesyłkę.
4. Żądanie zakończone powodzeniem powinno wygenerować etykiety. Odpowiedź z danymi wyjściowymi zawiera adresy URL etykiety lub zakodowane etykiety zgodnie z żądaniem.
5. Jeśli przesyłka zawiera błędy, odpowiedź zawiera szczegóły błędu.
6. Po poprawieniu wszystkich błędów użyj punktu końcowego Confirm Open Shipment (Potwierdź otwartą przesyłkę), aby uzyskać pomyślną odpowiedź.

Uwaga: 

• W tej metodzie, jeśli chcesz dodać więcej paczek do istniejącej przesyłki, możesz dodać ich maksymalnie 40. 

Asynchroniczne przetwarzanie przesyłek

Interfejs API wewnętrznie przetwarza przesyłkę asynchronicznie, gdy łączna liczba paczek przekracza 40 (tj. totalPackageCount>40). To bardzo wygodna metoda w przypadku dużej liczby paczek oraz okresowego wysyłania przesyłek zbiorczych. Wysyłanie przesyłek zbiorczych wiąże się z użyciem różnych drogich zasobów i operacji FedEx. W przypadku tej opcji przetwarzania FedEx wewnętrznie gwarantuje, że przesyłki zbiorcze są łatwo przetwarzane, a dane etykiety są dostępne okresowo.

Gdy przesyłka jest przetwarzana asynchronicznie, odpowiedź na to żądanie tylko potwierdza, że żądanie zostało pomyślnie dodane do kolejki, ale sama przesyłka mogła nie zostać pomyślnie przetworzona. Zwracany jest też jobId w celu pobrania wyników później.

Uwaga: w przypadku tego procesu pomyślne przetworzenie przesyłki pozwalające na późniejsze uzyskanie wyników zajmuje pewien czas.

Aby uzyskać wyniki dotyczące przesyłki przetwarzanej asynchronicznie, użyj punktu końcowego Get Open Shipment Results (Pobierz wyniki otwartej przesyłki) i w żądaniu podaj szczegóły jobId oraz accountNumber. Odpowiedź na to żądanie będzie zawierać dane wynikowe dotyczące przesyłki lub szczegóły błędu dotyczącego przesyłki.

Przykład: przesyłka składająca się z 45 paczek w przypadku jej potwierdzania będzie przetwarzana asynchronicznie. W odpowiedzi zwrócony zostanie jobId. Następnie należy użyć punktu końcowego Get Open Shipment Results (Pobierz wyniki otwartej przesyłki), aby pobrać wyniki dotyczące przesyłki i dane etykiet.

Poniższy ogólny przepływ pracy ilustruje przetwarzanie asynchroniczne wysyłki:

1. Użyj punktu końcowego Create Open Shipment (Utwórz otwartą przesyłkę).
2. Dodaj 40 lub więcej paczek za pomocą punktu końcowego Add Open Shipment Packages (Dodaj paczki otwartej przesyłki).
3. Użyj punktu końcowego Confirm Open Shipment (Potwierdź otwartą przesyłkę), aby potwierdzić przesyłkę.
4. Przesłanie zakończone powodzeniem spowoduje zwrócenie elementu jobId.
5. Za pomocą danych jobId i accountNumber pobierz wyniki wyjściowe, używając punktu końcowego Get Open Shipment Results (Pobierz wyniki otwartej przesyłki).
6. Dane wyjściowe pomyślnej operacji będą zawierać dane wyników ze szczegółami etykiet.
7. Jeśli dane wynikowe zawierają błędy, odpowiedź zawiera szczegóły błędu.

Uwaga:

• W tej metodzie w pojedynczym żądaniu maksymalne dopuszczalne wartości to liczba paczek do 300 lub liczba towarów do 999. 
• W tej metodzie po przesłaniu żądania nie można dodawać nowych, modyfikować ani usuwać paczek w pierwotnym żądaniu. Jeśli w odpowiedzi znajdują się błędy, popraw je za pomocą punktu końcowego Modify Open Shipment Packages (Modyfikuj paczki otwartej przesyłki), a następnie potwierdź przesyłkę za pomocą punktu końcowego Confirm Open Shipment (Potwierdź otwartą przesyłkę) i pobierz wyniki z danych wyjściowych pomyślnej operacji za pomocą punktu końcowego Get Open Shipment Results (Pobierz wyniki otwartej przesyłki).

Interfejs API FedEx obsługuje wiele różnych etykiet. Interfejs API FedEx obsługuje trzy typy opcji etykiet, w tym etykiety termiczne, na zwykłym papierze i dostosowywalne. Przy użyciu punktów końcowych interfejsu Open Ship API możesz utworzyć wiele różnych etykiet.

FedEx udostępnia 2 formaty etykiet na potrzeby usług wysyłkowych:

• Etykiety termiczne
• Etykiety laserowe

Etykiety termiczne

Interfejs API FedEx umożliwia drukowanie etykiet wysyłkowych dla wszystkich rodzajów wysyłek, na przykład FedEx Express^®, FedEx Ground^® i FedEx International Ground^® przy użyciu różnych termicznych drukarek etykiet.

Interfejs API FedEx obsługuje następujące rozmiary etykiet termicznych:

• 4 cale x 6 cali — bez konfigurowalnej karty dokumentu (Doc-Tab)
• 4 cale x 6,75 cala — z kartą Doc-Tab lub bez niej
• 4 cale x 8 cali — z miejscem na wybraną grafikę lub wybrany plik tekstowy
• 4 cale x 8,5 cala – z konfigurowalną kartą dokumentu (specjalnie dołączona do etykiety identyfikacyjnej opony)
• 4 cale x 9 cali — z miejscem na grafiki lub tekst oraz kartę Doc-Tab
• 4 cale x 10,5 cala – z konfigurowalną kartą dokumentu (specjalnie dołączona do etykiety identyfikacyjnej opony)
  

Rodzaje materiału etykiety 4 cale x 8,5 cala i 4 cale x 10,5 cala zawierają dodawaną kartę dokumentu z identycznymi kodami kreskowymi. Jeden kod kreskowy jest wyświetlany na etykiecie głównej, a drugi na karcie dokumentu. Ta wartość dla rodzaju materiału etykiety jest przydatna w przypadku paczek z oponami, ponieważ jedną etykietę można umieścić na bieżniku opony, a dodatkową etykietę na boku opony — z duplikatem kodu kreskowego i instrukcją obsługi. Stosowanie tych rodzajów materiałów etykiety pozwala ograniczyć ponowne etykietowanie opon, a zwiększona ilość skanów wymiarowych optymalizuje odzyskiwanie. Aby uzyskać więcej informacji o materiale etykiety, zapoznaj się z informacjami o rodzajach materiałów etykiet.

Uwaga: karta Doc-Tab to usuwalna przyklejana karta z dodatkowymi informacjami wysyłkowymi, która może zostać wybrana jako materiał etykiety podczas drukowania etykiet wysyłkowych przy użyciu drukarki termicznej.

Elementy etykiety termicznej

Termiczne etykiety wysyłkowe zawierają trzy podstawowe elementy:

• Zawartość czytelna dla człowieka: ta część etykiety zawiera informacje wysyłkowe.
• Czytelny dla człowieka kod kreskowy jest domyślnie zaszyfrowany.
• Dwuwymiarowy kod kreskowy: wymiarowy alfanumeryczny kod kreskowy zawiera dane przesyłek FedEx Express i FedEx Ground przy użyciu standardu American National Standards Institute (ANSI) MH10.8.3. Dwuwymiarowy kod kreskowy jest tworzony przy użyciu symboliki 417 PDF (Portable Data File).
• Kod kreskowy FedEx
  • ASTRA (Advanced Sorting Tracking Routing Assistance) dla przesyłek FedEx Express do chwili pełnego wdrożenia kodu kreskowego FDX 1D. Kod kreskowy „96” dla przesyłek FedEx Ground i FedEx Home Delivery. Usługa FedEx Ground umożliwia także korzystanie z kodu kreskowego „00” SSCC-18.
  • Kod kreskowy FedEx 1D (FDX1D) przesyłek FedEx Express jest tworzony przy użyciu standardu ANSI/AIM BC4-1995 (Uniform Symbology Specification CODE-128C).

Najważniejsze informacje potrzebne do wygenerowania etykiety termicznej

Poniżej znajdują się najważniejsze informacje wymagane do wygenerowania etykiety termicznej:

• LabelFormatType: element wymagany do uzyskania poprawnego obrazu etykiety przy użyciu interfejsu Open Ship Reply API:
  • COMMON2D: rodzaj formatu etykiety.
  • LABEL_DATA_ONLY: wartość używana do odbierania danych kodów kreskowych w przypadku tworzenia etykiety niestandardowej.

Poprawne wartości:

• ImageType: element wymagany do sformatowania etykiety termicznej pod kątem używanej drukarki. Określa rodzaj strumienia danych lub bitmapy, która ma zostać zwrócona.

  • EPL2 — Eltron (typy standardowych etykiet)
  • ZPLII — Zebra (typy standardowych etykiet)

Poprawne wartości:

Uwaga: wszystkie etykiety wymagane w przypadku przesyłki są generowane i zwracane w pojedynczym buforze.

Obsługiwane drukarki termiczne

Poniższe drukarki termiczne są zalecane w przypadku interfejsu API FedEx:

• Unimark
• Eltron
  • Orion (EPL2)
  • Eclipse (EPL2)
• Zebra
  • LP2443 (EPL2)
  • LP2844 (EPL2)
  • Gk420 (ZPL)
  • LP2348 Plus (EPL2/ZPL)
  • Z4M Plus (ZPL lub EPL)
  • ZP500/ZP505 (EPL2/ZPL)
  • Z4M/Z4M+ (EPL2/ZPL)
  • ZM400 (EPL2/ZPL)
  • ZT410 (EPL2/ZPL)
  • Inne drukarki z serii ZT4xx (EPL2/ZPL)

Uwaga: wszystkie te drukarki są zgodne z trybem strony języka ASCII Eltron Programming Language (EPL2). Drukarki termiczne są obsługiwane przy użyciu bezpośredniego zapisu na drukarce podłączonej do portu szeregowego systemu oraz jako natywne drukarki zainstalowane w systemie Windows i podłączone przy użyciu złącza LPT, szeregowego lub USB. Wersje oprogramowania sprzętowego drukarek udostępnionych przez FedEx mogą się różnić zależnie od regionu.

Liczba etykiet termicznych drukowanych dla usługi

Poniższa tabela wskazuje liczbę etykiet każdego typu potrzebnych dla danej usługi specjalnej. Wszystkie potrzebne etykiety są generowane przy użyciu wywołania serwera FedEx CLS (Common Label Server), który zwraca pojedynczy bufor z wyjątkiem etykiet zwrotnych w przypadku płatności przy odbiorze.

Liczba etykiet termicznych drukowanych dla usługi w USA

Typ usługi	Etykiety termiczne (serwer FedEx CLS zwraca w odpowiedzi odpowiednią liczbę etykiet)
FedEx Express w Stanach Zjednoczonych	1 etykieta wysyłkowa
FedEx Ground w Stanach Zjednoczonych/FedEx Home Delivery	1 etykieta wysyłkowa

Liczba etykiet termicznych drukowanych dla usługi Export International w USA

Typ usługi	Etykiety termiczne (serwer FedEx CLS zwraca w odpowiedzi odpowiednią liczbę etykiet)
FedEx Express Export International (Stany Zjednoczone)	1 etykieta wysyłkowa 2 etykiety odbiorcy
FedEx Express Export International (Stany Zjednoczone, opcja wyboru brokera)	1 etykieta wysyłkowa 2 etykiety odbiorcy
FedEx Ground Export International (Stany Zjednoczone)	1 etykieta wysyłkowa
FedEx Ground Export International (Stany Zjednoczone) z płatnością przy odbiorze	1 etykieta wysyłkowa 2 etykiety zwrotne w przypadku płatności przy odbiorze

Liczba etykiet termicznych drukowanych dla usługi wewnątrzkrajowej w Kanadzie

Typ usługi	Etykiety termiczne (serwer FedEx CLS zwraca w odpowiedzi odpowiednią liczbę etykiet)
FedEx Express na terenie Kanady	Towary niebędące towarami niebezpiecznymi/przesyłka suchego lodu: 1 etykieta wysyłkowa
FedEx Ground na terenie Kanady	1 etykieta wysyłkowa
FedEx Ground na terenie Kanady z płatnością przy odbiorze	1 etykieta wysyłkowa 2 etykiety zwrotne w przypadku płatności przy odbiorze

Liczba etykiet termicznych drukowanych dla usługi Export International w Kanadzie

Typ usługi	Etykiety termiczne (serwer FedEx CLS zwraca w odpowiedzi odpowiednią liczbę etykiet)
FedEx Express Export International (Kanada)	Towary niebędące towarami niebezpiecznymi/przesyłka suchego lodu: 1 etykieta wysyłkowa 2 etykiety odbiorcy
FedEx Express Export International (Kanada, opcja wyboru brokera)	Towary niebędące towarami niebezpiecznymi/przesyłka suchego lodu: 1 etykieta wysyłkowa 2 etykiety odbiorcy
FedEx Ground Export International (Kanada)	1 etykieta wysyłkowa

Liczba etykiet termicznych drukowanych dla przesyłek przychodzących na Filipinach i w Tajlandii

Typ usługi	Etykiety termiczne (serwer FedEx CLS zwraca w odpowiedzi odpowiednią liczbę etykiet)
Przesyłki przychodzące na Filipiny	2 etykiety wysyłkowe z wydrukowanym numerem konta 1 etykieta odbiorcy bez wydrukowanego numeru konta 3 kopie faktury handlowej
Przychodzące przesyłki towarów do Tajlandii	3 etykiety wysyłkowe z wydrukowanym numerem konta 1 etykieta odbiorcy bez wydrukowanego numeru konta
Przychodzące przesyłki dokumentów do Tajlandii	2 etykiety wysyłkowe z wydrukowanym numerem konta 1 etykieta odbiorcy bez wydrukowanego numeru konta

Doc-Tab

W przypadku drukowania etykiet wysyłkowych przy użyciu drukarki termicznej możesz wybrać materiał etykiety zawierający kartę Doc-Tab, usuwalną przylepną kartę z dodatkowymi informacjami wysyłkowymi. Te informacje wysyłkowe możesz skonfigurować przy użyciu danych wysyłki. Możesz też wydrukować konfigurowalne dane odpowiadające potrzebom wysyłkowym.

Etykiety laserowe

Interfejs API FedEx obsługuje drukowanie etykiet przy użyciu drukarki laserowej. Etykiety te są zwykle drukowane na papierze w formacie U.S. Letter lub A4 i składane na pół, by zmieściły się w standardowej przyklejonej foliowej kieszeni na etykiety FedEx. Etykiety drukowane przy użyciu drukarki laserowej są generowane w formacie PDF. Nie trzeba ich skalować ani zmieniać ich rozmiaru. Aby uzyskać więcej informacji o materiale etykiety, zapoznaj się z informacjami o rodzajach materiałów etykiet.

Wymagane składniki

Poniższe wymagania dotyczą etykiet PDF:

• Program Adobe Reader 6.0 lub nowszy jest wymagany do przetworzenia etykiety.
• W konfiguracji sterownika drukarki skalowanie musi być wyłączone.
• Używanie elementu opakowującego HTML nie jest konieczne w przypadku wyświetlania w przeglądarce etykiety PDF drukowanej na zwykłym papierze.
• Firma Acrobat zaleca używanie poniższych przeglądarek do wyświetlania dokumentów PDF:
  • Microsoft Internet Explorer 10 lub nowsza
  • Firefox 1.0 lub nowsza
  • Mozilla 1.7 lub nowsza

Opcja etykiety PDF eliminuje potrzebę określania parametru obrazu (szerokości i wysokości) i rozdzielczości ekranu w celu prawidłowego wyświetlania etykiety w przeglądarce.

Elementy etykiety laserowej

Laserowe etykiety wysyłkowe zawierają trzy podstawowe elementy:

• Zawartość czytelna dla człowieka — ta część etykiety zawiera informacje wysyłkowe.
• Czytelny dla człowieka kod kreskowy jest domyślnie zaszyfrowany.
• Dwuwymiarowy kod kreskowy — wymiarowy alfanumeryczny kod kreskowy zawiera dane przesyłek FedEx Express i FedEx Ground zapisane przy użyciu standardu American National Standards Institute (ANSI) MH10.8.3. Dwuwymiarowy kod kreskowy jest tworzony przy użyciu formatu 417 PDF (Portable Data File).
• Kod kreskowy FedEx
  • ASTRA (Advanced Sorting Tracking Routing Assistance) dla przesyłek FedEx Express do chwili pełnego wdrożenia kodu kreskowego FDX 1D. Kod kreskowy „96” dla przesyłek FedEx Ground i FedEx Home Delivery. Usługa FedEx Ground umożliwia także korzystanie z kodu kreskowego „00” SSCC-18, gdy ma to zastosowanie.
  • Kod kreskowy FedEx 1D (FDX1D) przesyłek FedEx Express jest tworzony przy użyciu standardu ANSI/AIM BC4-1995 (Uniform Symbology Specification CODE-128C).

Najważniejsze informacje potrzebne do wygenerowania etykiety laserowej

Poniższe elementy interfejsów API FedEx są wymagane do wygenerowania etykiety laserowej:

• LabelSpecification/LabelFormatType: element wymagany do uzyskania poprawnego obrazu etykiety przy użyciu interfejsu Open Ship Reply API: poprawne wartości to:
  • COMMON2D — typ formatu etykiety w celu uzyskania etykiety.
  • LABEL_DATA_ONLY — wartość używana do uzyskiwania danych kodów kreskowych w przypadku tworzenia etykiety niestandardowej.

• LabelSpecification/ImageType: wartość wymagana do wskazania formatowania etykiety. Rodzaj strumienia danych lub bitmapy, który ma zostać zwrócony:

  Poprawne wartości:

  • PDF — zwykły papier
  • PNG — zwykły papier

• LabelSpecification/LabelStockType: element wymagany w przypadku wszystkich typów etykiet. Pozwala określić, czy materiał etykiety zawiera kartę Doc-Tab na początku lub na końcu etykiety, czy też jej nie ma. W przypadku używania elementu ImageType z formatem PDF lub PNG te wartości wyświetlają etykietę formatu laserowego:
  • PAPER_4X6
  • PAPER_4X8
  • PAPER_4X9
  • PAPER_4X675
    Te wartości wyświetlają etykietę wysyłkową o formacie zwykłego papieru:
  • PAPER_7X47
  • PAPER_85X11_BOTTOM_HALF_LABEL
  • PAPER_85X11_TOP_HALF_LABEL
  • PAPER_LETTER

Uwaga: jeśli zostanie wysłane żądanie etykiety na zwykłym papierze, zwrócone dane to obraz etykiety z kodowaniem Base64. Przed wyświetleniem pliku etykiety należy zdekodować Base64.

Obsługiwane drukarki laserowe

Większość drukarek laserowych obsługuje ten rodzaj etykiety. Jednak niektóre etykiety nie są akceptowane po ich wydrukowaniu na drukarce atramentowej.
Uwaga: w przypadku używania kolorowej drukarki laserowej musi zostać zdefiniowany kolor czarny, nawet jeśli w drukarce znajduje się tylko czarny kartridż.

Liczba etykiet laserowych wymaganych dla usługi

Poniższa tabela wskazuje liczbę etykiet każdego typu potrzebnych dla danej usługi specjalnej. Wszystkie potrzebne etykiety są generowane przy użyciu wywołania serwera FedEx CLS (Common Label Server), który zwraca pojedynczy bufor z wyjątkiem etykiet zwrotnych w przypadku płatności przy odbiorze.

Liczba etykiet laserowych drukowanych dla usługi w USA

Typ usługi	Etykieta laserowa — format PDF
FedEx Ground/FedEx Home Delivery (Stany Zjednoczone)	1 etykieta wysyłkowa

Liczba etykiet laserowych drukowanych dla usługi Export International w USA

Typ usługi	Etykieta laserowa — format PDF
FedEx Express Export International (Stany Zjednoczone)	1 etykieta wysyłkowa w odpowiedzi. Należy wydrukować co najmniej 3 etykiety. 1 etykieta na paczce i 2 w przyklejonej foliowej kieszeni na dokumenty.
FedEx Express Export International (USA, opcja wyboru brokera)	1 etykieta wysyłkowa w odpowiedzi. Należy wydrukować co najmniej 3 etykiety. 1 etykieta na paczce i 2 w przyklejonej foliowej kieszeni na dokumenty.
FedEx Ground Export International (Stany Zjednoczone)	1 etykieta wysyłkowa
FedEx Ground Export International (Stany Zjednoczone) z płatnością przy odbiorze	1 etykieta wysyłkowa 2 etykiety zwrotne w przypadku płatności przy odbiorze

Liczba etykiet laserowych drukowanych dla usługi wewnątrzkrajowej w Meksyku

Typ usługi	Etykieta laserowa — format PDF
FedEx Express na terenie Meksyku	FedEx Express na terenie Meksyku Towary niebędące towarami niebezpiecznymi/przesyłka suchego lodu: 1 etykieta wysyłkowa

Liczba etykiet laserowych drukowanych dla usługi wewnątrzkrajowej w Kanadzie

Typ usługi	Etykieta laserowa — format PDF
FedEx Express na terenie Kanady	FedEx Express na terenie Kanady Towary niebędące towarami niebezpiecznymi/przesyłka suchego lodu: 1 etykieta wysyłkowa
FedEx Ground na terenie Kanady	1 etykieta wysyłkowa
FedEx Ground na terenie Kanady z płatnością przy odbiorze	1 etykieta wysyłkowa 2 etykiety zwrotne w przypadku płatności przy odbiorze

Liczba etykiet laserowych drukowanych dla usługi Export International w Kanadzie

Typ usługi	Etykieta laserowa — format PDF
FedEx Express Export International (Kanada)	FedEx Express Export International (Kanada) Towary niebędące towarami niebezpiecznymi/przesyłka suchego lodu: 1 etykieta wysyłkowa 2 etykiety odbiorcy
FedEx Express Export International (Kanada, opcja wyboru brokera)	FedEx Express Export International (Kanada, opcja wyboru brokera) Towary niebędące towarami niebezpiecznymi/przesyłka suchego lodu: 1 etykieta wysyłkowa 2 etykiety odbiorcy
FedEx Ground Export International (Kanada)	1 etykieta wysyłkowa

Liczba etykiet laserowych drukowanych dla usługi Export International w Kanadzie

Typ usługi	Etykieta laserowa — format PDF
FedEx Express Export International (Kanada)	FedEx Express Export International (Kanada) Towary niebędące towarami niebezpiecznymi/przesyłka suchego lodu: 1 etykieta wysyłkowa 2 etykiety odbiorcy
FedEx Express Export International (Kanada, opcja wyboru brokera)	FedEx Express Export International (Kanada, opcja wyboru brokera) Towary niebędące towarami niebezpiecznymi/przesyłka suchego lodu: 1 etykieta wysyłkowa 2 etykiety odbiorcy
FedEx Ground Export International (Kanada)	1 etykieta wysyłkowa

Liczba etykiet laserowych drukowanych dla przesyłek przychodzących na Filipinach i w Tajlandii

Typ usługi	Etykiety termiczne (serwer FedEx CLS zwraca w odpowiedzi odpowiednią liczbę etykiet)
Przesyłki przychodzące na Filipiny	2 etykiety wysyłkowe z wydrukowanym numerem konta 1 etykieta odbiorcy bez wydrukowanego numeru konta 3 kopie faktury handlowej
Przychodzące przesyłki towarów do Tajlandii	3 etykiety wysyłkowe z wydrukowanym numerem konta 1 etykieta odbiorcy bez wydrukowanego numeru konta
Przychodzące przesyłki dokumentów do Tajlandii	2 etykiety wysyłkowe z wydrukowanym numerem konta 1 etykieta odbiorcy bez wydrukowanego numeru konta

Etykieta niestandardowa

FedEx umożliwia dostosowywanie etykiet wygenerowanych przez FedEx. Możesz dodać tekst dotyczący działalności firmy i wybrać rodzaj kodu kreskowego (symboliki) używanej na dokumentach i etykietach FedEx w części etykiet termicznych, które można dostosować.

Na potrzeby aplikacji wysyłkowej interfejs Open Ship API FedEx udostępnia dwie opcje dostosowywania etykiety wysyłkowej:

• Umieszczenie grafiki PNG PAPER 7 cali x 475 cali na materiale etykiety. Możesz na przykład utworzyć listę pakowania na formularzu 8-1/2 cala x 11 cali. Na tym formularzu możesz też umieścić grafikę 7 cali x 475 cali PNG PAPER, zamiast tworzyć etykietę niestandardową.
• Dodaj grafikę lub plik tekstowy do etykiety termicznej 4 cale x 8 cali lub 4 cale x 9 cali. Ten rozmiar etykiety zapewnia 2 cale na grafikę lub tekst.

Uwaga: nie można zmieniać zawartości czytelnej dla człowieka i kodu kreskowego we wspólnej części etykiety.

Niestandardowa etykieta weryfikatora

Możesz tworzyć niestandardowe etykiety niewysyłkowe na poziomie paczki i przesyłki, określając potrzebne niestandardowe informacje, format tych informacji oraz miejsce ich umieszczenia na etykiecie niestandardowej. Etykiety niestandardowe są ograniczone do formatu etykiety termicznej.

Dostosowywanie etykiety termicznej

Interfejs API FedEx udostępnia dwa formaty etykiety termicznej, które można dostosować przy użyciu grafiki lub pliku tekstowego, by uniknąć tworzenia etykiety niestandardowej. Wszystkie usługi wysyłkowe FedEx obsługują te etykiety. Dostępne formaty:

• Etykieta termiczna 4 cale x 8 cali bez karty Doc-Tab
• Etykieta termiczna 4 cale x 9 cali z kartą Doc-Tab

Te etykiety mają dwucalową sekcję, którą można dostosować. Można z niej skorzystać tylko w przypadku etykiety termicznej wydrukowanej na drukarce termicznej z ustawieniem 203 DPI.

Reguły dotyczące etykiet niestandardowych

Reguły korzystania z formatów etykiet:

• Można dostosować tylko etykietę wysyłkową. Jeśli na przykład zostanie wydrukowana etykieta wysyłkowa Express z logo 4 cale x 8 cali, dodatkowe etykiety odbiorcy nie będą go zawierać.
• Grafika lub tekst, który można dostosować, nie może mieść wysokości większej niż 2 cale i szerokości większej niż 4-1/2 cala.
• FedEx nie zapewnia usługi korekty. Grafika i/lub tekst jest drukowany w postaci, w jakiej jest dostarczony do usługi wysyłkowej.
• Jeśli nie zostaną udostępnione wszystkie dane niezbędne do wydrukowania grafiki i/lub tekstu (na przykład: współrzędne X i Y), zostanie zwrócona poprawna etykieta wysyłkowa bez dostosowanych danych. Musisz anulować przesyłkę, której dotyczy ta etykieta, jeśli chcesz ponownie utworzyć inną etykietę z grafiką/tekstem.
• W przypadku umieszczania na współrzędnych X i Y układ odniesienia punktu wstawiania to przecięcie górnej i lewej krawędzi etykiety termicznej 4,00” x 6,75” z dolną kartą doc-tab. W przypadku etykiety termicznej 4,00” x 6,75” z górną kartą doc-tab zwiększ wartości współrzędnej Y punktu wstawiania o 164 punkty. W przypadku etykiety 4,00” x 6,00” bez karty doc-tab zwiększ wartości współrzędnej Y punktu wstawiania o 8 punktów. Elementy atrybutów etykiety termicznej są oparte na rozdzielczości drukarki 203 DPI (8 punktów/mm).
• Punkt wstawiania znaku to lewy górny róg pierwszego znaku w ciągu w linii wersalików.
• Ze względu na ograniczenia dotyczące drukarki miejsce początkowe musi znajdować się w lewym górnym kwadrancie z przodu. Oznacza to, że dane mogą zaczynać się w dostosowywanej sekcji etykiety i zostać zapisane aż do części FedEx etykiety (dane etykiety termicznej). W takim przypadku niestandardowe logo lub tekst zasłonią informacje etykiety FedEx. Musisz poprawić położenie niestandardowych elementów, aby korzystać z etykiety wysyłkowej.
• Informacje Doc-Tab dodane na etykiecie 4 cale x 9 cali muszą zostać skonfigurowane przy użyciu tego samego procesu, co w przypadku standardowej etykiety termicznej Doc-Tab 4 cale x 6 cali.

Uwaga: należy dodawać tylko binarne obrazy kolorowe, ponieważ etykiety są drukowane w czerni i bieli.

Elementy graficzne etykiety niestandardowej

Interfejs API umożliwia korzystanie z obrazów PNG (Portable Network Graphic) w przypadku etykiet FedEx Express i FedEx Ground. Grafika etykiety PNG to replika etykiety termicznej lub w postaci zwykłego papieru obsługiwana przez interfejs API. Ta opcja etykiety umożliwia umieszczanie grafiki etykiety PNG na materiale etykiety w celu zapobiegnięcia konieczności utworzenia etykiety niestandardowej.

Poniższe wymagania dotyczą używania grafiki PNG o rozmiarze 4 cale x 6 cali osadzonej w dokumencie wysyłkowym:

• Materiał etykiety
• Drukarka
• Skalowanie

Materiał etykiety

Etykiety PNG 4 cale x 6 cali powinny być używane tylko z naklejanym materiałem etykiety. Zespoły ds. certyfikacji etykiet FedEx Ground i FedEx Express odrzucają etykiety PNG 4' x 6' używane z innym materiałem, w tym etykiety drukowane na zwykłym papierze.

Drukarka

Zaleca się drukowanie etykiet na drukarkach laserowych. Nie należy używać drukarek atramentowych, ponieważ nie zawsze drukują możliwe do zeskanowania kody kreskowe. Etykiety PNG 4' x 6' PNG nie można drukować bez zdefiniowania koloru jako czarnego, nawet jeśli ma zainstalowany tylko czarny kartridż. To ustawienie jest niezbędne do uzyskania poprawnej definicji kodu kreskowego skanowanego w centrach FedEx.

Skalowanie

Obraz zwracany w transakcji wysyłkowej ma rozdzielczość 200 punktów na cal (DPI) i ma rozmiar 4 cale (S) x 6 cali (W) lub 800 x 1200 pikseli. Ta etykieta ma orientację pionową i jest zaprojektowana pod kątem wydruku na obszarze etykiety 4' x 6'. Wydrukowana etykieta powinna mieć rozmiar 4' x 6'.

Aby uzyskać etykietę i kody kreskowe w wymaganej rozdzielczości DPI, musisz ustawić odpowiednią skalę (lub rozmiar) przed wydrukowaniem obrazu. Skalowanie obrazu zależy od aplikacji używanej do wyświetlania i drukowania etykiety. Aby przeskalować obraz PNG dla etykiety 4 cale x 6 cali: ustaw szerokość 4 cale i długość 6 cali.

Lista kontrolna weryfikacji etykiety

Wszystkie kody kreskowe

Wymagania dotyczące weryfikacji:

• Strefa cicha: zawsze wymaga co najmniej 0,1 cala pustej przestrzeni nad kodem kreskowym i poniżej niego.
• Strefa cicha: zawsze wymaga co najmniej 0,2 cala pustej przestrzeni po lewej i po prawej stronie kodu kreskowego.
• Sprawdź, czy wszystkie kody kreskowe spełniają minimalne wymagania dotyczące wysokości.

Jakość wydruku

Częste problemy powodujące odrzucanie etykiet:

• Niejednolite kody kreskowe
• Wyblakły druk/puste miejsca
• Powtarzające się puste miejsca (problem z rolką)
• Rozmazania (transfer termiczny)
• Złuszczanie się (laser) oznacza problem ze scalaniem tonera z papierem
• Zagniecenia podczas druku (transfer termiczny)
• Kontrast wydruku w przypadku bezpośrednich etykiet termicznych musi wynosić co najmniej 90%

Szczegóły zawartości czytelnej dla człowieka na etykietach Ground

Wymagania dotyczące weryfikacji zawartości czytelnej dla człowieka na etykietach FedEx Ground:

• Kod kreskowy musi odpowiadać danym
• Logo FedEx Ground: logo są dostępne do pobrania ze strony FedEx Identity w witrynie fedex.com.
• Logo FedEx Home Delivery: etykiety muszą zawierać duże „H” w polu w odległości 1 cala od adresu doręczenia. „H” musi mieć wymiary co najmniej 0,25 cala x 0,70 cala.
• Opis usługi
• Informacje o nadawcy
• Informacje o odbiorcy
• Kod pocztowy i trasa przewozu
• Data wysyłki
• Waga rzeczywista
• Informacje o urządzeniu do automatyzacji klienta (licznik, aplikacja/system, wersja)
• Wymiary
• Różne informacje referencyjne
• Numer śledzenia i identyfikator formularza (numer śledzenia musi zawierać 14 cyfr)
• Identyfikator rampy na lotnisku
• Kod pocztowy

Szczegóły zawartości czytelnej dla człowieka na etykietach Express

Etykieta musi zawierać wydrukowane poniższe elementy, aby mogła uzyskać certyfikację:

• Logo FedEx Express: logo są dostępne do pobrania ze strony FedEx Identity w witrynie fedex.com.
• Opis usługi
• Typ paczki (w przypadku przesyłki międzynarodowej)
• Dzień tygodnia, w którym odbędzie się doręczenie (na przykład: PON w przypadku poniedziałku)
• Doręczenie przed datą
• Numer licznika
• Data wysyłki
• Format licznika sztuk, tekst etykiety głównej, tekst etykiety numeru referencyjnego w przypadku wszystkich przesyłek wieloczęściowych
• Identyfikator rampy na lotnisku
• Kod pocztowy i trasa przewozu
• Przedrostek i przyrostek trasy przewozu URSA
• Kody obsługi
• Zobowiązanie dotyczące obszaru usługi
• Numery telefonów nadawcy i odbiorcy
• Waga
• Wymiary (jeśli mają zastosowanie)
• Pole informacji referencyjnych w przypadku wysyłki alkoholu
• Numer śledzenia i identyfikator formularza (numer śledzenia musi zawierać 14 cyfr)
• Na etykiecie ASTRA 12-cyfrowy numer śledzenia znajduje się w pozycji od 17 do 28 kodu kreskowego składającego się z 32 znaków. W nowym kodzie kreskowym FDX 1D numer śledzenia zajmuje pozycje od 21 do 34. Numer śledzenia FedEx Express nadal ma 12 cyfr. Zera znajdują się na pierwszych dwóch pozycjach.

Następujące reguły mają zastosowanie do interfejsu Open Ship API:

• Otwartą przesyłkę można również utworzyć i potwierdzić z jedną paczką.
• Otwarte przesyłki są czyszczone, jeśli nie zostają potwierdzone do końca piątego dnia od ich utworzenia.
• Po potwierdzeniu otwartej przesyłki nie można do niej dodać więcej paczek.