location/fulfillment_service_integration/rejected

Overview

Property	Value
Webhook type	location/fulfillment_service_integration/rejected
Kafka topic	location.fulfillment-service-integration.rejected
Direction	Platform → Your endpoint

Description

Fired when an external fulfillment service explicitly rejects the connection request from a HappyColis location. The integration remains in a non-active state and a new connection request may need to be initiated.

Trigger Conditions

• The external fulfillment service denies the connection request
• The FulfillmentServiceIntegration state transitions from PENDING to a rejected/inactive state

Message Envelope

{
  "header": {
    "organizationId": "org_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "messageId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "webhookId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "type": "location/fulfillment_service_integration/rejected",
    "date": "2024-06-10T11:45:00.000Z"
  },
  "body": { ... }
}

Body — Property Table

FulfillmentServiceIntegration Object

Field	Type	Nullable	Description
id	string (uuid)	No	Unique integration identifier
locationId	string (uuid)	No	The location whose connection was rejected
fulfillmentServiceId	string (uuid)	No	The fulfillment service that rejected the connection
accessToken	string	Yes	Always null — no token is issued on rejection
scopes	string[]	No	Originally requested scopes
state	enum	Yes	INACTIVE or ERROR after rejection

Full JSON Payload Sample

{
  "header": {
    "organizationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "messageId": "v3w4x5y6-z7a8-9012-bcde-345678901234",
    "webhookId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "type": "location/fulfillment_service_integration/rejected",
    "date": "2024-06-10T11:45:00.000Z"
  },
  "body": {
    "id": "r9s0t1u2-v3w4-5678-xyza-901234567890",
    "locationId": "j1k2l3m4-n5o6-7890-pqrs-123456789012",
    "fulfillmentServiceId": "s0t1u2v3-w4x5-6789-yzab-012345678901",
    "accessToken": null,
    "scopes": ["fulfillment:read", "fulfillment:write", "inventory:read"],
    "state": "INACTIVE"
  }
}

Related Events

• location/fulfillment_service_integration/created — the initial connection request
• location/fulfillment_service_integration/accepted — the accepted connection path
• location/fulfillment_service_integration/errored — fired on error

Notes

• accessToken is always null in rejected integrations — no credentials are issued.
• After a rejection, a new integration record must be created to retry the connection.
• Contact the fulfillment service provider to understand why the connection was rejected before retrying.