api:internet:account:confirm
Table of Contents
API : Internet Account Confirm
Introduction
This request will confirm an ordered Internet account, setting delivery date and other information.
Request
| URL | https://api.telecomx.dk/internet/account/ACCOUNT_ID/confirm | ||
|---|---|---|---|
| Method | POST | ||
| Access level | RESELLER_ADMIN or ADMIN. | ||
| Params | ACCOUNT_ID | Id of the Internet account. | |
| Body | startDate | Date | The date the account will be delivered/go live. |
| circuit | String | Id of the circuit. | |
| installTime | String | Time of delivery. Valid values: 7_30_TO_16, 7_30_TO_12, 12_TO_16. | |
| name | String | Logical name of connection. Min 1, max 100 chars. | |
| takeoverCustomer | String | Customer number at donor operator (DSL takeover only). | |
| installCallNumber | String | Number that technician will call 30 minutes before arriving. | |
| installCallName | String | Name of person technician will call 30 minutes before arriving. | |
| notes | String | Note about the service. Max length 4096. | |
| notify | Array | ||
| notify[]._id | Id | Id of employee to notify. | |
| notify[].email | Boolean | True to notify via e-mail. | |
| notify[].sms | Boolean | True to notify via SMS. | |
| net | Object | ||
| net.ipAddress | String | Assigned IP address. IPv4 dotted-quad, or an empty string to clear. | |
| net.subnet | String | Assigned subnet mask. IPv4 dotted-quad, or an empty string to clear. | |
| net.gateway | String | Assigned default gateway. IPv4 dotted-quad, or an empty string to clear. | |
| net.lanNet | String | If an additional network is assigned, this is the first IP address in the range. IPv4 dotted-quad, or an empty string to clear. | |
| net.lanSubnet | String | If an additional network is assigned, this is the subnet mask of the range. IPv4 dotted-quad, or an empty string to clear. | |
| 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.routerId | Id | Id of the router | |
| fiber | Object | ||
| fiber.initiationCost | Number | Installation cost (FIBER only), 0-500000. | |
| fiber.initiationWholesale | Number | Reseller installation price (FIBER only), 0-500000. | |
| fiber.initiationCustomer | Number | Customer installation price (FIBER only), 0-500000. | |
| fiber.monthlyCost | Number | Monthly fee cost (FIBER only), 0-500000. | |
| fiber.monthlyWholesale | Number | Monthly fee reseller (FIBER only), 0-500000. | |
| fiber.monthlyCustomer | Number | Monthly fee customer (FIBER only), 0-500000. | |
| provider | Object | ||
| provider.orderId | String | Providers order id for the circuit. | |
| provider.name | String | Name of provider. | |
| provider.ipAddresses | Number | Number of IP addresses ordered: 1, 2, 4, 8, 16 or 32 (FIBER only). | |
startDate and circuit must be set - in the body or already on the account - because the account becomes CONFIRMED; the confirm fails with 422 otherwise.
Query examples
{ "startDate": "2026-09-01T00:00:00.000Z", "circuit": "EM23867", "installTime": "12_TO_16", "name": "Office connection", "installCallNumber": "71919998", "installCallName": "Hans Eksempel", "notes": "Customer requires installation in basement.", "notify": [ { "_id": "650000000000000000000004", "email": true, "sms": false } ], "provider": { "orderId": "5637575637", "name": "Eksempel Fiber A/S" }, "net": { "ipAddress": "198.51.100.10", "subnet": "255.255.255.0", "gateway": "198.51.100.1", "failover": true, "failoverNumber": "+4571919998" }, "fiber": { "initiationCost": 5000, "initiationWholesale": 6000, "initiationCustomer": 7500, "monthlyCost": 300, "monthlyWholesale": 400, "monthlyCustomer": 499 } }
Response
| JSON object | ||
|---|---|---|
| success | Boolean | True on success |
Example
{ "success": true }
Errors
| Error code | Message | Description |
|---|---|---|
| 422 | <property> | Invalid input for the named property - the request body, query or URL parameter failed validation |
| 404 | _id | Internet account not found |
| 404 | template | Template not found - the e-mail template is missing for a notify recipient; the account is nevertheless confirmed |
| 409 | net.ipAddress | IP address is already in use |
| 422 | state | Account must be in ORDERED state |
| 422 | startDate | Start date is required |
| 422 | startDate | Start date must be between 4 years ago and 6 months in the future |
| 422 | circuit | Circuit number is required |
| 422 | takeoverCustomer | Id/number of customer to takeover from is required |
| 422 | net.failoverNumber | Failover number is required when failover is enabled |
| 422 | notes | Notes exceeds 4 Kb limit |
| 422 | multiple | Multiple errors - see inner |
| 403 | access_denied | Insufficient access level |
| 500 | internal_error | <Unspecified> |
api/internet/account/confirm.txt · Last modified: by Mikkel Meerwaldt Jørgensen