Subscriptions error catalogue
Client Errors
These are the errors returned when the request cannot be accepted because of an error on request info
400 Bad Request - General Client Errors
| Code | Description | Possible actions |
|---|---|---|
| BAD_REQUEST | General bad request error | Check request format and parameters |
| INVALID_MSISDN | The provided MSISDN is not valid | Check the MSISDN format |
| INVALID_IMSI | The provided IMSI is not valid | Check the IMSI format |
| INVALID_PHONE_NUMBER | The provided phone number is not valid | Check the phone number format |
| MISSING_QUERY_PARAMS | The request is missing required query parameters | Check endpoint documentation |
| MULTIPLE_PATCH_SAME_PATH | Multiple patch operations for the same path are not allowed | Review patch operations and remove duplicates |
400 Bad Request - Lifecycle & State Validation
| Code | Description | Possible actions |
|---|---|---|
| PROMOTION_INVALID_SUBSCRIPTION_STATUS | Subscription status does not allow promotions to be added | Check subscription status before adding promotions |
| SUBSCRIPTION_STATUS_DOES_NOT_ALLOW_OPERATION | Subscription status does not allow the requested promotion operation | Verify subscription is in correct status for operation |
| PROMOTION_ACTIVATION_DATE_NOT_ALLOWED | Subscription status does not allow promotions to be programmed | Check subscription status supports scheduled promotions |
| PROMOTION_NOT_CANCELLABLE | Promotion must be in status REQUESTED to be cancelled | Verify promotion is in REQUESTED status |
| PROMOTION_NOT_DEACTIVATABLE | Promotion must be in status ACTIVE to be deactivated | Verify promotion is in ACTIVE status |
| INVALID_SUBSCRIPTION_STATUS | Subscription must be active or pre-active to perform the operation | Check subscription status is ACTIVE or PRE_ACTIVE |
| OPERATION_NOT_SUPPORTED | The requested operation type is not supported | Check available operations for this subscription type |
400 Bad Request - Change Requests
| Code | Description | Possible actions |
|---|---|---|
| NOT_ACTIVE_SUBSCRIPTION_NO_CR | Not active subscription does not allow change request | Subscription must be active to create change requests |
| SUBSCRIPTION_TYPE_NO_CR | Subscription type does not allow change requests | Verify subscription type supports change requests |
400 Bad Request - Patch Operations
| Code | Description | Possible actions |
|---|---|---|
| INVALID_PATCH_OPERATION | Invalid patch operation | Review patch operation syntax |
| INVALID_PATCH_PATH | Invalid patch path | Check patch path is valid for the resource |
| INVALID_PATCH_REASON | Invalid patch reason | Provide valid reason for patch operation |
| INVALID_PATCH_VALUE | Invalid patch value | Check patch value matches expected format |
400 Bad Request - Device Insurance
| Code | Description | Possible actions |
|---|---|---|
| DEVICE_ALREADY_INSURED | Device is already insured | Check if insurance already exists for this device |
| DEVICE_NOT_ALLOWED_TO_BE_INSURABLE | Device is not eligible for insurance | Verify device model is insurable |
400 Bad Request - Catalogue Validation
| Code | Description | Possible actions |
|---|---|---|
| BUNDLE_DOES_NOT_INCLUDE_SUBSCRIPTION_TYPE | The bundled product is not compatible with the subscription type | Check bundle includes the subscription type |
| MAX_SUBSCRIPTIONS_QUANTITY_EXCEEDED | The requested quantity exceeds the maximum allowed | Reduce quantity or check bundle limits |
| TARIFF_NOT_COMPATIBLE_WITH_PROMOTION | Tariff is not compatible with received promotion | Check promotion compatibility in +Catalogue |
| TARIFF_NOT_COMPATIBLE_WITH_FREE_UNITS_PACKAGE | Tariff is not compatible with received free units package | Check free units package compatibility in +Catalogue |
| TARIFF_NOT_COMPATIBLE_WITH_ADDONS | Tariff is not compatible with received addons | Check addon compatibility in +Catalogue |
| COMMERCIAL_DEVICE_NOT_EXISTS_FOR_TARIFF | Commercial device does not exist for given tariff | Verify device is available for this tariff |
| TARIFF_NOT_COMPATIBLE_WITH_SUBSCRIPTION_TYPE_IN_BUNDLE | Tariff does not belong to subscription type in bundled product | Check tariff belongs to bundle subscription type |
| TARIFF_IS_NOT_AVAILABLE_FOR_SWITCHING | Tariff is not available for switching from original tariff | Verify tariff allows switching from current tariff |
| MISSING_MANDATORY_PROMOTIONS | The request is missing mandatory promotions | Add all mandatory promotions from catalogue |
| MISSING_MANDATORY_FREE_UNITS_PACKAGES | The request is missing mandatory free units packages | Add all mandatory free units packages from catalogue |
| MISSING_MANDATORY_ADDONS | The request is missing mandatory addons | Add all mandatory addons from catalogue |
| MISSING_MANDATORY_COMMERCIAL_DEVICES | The request is missing mandatory commercial devices | Add all mandatory commercial devices from catalogue |
| TARIFF_WRONGFULLY_MARKED_AS_MANDATORY | Tariff marked as mandatory does not match catalogue definition | Check tariff mandatory flag matches catalogue |
| BUNDLED_COMMERCIAL_PRODUCT_NOT_FOUND | No bundled commercial product found for subscription type in bundle | Verify bundle contains commercial product for subscription type |
| INSURANCE_TYPE_MISSING_IN_BUNDLED_PRODUCT | Insurance type not found in bundled commercial product | Add insurance type to bundled commercial product in catalogue |
| CATALOGUE_DEVICE_ERROR | Unable to retrieve catalogue device data | Verify catalogue device exists in +Catalogue |
400 Bad Request - Barrings Validation
| Code | Description | Possible actions |
|---|---|---|
| SUBSCRIPTION_HAS_DEBT_MASK | The action is not allowed because subscription is barred for debt | Clear debt barring before attempting operation |
| SUBSCRIPTION_NOT_ACTIVE_ON_THIRD_PARTY_NO_CR | Subscription not active on third party does not allow change request | Activate subscription on third party first |
400 Bad Request - Sales Promotions
| Code | Description | Possible actions |
|---|---|---|
| INVALID_ACTIVATION_DATE | Activation date provided is invalid | Provide valid activation date |
| INVALID_EXPIRATION_DATE | Expiration date provided is invalid | Provide valid expiration date |
| INVALID_SUBSCRIPTION_TYPE | Subscription status does not allow the action requested | Check subscription status |
| SUBSCRIPTION_BARRED | Subscription barred for debt does not allow the action requested | Clear debt barring before proceeding |
| PROMOTION_STATUS_INVALID | Promotion status does not allow the action requested | Check promotion status |
| VALIDATION_DOES_NOT_MATCH | Conditions evaluated in validation have changed | Validate again with current conditions |
| VALIDATION_EXPIRED | Validation expired for the request | Request new validation |
| INVALID_CATALOGUE_PROMOTION_ID | Subscription is not compatible with requested catalogue promotion | Check promotion compatibility in +Catalogue |
| CATALOGUE_PROMOTION_ID_IS_BUNDLED | Bundle level promotion category is not supported by this service | Use bundle-level promotion endpoint |
| NO_VALID_SUBSCRIPTIONS | There are no subscriptions with a valid status for the given bundle | Check subscriptions have valid status |
| BUNDLE_HAS_NO_ELIGIBLE_SUBSCRIPTIONS | There are no mandatory or bundled subscriptions eligible for the given bundle | Check bundle contains mandatory or bundled subscriptions |
401 Unauthorized
| Code | Description | Possible actions |
|---|---|---|
| UNAUTHORIZED | User is not authenticated | Provide valid authentication credentials |
403 Forbidden
| Code | Description | Possible actions |
|---|---|---|
| FORBIDDEN | Not authorized to perform the operation | Check user permissions |
| UNSUPPORTED_SUBSCRIPTION_OPERATION | The operation cannot be performed on this subscription | Check supported operations for this subscription type |
| UNSUPPORTED_SUBSCRIPTION_TYPE | Subscription type not supported | Verify subscription type is supported by this endpoint |
| ORANGE_TV_INSTALLATION_STATUS_NOT_ALLOWED_IN_CANCELLATION | Installation status does not allow cancellation | Wait for installation to reach cancellable status |
404 Not Found
| Code | Description | Possible actions |
|---|---|---|
| NOT_FOUND | Resource not found | Verify resource identifier is correct |
| SUBSCRIPTION_NOT_FOUND | The requested subscription does not exist | Check the subscription id provided |
| BUNDLE_NOT_FOUND | The requested bundle does not exist | Check the bundle id provided |
| DEVICE_NOT_FOUND_EXCEPTION | Device not found | Verify device identifier is correct |
| PROMOTION_NOT_FOUND | Promotion not found | Check promotion id provided |
| CHANGE_REQUEST_NOT_FOUND_EXCEPTION | Change request not found | Verify change request identifier is correct |
| COMMITMENT_NOT_FOUND_EXCEPTION | Commitment not found | Verify commitment identifier is correct |
| CONTRACT_NOT_FOUND | Contract not found | Verify contract identifier is correct |
| DOCUMENTS_CONTRACT_NOT_FOUND | Documents contract not found | Verify documents contract identifier is correct |
| ADD_ON_NOT_FOUND | No addOn found with given id | Verify addon identifier is correct |
| FRAUD_REQUEST_NOT_FOUND | Fraud request not found | Verify fraud request identifier is correct |
| PROMOTION_ID_NOT_FOUND | PromotionId provided is not found for the subscription | Check promotion exists in subscription |
| SALE_PROMOTION_NOT_FOUND | SalePromotion not found | Verify sale promotion identifier is correct |
406 Not Acceptable
| Code | Description | Possible actions |
|---|---|---|
| NOT_ACCEPTABLE | Request content type or format not acceptable | Check Accept headers and request format |
409 Conflict
| Code | Description | Possible actions |
|---|---|---|
| CONFLICT | Resource conflict | Check resource state and resolve conflict |
| PROMOTION_ALREADY_EXISTS | Promotion already exists | Remove duplicate promotion or use existing one |
| INVALID_OPERATION_ON_BUNDLE_STATUS | Bundle status does not allow operation | Check bundle status before performing operation |
| UNFINISHED_CHANGE_REQUEST_EXISTS | Unfinished change request already exists for subscription | Complete or cancel existing change request |
| ORANGE_TV_LIBRE_REGISTRATION_EMAIL_ALREADY_IN_USE | Orange TV Libre registration email is already in use | Use a different email address |
| ORANGE_TV_REGISTRATION_EMAIL_ALREADY_IN_USE | Orange TV registration email is already in use | Use a different email address |
| SALE_PROMOTION_ALREADY_EXECUTED | Sale promotion already executed | Cannot re-execute already executed promotion |
| SALE_PROMOTION_ROLLBACK_PENDING | Sale promotion rollback is pending | Wait for rollback to complete |
500 Internal Server Error
| Code | Description | Possible actions |
|---|---|---|
| INTERNAL_SERVER_ERROR | Internal server error occurred | Retry request or contact support |
501 Not Implemented
| Code | Description | Possible actions |
|---|---|---|
| NOT_IMPLEMENTED | Functionality not yet implemented | Check API documentation for available features |
503 Service Unavailable
| Code | Description | Possible actions |
|---|---|---|
| SERVICE_UNAVAILABLE | Service temporarily unavailable | Retry request after some time |