DOCS

Utwórz przesyłkę

Utwórz przesyłkę

Twórz przesyłki za pomocą API Zonos przy użyciu mutacji GraphQL.

GraphQL

Jeśli jesteś zintegrowany z API Zonos i masz zatwierdzenie do wysyłania 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 ani stron. Obsługuje opcjonalne numery śledzenia, centra realizacji i wybór poziomu usługi.

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"
  }
}

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?