Händelsepayloads Och Spårningsstatusar

Den här referensen visar exempelpayloads för alla utgående webhook- händelser som Shipit för närvarande stöder.

Kommentarer om exemplen

Payloadsen nedan motsvarar den aktuella utsända strukturen.
Vissa värden kan vara null beroende på försändelsen eller händelsen.
Wallet credit- och debit-händelser saknar för närvarande ett toppnivåfält 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"
}

Spårningshändelsestatusar

tracking_event.status i shipment.tracking_event_updated kan ha någon av följande enum-värden:

Status	Betydelse
`ADVANCED_SHIPPING_NOTICE`	Transportören har fått förhandsinformation innan fysisk överlämning.
`AT_OFFICE_OF_EXCHANGE`	Försändelsen nådde ett bytes- eller överföringskontor.
`ATTEMPTED_DELIVERY`	Leverans har försökt genomföras.
`AWAITING_DELIVERY`	Försändelsen väntar på slutlig leverans.
`AWAITING_DELIVERY_TIME_SELECTION`	Mottagaren måste välja leveranstid.
`AWAITING_DISPATCH`	Försändelsen väntar på dispatch.
`CANCELLED`	Försändelsen eller transportsteget avbröts.
`CASH_ON_DELIVERY`	Försändelsen involverar postförskott.
`COLLECTED`	Försändelsen har hämtats upp.
`CONFIRMED`	Transportören bekräftade försändelsen eller händelsen.
`CONSOLIDATED`	Försändelsen konsoliderades med annat gods.
`DAMAGED`	Transportören rapporterade skada.
`DECONSOLIDATED`	Försändelsen separerades från ett konsoliderat flöde.
`DELAYED`	Försändelsen är försenad.
`DELETED`	Försändelsen eller händelsen togs bort i källsystemet.
`DELIVERED`	Försändelsen levererades.
`DELIVERY_CANCELLED`	Planerad leverans avbröts.
`DELIVERY_IMPOSSIBLE`	Leveransen kunde inte slutföras.
`DELIVERY_REFUSED`	Mottagaren vägrade ta emot leveransen.
`DELIVERY_TIME_SELECTED`	Mottagaren valde en leveranstid.
`DISPATCHED`	Försändelsen skickades iväg.
`EN_ROUTE`	Försändelsen är på väg genom nätverket.
`EXCEPTION`	Transportören rapporterade en avvikelse.
`EXTRA_SERVICE`	Extra servicinformation kopplades till händelsen.
`IN_CUSTOMS`	Försändelsen är i tullhantering.
`LOST`	Transportören rapporterade försändelsen som förlorad.
`NOTICE_OF_ARRIVAL`	Avisering om ankomst skickades eller skapades.
`OTHER`	Händelsen kunde inte mappas till en mer specifik status.
`OUT_FOR_DELIVERY`	Försändelsen är ute för leverans.
`PARTIALLY_DELIVERED`	Bara en del av försändelsen levererades.
`PICK_UP_CANCELLED`	En upphämtning avbröts.
`RECIPIENT_CONTACTED`	Transportören kontaktade mottagaren.
`REGISTERED`	Försändelsen registrerades i transportörens system.
`REROUTING`	Försändelsen omdirigeras.
`RETURNED`	Försändelsen returnerades.
`RETURNING`	Försändelsen är på väg tillbaka till avsändaren.
`SORTING`	Försändelsen sorteras.
`TEST`	Teststatus från en upstream-källa.
`UNCONFIRMED`	Händelsen finns men är ännu inte bekräftad.
`UNKNOWN`	Statusen är okänd.
`UNSUCCESSFUL_DELIVERY`	Leveransen misslyckades.
`UNSUCCESSFUL_DELIVERY_ATTEMPT`	Leveransförsöket misslyckades.
`UNSUCCESSFUL_DISPATCH`	Dispatch misslyckades.
`UNSUCCESSFUL_DISPATCH_ATTEMPT`	Dispatchförsöket misslyckades.