Unsolicited Cease KCI Examples

Unsolicited ceases are presented as new orders that are received from the supplier rather than being sent by the tenant. An initial KCI is sent to signify creation of the unsolicited cease order and then KCIs follow a similar path to other orders. Examples of the possible KCIs are included here.

KCI: CREATED

KCI to inform tenant that a new unsolicited cease order has been created for an active service:

Copy

Copied

{
  "id": "7b21f96d-7cf5-4336-8c98-56e41c54be6a",
  "supplier": "FIBRECO",
  "sequenceNumber": 1,
  "deliveredOn": "2024-04-10T09:53:14.737Z",
  "updateType": "INFORMATIONAL",
  "entityType": "UNSOLICITED_CEASE_ORDER",
  "entity": {
    "supplierOrderNumber": "FC123",
    "status": "RECEIVED_BY_GATEWAY",
    "created": "2024-04-10T09:53:11.745Z",
    "requestedCeaseDate": "2024-04-012T00:00:00Z",
    "supplier": "FIBRECO",
    "reason": "CHANGE_OF_CP",
    "serviceId": "S12345",
    "orderType": "UNSOLICITED_CEASE",
    "id": 12345,
    "updated": "2024-04-10T09:53:13.330Z"
  },
  "information": {
    "type": "CREATED"
  }
}

KCI: ACKNOWLEDGED

The unsolicited cease order is now acknowledged:

Copy

Copied

{
  "id": "5b20fb0c-d120-55ff-963b-399fe8073525",
  "supplier": "FIBRECO",
  "sequenceNumber": 3,
  "issuedOn": "2024-04-10T09:53:17.044Z",
  "receivedOn": "2024-04-10T09:53:38.476Z",
  "deliveredOn": "2024-04-10T09:53:38.817Z",
  "updateType": "INFORMATIONAL",
  "entityType": "UNSOLICITED_CEASE_ORDER",
  "entity": {
    "supplierOrderNumber": "FC123",
    "status": "ACKNOWLEDGED",
    "created": "2024-04-10T09:53:11.745Z",
    "requestedCeaseDate": "2024-04-12T00:00:00Z",
    "supplier": "FIBRECO",
    "reason": "CHANGE_OF_CP",
    "serviceId": "S12345",
    "orderType": "UNSOLICITED_CEASE",
    "id": 12345,
    "updated": "2024-04-10T09:53:38.622Z"
  },
  "information": {
    "type": "ACKNOWLEDGED"
  }
}

Note: some suppliers may send other KCIs before/after acknowledging/committing orders - these will be received as generic UPDATE KCIs.

KCI: COMMITTED

The unsolicited cease order is now committed:

Copy

Copied

{
  "id": "995743c8-3073-52d7-b090-c524008c157f",
  "supplier": "FIBRECO",
  "sequenceNumber": 4,
  "issuedOn": "2024-04-10T09:53:35.618Z",
  "receivedOn": "2024-04-10T09:53:39.983Z",
  "deliveredOn": "2024-04-10T09:53:40.227Z",
  "updateType": "INFORMATIONAL",
  "entityType": "UNSOLICITED_CEASE_ORDER",
  "entity": {
    "supplierOrderNumber": "FC123",
    "status": "IN_PROGRESS",
    "created": "2024-04-10T09:53:11.745Z",
    "requestedCeaseDate": "2024-04-12T00:00:00Z",
    "supplier": "FIBRECO",
    "reason": "CHANGE_OF_CP",
    "serviceId": "S12345",
    "orderType": "UNSOLICITED_CEASE",
    "id": 12345,
    "updated": "2024-04-10T09:53:40.140Z",
    "committedDate": "2024-04-12",
    "targetDate": "2024-04-12"
  },
  "information": {
    "type": "COMMITTED"
  }
}

The order is now in progress and has a committed date for the cease to complete. Target date will show the current expected cease date where this date changes.

KCI: UPDATED CEASE DATE

An unsolicited cease order may be updated by the supplier i.e. the date of the cease/takeover is changed so a new requested cease date and target date is sent.

Copy

Copied

{
  "id": "3d38b467-3213-4f75-a9df-c4dcfd67a772",
  "supplier": "FIBRECO",
  "sequenceNumber": 5,
  "issuedOn": "2024-04-11T10:53:54.137Z",
  "receivedOn": "2024-04-11T10:53:56.039Z",
  "deliveredOn": "2024-04-11T10:53:56.305Z",
  "updateType": "INFORMATIONAL",
  "entityType": "UNSOLICITED_CEASE_ORDER",
  "entity": {
    "supplierOrderNumber": "FC123",
    "status": "IN_PROGRESS",
    "created": "2024-04-10T09:53:11.745Z",
    "requestedCeaseDate": "2024-04-13T00:00:00Z",
    "supplier": "FIBRECO",
    "reason": "CHANGE_OF_CP",
    "serviceId": "S12345",
    "orderType": "UNSOLICITED_CEASE",
    "id": 12345,
    "updated": "2024-04-11T10:56:46.197Z",
    "committedDate": "2024-04-12",
    "targetDate": "2024-04-13"
  },
  "information": {
    "type": "ADDITIONAL",
    "text": "Requested cease date changed to 2024-04-13"
  }
}

