# Service Problem Management

## Create a problem/incident for an active service owned by the communications provider (CP).

 - [POST /service-problems](https://docs.thefibrecafe.net/openapi/prod/tenant-api/gen/service-problem-management/handlecreateproblem.md): This endpoint can be called to raise a problem with a supplier to resolve a potential issue with a service.

The Fibre Cafe will validate the request and generate a problem identifier which is 
returned. If the problem request is rejected immediately then a 4XX code will be returned
with reason(s) for the rejection in the response.

The problem will then be sent to the supplier for processing and further updates
will be sent via KCIs - this could include a rejection if the problem does not
meet supplier validation/processing rules. Once the problem is acknowledged, the
supplier may assign their internal reference number which will be returned in the KCI as a characteristic.

## Retrieve current service problem details including updates (KCIs).

 - [GET /service-problems/{id}](https://docs.thefibrecafe.net/openapi/prod/tenant-api/gen/service-problem-management/handlegetserviceproblembyid.md): This endpoint is called to retrieve the current details (including KCIs) about a service problem request.

## Request to amend an inflight service problem.

 - [POST /service-problem-amendments](https://docs.thefibrecafe.net/openapi/prod/tenant-api/gen/service-problem-management/handleamendproblem.md): This endpoint is called to request amendment of an existing inflight service problem on an active service.

The Fibre Cafe will validate the request and generate a unique ID which is returned.
If the problem amendment is rejected immediately then a 4XX code will be
returned with reason(s) for the rejection in the response.

The problem amendment will then be sent to the supplier for processing and further
updates will be sent via KCIs - this could include a rejection if the request
does not meet supplier validation/processing rules.

## Request to cancel an inflight service problem.

 - [POST /service-problem-cancellations](https://docs.thefibrecafe.net/openapi/prod/tenant-api/gen/service-problem-management/handlecancelproblem.md): This endpoint is called to request cancellation of an existing inflight service problem on an active service.

The Fibre Cafe will validate the request and generate a unique ID which is returned.
If the problem cancellation is rejected immediately then a 4XX code will be
returned with reason(s) for the rejection in the response.

The problem cancellation will then be sent to the supplier for processing and further
updates will be sent via KCIs - this could include a rejection if the cancellation
does not meet supplier validation/processing rules.

## Request to accept or reject resolution of an inflight service problem.

 - [PATCH /service-problem-resolutions/{id}](https://docs.thefibrecafe.net/openapi/prod/tenant-api/gen/service-problem-management/handleserviceproblemresolution.md): This endpoint is called to request acceptance or rejection of a supplier's resolution to an inflight
service problem.