DOCS

Maak een zending

Maak een zending voor bestaande bestellingen

Maak zendingen en labels met de Zonos API nadat je de landed costs hebt berekend en bestellingen hebt aangemaakt.

GraphQL

Deze gids is ontworpen voor gebruikers die al zijn geïntegreerd met de Zonos API en zendingen moeten maken voor bestaande bestellingen in hun systeem. Als je een verzendplatform bent en Zonos zendingcreatie aan je klanten wilt aanbieden, zie dan onze Zending API-gids.

Als je bent geïntegreerd met de Zonos API en goedgekeurd bent om te verzenden buiten Dashboard, gebruik dan de shipmentCreateWorkflow-mutatie om zendingen te creëren en trackinginformatie te verstrekken. Deze mutaties stellen je ook in staat om Zonos te informeren over binnenlandse zendingen naar cross-dockingfaciliteiten.

Opmerking: Als je een Duty and Tax-app gebruikt met een platform dat automatisch trackingnummers synchroniseert met Zonos, of als je rechtstreeks via Dashboard verzendt, zijn deze mutaties niet vereist.

Maak zendingen via API 

Nadat je een Landed Cost hebt berekend en een bestelling hebt aangemaakt, kun je trackingnummers en andere zendingdetails naar Zonos sturen via de API.

Gebruik deze workflow wanneer je een zending maakt voor een bestaande bestelling en geen wijzigingen hoeft aan te brengen in artikel- of partijgegevens. Het ondersteunt optionele trackingnummers, fulfilmentcentra, servicelevelselectie en verzekeringen voor opgegeven waarde.

Mutatie

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

Basisvariabelen

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

Met Fulfillment Center

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

Met Aangepaste Tracking

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

Met Serviceniveau

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

Met verklaarde waarde verzekering

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

Verklaarde waarde

Stel "isDeclaredValue": true in om dekking voor de verklaarde waarde voor alle artikelen in uw zending in te schakelen. Zonos claimt automatisch de volledige waarde van alle artikelen die in de bestelling zijn ingediend; handelaren kunnen dit bedrag niet wijzigen. Dit stelt de maximale aansprakelijkheid in die de vervoerder accepteert in geval van verlies, schade of diefstal tijdens het transport. Deze functie wordt alleen ondersteund voor UPS-, FedEx- en DHL-zendingen. Zonos behandelt automatisch de vervoerdersspecifieke implementatie wanneer u de verklaarde waarde inschakelt, inclusief de juiste parameters in onze API-aanroepen naar deze vervoerders, zodat u geen verschillende vereisten van vervoerders hoeft te beheren.

UPS-beperkingen: UPS dekt alleen waarden tussen 100-50.000 USD en verwerkt de verklaarde waarde op het niveau van de doos. Voor zendingen met meerdere dozen moeten handelaren de zending splitsen om dekking per doos aan te geven. UPS genereert ook een extra verzekeringsformulier dat met de labels moet worden afgedrukt.

FedEx en DHL: Verwerken de verklaarde waarde op het niveau van de zending zonder aanvullende beperkingen.

Annuleer een zending 

Om een gemaakte label te annuleren, gebruik de volgende mutatie om de zending te annuleren. Alle bijbehorende labels worden ook automatisch geannuleerd. Houd er rekening mee dat zodra een zending is geannuleerd, deze niet kan worden bijgewerkt of hersteld.

Mutatie

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

Was deze pagina nuttig?