api:internet:account:move
Table of Contents
API : Internet Accounts Move
Introduction
This request will move a single Internet account from one customer to another (DSL only)
Request
| URL | https://api.telecomx.dk/internet/account/ACCOUNT_ID/move | ||
|---|---|---|---|
| Method | POST | ||
| Access level | RESELLER_ADMIN, ADMIN. | ||
| Property | Type | Description | |
| Params | ACCOUNT_ID | Id | Id of the Internet account. |
| Body | address | Id | Id of new installation address (must be an address on the new customer) |
| customer | Id | Id of new customer | |
Query examples
{
"customer": "650000000000000000000010",
"address": "650000000000000000000011"
}
Response
| Property | Type | Description |
|---|---|---|
| _id | Id | Unique id of the Internet account. |
| type | String | Type of circuit: DSL or FIBER. |
| state | String | State of product: |
| ORDERED - customer/reseller has ordered the account. | ||
| CONFIRMED - the account has been confirmed for delivery on the specified date. | ||
| ACTIVE - the account is in active use. | ||
| CANCELLED - the account has been cancelled and will terminate on the specified date. | ||
| customer | Id | Id of customer the account belongs to. |
| orderedBy | Id | Id of the employee who ordered the account. |
| address | Id | Id of installation address |
| address2 | Id | Id of installation address2 (if it is a point-2-point account). |
| circuit | String | Id of the circuit. |
| product | Id | Id of the product, that is invoiced. |
| initiationFeeProduct | Id | Id of the product invoiced for establishing the account. |
| takeover | Boolean | True if account is a takeover from another provider (type DSL only). |
| takeoverCustomer | String | Id of customer at provider the takeover is from (type DSL only). |
| orderDate | Date | Date the account was ordered. |
| startDate | Date | When state is ORDERED, the requested start date, otherwise the date the account will go/went live. |
| terminationDate | Date | If state is CANCELLED, the date the account will terminate. |
| requestedTerminationDate | Date | If state is CANCELLED, the date the customer wants the account to be terminated. |
| commitmentExpireDate | Date | The earliest date on which the account may be terminated. |
| commitmentExpireDateCustomer | Date | The earliest termination date agreed with the customer - may differ from commitmentExpireDate. |
| invoicedUntil | Date | The date the account has been invoiced until. |
| installCallNumber | String | Number that technician will call 30 minutes before arriving to install the service. |
| installCallName | String | Name of person technician will call 30 minutes before arriving to install the service. |
| installTime | String | Time of day installation will be performed: 7_30_TO_16, 7_30_TO_12, 12_TO_16. |
| provider | Object | |
| provider.name | String | Name of the subcontractor providing the circuit (RESELLER_ADMIN/ADMIN only). |
| provider.orderId | String | Subcontractors order id (RESELLER_ADMIN/ADMIN only). |
| provider.invoicedUntil | Date | The date until when the provider has invoiced TCX for the account (RESELLER_ADMIN/ADMIN only). |
| provider.ipAddresses | Number | Number of IP addresses ordered for the account (RESELLER_ADMIN/ADMIN only). |
| fiber | Object | |
| fiber.initiationCost | Number | Installation cost (type FIBER only). |
| fiber.initiationWholesale | Number | Reseller installation price (type FIBER only). |
| fiber.initiationCustomer | Number | Customer installation price (type FIBER only). |
| fiber.monthlyCost | Number | Monthly fee cost (type FIBER only). |
| fiber.monthlyWholesale | Number | Monthly fee reseller (type FIBER only). |
| fiber.monthlyCustomer | Number | Monthly fee customer (type FIBER only). |
| changeRequest | Object | |
| changeRequest.state | String | State of change request: NONE, REQUESTED, ORDERED. |
| changeRequest.product | Id | New product/speed customer wishes to change to. |
| changeRequest.by | Id | Id of employee who requested the change and who will be notified. |
| changeRequest.date | Date | The date the change will happen. |
| changeRequest.feeProduct | Id | Id of product for change fee. |
| changeRequest.monthlyCost | Number | New monthly fee cost (type FIBER only). |
| changeRequest.monthlyWholesale | Number | New monthly fee reseller (type FIBER only). |
| changeRequest.monthlyCustomer | Number | New monthly fee customer (type FIBER only). |
| net | Object | |
| net.ipAddress | String | Assigned IP address. |
| net.subnet | String | Assigned subnet mask. |
| net.gateway | String | Assigned default gateway. |
| net.lanNet | String | If an additional network is assigned, this is the first IP address in the range. |
| net.lanSubnet | String | If an additional network is assigned, this is the subnet mask of the range. |
| net.failover | Boolean | True if this line has 3G/4G failover. |
| net.failoverNumber | String | Phone number of failover SIM, if net.failover is true. |
| net.up | Boolean | True if the accounts ipAddress is online/pingable. |
| notes | String | Note about the service (RESELLER/ADMIN only). |
| documents | Array | List of id's of documents related to the account. |
| custom | Object | Optional custom data that 3rd parties may append, max. 4Kb. |
| notify | Array | |
| notify._id | Id | Id of employee to notify when the account goes online/offline. |
| notify.email | Boolean | True to notify via e-mail. |
| notify.sms | Boolean | True to notify via SMS. |
Note that properties holding no value may be omitted from the object.
Example
{ "_id": "650000000000000000000001", "type": "DSL", "state": "ACTIVE", "name": "Eksempelvej 20A", "customer": "650000000000000000000010", "reseller": "650000000000000000000003", "orderedBy": "650000000000000000000004", "address": "650000000000000000000011", "circuit": "EM123456", "product": "650000000000000000000006", "initiationFeeProduct": "650000000000000000000007", "takeover": false, "takeoverCustomer": "", "orderDate": "2026-01-01T00:00:00.000Z", "startDate": "2026-01-14T00:00:00.000Z", "terminationDate": null, "requestedTerminationDate": null, "commitmentExpireDate": "2027-01-14T00:00:00.000Z", "commitmentExpireDateCustomer": "2027-01-14T00:00:00.000Z", "invoicedUntil": "2026-08-01T00:00:00.000Z", "installCallNumber": "71919999", "installCallName": "Hans Eksempel", "installTime": "7_30_TO_12", "changeRequest": { "state": "NONE" }, "net": { "ipAddress": "198.51.100.123", "subnet": "255.255.255.128", "gateway": "198.51.100.1", "failover": false, "up": true }, "notes": "Very important customer", "documents": [], "custom": null, "notify": [ { "_id": "650000000000000000000004", "email": true, "sms": false } ] }
Errors
| Error code | Message | Description |
|---|---|---|
| 403 | access_denied | Insufficient access level |
| 404 | address | Address not found |
| 404 | customer | Customer not found |
| 404 | internetAccount | Internet account not found |
| 409 | id | The old and new customer IDs are the same |
| 409 | parentReseller | The customers do not have the same parentReseller |
| 500 | internal_error | <Unspecified> |
api/internet/account/move.txt · Last modified: by Mikkel Meerwaldt Jørgensen