Schemas

portabilityInfo

 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
{
  "phoneRanges": [
    {
      "nrnRange": "312800",
      "initialRange": "900000000",
      "endRange": "900000000"
    }
  ],
  "stateId": 1,
  "messageType": "DSP1",
  "externalReference": "MYSIM_112233",
  "brand": "MASMOVIL",
  "recipientRol": true,
  "processId": "00031202005111500003",
  "recipientOperator": "00031",
  "donorOperator": "00001",
  "requestDate": "2017-09-13T13:00:00",
  "messageDate": "2017-09-13T14:00:00",
  "windowDate": "2017-09-15T08:00:00",
  "cancellationDate": "2017-09-15T08:00:00",
  "processType": 15,
  "administrative": "445022444216",
  "lluProcessId": "550739346020000001",
  "fullNumberFlag": 0,
  "wholesalerFlag": 0,
  "accessType": "01",
  "donorResellerOperator": "REVENDEDOR",
  "recipientResellerOperator": "MASMOVIL",
  "subscriber": {
    "nif": "11111111H",
    "name": "nombre apellidos",
    "address": "Calle COLON",
    "postalCode": "28100",
    "province": "28",
    "town": "Madrid",
    "date": "2017-09-13T13:00:00"
  },
  "causeCode": "0001",
  "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor",
  "observations": "",
  "infoTariff": "",
  "internal": false,
  "isCancellable": false,
  "accessPhoneRanges": [
    {
      "accessType": "01",
      "initialRange": "900000000",
      "endRange": "900000000"
    }
  ],
  "eventList": [
    {
      "eventTimestamp": "2017-09-15T08:42:33.123456",
      "messageType": "DSP1",
      "messageId": "00031202005110000003",
      "subProcessId": "00031202005110200003",
      "eventType": "EVENT",
      "causeCode": "0001",
      "administrative": "445022444216"
    }
  ]
}
Name Type Required Description
phoneRanges phoneRanges false none
stateId stateId false portability state
messageType messageType false Message type Portabaility
externalReference externalReference false externalReference associated
brand brand false brand associated
recipientRol recipientRol true operator rol recipient or donor
processId processId true process id in Portanet
recipientOperator recipientOperator false current recipient operator code
donorOperator donorOperator false initial donor operator code
requestDate requestDate false request date for portability
messageDate messageDate false date to send to Portanet
windowDate windowDate false portability window
cancellationDate cancellationDate false cancellation date
processType processType false process type
administrative administrative false administrative access number
lluProcessId lluProcessId false local loop unbundling identifier
fullNumberFlag fullNumberFlag false full number flag
wholesalerFlag wholesalerFlag false wholesaler flag
accessType accessType false portability access type
donorResellerOperator donorResellerOperator false donor reseller operator
recipientResellerOperator recipientResellerOperator false recipient reseller operator
subscriber subscriber false none
causeCode causeCode false cause code of a denied operation
causeDescription causeDescription false cause description of a denied operation
observations observations false observations of a portability
infoTariff infoTariff false info tariff of a portability
internal internal false is a portability between own operators
isCancellable isCancellable false is a portability cancellable
accessPhoneRanges accessPhoneRanges false none
eventList [event] false none

portabilitiesInfo

 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
[
  {
    "phoneRanges": [
      {
        "nrnRange": "312800",
        "initialRange": "900000000",
        "endRange": "900000000"
      }
    ],
    "stateId": 1,
    "messageType": "DSP1",
    "externalReference": "MYSIM_112233",
    "brand": "MASMOVIL",
    "recipientRol": true,
    "processId": "00031202005111500003",
    "recipientOperator": "00031",
    "donorOperator": "00001",
    "requestDate": "2017-09-13T13:00:00",
    "messageDate": "2017-09-13T14:00:00",
    "windowDate": "2017-09-15T08:00:00",
    "cancellationDate": "2017-09-15T08:00:00",
    "processType": 15,
    "administrative": "445022444216",
    "lluProcessId": "550739346020000001",
    "fullNumberFlag": 0,
    "wholesalerFlag": 0,
    "accessType": "01",
    "donorResellerOperator": "REVENDEDOR",
    "recipientResellerOperator": "MASMOVIL",
    "subscriber": {
      "nif": "11111111H",
      "name": "nombre apellidos",
      "address": "Calle COLON",
      "postalCode": "28100",
      "province": "28",
      "town": "Madrid",
      "date": "2017-09-13T13:00:00"
    },
    "causeCode": "0001",
    "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor",
    "observations": "",
    "infoTariff": "",
    "internal": false,
    "isCancellable": false,
    "accessPhoneRanges": [
      {
        "accessType": "01",
        "initialRange": "900000000",
        "endRange": "900000000"
      }
    ],
    "eventList": [
      {
        "eventTimestamp": "2017-09-15T08:42:33.123456",
        "messageType": "DSP1",
        "messageId": "00031202005110000003",
        "subProcessId": "00031202005110200003",
        "eventType": "EVENT",
        "causeCode": "0001",
        "administrative": "445022444216"
      }
    ]
  }
]
Name Type Required Description
anonymous [portabilityInfo] false none

minimumWindowDate

1
2
3
{
  "result": "2024-05-20T22:00:00Z"
}
Name Type Required Description
result string true minimum window date

acceptDonorPortabilityRequest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
{
  "processId": "00031202005111500003",
  "phoneRanges": [
    {
      "nrnRange": "312800",
      "initialRange": "900000000",
      "endRange": "900000000"
    }
  ],
  "observations": "",
  "externalReference": "MYSIM_112233",
  "brand": "MASMOVIL"
}
Name Type Required Description
processId processIdMandatory true process id in Portanet
phoneRanges phoneRanges false none
observations observations false observations of a portability
externalReference externalReference false externalReference associated
brand brand false brand associated

denyDonorPortabilityRequest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
{
  "processId": "00031202005111500003",
  "causeCode": "0001",
  "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor",
  "administrative": "445022444216",
  "accessPhoneRanges": [
    {
      "accessType": "01",
      "initialRange": "900000000",
      "endRange": "900000000"
    }
  ],
  "observations": "",
  "externalReference": "MYSIM_112233",
  "brand": "MASMOVIL"
}
Name Type Required Description
processId processIdMandatory true process id in Portanet
causeCode causeCodeMandatory true cause code of a denied operation
causeDescription causeDescription false cause description of a denied operation
administrative administrative false administrative access number
accessPhoneRanges accessPhoneRanges false none
observations observations false observations of a portability
externalReference externalReference false externalReference associated
brand brand false brand associated

errorResponse

1
2
3
4
5
6
{
  "code": "0002",
  "status": "BAD_REQUEST",
  "message": "Bad Request",
  "detailMsg": "Portability not found"
}
Name Type Required Description
code string false error code
status string false status code response
message string false message response
detailMsg string false detail description of error

changeNrn

1
2
3
4
5
6
7
8
{
  "recipientOperator": "00031",
  "initialRange": "900000000",
  "endRange": "900000000",
  "nrnRange": "312800",
  "windowDate": "2017-09-15T08:00:00",
  "observations": ""
}
Name Type Required Description
recipientOperator recipientOperatorMandatory true current recipient operator code
initialRange initialRange true intial phone number range
endRange endRange true end phone number range
nrnRange nrnRange true nrn range
windowDate windowDateMandatory true portability window
observations observations false observations of a portability

cause

1
2
3
4
5
{
  "messageType": "DSP1",
  "causeCode": "0001",
  "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor"
}
Name Type Required Description
messageType messageTypeMandatory true Message type Portabaility
causeCode causeCodeMandatory true cause code of a denied operation
causeDescription causeDescription false cause description of a denied operation

causes

1
2
3
4
5
6
7
[
  {
    "messageType": "DSP1",
    "causeCode": "0001",
    "causeDescription": "Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor"
  }
]
Name Type Required Description
anonymous [cause] false none

holiday

1
2
3
{
  "isHoliday": true
}
Name Type Required Description
isHoliday boolean true return is holiday

cancelChangeNrn

1
2
3
4
5
{
  "processId": "00031202005111500003",
  "causeCode": "0001",
  "observations": ""
}
Name Type Required Description
processId processIdMandatory true process id in Portanet
causeCode causeCodeMandatory true cause code of a denied operation
observations observations false observations of a portability

forceDownloadPortanetFileRequest

1
2
3
4
5
{
  "ftpFile": "dsp2_15_r",
  "operatorId": "00031",
  "date": "2017-09-15"
}
Name Type Required Description
ftpFile string true Ftp file name
operatorId string true operator code
date string(date) true file date

forceDownloadStorage

1
2
3
4
5
{
  "ftpFile": "SP_D",
  "operatorId": "00031",
  "date": "2017-09-15"
}
Name Type Required Description
ftpFile string true Ftp file name
operatorId string true operator code
date string(date) true file date

portabilityRequest

 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
{
  "phoneRanges": [
    {
      "nrnRange": "312800",
      "initialRange": "900000000",
      "endRange": "900000000"
    }
  ],
  "externalReference": "MYSIM_112233",
  "brand": "MASMOVIL",
  "recipientOperator": "00031",
  "donorOperator": "00001",
  "windowDate": "2017-09-15T08:00:00",
  "administrative": "445022444216",
  "lluProcessId": "550739346020000001",
  "fullNumberFlag": 0,
  "wholesalerFlag": 0,
  "coordinatedActionFlag": 0,
  "accessType": "01",
  "donorResellerOperator": "REVENDEDOR",
  "recipientResellerOperator": "MASMOVIL",
  "processType": 15,
  "subscriber": {
    "nif": "11111111H",
    "name": "nombre apellidos",
    "address": "Calle COLON",
    "postalCode": "28100",
    "province": "28",
    "town": "Madrid",
    "date": "2017-09-13T13:00:00"
  },
  "infoTariff": "",
  "observations": ""
}
Name Type Required Description
phoneRanges phoneRanges true none
externalReference externalReference true externalReference associated
brand brand true brand associated
recipientOperator recipientOperatorMandatory true current recipient operator code
donorOperator donorOperatorMandatory true initial donor operator code
windowDate windowDate false portability window
administrative administrative false administrative access number
lluProcessId lluProcessId false local loop unbundling identifier
fullNumberFlag fullNumberFlag false full number flag
wholesalerFlag wholesalerFlag false wholesaler flag
coordinatedActionFlag coordinatedActionFlag false coordinated action flag
accessType accessType false portability access type
donorResellerOperator donorResellerOperator false donor reseller operator
recipientResellerOperator recipientResellerOperator false recipient reseller operator
processType processType true process type
subscriber subscriber true none
infoTariff infoTariff false info tariff of a portability
observations observations false observations of a portability

createRequestKafka

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
{
  "offset": 0,
  "timestamp": "1732095916580",
  "serializedKeySize": 0,
  "serializedValueSize": 0,
  "topicPartition": {
    "hash": 0,
    "partition": 0,
    "topic": "topic"
  }
}
Name Type Required Description
offset integer false offset
timestamp number false timestamp
serializedKeySize integer false serialized key size
serializedValueSize number false serialized value size
topicPartition object false none
» hash integer false hash
» partition integer false partition
» topic string false topic

cancelPortability

1
2
3
4
5
{
  "processId": "00031202005111500003",
  "causeCode": "0001",
  "observations": ""
}
Name Type Required Description
processId processIdMandatory true process id in Portanet
causeCode causeCodeMandatory true cause code of a denied operation
observations observations false observations of a portability

unsubscribeRequest

1
2
3
4
5
6
7
{
  "recipientOperator": "00031",
  "donorOperator": "00001",
  "initialRange": "900000000",
  "endRange": "900000000",
  "observations": ""
}
Name Type Required Description
recipientOperator recipientOperatorMandatory true current recipient operator code
donorOperator donorOperatorMandatory true initial donor operator code
initialRange initialRange true intial phone number range
endRange endRange true end phone number range
observations observations false observations of a portability

cancelUnsubscribe

1
2
3
4
5
{
  "processId": "00031202005111500003",
  "causeCode": "0001",
  "observations": ""
}
Name Type Required Description
processId processIdMandatory true process id in Portanet
causeCode causeCodeMandatory true cause code of a denied operation
observations observations false observations of a portability

qspEvent

1
2
3
4
{
  "processId": "00031202005111500003",
  "windowDate": "2017-09-15T08:00:00"
}
Name Type Required Description
processId processIdMandatory true process id in Portanet
windowDate windowDate false portability window

aspEvent

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{
  "processId": "00031202005111500003",
  "phoneRanges": [
    {
      "nrnRange": "312800",
      "initialRange": "900000000",
      "endRange": "900000000"
    }
  ],
  "windowDate": "2017-09-15T08:00:00",
  "observations": ""
}
Name Type Required Description
processId processIdMandatory true process id in Portanet
phoneRanges phoneRanges false none
windowDate windowDate false portability window
observations observations false observations of a portability

dsp1Event

1
2
3
4
5
{
  "processId": "00031202005111500003",
  "causeCode": "0001",
  "observations": ""
}
Name Type Required Description
processId processIdMandatory true process id in Portanet
causeCode causeCodeMandatory true cause code of a denied operation
observations observations false observations of a portability

dsp2Event

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
{
  "processId": "00031202005111500003",
  "causeCode": "0001",
  "administrative": "445022444216",
  "phoneRanges": [
    {
      "nrnRange": "312800",
      "initialRange": "900000000",
      "endRange": "900000000"
    }
  ],
  "observations": ""
}
Name Type Required Description
processId processIdMandatory true process id in Portanet
causeCode causeCodeMandatory true cause code of a denied operation
administrative administrative false administrative access number
phoneRanges phoneRanges false none
observations observations false observations of a portability

wEvent

1
2
3
4
5
{
  "processId": "00031202005111500003",
  "causeCode": "0001",
  "observations": ""
}
Name Type Required Description
processId processIdMandatory true process id in Portanet
causeCode causeCodeMandatory true cause code of a denied operation
observations observations false observations of a portability

pncEvent

1
2
3
{
  "processId": "00031202005111500003"
}
Name Type Required Description
processId processIdMandatory true process id in Portanet

stccEvent

1
2
3
{
  "processId": "00031202005111500003"
}
Name Type Required Description
processId processIdMandatory true process id in Portanet

dcncEvent

1
2
3
4
5
{
  "processId": "00031202005111500003",
  "causeCode": "0001",
  "observations": ""
}
Name Type Required Description
processId processIdMandatory true process id in Portanet
causeCode causeCodeMandatory true cause code of a denied operation
observations observations false observations of a portability

acquisitionStatus

1
2
3
4
5
{
  "id": "1",
  "description": "Portado",
  "cancellable": false
}
Name Type Required Description
id string false status id
description string false status description
cancellable boolean false is cancellable the current status

acquisitionDate

1
2
3
4
5
{
  "operator": "2017-09-15T08:00:00",
  "cmt_numeration": "2017-09-15T08:00:00",
  "acquisition": "2017-09-15T08:00:00"
}
Name Type Required Description
operator string false operators last modified date
cmt_numeration string false cmt_numeration last modified date
acquisition string false acquisition last modified date

operator

1
2
3
4
5
6
{
  "id": "00031",
  "name": "Xtra Telecom S.A.",
  "license": "01",
  "community": "15"
}
Name Type Required Description
id string true operator code
name string true operator name
license string¦null false license type
community string false community type

ownerOperator

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
{
  "phonenumber": "911111111",
  "donorOperator": "00001",
  "donorOperatorName": "Movistar",
  "recipientOperator": "00031",
  "recipientOperatorName": "Xtra",
  "initialDonorOperator": "00002",
  "initialDonorOperatorName": "Vodafone",
  "initialDonorOperator2": "00002",
  "initialDonorOperator2Name": "Vodafone",
  "initialDonorOperator3": "00002",
  "initialDonorOperator3Name": "Vodafone",
  "nrn": "312800",
  "windowDate": "2017-09-15T08:00:00",
  "status": "1",
  "statusName": "Portado",
  "recipientResellerOperator": "XFERA",
  "donorResellerOperator": "CABLEMOBIL"
}
Name Type Required Description
phonenumber string false phonenumber
donorOperator string false donor operator code
donorOperatorName string false donor operator name
recipientOperator string false recipient operator code
recipientOperatorName string false recipient operator name
initialDonorOperator string false initial donor operator code
initialDonorOperatorName string false initial donor operator name
initialDonorOperator2 string false initial donor operator 2 code
initialDonorOperator2Name string false initial donor operator 2 name
initialDonorOperator3 string false initial donor operator 3 code
initialDonorOperator3Name string false initial donor operator 3 name
nrn string false network routing number
windowDate string false portability date
status string false status code
statusName string false status name
recipientResellerOperator string false recipient reseller operator name
donorResellerOperator string false donor reseller operator name

externalReference

1
"MYSIM_112233"
Name Type Required Description
anonymous string¦null false externalReference associated

brand

1
"MASMOVIL"
Name Type Required Description
anonymous string¦null false brand associated

stateId

1
1
Name Type Required Description
anonymous integer(int32) false portability state

processId

1
"00031202005111500003"
Name Type Required Description
anonymous string¦null false process id in Portanet

processIdMandatory

1
"00031202005111500003"
Name Type Required Description
anonymous string false process id in Portanet

processType

1
15
Name Type Required Description
anonymous integer(int32) false process type

messageType

1
"DSP1"
Name Type Required Description
anonymous string¦null false Message type Portabaility

messageTypeMandatory

1
"DSP1"
Name Type Required Description
anonymous string false Message type Portabaility

recipientRol

1
true
Name Type Required Description
anonymous boolean false operator rol recipient or donor

recipientOperator

1
"00031"
Name Type Required Description
anonymous string¦null false current recipient operator code

recipientOperatorMandatory

1
"00031"
Name Type Required Description
anonymous string false current recipient operator code

donorOperator

1
"00001"
Name Type Required Description
anonymous string¦null false initial donor operator code

donorOperatorMandatory

1
"00001"
Name Type Required Description
anonymous string false initial donor operator code

infoTariff

1
""
Name Type Required Description
anonymous string¦null false info tariff of a portability

subscriber

1
2
3
4
5
6
7
8
9
{
  "nif": "11111111H",
  "name": "nombre apellidos",
  "address": "Calle COLON",
  "postalCode": "28100",
  "province": "28",
  "town": "Madrid",
  "date": "2017-09-13T13:00:00"
}
Name Type Required Description
nif string false subscriber nif
name string false subscriber full name
address string false subscriber address
postalCode string false subscriber postalcode
province string false subscriber province code
town string false subscriber town
date string¦null false subscriber request date

windowDate

1
"2017-09-15T08:00:00"
Name Type Required Description
anonymous string¦null false portability window

windowDateMandatory

1
"2017-09-15T08:00:00"
Name Type Required Description
anonymous string false portability window

requestDate

1
"2017-09-13T13:00:00"
Name Type Required Description
anonymous string¦null false request date for portability

messageDate

1
"2017-09-13T14:00:00"
Name Type Required Description
anonymous string¦null false date to send to Portanet

cancellationDate

1
"2017-09-15T08:00:00"
Name Type Required Description
anonymous string¦null false cancellation date

administrative

1
"445022444216"
Name Type Required Description
anonymous string¦null false administrative access number

lluProcessId

1
"550739346020000001"
Name Type Required Description
anonymous string¦null false local loop unbundling identifier

fullNumberFlag

1
0
Name Type Required Description
anonymous integer(int32) false full number flag

coordinatedActionFlag

1
0
Name Type Required Description
anonymous integer(int32) false coordinated action flag

wholesalerFlag

1
0
Name Type Required Description
anonymous integer(int32) false wholesaler flag

accessType

1
"01"
Name Type Required Description
anonymous string¦null false portability access type

donorResellerOperator

1
"REVENDEDOR"
Name Type Required Description
anonymous string¦null false donor reseller operator

recipientResellerOperator

1
"MASMOVIL"
Name Type Required Description
anonymous string¦null false recipient reseller operator

causeCode

1
"0001"
Name Type Required Description
anonymous string¦null false cause code of a denied operation

causeCodeMandatory

1
"0001"
Name Type Required Description
anonymous string false cause code of a denied operation

causeDescription

1
"Falta de correspondencia entre numeración y NIF/CIF del abonado del revendedor"
Name Type Required Description
anonymous string¦null false cause description of a denied operation

observations

1
""
Name Type Required Description
anonymous string¦null false observations of a portability

internal

1
false
Name Type Required Description
anonymous boolean false is a portability between own operators

isCancellable

1
false
Name Type Required Description
anonymous boolean false is a portability cancellable

nrnRange

1
"312800"
Name Type Required Description
anonymous string false nrn range

initialRange

1
"900000000"
Name Type Required Description
anonymous string false intial phone number range

endRange

1
"900000000"
Name Type Required Description
anonymous string false end phone number range

phoneRange

1
2
3
4
5
{
  "nrnRange": "312800",
  "initialRange": "900000000",
  "endRange": "900000000"
}
Name Type Required Description
nrnRange nrnRange true nrn range
initialRange initialRange true intial phone number range
endRange endRange true end phone number range

phoneRanges

1
2
3
4
5
6
7
[
  {
    "nrnRange": "312800",
    "initialRange": "900000000",
    "endRange": "900000000"
  }
]
Name Type Required Description
anonymous [phoneRange]¦null false none

accessPhoneRange

1
2
3
4
5
{
  "accessType": "01",
  "initialRange": "900000000",
  "endRange": "900000000"
}
Name Type Required Description
accessType accessType true portability access type
initialRange initialRange true intial phone number range
endRange endRange true end phone number range

accessPhoneRanges

1
2
3
4
5
6
7
[
  {
    "accessType": "01",
    "initialRange": "900000000",
    "endRange": "900000000"
  }
]
Name Type Required Description
anonymous [accessPhoneRange]¦null false none

eventTimestamp

1
"2017-09-15T08:42:33.123456"
Name Type Required Description
anonymous string false event datetime

messageId

1
"00031202005110000003"
Name Type Required Description
anonymous string¦null false message id in Portanet

subProcessId

1
"00031202005110200003"
Name Type Required Description
anonymous string¦null false subprocess id in Portanet

eventType

1
"EVENT"
Name Type Required Description
anonymous string false event type

event

1
2
3
4
5
6
7
8
9
{
  "eventTimestamp": "2017-09-15T08:42:33.123456",
  "messageType": "DSP1",
  "messageId": "00031202005110000003",
  "subProcessId": "00031202005110200003",
  "eventType": "EVENT",
  "causeCode": "0001",
  "administrative": "445022444216"
}
Name Type Required Description
eventTimestamp eventTimestamp true event datetime
messageType messageType true Message type Portabaility
messageId messageId false message id in Portanet
subProcessId subProcessId false subprocess id in Portanet
eventType eventType true event type
causeCode causeCode false cause code of a denied operation
administrative administrative false administrative access number