DOCS

Utwórz przesyłkę

Landed Cost•
Strona głównaDla dostawców logistyki Landed Cost Utwórz przesyłkę

Utwórz przesyłkę dla istniejących zamówień

Twórz przesyłki i etykiety za pomocą API Zonos po obliczeniu kosztów dostawy i utworzeniu zamówień.

GraphQL

Ten przewodnik jest przeznaczony dla użytkowników, którzy są już zintegrowani z API Zonos i potrzebują tworzyć przesyłki dla istniejących zamówień w swoim systemie. Jeśli jesteś platformą wysyłkową i chcesz zaoferować swoim klientom tworzenie przesyłek Zonos, zapoznaj się z naszym przewodnikiem po API przesyłek.

Jeśli jesteś zintegrowany z API Zonos i masz zatwierdzenie na wysyłkę poza Dashboard, użyj mutacji shipmentCreateWorkflow, aby tworzyć przesyłki i dostarczać informacje o śledzeniu. Te mutacje pozwalają również poinformować Zonos o krajowych przesyłkach do obiektów cross-docking.

Uwaga: Jeśli korzystasz z aplikacji Duty and Tax z platformą, która automatycznie synchronizuje numery śledzenia z Zonos, lub jeśli wysyłasz bezpośrednio przez Dashboard, te mutacje nie są wymagane.

Tworzenie przesyłek za pomocą API 

Po obliczeniu Landed Cost i utworzeniu zamówienia, możesz wysłać numery śledzenia i inne szczegóły przesyłki do Zonos za pośrednictwem API.

Użyj tego przepływu, gdy tworzysz przesyłkę dla istniejącego zamówienia i nie musisz modyfikować szczegółów przedmiotów lub stron. Obsługuje opcjonalne numery śledzenia, centra realizacji, wybór poziomu usługi i ubezpieczenie wartości zadeklarowanej.

Mutacja

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {
  shipmentCreateWorkflow(input: $input) {
    id
    status
    trackingDetails {
      number
    }
    serviceLevel {
      id
      name
      carrier {
        id
        name
      }
    }
    shipmentCartons {
      id
      carton {
        id
        width
        length
        height
        weight
        items {
          item {
            id
            amount
            description
          }
        }
      }
      label {
        url
        trackingNumber
        id
        documentFiling
      }
    }
  }
}

Podstawowe zmienne

1
2
3
4
5
6
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789abc"
  }
}

Z Centrum Realizacji Zamówień

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789def",
    "fulfillmentCenter": "fulfillment_center_12345"
  }
}

Z niestandardowym śledzeniem

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": false,
    "orderId": "order_12345678-1234-1234-1234-123456789ghi",
    "trackingNumbers": ["tracking_example_1", "tracking_example_2"]
  }
}

Z poziomem usługi

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789jkl",
    "serviceLevel": "dhl.express_example"
  }
}

Z ubezpieczeniem wartości zadeklarowanej

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789mno",
    "isDeclaredValue": true
  }
}

Wartość zadeklarowana

Ustaw "isDeclaredValue": true, aby włączyć pokrycie wartości zadeklarowanej dla wszystkich przedmiotów w Twojej przesyłce. Zonos automatycznie zgłasza pełną wartość wszystkich przedmiotów zgłoszonych w zamówieniu; sprzedawcy nie mogą modyfikować tej kwoty. Ustala to maksymalne zobowiązanie, które przewoźnik zaakceptuje w przypadku utraty, uszkodzenia lub kradzieży podczas transportu. Ta funkcja jest obsługiwana tylko dla przesyłek UPS, FedEx i DHL. Zonos automatycznie obsługuje specyficzną dla przewoźnika implementację, gdy włączysz wartość zadeklarowaną, w tym odpowiednie parametry w naszych wywołaniach API do tych przewoźników, więc nie musisz zarządzać różnymi wymaganiami przewoźników.

Ograniczenia UPS: UPS pokrywa tylko wartości między 100-50,000 USD i przetwarza wartość zadeklarowaną na poziomie kartonu. W przypadku przesyłek wielokartonowych sprzedawcy muszą podzielić przesyłkę, aby wyznaczyć pokrycie na każdy karton. UPS generuje również dodatkowy formularz ubezpieczenia, który musi być wydrukowany razem z etykietami.

FedEx i DHL: Przetwarzają wartość zadeklarowaną na poziomie przesyłki bez dodatkowych ograniczeń.

Anulowanie przesyłki 

Aby anulować utworzoną etykietę, użyj poniższej mutacji, aby unieważnić przesyłkę. Wszelkie powiązane etykiety również zostaną automatycznie unieważnione. Należy pamiętać, że po unieważnieniu przesyłki nie można jej zaktualizować ani przywrócić.

Mutacja

1
2
3
4
5
6
7
8
9
10
11
12
mutation {
  shipmentStatusUpdate(
    input: {
      shipment: "shipment_12345678-1234-1234-1234-123456789stu"
      status: VOIDED
      note: "Voiding shipment"
    }
  ) {
    id
    status
  }
}

Czy ta strona była pomocna?

Zarezerwuj demonstrację

Zobacz Zonos

polityki i umowy.
© 2025 Zonoszonos.com
Na tej stronie:
  • Utwórz przesyłkę dla istniejących zamówień
  • Tworzenie przesyłek za pomocą API
  • Anulowanie przesyłki