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 |
| SUBSCRIPTION_STATUS_DOES_NOT_ALLOW_DEACTIVATION | Subscription status does not allow deactivation | Verify subscription is ACTIVE before deactivation |
| SUBSCRIPTION_DEACTIVATION_COMMITMENTS_DO_NOT_MATCH | Received commitments do not match subscription commitments | Verify commitment identifiers belong to the subscription |
| 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 |
| SUBSCRIPTION_NOT_SUPPORTED | Subscription type is not supported for bundle modification | Only internally managed subscriptions can be added |
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 |
| COMMERCIAL_PRODUCT_DEVICES_QUANTITY_OUT_OF_RANGE | Requested commercial devices quantity is outside catalogue limits | Check commercial product min/max devices in +Catalogue |
| 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 |
400 Bad Request - AgileTv Validation
| Code | Description | Possible actions |
|---|---|---|
| AGILE_TV_NOT_MAIN_LINE | Only primary AgileTv subscriptions are allowed in new bundle sales | Ensure the bundled commercial product corresponds to a primary AgileTv line |
| PRIMARY_AGILE_TV_WITHOUT_PROVIDER_ID | Primary AgileTv subscription is missing provider product id | Request the provider product id for the AgileTv commercial product in Catalogue |
| NO_PRIMARY_AGILE_TV_SUBSCRIPTION | Received bundled_commercial_product is for a secondary agile tv subscription, but the given account has no primary agile tv subscription | Add a primary AgileTv subscription to the account before adding secondary ones |
400 Bad Request - MySim Sell Validation
| Code | Description | Possible actions |
|---|---|---|
| NUMBER_IS_IN_USE | Phone number in use | Use a different phone number |
| NUMBER_NOT_ACTIVE | Phone number is not active | Verify the phone number is active before retry |
| INTRODUCE_VALID_DOCUMENT_NUMBER | Invalid document number | Provide a valid document number |
| ICCID_IN_USE_2 | ICCID is already in use | Use a different SIM card |
| PHONE_ALREADY_RESERVED_OTHER_SALE | Phone number already reserved for another sale | Wait for release or use a different number |
| PORTABILITY_OPERATOR_NOT_ALLOWED | Portability for this operator is not allowed | Verify portability is supported for the operator |
| DUPLICATED_MSISDN | There are duplicated MSISDNs | Remove duplicated MSISDNs from the request |
| INCOMPATIBLE_BUNDLE_PRODUCT | Incompatible bundled product | Select a product compatible with the bundle |
| MISSING_DONOR_ICC | Missing donor ICCID | Provide the donor ICCID |
| NEW_PHONE_NOT_VALID | New phone is not valid | Provide a valid phone number |
| INVALID_SELL_ID_OR_TENANT | Either sell ID or tenant is invalid | Verify the sell identifier and tenant |
| SIM_NOT_ASSOCIATED_DEALER | SIM card is not associated to dealer | Use a SIM card associated with the dealer |
| LANDLINE_OPERATOR_NOT_FOUND | Landline operator not found | Verify the landline operator information |
| COMPANY_NAME_TOO_LONG | Company name too long | Shorten the company name |
| AGILE_DOCUMENT_NUMBER_ALREADY_ACTIVE | Client document already has an AgileTv service active | Use another customer or remove AgileTv |
| DIFFERENT_ICCS | Origin ICCID differs from the final ICCID | Use matching origin and final ICCIDs |
| INVALID_ICCID | Invalid ICCID | Provide a valid ICCID |
| CUSTOMER_NOT_FOUND | Customer not found | Verify the customer exists |
| NOT_ALLOWED_OPERATION_INVALID_BLOCK_ACCOUNT_STATUS | Operation not allowed: Contract state is invalid | Check contract status before retrying |
| NUMBER_ALREADY_ACTIVE | Phone number is already active | Use another phone number |
| MSISDN_USED | Msisdn is in use | Select an unused MSISDN |
| NOT_MOBILE_NUMBER | One of the provided msisdn is not a valid mobile number | Provide valid mobile numbers |
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 |
409 Conflict - MySim Sell Validation
| Code | Description | Possible actions |
|---|---|---|
| FRAUD_DENIED | Rejected by fraud | Review fraud result before retrying |
| CUSTOMER_HAS_WORKORDER_IN_PROGRESS | Customer already has a work order in progress | Wait for the current work order to finish |
| SUBSCRIPTION_IN_WAITING_STATUS | Subscription is pending termination | Wait until termination is completed |
| PORTABILITY_IN_PROGRESS | Portability in progress | Wait until portability is completed |
| PORTABILITY_IN_PROGRESS_MY_PORTABILITY | Portability in progress | Wait until portability is completed |
| PORTABILITY_REJECTED_AND_IN_RETRY_PERIOD | Portability was rejected and is in retry period | Wait until the retry period ends or retry later |
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 |