Hændelsespayloads Og Sporingsstatusser

Denne reference viser eksempelpayloads for alle udgående webhook- hændelser, som Shipit i øjeblikket understøtter.

Bemærkninger om eksemplerne

Payloadsene nedenfor afspejler den aktuelt udsendte struktur.
Nogle værdier kan være null afhængigt af forsendelsen eller hændelsen.
Wallet credit- og debit-hændelser inkluderer i øjeblikket ikke et topniveau-event felt.

`shipment.booked`

{
  "event": "shipment.booked",
  "shipment": {
    "id": "01h2x4y6z8a9b0c1d2e3f4g5h6",
    "shipit_number": "SHP-2024-001234",
    "tracking_number": "1Z999AA10123456784",
    "tracking_number_2": null,
    "service_id": "ups_express",
    "carrier_code": "ups",
    "reference": "ORDER-12345",
    "external_id": "ext-abc-123",
    "price": "15.99",
    "currency": "EUR",
    "created_at": "2024-01-15T10:30:00+00:00"
  },
  "sender": {
    "name": "Acme Corp",
    "email": "[email protected]",
    "phone": "+358401234567",
    "street": "Warehouse Street 10",
    "postcode": "00100",
    "city": "Helsinki",
    "country": "FI"
  },
  "receiver": {
    "name": "John Doe",
    "email": "[email protected]",
    "phone": "+358409876543",
    "street": "Customer Road 5",
    "postcode": "00200",
    "city": "Espoo",
    "country": "FI"
  }
}

`shipment.failed`

{
  "event": "shipment.failed",
  "error_message": "Recipient address could not be validated",
  "shipment_data": {
    "serviceId": "dhl_express",
    "reference": "ORDER-12346",
    "externalId": "ext-abc-124",
    "sender": {
      "name": "Acme Corp"
    },
    "receiver": {
      "name": "John Doe"
    }
  }
}

`shipment.tracking_event_updated`

{
  "event": "shipment.tracking_event_updated",
  "shipment": {
    "id": "01h2x4y6z8a9b0c1d2e3f4g5h6",
    "shipit_number": "SHP-2024-001234",
    "tracking_number": "1Z999AA10123456784",
    "tracking_number_2": null,
    "service_id": "ups_express",
    "carrier_code": "ups",
    "reference": "ORDER-12345",
    "external_id": "ext-abc-123"
  },
  "tracking_event": {
    "id": "01hxtrackingevent1234567890",
    "status": "DELIVERED",
    "shipment_tracking_number": "1Z999AA10123456784",
    "parcel_tracking_number": "1Z999AA10123456784",
    "return_tracking_number": null,
    "description": {
      "en": "Shipment delivered"
    },
    "information": null,
    "instruction": null,
    "location": {
      "city": "Helsinki",
      "country": "FI"
    },
    "metadata": {
      "carrier_event_code": "DELIVERED"
    },
    "happened_at": "2024-01-15T10:30:00+00:00",
    "created_at": "2024-01-15T10:30:00+00:00",
    "updated_at": "2024-01-15T10:35:00+00:00"
  }
}

`pending_shipment.created`

{
  "event": "pending_shipment.created",
  "pending_shipment": {
    "id": "01h2x4y6z8a9b0c1d2e3f4g5h6",
    "external_id": "pending-ext-123",
    "status": "pending",
    "source": "api",
    "request": {
      "receiver": {
        "name": "Jane Smith",
        "email": "[email protected]"
      },
      "parcels": [
        {
          "weight": 2.5,
          "length": 30,
          "width": 20,
          "height": 10
        }
      ]
    },
    "created_at": "2024-01-15T10:00:00+00:00"
  }
}

`pending_shipment.completed`

{
  "event": "pending_shipment.completed",
  "pending_shipment": {
    "id": "01h2x4y6z8a9b0c1d2e3f4g5h6",
    "external_id": "pending-ext-123",
    "status": "completed",
    "source": "api",
    "request": {
      "receiver": {
        "name": "Jane Smith",
        "email": "[email protected]"
      },
      "parcels": [
        {
          "weight": 2.5,
          "length": 30,
          "width": 20,
          "height": 10
        }
      ]
    },
    "created_at": "2024-01-15T10:00:00+00:00",
    "updated_at": "2024-01-15T10:30:00+00:00"
  }
}

`wallet.credited`

{
  "transaction_id": "01h2x4y6z8a9b0c1d2e3f4g5h6",
  "amount": "100.00",
  "vat": "24.00",
  "vat_percent": "24",
  "comment": "Account top-up",
  "created_at": "2024-01-15T10:00:00+00:00",
  "user_id": "12345"
}

