User Tools

Site Tools


api:internet:account:confirm

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

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki