API : Porting Stage Override
Introduction
This is a failsafe request for ADMIN to change the current stage of a porting. This is only to be used if for some unforeseen reason the porting does not reflect the actual stage of the porting.
Request
| URL | https://api.telecomx.dk/porting/PORTING_ID/stageOverride |
| Method | GET |
| Access level | RESELLER_ADMIN with PORTING feature. |
| Param | PORTING_ID | Id of the porting (24 hex-char string) |
| Query | stage | The new stage code. See stage codes below. |
| message | Message to go with the stage code, if it applies. |
| Stage code | Description | Requires attention |
| IN_CREATED | Porting has been created. | |
| IN_AWAITING_POA_FROM_CUSTOMER | Power Of Attorney document(s) has been sent to the customer and we now wait for the customer to sign and return them. | After 3 days. |
| IN_POA_RECEIVED_FROM_CUSTOMER | Power Of Attorney document(s) has been received from the customer and we now wait for an ADMIN to approve them, so that the POA can be forwarded to the donor operator and the porting can be ordered. | Immediately. |
| IN_POA_SENT | POA document(s) has been sent to the donor operator. | After 2 days. |
| IN_ORDERED | Porting of the number(s) has been ordered, we now wait for the donor operator to reply. | After 3 days. |
| IN_CONFIRMED | Porting has been confirmed/approved by the donor operator and we are now waiting for the porting date to come, where the porting will be carried out and the porting will be completed. | |
| IN_REJECTED | Donor operator has rejected the porting request. An ADMIN will investigate the matter. | Immediately. |
| IN_DONOR_CONTACTED | The donor operator has been contacted due to some issue with the porting. | After 3 days. |
| IN_COMPLETED | The porting has been completed and the numbers has been transferred. [End of run] | |
| IN_CANCELLED | The porting has been cancelled, either by customer, reseller or ADMIN or by ADMIN due to a rejection. [End of run] | |
| OUT_RECEIVED | A request for out porting to another operator has been received. Now waiting for an ADMIN to confirm or reject. | Immediately. |
| OUT_RECEIVER_CONTACTED | The receiving operator has been contacted due to some issue with the porting. | After 3 days. |
| OUT_CONFIRMED | The out porting has been confirmed to take place on the set date. Now waiting for the porting to be completed. | |
| OUT_COMPLETED | The out porting has been completed and the numbers has been transferred out. [End of run] | |
| OUT_CANCELLED | The receiving operator has cancelled the porting. [End of run] | |
| OUT_REJECTED | We have rejected the out porting due to an error in the request. [End of run] | |
Query example
https://api.telecomx.dk/porting/1234567890ABCDEF12345678/stageOverride?stage=IN_CONFIRMED&message=2014-07-23
Response
| Json object |
| success | Boolean | True if request was sucessful. |
Example
Errors
| Error code | Message | Description |
| 400 | bad_request | Porting id not found in requested URI |
| 422 | stage | Stage is not valid |
| 404 | not_found | Porting not found |
| 403 | access_denied | Insufficient access level |
| 500 | internal_error | <Unspecified> |