`wallet.debited`

{
  "transaction_id": "01h2x4y6z8a9b0c1d2e3f4g5h6",
  "amount": "-15.99",
  "vat": "-3.84",
  "vat_percent": "24",
  "comment": "Payment for shipment SHP-2024-001234",
  "shipment_id": "01h2x4y6z8a9b0c1d2e3f4g5h7",
  "created_at": "2024-01-15T10:30:00+00:00",
  "user_id": "12345"
}

`wallet.low_balance`

{
  "event": "wallet.low_balance",
  "wallet": {
    "user_id": "01h2x4y6z8a9b0c1d2e3f4g5h6",
    "current_balance": 500,
    "threshold": 1000,
    "balance_below_threshold": true,
    "difference": 500
  },
  "timestamp": "2024-01-15T11:00:00+00:00"
}

Sporingshændelsesstatusser

tracking_event.status i shipment.tracking_event_updated kan være en af følgende enum-værdier:

Status	Betydning
`ADVANCED_SHIPPING_NOTICE`	Transportøren har modtaget forhåndsdata før fysisk overdragelse.
`AT_OFFICE_OF_EXCHANGE`	Forsendelsen nåede et udvekslings- eller transferkontor.
`ATTEMPTED_DELIVERY`	Levering blev forsøgt.
`AWAITING_DELIVERY`	Forsendelsen afventer endelig levering.
`AWAITING_DELIVERY_TIME_SELECTION`	Modtageren skal vælge leveringstidspunkt.
`AWAITING_DISPATCH`	Forsendelsen afventer dispatch.
`CANCELLED`	Forsendelsen eller transporttrinnet blev annulleret.
`CASH_ON_DELIVERY`	Forsendelsen involverer efterkrav.
`COLLECTED`	Forsendelsen er blevet afhentet.
`CONFIRMED`	Transportøren bekræftede forsendelsen eller hændelsen.
`CONSOLIDATED`	Forsendelsen blev konsolideret med andet gods.
`DAMAGED`	Transportøren rapporterede skade.
`DECONSOLIDATED`	Forsendelsen blev adskilt fra et konsolideret flow.
`DELAYED`	Forsendelsen er forsinket.
`DELETED`	Forsendelsen eller hændelsen blev slettet i kildesystemet.
`DELIVERED`	Forsendelsen blev leveret.
`DELIVERY_CANCELLED`	Planlagt levering blev annulleret.
`DELIVERY_IMPOSSIBLE`	Leveringen kunne ikke gennemføres.
`DELIVERY_REFUSED`	Modtageren nægtede at modtage forsendelsen.
`DELIVERY_TIME_SELECTED`	Modtageren valgte leveringstidspunkt.
`DISPATCHED`	Forsendelsen blev sendt af sted.
`EN_ROUTE`	Forsendelsen er på vej gennem netværket.
`EXCEPTION`	Transportøren rapporterede en undtagelse eller afvigelse.
`EXTRA_SERVICE`	Ekstra serviceinformation blev knyttet til hændelsen.
`IN_CUSTOMS`	Forsendelsen er i toldbehandling.
`LOST`	Transportøren rapporterede forsendelsen som mistet.
`NOTICE_OF_ARRIVAL`	En ankomstmeddelelse blev sendt eller oprettet.
`OTHER`	Hændelsen kunne ikke matches til en mere specifik status.
`OUT_FOR_DELIVERY`	Forsendelsen er ude til levering.
`PARTIALLY_DELIVERED`	Kun en del af forsendelsen blev leveret.
`PICK_UP_CANCELLED`	En afhentning blev annulleret.
`RECIPIENT_CONTACTED`	Transportøren kontaktede modtageren.
`REGISTERED`	Forsendelsen blev registreret i transportørens system.
`REROUTING`	Forsendelsen omdirigeres.
`RETURNED`	Forsendelsen blev returneret.
`RETURNING`	Forsendelsen er på vej tilbage til afsenderen.
`SORTING`	Forsendelsen er under sortering.
`TEST`	Teststatus fra en upstream-kilde.
`UNCONFIRMED`	Hændelsen findes, men er endnu ikke bekræftet.
`UNKNOWN`	Status er ukendt.
`UNSUCCESSFUL_DELIVERY`	Leveringen mislykkedes.
`UNSUCCESSFUL_DELIVERY_ATTEMPT`	Leveringsforsøget mislykkedes.
`UNSUCCESSFUL_DISPATCH`	Dispatch mislykkedes.
`UNSUCCESSFUL_DISPATCH_ATTEMPT`	Dispatch-forsøget mislykkedes.