Hendelsespayloads Og Sporingsstatuser

Denne referansen viser eksempelpayloads for alle utgående webhook- hendelser som Shipit støtter i dag.

Merknader om eksemplene

Payloadene nedenfor gjenspeiler den faktiske strukturen som sendes ut nå.
Noen verdier kan være null avhengig av sendingen eller hendelsen.
Wallet credit- og debit-hendelser inkluderer for tiden ikke et toppnivåfelt event.

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

Sporingshendelsesstatuser

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

Status	Betydning
`ADVANCED_SHIPPING_NOTICE`	Transportøren mottok forhåndsvarsel før fysisk overlevering.
`AT_OFFICE_OF_EXCHANGE`	Sendingen nådde et utvekslings- eller overføringskontor.
`ATTEMPTED_DELIVERY`	Levering ble forsøkt.
`AWAITING_DELIVERY`	Sendingen venter på endelig levering.
`AWAITING_DELIVERY_TIME_SELECTION`	Mottakeren må velge leveringstid.
`AWAITING_DISPATCH`	Sendingen venter på dispatch.
`CANCELLED`	Sendingen eller transportsteget ble kansellert.
`CASH_ON_DELIVERY`	Sendingen involverer oppkrav.
`COLLECTED`	Sendingen er hentet inn.
`CONFIRMED`	Transportøren bekreftet sendingen eller hendelsen.
`CONSOLIDATED`	Sendingen ble konsolidert med annet gods.
`DAMAGED`	Transportøren rapporterte skade.
`DECONSOLIDATED`	Sendingen ble skilt ut fra en konsolidert flyt.
`DELAYED`	Sendingen er forsinket.
`DELETED`	Sendingen eller hendelsen ble slettet i kildesystemet.
`DELIVERED`	Sendingen ble levert.
`DELIVERY_CANCELLED`	Planlagt levering ble kansellert.
`DELIVERY_IMPOSSIBLE`	Leveringen kunne ikke gjennomføres.
`DELIVERY_REFUSED`	Mottakeren nektet å ta imot leveringen.
`DELIVERY_TIME_SELECTED`	Mottakeren valgte leveringstidspunkt.
`DISPATCHED`	Sendingen ble sendt ut.
`EN_ROUTE`	Sendingen er på vei gjennom nettverket.
`EXCEPTION`	Transportøren rapporterte et avvik eller unntak.
`EXTRA_SERVICE`	Ekstra serviceinformasjon ble knyttet til hendelsen.
`IN_CUSTOMS`	Sendingen er i tollbehandling.
`LOST`	Transportøren rapporterte sendingen som tapt.
`NOTICE_OF_ARRIVAL`	Ankomstvarsel ble sendt eller opprettet.
`OTHER`	Hendelsen kunne ikke mappes til en mer spesifikk status.
`OUT_FOR_DELIVERY`	Sendingen er ute for levering.
`PARTIALLY_DELIVERED`	Bare deler av sendingen ble levert.
`PICK_UP_CANCELLED`	En henting ble kansellert.
`RECIPIENT_CONTACTED`	Transportøren kontaktet mottakeren.
`REGISTERED`	Sendingen ble registrert i transportørens system.
`REROUTING`	Sendingen blir omdirigert.
`RETURNED`	Sendingen ble returnert.
`RETURNING`	Sendingen er på vei tilbake til avsenderen.
`SORTING`	Sendingen er under sortering.
`TEST`	Teststatus fra en upstream-kilde.
`UNCONFIRMED`	Hendelsen finnes, men er ennå ikke bekreftet.
`UNKNOWN`	Statusen er ukjent.
`UNSUCCESSFUL_DELIVERY`	Leveringen mislyktes.
`UNSUCCESSFUL_DELIVERY_ATTEMPT`	Leveringsforsøket mislyktes.
`UNSUCCESSFUL_DISPATCH`	Dispatch mislyktes.
`UNSUCCESSFUL_DISPATCH_ATTEMPT`	Dispatch-forsøket mislyktes.