Tesamanager

API to create and get TESA request.


Parameters

Name In Type Required Description
org path string true Tenant
body body TesaActivationRequest false ‘none’

Request body - instance of TesaActivationRequest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
{
  "territoryOwner": "NEBA",
  "portabilityIndicator": "D",
  "externalReference": "string",
  "technicalCoordinators": {
    "name": "string",
    "surnames": "string",
    "phoneNumbers": {
      "principal": "string",
      "alternative": "string"
    },
    "emails": {
      "principal": "string",
      "alternative": "string"
    },
    "fax": "string"
  },
  "customer": {
    "name": "string",
    "surnames": "string",
    "segment": "B2C",
    "phoneNumbers": {
      "principal": "string",
      "alternative": "string"
    }
  },
  "servicePoint": {
    "gescal": "string",
    "comments": "string",
    "iua": "string",
    "ppai": "string",
    "opVlan": "string",
    "speed": {
      "upload": "string",
      "download": "string"
    },
    "installation": {
      "ptro": true,
      "ont": "N"
    },
    "maintenance": {
      "indicator": true,
      "type": "DSI"
    },
    "portability": {
      "phoneNumber": "string",
      "documentType": "L",
      "documentNumber": "string",
      "accessType": "01",
      "nrn": "string",
      "phoneRange": {
        "initial": "string",
        "final": "string"
      },
      "wholeNumbering": true,
      "resellerDonor": {
        "name": "string",
        "document": "string"
      },
      "resellerRecipient": {
        "name": "string",
        "document": "string"
      }
    }
  }
}
Name Type Required Description
territoryOwner string true Territory owner:
* NEBA - Neba
* VULA_COMMERCIAL - Vula commercial
* VULA_REGULATED - Vula regulated
portabilityIndicator string false Portability type:
* D - Donor
* T - Third party
* N - Without portability
* A - Agreement
externalReference string true none
technicalCoordinators TesaTechnicalCoordinators true none
customer TesaCustomer true none
servicePoint TesaServicePoint true none
Property Values
territoryOwner one of [NEBA, VULA_COMMERCIAL, VULA_REGULATED]
portabilityIndicator one of [D, T, N, A]

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

curl -X POST https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/activation \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'territoryOwner': 'NEBA',
  'portabilityIndicator': 'D',
  'externalReference': 'string',
  'technicalCoordinators': {
    'name': 'string',
    'surnames': 'string',
    'phoneNumbers': {
      'principal': 'string',
      'alternative': 'string'
    },
    'emails': {
      'principal': 'string',
      'alternative': 'string'
    },
    'fax': 'string'
  },
  'customer': {
    'name': 'string',
    'surnames': 'string',
    'segment': 'B2C',
    'phoneNumbers': {
      'principal': 'string',
      'alternative': 'string'
    }
  },
  'servicePoint': {
    'gescal': 'string',
    'comments': 'string',
    'iua': 'string',
    'ppai': 'string',
    'opVlan': 'string',
    'speed': {
      'upload': 'string',
      'download': 'string'
    },
    'installation': {
      'ptro': true,
      'ont': 'N'
    },
    'maintenance': {
      'indicator': true,
      'type': 'DSI'
    },
    'portability': {
      'phoneNumber': 'string',
      'documentType': 'L',
      'documentNumber': 'string',
      'accessType': '01',
      'nrn': 'string',
      'phoneRange': {
        'initial': 'string',
        'final': 'string'
      },
      'wholeNumbering': true,
      'resellerDonor': {
        'name': 'string',
        'document': 'string'
      },
      'resellerRecipient': {
        'name': 'string',
        'document': 'string'
      }
    }
  }
}" 

Responses

Code Meaning Description Schema
201 Created Created TesaResult
400 Bad Request Bad request TesaResult
401 Unauthorized Unauthorized TesaResult
default Default Internal Server Error TesaResult

Parameters

Name In Type Required Description
org path string true Tenant
body body TesaTerminationRequest false ‘none’

Request body - instance of TesaTerminationRequest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
  "territoryOwner": "NEBA",
  "externalReference": "string",
  "technicalCoordinators": {
    "name": "string",
    "surnames": "string",
    "phoneNumbers": {
      "principal": "string",
      "alternative": "string"
    },
    "emails": {
      "principal": "string",
      "alternative": "string"
    },
    "fax": "string"
  },
  "customer": {
    "name": "string",
    "surnames": "string",
    "segment": "B2C",
    "phoneNumbers": {
      "principal": "string",
      "alternative": "string"
    }
  },
  "servicePoint": {
    "iua": "string",
    "administrative": "string"
  }
}
Name Type Required Description
territoryOwner string true Territory owner:
* NEBA - Neba
* VULA_COMMERCIAL - Vula commercial
* VULA_REGULATED - Vula regulated
externalReference string true none
technicalCoordinators TesaTechnicalCoordinators true none
customer TesaCustomer true none
servicePoint TesaTerminationServicePoint true none
Property Values
territoryOwner one of [NEBA, VULA_COMMERCIAL, VULA_REGULATED]

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

curl -X POST https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/termination \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'territoryOwner': 'NEBA',
  'externalReference': 'string',
  'technicalCoordinators': {
    'name': 'string',
    'surnames': 'string',
    'phoneNumbers': {
      'principal': 'string',
      'alternative': 'string'
    },
    'emails': {
      'principal': 'string',
      'alternative': 'string'
    },
    'fax': 'string'
  },
  'customer': {
    'name': 'string',
    'surnames': 'string',
    'segment': 'B2C',
    'phoneNumbers': {
      'principal': 'string',
      'alternative': 'string'
    }
  },
  'servicePoint': {
    'iua': 'string',
    'administrative': 'string'
  }
}" 

Responses

Code Meaning Description Schema
201 Created Created TesaResult
400 Bad Request Bad request TesaResult
401 Unauthorized Unauthorized TesaResult
default Default Internal Server Error TesaResult

Parameters

Name In Type Required Description
org path string true Tenant
body body TesaCancellationRequest false ‘none’

Request body - instance of TesaCancellationRequest

1
2
3
{
  "externalReference": "string"
}
Name Type Required Description
externalReference string true none

Request example

1
2
3
4
5
6
7
8

curl -X PUT https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/cancellation \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'externalReference': 'string'
}" 

Responses

Code Meaning Description Schema
200 OK Ok TesaResult
400 Bad Request Bad Request TesaResult
401 Unauthorized Unauthorized TesaResult
404 Not Found Not found TesaResult
406 Not Acceptable Not acceptable TesaResult
default Default Internal Server Error TesaResult

Parameters

Name In Type Required Description
org path string true Tenant
body body TesaIncidentResolveRequest false ‘none’

Request body - instance of TesaIncidentResolveRequest

1
2
3
4
{
  "externalReference": "string",
  "observations": "string"
}
Name Type Required Description
externalReference string true none
observations string false none

Request example

1
2
3
4
5
6
7
8
9

curl -X PUT https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/incident/resolved \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'externalReference': 'string',
  'observations': 'string'
}" 

Responses

Code Meaning Description Schema
200 OK Ok TesaResult
400 Bad Request Bad Request TesaResult
401 Unauthorized Unauthorized TesaResult
404 Not Found Not found TesaResult
406 Not Acceptable Not acceptable TesaResult
default Default Internal Server Error TesaResult

Parameters

Name In Type Required Description
org path string true Tenant
body body TesaCreateAccessRequest false ‘none’

Request body - instance of TesaCreateAccessRequest

1
2
3
4
5
{
  "externalReference": "string",
  "technicianCode": "string",
  "reason": "string"
}
Name Type Required Description
externalReference string true none
technicianCode string true none
reason string false none

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

curl -X POST https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/stamping/access/sync \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'externalReference': 'string',
  'technicianCode': 'string',
  'reason': 'string'
}" 

Responses

Code Meaning Description Schema
200 OK Success TesaCreateAccessResult
400 Bad Request Bad request TesaResult
401 Unauthorized Unauthorized TesaResult
404 Not Found Not found TesaResult
406 Not Acceptable Not acceptable TesaResult
default Default Internal Server Error TesaResult

Parameters

Name In Type Required Description
org path string true Tenant
body body TesaCreateStatusCtoRequest false ‘none’

Request body - instance of TesaCreateStatusCtoRequest

1
2
3
{
  "externalReference": "string"
}
Name Type Required Description
externalReference string true none

Request example

1
2
3
4
5
6
7
8

curl -X POST https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/stamping/cto_status \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'externalReference': 'string'
}" 

Responses

Code Meaning Description Schema
200 OK Success TesaResult
400 Bad Request Bad request TesaResult
401 Unauthorized Unauthorized TesaResult
404 Not Found Not found TesaResult
406 Not Acceptable Not acceptable TesaResult
default Default Internal Server Error TesaResult

Parameters

Name In Type Required Description
org path string true Tenant
body body TesaCreatePortRequest false ‘none’

Request body - instance of TesaCreatePortRequest

1
2
3
4
{
  "externalReference": "string",
  "port": "string"
}
Name Type Required Description
externalReference string true none
port string true none

Request example

1
2
3
4
5
6
7
8
9

curl -X POST https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/stamping/port_test \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'externalReference': 'string',
  'port': 'string'
}" 

Responses

Code Meaning Description Schema
200 OK Success TesaResult
400 Bad Request Bad request TesaResult
401 Unauthorized Unauthorized TesaResult
404 Not Found Not found TesaResult
406 Not Acceptable Not acceptable TesaResult
default Default Internal Server Error TesaResult

Parameters

Name In Type Required Description
org path string true Tenant
body body TesaCreatePortRequest false ‘none’

Request body - instance of TesaCreatePortRequest

1
2
3
4
{
  "externalReference": "string",
  "port": "string"
}
Name Type Required Description
externalReference string true none
port string true none

Request example

1
2
3
4
5
6
7
8
9

curl -X POST https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/stamping/service_recovery \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'externalReference': 'string',
  'port': 'string'
}" 

Responses

Code Meaning Description Schema
200 OK Success TesaResult
400 Bad Request Bad request TesaResult
401 Unauthorized Unauthorized TesaResult
404 Not Found Not found TesaResult
406 Not Acceptable Not acceptable TesaResult
default Default Internal Server Error TesaResult

Parameters

Name In Type Required Description
org path string true Tenant
body body TesaTerminateAccessRequest false ‘none’

Request body - instance of TesaTerminateAccessRequest

1
2
3
4
{
  "externalReference": "string",
  "observations": "string"
}
Name Type Required Description
externalReference string true none
observations string true none

Request example

1
2
3
4
5
6
7
8
9

curl -X POST https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/stamping/termination \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'externalReference': 'string',
  'observations': 'string'
}" 

Responses

Code Meaning Description Schema
200 OK Success TesaResult
400 Bad Request Bad request TesaResult
401 Unauthorized Unauthorized TesaResult
404 Not Found Not found TesaResult
406 Not Acceptable Not acceptable TesaResult
default Default Internal Server Error TesaResult

Parameters

Name In Type Required Description
org path string true Tenant
body body TesaInstallationIncidentRequest false ‘none’

Request body - instance of TesaInstallationIncidentRequest

1
2
3
4
5
6
7
8
9
{
  "externalReference": "string",
  "requestType": "string",
  "requestNumber": 0,
  "subRequestNumber": 0,
  "incidence": "string",
  "cto": "string",
  "comments": "string"
}
Name Type Required Description
externalReference string true none
requestType string true none
requestNumber integer(int64) true none
subRequestNumber integer(int64) true none
incidence string true none
cto string true none
comments string true none

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

curl -X POST https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/installation/incident \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'externalReference': 'string',
  'requestType': 'string',
  'requestNumber': 0,
  'subRequestNumber': 0,
  'incidence': 'string',
  'cto': 'string',
  'comments': 'string'
}" 

Responses

Code Meaning Description Schema
200 OK Success TesaResult
400 Bad Request Bad request TesaResult
401 Unauthorized Unauthorized TesaResult
404 Not Found Not found TesaResult
406 Not Acceptable Not acceptable TesaResult
default Default Internal Server Error TesaResult

Parameters

Name In Type Required Description
org path string true Tenant
body body TesaInstallationEndRequest false ‘none’

Request body - instance of TesaInstallationEndRequest

1
2
3
4
5
6
7
8
9
{
  "externalReference": "string",
  "requestType": "NEBA",
  "requestNumber": 0,
  "subRequestNumber": 0,
  "test": "string",
  "indicator": "string",
  "owner": "string"
}
Name Type Required Description
externalReference string true none
requestType string true none
requestNumber integer(int64) true none
subRequestNumber integer(int64) true none
test string true none
indicator string true none
owner string true none
Property Values
requestType one of [NEBA, VULA]

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

curl -X POST https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/installation/end \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'externalReference': 'string',
  'requestType': 'NEBA',
  'requestNumber': 0,
  'subRequestNumber': 0,
  'test': 'string',
  'indicator': 'string',
  'owner': 'string'
}" 

Responses

Code Meaning Description Schema
200 OK Success TesaResult
400 Bad Request Bad request TesaResult
401 Unauthorized Unauthorized TesaResult
404 Not Found Not found TesaResult
406 Not Acceptable Not acceptable TesaResult
default Default Internal Server Error TesaResult

Parameters

Name In Type Required Description
org path string true Tenant
body body TesaCtoChangeRequest false ‘none’

Request body - instance of TesaCtoChangeRequest

1
2
3
4
5
6
{
  "externalReference": "string",
  "ctoIdentifier": "string",
  "ctoPort": "string",
  "reason": "AV"
}
Name Type Required Description
externalReference string true none
ctoIdentifier string true none
ctoPort string false none
reason TesaReasonForCtoChange true Reason for the CTO change:
* AV - Broken
* OT - Others

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