KCI: COMPLETED

The unsolicited cease order has now completed and service has ended:

Copy

Copied

{
  "id": "5ab0f163-cbe7-510a-a161-0f904f3ff68f",
  "supplier": "FIBRECO",
  "sequenceNumber": 6,
  "issuedOn": "2024-04-12T09:00:34.137Z",
  "receivedOn": "2024-04-12T09:00:36.039Z",
  "deliveredOn": "2024-04-12T09:00:36.305Z",
  "updateType": "INFORMATIONAL",
  "entityType": "UNSOLICITED_CEASE_ORDER",
  "entity": {
    "supplierOrderNumber": "FC123",
    "status": "COMPLETED",
    "created": "2024-04-10T09:53:11.745Z",
    "requestedCeaseDate": "2024-04-12T00:00:00Z",
    "supplier": "FIBRECO",
    "reason": "CHANGE_OF_CP",
    "serviceId": "S12345",
    "orderType": "UNSOLICITED_CEASE",
    "id": 12345,
    "updated": "2024-04-12T09:00:36.197Z",
    "committedDate": "2024-04-12",
    "targetDate": "2024-04-12"
  },
  "information": {
    "type": "COMPLETED"
  }
}

KCI: CANCEL REJECTED

Alternatively, the unsolicited cease order may be requested to be cancelled by the tenant placing a "cancel other". Sending this request will be confirmed by a KCI and may be rejected by the supplier if it does not meet cancel other requirements.

Copy

Copied

{
  "id": "0c3058d6-1456-4f20-b5e9-f3eb453d2ff7",
  "supplier": "FIBRECO",
  "sequenceNumber": 5,
  "issuedOn": "2024-04-10T09:53:44.137Z",
  "receivedOn": "2024-04-10T09:53:46.039Z",
  "deliveredOn": "2024-04-10T09:53:46.305Z",
  "updateType": "INFORMATIONAL",
  "entityType": "UNSOLICITED_CEASE_ORDER",
  "entity": {
    "supplierOrderNumber": "FC123",
    "status": "IN_PROGRESS",
    "created": "2024-04-10T09:53:11.745Z",
    "requestedCeaseDate": "2024-04-12T00:00:00Z",
    "supplier": "FIBRECO",
    "reason": "CHANGE_OF_CP",
    "serviceId": "S12345",
    "orderType": "UNSOLICITED_CEASE",
    "id": 12345,
    "updated": "2024-04-10T09:53:46.197Z",
    "committedDate": "2024-04-12",
    "targetDate": "2024-04-12",
    "serviceOrderCancellation": {
      "id": 2345,
      "orderId": 12345,
      "reasonCode": "CUSTOMER_CHANGED_MIND",
      "text": "Customer wants to stay",
      "status": "REJECTED"
    }
  },
  "action": {
    "type": "RESUBMIT",
    "code": "INVALID_REQUEST",
    "text": "Cancellation reason code CUSTOMER_CHANGED_MIND is not valid for UNSOLICITED_CEASE orders"
  }
}

KCI: CANCELLED

Where the unsolicited cease order is cancelled by the supplier either as a result of a "cancel other" from the existing tenant or the new takeover being cancelled by the new tenant, this will result in a cancelled KCI:

Copy

Copied

{
  "id": "12056846-dfa1-4834-9962-7c50b1109cb7",
  "supplier": "FIBRECO",
  "sequenceNumber": 5,
  "issuedOn": "2024-04-10T09:53:54.137Z",
  "receivedOn": "2024-04-10T09:53:56.039Z",
  "deliveredOn": "2024-04-10T09:53:56.305Z",
  "updateType": "INFORMATIONAL",
  "entityType": "UNSOLICITED_CEASE_ORDER",
  "entity": {
    "supplierOrderNumber": "FC123",
    "status": "CANCELLED",
    "created": "2024-04-10T09:53:11.745Z",
    "requestedCeaseDate": "2024-04-12T00:00:00Z",
    "supplier": "FIBRECO",
    "reason": "CHANGE_OF_CP",
    "serviceId": "S12345",
    "orderType": "UNSOLICITED_CEASE",
    "id": 12345,
    "updated": "2024-04-10T09:56:46.197Z",
    "committedDate": "2024-04-12",
    "targetDate": "2024-04-12"
  },
  "information": {
    "type": "CANCELLED"
  }
}