zernio-sdk 0.0.532 → 0.0.534
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +7 -0
- data/docs/CheckPhoneNumberPortability200ResponseResultsInner.md +5 -1
- data/docs/CreatePhoneNumberPortInRequest.md +4 -2
- data/docs/CreatePhoneNumberPortInRequestEndUser.md +8 -4
- data/docs/CreatePhoneNumberPortInRequestRequirementsInner.md +20 -0
- data/docs/GetPhoneNumberPortInOrderRequirements200Response.md +20 -0
- data/docs/GetPhoneNumberPortInOrderRequirements200ResponseRequirementsInner.md +32 -0
- data/docs/GetPhoneNumberPortInRequirements200Response.md +24 -0
- data/docs/GetPhoneNumberPortInRequirements200ResponseFieldsInner.md +28 -0
- data/docs/PhoneNumbersApi.md +149 -5
- data/lib/zernio-sdk/api/phone_numbers_api.rb +148 -10
- data/lib/zernio-sdk/models/check_phone_number_portability200_response_results_inner.rb +24 -2
- data/lib/zernio-sdk/models/create_phone_number_port_in_request.rb +36 -5
- data/lib/zernio-sdk/models/create_phone_number_port_in_request_end_user.rb +65 -23
- data/lib/zernio-sdk/models/create_phone_number_port_in_request_requirements_inner.rb +201 -0
- data/lib/zernio-sdk/models/get_phone_number_port_in_order_requirements200_response.rb +158 -0
- data/lib/zernio-sdk/models/get_phone_number_port_in_order_requirements200_response_requirements_inner.rb +247 -0
- data/lib/zernio-sdk/models/get_phone_number_port_in_requirements200_response.rb +177 -0
- data/lib/zernio-sdk/models/get_phone_number_port_in_requirements200_response_fields_inner.rb +231 -0
- data/lib/zernio-sdk/version.rb +1 -1
- data/lib/zernio-sdk.rb +5 -0
- data/openapi.yaml +134 -19
- data/spec/api/phone_numbers_api_spec.rb +28 -3
- data/spec/models/check_phone_number_portability200_response_results_inner_spec.rb +12 -0
- data/spec/models/create_phone_number_port_in_request_end_user_spec.rb +13 -1
- data/spec/models/create_phone_number_port_in_request_requirements_inner_spec.rb +42 -0
- data/spec/models/create_phone_number_port_in_request_spec.rb +6 -0
- data/spec/models/get_phone_number_port_in_order_requirements200_response_requirements_inner_spec.rb +82 -0
- data/spec/models/get_phone_number_port_in_order_requirements200_response_spec.rb +42 -0
- data/spec/models/get_phone_number_port_in_requirements200_response_fields_inner_spec.rb +70 -0
- data/spec/models/get_phone_number_port_in_requirements200_response_spec.rb +54 -0
- metadata +21 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: a9f2ecc9e4bbe900e4d28ba69916f7025331bb21b3043e6a62f8c0576e3600f1
|
|
4
|
+
data.tar.gz: 567b5851f4a1d46b053ab67c7c6b791ff9038b197c7dacd9504f2f3744ae2870
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 4146f13388c92613e72084491bf80537f1ee0f3065d63d4890ca2b16951d8fc413f8ad8c25ff20e834f4117a6a1c4c63c5e9673a39035509a4d98fd7f473cf1d
|
|
7
|
+
data.tar.gz: ceb3f3bfefab5b8dedfb0e7927a8eae0f9c55386006b13003d175e7c8cb8ea83fdf248daf07a712c802962d27a64d7557a1040eca464553e7e73f2881e765c05
|
data/README.md
CHANGED
|
@@ -358,6 +358,8 @@ Class | Method | HTTP request | Description
|
|
|
358
358
|
*Zernio::PhoneNumbersApi* | [**create_phone_number_port_in**](docs/PhoneNumbersApi.md#create_phone_number_port_in) | **POST** /v1/phone-numbers/port-in | Port numbers in
|
|
359
359
|
*Zernio::PhoneNumbersApi* | [**get_phone_number**](docs/PhoneNumbersApi.md#get_phone_number) | **GET** /v1/phone-numbers/{id} | Get phone number
|
|
360
360
|
*Zernio::PhoneNumbersApi* | [**get_phone_number_kyc_form**](docs/PhoneNumbersApi.md#get_phone_number_kyc_form) | **GET** /v1/phone-numbers/kyc | Get KYC form spec
|
|
361
|
+
*Zernio::PhoneNumbersApi* | [**get_phone_number_port_in_order_requirements**](docs/PhoneNumbersApi.md#get_phone_number_port_in_order_requirements) | **GET** /v1/phone-numbers/port-in/{id}/requirements | A port-in order's pending requirements
|
|
362
|
+
*Zernio::PhoneNumbersApi* | [**get_phone_number_port_in_requirements**](docs/PhoneNumbersApi.md#get_phone_number_port_in_requirements) | **GET** /v1/phone-numbers/port-in/requirements | Country porting requirements
|
|
361
363
|
*Zernio::PhoneNumbersApi* | [**get_phone_number_remediation**](docs/PhoneNumbersApi.md#get_phone_number_remediation) | **GET** /v1/phone-numbers/{id}/remediate | Get declined requirements
|
|
362
364
|
*Zernio::PhoneNumbersApi* | [**list_phone_number_countries**](docs/PhoneNumbersApi.md#list_phone_number_countries) | **GET** /v1/phone-numbers/countries | List offerable number countries
|
|
363
365
|
*Zernio::PhoneNumbersApi* | [**list_phone_number_port_ins**](docs/PhoneNumbersApi.md#list_phone_number_port_ins) | **GET** /v1/phone-numbers/port-in | List port-in orders
|
|
@@ -761,6 +763,7 @@ Class | Method | HTTP request | Description
|
|
|
761
763
|
- [Zernio::CreatePhoneNumberPortIn201ResponseOrdersInner](docs/CreatePhoneNumberPortIn201ResponseOrdersInner.md)
|
|
762
764
|
- [Zernio::CreatePhoneNumberPortInRequest](docs/CreatePhoneNumberPortInRequest.md)
|
|
763
765
|
- [Zernio::CreatePhoneNumberPortInRequestEndUser](docs/CreatePhoneNumberPortInRequestEndUser.md)
|
|
766
|
+
- [Zernio::CreatePhoneNumberPortInRequestRequirementsInner](docs/CreatePhoneNumberPortInRequestRequirementsInner.md)
|
|
764
767
|
- [Zernio::CreatePinterestBoard201Response](docs/CreatePinterestBoard201Response.md)
|
|
765
768
|
- [Zernio::CreatePinterestBoard201ResponseBoard](docs/CreatePinterestBoard201ResponseBoard.md)
|
|
766
769
|
- [Zernio::CreatePinterestBoardRequest](docs/CreatePinterestBoardRequest.md)
|
|
@@ -1132,6 +1135,10 @@ Class | Method | HTTP request | Description
|
|
|
1132
1135
|
- [Zernio::GetPhoneNumberKycForm200ResponseReusable](docs/GetPhoneNumberKycForm200ResponseReusable.md)
|
|
1133
1136
|
- [Zernio::GetPhoneNumberKycForm200ResponseReusableDetailsInner](docs/GetPhoneNumberKycForm200ResponseReusableDetailsInner.md)
|
|
1134
1137
|
- [Zernio::GetPhoneNumberKycForm200ResponseReusableOptionsInner](docs/GetPhoneNumberKycForm200ResponseReusableOptionsInner.md)
|
|
1138
|
+
- [Zernio::GetPhoneNumberPortInOrderRequirements200Response](docs/GetPhoneNumberPortInOrderRequirements200Response.md)
|
|
1139
|
+
- [Zernio::GetPhoneNumberPortInOrderRequirements200ResponseRequirementsInner](docs/GetPhoneNumberPortInOrderRequirements200ResponseRequirementsInner.md)
|
|
1140
|
+
- [Zernio::GetPhoneNumberPortInRequirements200Response](docs/GetPhoneNumberPortInRequirements200Response.md)
|
|
1141
|
+
- [Zernio::GetPhoneNumberPortInRequirements200ResponseFieldsInner](docs/GetPhoneNumberPortInRequirements200ResponseFieldsInner.md)
|
|
1135
1142
|
- [Zernio::GetPhoneNumberRemediation200Response](docs/GetPhoneNumberRemediation200Response.md)
|
|
1136
1143
|
- [Zernio::GetPinterestBoards200Response](docs/GetPinterestBoards200Response.md)
|
|
1137
1144
|
- [Zernio::GetPinterestBoards200ResponseBoardsInner](docs/GetPinterestBoards200ResponseBoardsInner.md)
|
|
@@ -7,7 +7,9 @@
|
|
|
7
7
|
| **phone_number** | **String** | | [optional] |
|
|
8
8
|
| **portable** | **Boolean** | | [optional] |
|
|
9
9
|
| **fast_portable** | **Boolean** | Qualifies for the carrier's accelerated FastPort lane. | [optional] |
|
|
10
|
-
| **line_type** | **String** | Line type when known (mobile, landline, voip…). A mobile number requires the transfer PIN at submit. | [optional] |
|
|
10
|
+
| **line_type** | **String** | Line type when known (mobile, landline, voip…). A US/CA mobile number requires the transfer PIN at submit. | [optional] |
|
|
11
|
+
| **country_code** | **String** | ISO country of the number — pass it to GET /v1/phone-numbers/port-in/requirements for international numbers. | [optional] |
|
|
12
|
+
| **phone_number_type** | **String** | Carrier number-type classification (local, mobile, national, toll_free…) — the numberType for the requirements endpoint. | [optional] |
|
|
11
13
|
| **not_portable_reason** | **String** | Carrier reason when not portable; null when portable. | [optional] |
|
|
12
14
|
|
|
13
15
|
## Example
|
|
@@ -20,6 +22,8 @@ instance = Zernio::CheckPhoneNumberPortability200ResponseResultsInner.new(
|
|
|
20
22
|
portable: null,
|
|
21
23
|
fast_portable: null,
|
|
22
24
|
line_type: null,
|
|
25
|
+
country_code: null,
|
|
26
|
+
phone_number_type: null,
|
|
23
27
|
not_portable_reason: null
|
|
24
28
|
)
|
|
25
29
|
```
|
|
@@ -8,9 +8,10 @@
|
|
|
8
8
|
| **end_user** | [**CreatePhoneNumberPortInRequestEndUser**](CreatePhoneNumberPortInRequestEndUser.md) | | |
|
|
9
9
|
| **loa_document_id** | **String** | Document id from POST /v1/phone-numbers/port-in/documents (kind=loa). | |
|
|
10
10
|
| **invoice_document_id** | **String** | Document id from POST /v1/phone-numbers/port-in/documents (kind=invoice). | |
|
|
11
|
-
| **foc_datetime_requested** | **Time** | Requested port date; the carrier confirms the actual FOC later.
|
|
11
|
+
| **foc_datetime_requested** | **Time** | Requested port date; the carrier confirms the actual FOC later. US/CA default is one week out (shifted off weekends); international orders are scheduled into the carrier's next allowed porting window at or after this date. | [optional] |
|
|
12
12
|
| **customer_reference** | **String** | | [optional] |
|
|
13
13
|
| **port_type** | **String** | Whether the losing account ports all its numbers (full) or keeps some (partial). | [optional][default to 'full'] |
|
|
14
|
+
| **requirements** | [**Array<CreatePhoneNumberPortInRequestRequirementsInner>**](CreatePhoneNumberPortInRequestRequirementsInner.md) | Country-specific requirement values for international ports (from GET /v1/phone-numbers/port-in/requirements). Not needed for US/CA. The LOA and invoice requirements are satisfied automatically by loaDocumentId/invoiceDocumentId, and address-type requirements by the endUser service address. | [optional] |
|
|
14
15
|
|
|
15
16
|
## Example
|
|
16
17
|
|
|
@@ -24,7 +25,8 @@ instance = Zernio::CreatePhoneNumberPortInRequest.new(
|
|
|
24
25
|
invoice_document_id: null,
|
|
25
26
|
foc_datetime_requested: null,
|
|
26
27
|
customer_reference: null,
|
|
27
|
-
port_type: null
|
|
28
|
+
port_type: null,
|
|
29
|
+
requirements: null
|
|
28
30
|
)
|
|
29
31
|
```
|
|
30
32
|
|
|
@@ -8,13 +8,15 @@
|
|
|
8
8
|
| **auth_person_name** | **String** | Full name (first + last) of the person authorizing the port — must match the LOA signature. | |
|
|
9
9
|
| **billing_phone_number** | **String** | Phone number on the losing carrier's bill. Defaults to the ported number itself on single-number orders. Validated as a real phone number when present. | [optional] |
|
|
10
10
|
| **account_number** | **String** | Account number with the losing carrier — required (carriers reject ports without it; on prepaid mobile plans it is often the phone number itself). | |
|
|
11
|
-
| **pin_passcode** | **String** | Transfer PIN. Required for mobile numbers (wireless carriers reject PIN-less ports). Forwarded to the carrier, never stored. | [optional] |
|
|
11
|
+
| **pin_passcode** | **String** | Transfer PIN. Required for US/CA mobile numbers (wireless carriers reject PIN-less ports). Forwarded to the carrier, never stored. International porting codes (e.g. the UK PAC) go through `requirements` instead. | [optional] |
|
|
12
|
+
| **tax_identifier** | **String** | Company tax id on the carrier account (EU ports, e.g. Spanish CIF). | [optional] |
|
|
13
|
+
| **business_identifier** | **String** | Business registration id on the carrier account (EU ports). | [optional] |
|
|
12
14
|
| **street_address** | **String** | | |
|
|
13
15
|
| **extended_address** | **String** | | [optional] |
|
|
14
16
|
| **locality** | **String** | | |
|
|
15
|
-
| **administrative_area** | **String** | 2-letter
|
|
16
|
-
| **postal_code** | **String** | US ZIP
|
|
17
|
-
| **country_code** | **String** |
|
|
17
|
+
| **administrative_area** | **String** | Region. Required for US/CA as the 2-letter state/province code (full names are accepted and normalized); optional elsewhere. | [optional] |
|
|
18
|
+
| **postal_code** | **String** | Postal code. Validated as a US ZIP / Canadian postal code for US/CA; free-form elsewhere. | |
|
|
19
|
+
| **country_code** | **String** | Service-address country (a supported port-in country). | |
|
|
18
20
|
|
|
19
21
|
## Example
|
|
20
22
|
|
|
@@ -27,6 +29,8 @@ instance = Zernio::CreatePhoneNumberPortInRequestEndUser.new(
|
|
|
27
29
|
billing_phone_number: null,
|
|
28
30
|
account_number: null,
|
|
29
31
|
pin_passcode: null,
|
|
32
|
+
tax_identifier: null,
|
|
33
|
+
business_identifier: null,
|
|
30
34
|
street_address: null,
|
|
31
35
|
extended_address: null,
|
|
32
36
|
locality: null,
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Zernio::CreatePhoneNumberPortInRequestRequirementsInner
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **requirement_type_id** | **String** | The requirement's id, from the requirements endpoint. | |
|
|
8
|
+
| **field_value** | **String** | Text value, ISO datetime, or a documentId from POST /v1/phone-numbers/port-in/documents, per the requirement's kind. | |
|
|
9
|
+
|
|
10
|
+
## Example
|
|
11
|
+
|
|
12
|
+
```ruby
|
|
13
|
+
require 'zernio-sdk'
|
|
14
|
+
|
|
15
|
+
instance = Zernio::CreatePhoneNumberPortInRequestRequirementsInner.new(
|
|
16
|
+
requirement_type_id: null,
|
|
17
|
+
field_value: null
|
|
18
|
+
)
|
|
19
|
+
```
|
|
20
|
+
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# Zernio::GetPhoneNumberPortInOrderRequirements200Response
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **country** | **String** | | [optional] |
|
|
8
|
+
| **requirements** | [**Array<GetPhoneNumberPortInOrderRequirements200ResponseRequirementsInner>**](GetPhoneNumberPortInOrderRequirements200ResponseRequirementsInner.md) | | [optional] |
|
|
9
|
+
|
|
10
|
+
## Example
|
|
11
|
+
|
|
12
|
+
```ruby
|
|
13
|
+
require 'zernio-sdk'
|
|
14
|
+
|
|
15
|
+
instance = Zernio::GetPhoneNumberPortInOrderRequirements200Response.new(
|
|
16
|
+
country: null,
|
|
17
|
+
requirements: null
|
|
18
|
+
)
|
|
19
|
+
```
|
|
20
|
+
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Zernio::GetPhoneNumberPortInOrderRequirements200ResponseRequirementsInner
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **requirement_id** | **String** | | [optional] |
|
|
8
|
+
| **label** | **String** | | [optional] |
|
|
9
|
+
| **kind** | **String** | | [optional] |
|
|
10
|
+
| **description** | **String** | | [optional] |
|
|
11
|
+
| **example** | **String** | | [optional] |
|
|
12
|
+
| **acceptable_values** | **Array<String>** | | [optional] |
|
|
13
|
+
| **status** | **String** | requirement-info-pending | requirement-info-under-review | requirement-info-exception | approved | [optional] |
|
|
14
|
+
| **filled** | **Boolean** | | [optional] |
|
|
15
|
+
|
|
16
|
+
## Example
|
|
17
|
+
|
|
18
|
+
```ruby
|
|
19
|
+
require 'zernio-sdk'
|
|
20
|
+
|
|
21
|
+
instance = Zernio::GetPhoneNumberPortInOrderRequirements200ResponseRequirementsInner.new(
|
|
22
|
+
requirement_id: null,
|
|
23
|
+
label: null,
|
|
24
|
+
kind: null,
|
|
25
|
+
description: null,
|
|
26
|
+
example: null,
|
|
27
|
+
acceptable_values: null,
|
|
28
|
+
status: null,
|
|
29
|
+
filled: null
|
|
30
|
+
)
|
|
31
|
+
```
|
|
32
|
+
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# Zernio::GetPhoneNumberPortInRequirements200Response
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **country** | **String** | | [optional] |
|
|
8
|
+
| **number_type** | **String** | | [optional] |
|
|
9
|
+
| **supported** | **Boolean** | false when the combination includes a step that can't be completed through the API (e.g. an in-person identity verification) — porting it needs support. | [optional] |
|
|
10
|
+
| **fields** | [**Array<GetPhoneNumberPortInRequirements200ResponseFieldsInner>**](GetPhoneNumberPortInRequirements200ResponseFieldsInner.md) | | [optional] |
|
|
11
|
+
|
|
12
|
+
## Example
|
|
13
|
+
|
|
14
|
+
```ruby
|
|
15
|
+
require 'zernio-sdk'
|
|
16
|
+
|
|
17
|
+
instance = Zernio::GetPhoneNumberPortInRequirements200Response.new(
|
|
18
|
+
country: null,
|
|
19
|
+
number_type: null,
|
|
20
|
+
supported: null,
|
|
21
|
+
fields: null
|
|
22
|
+
)
|
|
23
|
+
```
|
|
24
|
+
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# Zernio::GetPhoneNumberPortInRequirements200ResponseFieldsInner
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **requirement_id** | **String** | Pass back as requirements[].requirementTypeId. | [optional] |
|
|
8
|
+
| **label** | **String** | | [optional] |
|
|
9
|
+
| **kind** | **String** | text/date take a string value; file takes a documentId from the documents endpoint; address is satisfied automatically from the end-user service address. | [optional] |
|
|
10
|
+
| **description** | **String** | | [optional] |
|
|
11
|
+
| **example** | **String** | | [optional] |
|
|
12
|
+
| **acceptable_values** | **Array<String>** | When present, the value must be one of these. | [optional] |
|
|
13
|
+
|
|
14
|
+
## Example
|
|
15
|
+
|
|
16
|
+
```ruby
|
|
17
|
+
require 'zernio-sdk'
|
|
18
|
+
|
|
19
|
+
instance = Zernio::GetPhoneNumberPortInRequirements200ResponseFieldsInner.new(
|
|
20
|
+
requirement_id: null,
|
|
21
|
+
label: null,
|
|
22
|
+
kind: null,
|
|
23
|
+
description: null,
|
|
24
|
+
example: null,
|
|
25
|
+
acceptable_values: null
|
|
26
|
+
)
|
|
27
|
+
```
|
|
28
|
+
|
data/docs/PhoneNumbersApi.md
CHANGED
|
@@ -11,6 +11,8 @@ All URIs are relative to *https://zernio.com/api*
|
|
|
11
11
|
| [**create_phone_number_port_in**](PhoneNumbersApi.md#create_phone_number_port_in) | **POST** /v1/phone-numbers/port-in | Port numbers in |
|
|
12
12
|
| [**get_phone_number**](PhoneNumbersApi.md#get_phone_number) | **GET** /v1/phone-numbers/{id} | Get phone number |
|
|
13
13
|
| [**get_phone_number_kyc_form**](PhoneNumbersApi.md#get_phone_number_kyc_form) | **GET** /v1/phone-numbers/kyc | Get KYC form spec |
|
|
14
|
+
| [**get_phone_number_port_in_order_requirements**](PhoneNumbersApi.md#get_phone_number_port_in_order_requirements) | **GET** /v1/phone-numbers/port-in/{id}/requirements | A port-in order's pending requirements |
|
|
15
|
+
| [**get_phone_number_port_in_requirements**](PhoneNumbersApi.md#get_phone_number_port_in_requirements) | **GET** /v1/phone-numbers/port-in/requirements | Country porting requirements |
|
|
14
16
|
| [**get_phone_number_remediation**](PhoneNumbersApi.md#get_phone_number_remediation) | **GET** /v1/phone-numbers/{id}/remediate | Get declined requirements |
|
|
15
17
|
| [**list_phone_number_countries**](PhoneNumbersApi.md#list_phone_number_countries) | **GET** /v1/phone-numbers/countries | List offerable number countries |
|
|
16
18
|
| [**list_phone_number_port_ins**](PhoneNumbersApi.md#list_phone_number_port_ins) | **GET** /v1/phone-numbers/port-in | List port-in orders |
|
|
@@ -312,7 +314,7 @@ end
|
|
|
312
314
|
|
|
313
315
|
Port numbers in
|
|
314
316
|
|
|
315
|
-
Submit a port-in for one or more existing numbers from another carrier. Creates the carrier order(s), attaches the end-user (current account) info plus the LOA and invoice documents, and submits to the losing carrier. The transfer PIN is forwarded to the carrier and never stored. Ported numbers arrive voice-ready (and SMS-ready where the order supports messaging). Run the portability check (POST /v1/phone-numbers/port-in/check) and upload the two documents (POST /v1/phone-numbers/port-in/documents) first. The carrier may split the numbers into several orders (by country, number type, losing carrier); `orders` carries per-order results, and a partial failure still returns 201 with the failed orders' `error` set (they stay as cancellable drafts).
|
|
317
|
+
Submit a port-in for one or more existing numbers from another carrier. Creates the carrier order(s), attaches the end-user (current account) info plus the LOA and invoice documents, and submits to the losing carrier. The transfer PIN is forwarded to the carrier and never stored. Ported numbers arrive voice-ready (and SMS-ready where the order supports messaging). Run the portability check (POST /v1/phone-numbers/port-in/check) and upload the two documents (POST /v1/phone-numbers/port-in/documents) first — uploaded documents must be attached to an order within 30 minutes or the carrier deletes them, so upload right before this call. The carrier may split the numbers into several orders (by country, number type, losing carrier); `orders` carries per-order results, and a partial failure still returns 201 with the failed orders' `error` set (they stay as cancellable drafts). Non-US/CA numbers additionally need the country-specific values from GET /v1/phone-numbers/port-in/requirements, passed via `requirements`, and must be submitted one country per request. When required information is still missing after submission, the order is kept as a resumable draft whose `error` / `declineReason` names the gaps.
|
|
316
318
|
|
|
317
319
|
### Examples
|
|
318
320
|
|
|
@@ -326,7 +328,7 @@ Zernio.configure do |config|
|
|
|
326
328
|
end
|
|
327
329
|
|
|
328
330
|
api_instance = Zernio::PhoneNumbersApi.new
|
|
329
|
-
create_phone_number_port_in_request = Zernio::CreatePhoneNumberPortInRequest.new({phone_numbers: ['phone_numbers_example'], end_user: Zernio::CreatePhoneNumberPortInRequestEndUser.new({entity_name: 'entity_name_example', auth_person_name: 'auth_person_name_example', account_number: 'account_number_example', street_address: 'street_address_example', locality: 'locality_example',
|
|
331
|
+
create_phone_number_port_in_request = Zernio::CreatePhoneNumberPortInRequest.new({phone_numbers: ['phone_numbers_example'], end_user: Zernio::CreatePhoneNumberPortInRequestEndUser.new({entity_name: 'entity_name_example', auth_person_name: 'auth_person_name_example', account_number: 'account_number_example', street_address: 'street_address_example', locality: 'locality_example', postal_code: 'postal_code_example', country_code: 'US'}), loa_document_id: 'loa_document_id_example', invoice_document_id: 'invoice_document_id_example'}) # CreatePhoneNumberPortInRequest |
|
|
330
332
|
|
|
331
333
|
begin
|
|
332
334
|
# Port numbers in
|
|
@@ -517,6 +519,148 @@ end
|
|
|
517
519
|
- **Accept**: application/json
|
|
518
520
|
|
|
519
521
|
|
|
522
|
+
## get_phone_number_port_in_order_requirements
|
|
523
|
+
|
|
524
|
+
> <GetPhoneNumberPortInOrderRequirements200Response> get_phone_number_port_in_order_requirements(id)
|
|
525
|
+
|
|
526
|
+
A port-in order's pending requirements
|
|
527
|
+
|
|
528
|
+
The live requirements on an EXISTING porting order: which are filled, which are still pending, and which bounced on review (`requirement-info-exception`). Use it to fix and resubmit a rejected international port. Same field shape as the country-level requirements endpoint, plus per-requirement status.
|
|
529
|
+
|
|
530
|
+
### Examples
|
|
531
|
+
|
|
532
|
+
```ruby
|
|
533
|
+
require 'time'
|
|
534
|
+
require 'zernio-sdk'
|
|
535
|
+
# setup authorization
|
|
536
|
+
Zernio.configure do |config|
|
|
537
|
+
# Configure Bearer authorization (JWT): bearerAuth
|
|
538
|
+
config.access_token = 'YOUR_BEARER_TOKEN'
|
|
539
|
+
end
|
|
540
|
+
|
|
541
|
+
api_instance = Zernio::PhoneNumbersApi.new
|
|
542
|
+
id = 'id_example' # String | Porting order ID (from the port-in list).
|
|
543
|
+
|
|
544
|
+
begin
|
|
545
|
+
# A port-in order's pending requirements
|
|
546
|
+
result = api_instance.get_phone_number_port_in_order_requirements(id)
|
|
547
|
+
p result
|
|
548
|
+
rescue Zernio::ApiError => e
|
|
549
|
+
puts "Error when calling PhoneNumbersApi->get_phone_number_port_in_order_requirements: #{e}"
|
|
550
|
+
end
|
|
551
|
+
```
|
|
552
|
+
|
|
553
|
+
#### Using the get_phone_number_port_in_order_requirements_with_http_info variant
|
|
554
|
+
|
|
555
|
+
This returns an Array which contains the response data, status code and headers.
|
|
556
|
+
|
|
557
|
+
> <Array(<GetPhoneNumberPortInOrderRequirements200Response>, Integer, Hash)> get_phone_number_port_in_order_requirements_with_http_info(id)
|
|
558
|
+
|
|
559
|
+
```ruby
|
|
560
|
+
begin
|
|
561
|
+
# A port-in order's pending requirements
|
|
562
|
+
data, status_code, headers = api_instance.get_phone_number_port_in_order_requirements_with_http_info(id)
|
|
563
|
+
p status_code # => 2xx
|
|
564
|
+
p headers # => { ... }
|
|
565
|
+
p data # => <GetPhoneNumberPortInOrderRequirements200Response>
|
|
566
|
+
rescue Zernio::ApiError => e
|
|
567
|
+
puts "Error when calling PhoneNumbersApi->get_phone_number_port_in_order_requirements_with_http_info: #{e}"
|
|
568
|
+
end
|
|
569
|
+
```
|
|
570
|
+
|
|
571
|
+
### Parameters
|
|
572
|
+
|
|
573
|
+
| Name | Type | Description | Notes |
|
|
574
|
+
| ---- | ---- | ----------- | ----- |
|
|
575
|
+
| **id** | **String** | Porting order ID (from the port-in list). | |
|
|
576
|
+
|
|
577
|
+
### Return type
|
|
578
|
+
|
|
579
|
+
[**GetPhoneNumberPortInOrderRequirements200Response**](GetPhoneNumberPortInOrderRequirements200Response.md)
|
|
580
|
+
|
|
581
|
+
### Authorization
|
|
582
|
+
|
|
583
|
+
[bearerAuth](../README.md#bearerAuth)
|
|
584
|
+
|
|
585
|
+
### HTTP request headers
|
|
586
|
+
|
|
587
|
+
- **Content-Type**: Not defined
|
|
588
|
+
- **Accept**: application/json
|
|
589
|
+
|
|
590
|
+
|
|
591
|
+
## get_phone_number_port_in_requirements
|
|
592
|
+
|
|
593
|
+
> <GetPhoneNumberPortInRequirements200Response> get_phone_number_port_in_requirements(country, opts)
|
|
594
|
+
|
|
595
|
+
Country porting requirements
|
|
596
|
+
|
|
597
|
+
The country-specific information a port-in needs BEYOND the LOA, invoice, and account/address details — e.g. an ID copy, proof of address, a tax id, or a porting code. Call it after the portability check (which returns each number's `countryCode` and `phoneNumberType`), render the fields, and pass the collected values as the create request's `requirements`. US/CA return an empty list.
|
|
598
|
+
|
|
599
|
+
### Examples
|
|
600
|
+
|
|
601
|
+
```ruby
|
|
602
|
+
require 'time'
|
|
603
|
+
require 'zernio-sdk'
|
|
604
|
+
# setup authorization
|
|
605
|
+
Zernio.configure do |config|
|
|
606
|
+
# Configure Bearer authorization (JWT): bearerAuth
|
|
607
|
+
config.access_token = 'YOUR_BEARER_TOKEN'
|
|
608
|
+
end
|
|
609
|
+
|
|
610
|
+
api_instance = Zernio::PhoneNumbersApi.new
|
|
611
|
+
country = 'country_example' # String | ISO country of the numbers being ported (a supported port-in country).
|
|
612
|
+
opts = {
|
|
613
|
+
number_type: 'local' # String | The portability check's phoneNumberType — requirements differ by type.
|
|
614
|
+
}
|
|
615
|
+
|
|
616
|
+
begin
|
|
617
|
+
# Country porting requirements
|
|
618
|
+
result = api_instance.get_phone_number_port_in_requirements(country, opts)
|
|
619
|
+
p result
|
|
620
|
+
rescue Zernio::ApiError => e
|
|
621
|
+
puts "Error when calling PhoneNumbersApi->get_phone_number_port_in_requirements: #{e}"
|
|
622
|
+
end
|
|
623
|
+
```
|
|
624
|
+
|
|
625
|
+
#### Using the get_phone_number_port_in_requirements_with_http_info variant
|
|
626
|
+
|
|
627
|
+
This returns an Array which contains the response data, status code and headers.
|
|
628
|
+
|
|
629
|
+
> <Array(<GetPhoneNumberPortInRequirements200Response>, Integer, Hash)> get_phone_number_port_in_requirements_with_http_info(country, opts)
|
|
630
|
+
|
|
631
|
+
```ruby
|
|
632
|
+
begin
|
|
633
|
+
# Country porting requirements
|
|
634
|
+
data, status_code, headers = api_instance.get_phone_number_port_in_requirements_with_http_info(country, opts)
|
|
635
|
+
p status_code # => 2xx
|
|
636
|
+
p headers # => { ... }
|
|
637
|
+
p data # => <GetPhoneNumberPortInRequirements200Response>
|
|
638
|
+
rescue Zernio::ApiError => e
|
|
639
|
+
puts "Error when calling PhoneNumbersApi->get_phone_number_port_in_requirements_with_http_info: #{e}"
|
|
640
|
+
end
|
|
641
|
+
```
|
|
642
|
+
|
|
643
|
+
### Parameters
|
|
644
|
+
|
|
645
|
+
| Name | Type | Description | Notes |
|
|
646
|
+
| ---- | ---- | ----------- | ----- |
|
|
647
|
+
| **country** | **String** | ISO country of the numbers being ported (a supported port-in country). | |
|
|
648
|
+
| **number_type** | **String** | The portability check's phoneNumberType — requirements differ by type. | [optional][default to 'local'] |
|
|
649
|
+
|
|
650
|
+
### Return type
|
|
651
|
+
|
|
652
|
+
[**GetPhoneNumberPortInRequirements200Response**](GetPhoneNumberPortInRequirements200Response.md)
|
|
653
|
+
|
|
654
|
+
### Authorization
|
|
655
|
+
|
|
656
|
+
[bearerAuth](../README.md#bearerAuth)
|
|
657
|
+
|
|
658
|
+
### HTTP request headers
|
|
659
|
+
|
|
660
|
+
- **Content-Type**: Not defined
|
|
661
|
+
- **Accept**: application/json
|
|
662
|
+
|
|
663
|
+
|
|
520
664
|
## get_phone_number_remediation
|
|
521
665
|
|
|
522
666
|
> <GetPhoneNumberRemediation200Response> get_phone_number_remediation(id)
|
|
@@ -1298,7 +1442,7 @@ end
|
|
|
1298
1442
|
|
|
1299
1443
|
Upload a porting document
|
|
1300
1444
|
|
|
1301
|
-
Upload ONE porting document
|
|
1445
|
+
Upload ONE porting document and get back its `documentId`. For the signed LOA / carrier invoice the id goes to `loaDocumentId` / `invoiceDocumentId`; for a country-specific document requirement (international ports) it becomes that requirement's `fieldValue`. Requirement documents are normalized to PDF automatically (regulators reject raw images). PDF, JPEG, or PNG, 10MB max. Uploads must be attached to an order within 30 minutes or the carrier deletes them.
|
|
1302
1446
|
|
|
1303
1447
|
### Examples
|
|
1304
1448
|
|
|
@@ -1314,7 +1458,7 @@ end
|
|
|
1314
1458
|
api_instance = Zernio::PhoneNumbersApi.new
|
|
1315
1459
|
file = File.new('/path/to/some/file') # File | The document (PDF/JPEG/PNG, 10MB max).
|
|
1316
1460
|
opts = {
|
|
1317
|
-
kind: '
|
|
1461
|
+
kind: 'kind_example' # String | 'loa', 'invoice', or any short slug for requirement documents. Informational; used for the stored filename.
|
|
1318
1462
|
}
|
|
1319
1463
|
|
|
1320
1464
|
begin
|
|
@@ -1349,7 +1493,7 @@ end
|
|
|
1349
1493
|
| Name | Type | Description | Notes |
|
|
1350
1494
|
| ---- | ---- | ----------- | ----- |
|
|
1351
1495
|
| **file** | **File** | The document (PDF/JPEG/PNG, 10MB max). | |
|
|
1352
|
-
| **kind** | **String** | Informational; used for the stored filename. | [optional] |
|
|
1496
|
+
| **kind** | **String** | 'loa', 'invoice', or any short slug for requirement documents. Informational; used for the stored filename. | [optional] |
|
|
1353
1497
|
|
|
1354
1498
|
### Return type
|
|
1355
1499
|
|