Table of Contents

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

{
  success: true
}

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>