curl -X POST https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/installation/cto_change \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
 --data-raw "{
  'externalReference': 'string',
  'ctoIdentifier': 'string',
  'ctoPort': 'string',
  'reason': 'AV'
}" 

Responses

Code Meaning Description Schema
200 OK Success TesaResult
400 Bad Request Bad request TesaResult
401 Unauthorized Unauthorized TesaResult
404 Not Found Not found TesaResult
406 Not Acceptable Not acceptable TesaResult
default Default Internal Server Error TesaResult

Parameters

Name In Type Required Description
org path string true Tenant
statuses query array[string] false Get reference ids of requests with a status. Admits more than one status separated by ‘,’
externalReference query string false Get reference ids of requests with an external reference
autoInstallation query boolean false Get reference ids of requests which are of auto-installation
cancelling query boolean false Get reference ids of cancelling requests
persistence_type query TesaPersistenceType false Persistence Type
notUpdatedSince query string(date-time) false Get reference ids of requests not updated since

Enumerated Values

Property Values
statuses one of [NOT_SENT, VALIDATING, REJECTED, PROCESSING, PROCESSED, INCIDENCE_TESA, INCIDENCE_OPERATOR, INSTALLING, INCIDENCE_INSTALLING, INSTALLED, CANCELED, FINISHED]
persistence_type one of [ACTIVATION, TERMINATION]

Request example

1
2
3
4

curl -X GET https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/tesa_requests?statuses=["NOT_SENT"]&externalReference='EXT_REF'&autoInstallation='true'&cancelling='true'&persistence_type='ACTIVATION'&notUpdatedSince='2023-05-31T08:50:40Z' \
  -H "Accept: application/json"

Responses

Code Meaning Description Schema
200 OK The ids have been successfully retrieved TesaReferenceIdList
401 Unauthorized Unauthorized TesaError
default Default Unexpected error TesaError

Parameters

Name In Type Required Description
org path string true Tenant
referenceId path string true The id of the request to retrieve issues for

Request example

1
2
3
4

curl -X GET https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/tesa_requests/{referenceId} \
  -H "Accept: application/json"

Responses

Code Meaning Description Schema
200 OK The Tesa request has been successfully retrieved TesaRequest
401 Unauthorized Unauthorized TesaError
404 Not Found Not Found TesaError
default Default Unexpected error TesaError

Parameters

Name In Type Required Description
org path string true Tenant
referenceId path string true The id of the request to retrieve issues for

Request example

1
2
3
4

curl -X GET https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/tesa_requests/{referenceId}/events \
  -H "Accept: application/json"

Responses

Code Meaning Description Schema
200 OK The request events have been successfully retrieved [TesaEvent]
401 Unauthorized Unauthorized TesaError
404 Not Found Not Found TesaError
default Default Unexpected error TesaError

200 - instance of TesaEvent

Custom schema example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
[
  {
    "id": 1,
    "sequence_number": 1,
    "reference_id": "reference_id",
    "request_number": 0,
    "event_date": "2023-05-31T08:50:40Z",
    "message_type": "message_type",
    "subrequest_number": 6,
    "inconsistent": false
  }
]
Name Type Required Description
id integer(int64) false Event id
reference_id string true Request reference id
message_type string true TESA message type
request_number integer(int64) true TESA request code
subrequest_number integer(int64) true TESA subrequest code returned
event_date string(date-time) true Event date
sequence_number integer(int32) true Sequence Number
inconsistent boolean true If true, the event must be reconciled.

Parameters

Name In Type Required Description
org path string true Tenant
referenceId path string true The id of the request to retrieve issues for

Request example

1
2
3
4

curl -X GET https://provision-master.private.dev.k8s.masmovil.com/v1/tesamanager/orgs/pepephone/tesa_requests/{referenceId}/issues \
  -H "Accept: application/json"

Responses

Code Meaning Description Schema
200 OK The request issues have been successfully retrieved [TesaIssue]
401 Unauthorized Unauthorized TesaError
404 Not Found Not Found TesaError
default Default Unexpected error TesaError

200 - instance of TesaIssue

Custom schema example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
[
  {
    "id": 1,
    "reference_id": 1001,
    "issue_sequence": 2,
    "issue_code": "I200",
    "resolved": false,
    "repeated": false,
    "last_updated": "2023-05-31T00:00:00.000Z"
  }
]
Name Type Required Description
id integer(int64) true Id of the issue
reference_id string true Request reference id
issue_sequence integer(int32) true Number of issue
issue_code string true Issue code
resolved boolean true Issue is resolved or not
repeated boolean false Issue is repeated or not
last_updated string(date-time) true The date of the issue

Endpoints

Provision TV Amazon

    Provision TV Netflix

      Provision TV HBO

        Provision FTTH

          Provision Orange TV

            Tesamanager

              Device Insurance