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.
Files changed (33) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +7 -0
  3. data/docs/CheckPhoneNumberPortability200ResponseResultsInner.md +5 -1
  4. data/docs/CreatePhoneNumberPortInRequest.md +4 -2
  5. data/docs/CreatePhoneNumberPortInRequestEndUser.md +8 -4
  6. data/docs/CreatePhoneNumberPortInRequestRequirementsInner.md +20 -0
  7. data/docs/GetPhoneNumberPortInOrderRequirements200Response.md +20 -0
  8. data/docs/GetPhoneNumberPortInOrderRequirements200ResponseRequirementsInner.md +32 -0
  9. data/docs/GetPhoneNumberPortInRequirements200Response.md +24 -0
  10. data/docs/GetPhoneNumberPortInRequirements200ResponseFieldsInner.md +28 -0
  11. data/docs/PhoneNumbersApi.md +149 -5
  12. data/lib/zernio-sdk/api/phone_numbers_api.rb +148 -10
  13. data/lib/zernio-sdk/models/check_phone_number_portability200_response_results_inner.rb +24 -2
  14. data/lib/zernio-sdk/models/create_phone_number_port_in_request.rb +36 -5
  15. data/lib/zernio-sdk/models/create_phone_number_port_in_request_end_user.rb +65 -23
  16. data/lib/zernio-sdk/models/create_phone_number_port_in_request_requirements_inner.rb +201 -0
  17. data/lib/zernio-sdk/models/get_phone_number_port_in_order_requirements200_response.rb +158 -0
  18. data/lib/zernio-sdk/models/get_phone_number_port_in_order_requirements200_response_requirements_inner.rb +247 -0
  19. data/lib/zernio-sdk/models/get_phone_number_port_in_requirements200_response.rb +177 -0
  20. data/lib/zernio-sdk/models/get_phone_number_port_in_requirements200_response_fields_inner.rb +231 -0
  21. data/lib/zernio-sdk/version.rb +1 -1
  22. data/lib/zernio-sdk.rb +5 -0
  23. data/openapi.yaml +134 -19
  24. data/spec/api/phone_numbers_api_spec.rb +28 -3
  25. data/spec/models/check_phone_number_portability200_response_results_inner_spec.rb +12 -0
  26. data/spec/models/create_phone_number_port_in_request_end_user_spec.rb +13 -1
  27. data/spec/models/create_phone_number_port_in_request_requirements_inner_spec.rb +42 -0
  28. data/spec/models/create_phone_number_port_in_request_spec.rb +6 -0
  29. data/spec/models/get_phone_number_port_in_order_requirements200_response_requirements_inner_spec.rb +82 -0
  30. data/spec/models/get_phone_number_port_in_order_requirements200_response_spec.rb +42 -0
  31. data/spec/models/get_phone_number_port_in_requirements200_response_fields_inner_spec.rb +70 -0
  32. data/spec/models/get_phone_number_port_in_requirements200_response_spec.rb +54 -0
  33. metadata +21 -1
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: f5c7aae8aa0d4f6849a28e26a4d71c5074264026717d7b7a666e9e636170781e
4
- data.tar.gz: 053dd32b6648528c8e4b2cb94c628288dd06335acce9f4fe08e57586ccb143fc
3
+ metadata.gz: a9f2ecc9e4bbe900e4d28ba69916f7025331bb21b3043e6a62f8c0576e3600f1
4
+ data.tar.gz: 567b5851f4a1d46b053ab67c7c6b791ff9038b197c7dacd9504f2f3744ae2870
5
5
  SHA512:
6
- metadata.gz: 70e1a5658a768a16184940231db1e86b53c137367242e296332283d73566a018c71ecd34d36b02c0efdebb3416a72cc792a438bd2a6b3506347dfaacc7c6423a
7
- data.tar.gz: dc2c702ccf60d3420b39d02ede8806e452de4e9330071598190e67a663b6053fdd83c9bd4d88b584ee8dea45dab97b9a92ae9ff2d56813c0742ec0542f2f8571
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. Defaults to one week out (shifted off weekends) when omitted. | [optional] |
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 US state / CA province code (full names are accepted and normalized). | |
16
- | **postal_code** | **String** | US ZIP (5 digits) or Canadian postal code, matching countryCode. | |
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
+
@@ -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', administrative_area: 'administrative_area_example', postal_code: 'postal_code_example', country_code: 'US'}), loa_document_id: 'loa_document_id_example', invoice_document_id: 'invoice_document_id_example'}) # CreatePhoneNumberPortInRequest |
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&#39;s phoneNumberType — requirements differ by type. | [optional][default to &#39;local&#39;] |
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 (the signed LOA or a recent carrier invoice) and get back its `documentId`, which the port-in create request takes as `loaDocumentId` / `invoiceDocumentId`. PDF, JPEG, or PNG, 10MB max.
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: 'loa' # String | Informational; used for the stored filename.
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** | &#39;loa&#39;, &#39;invoice&#39;, or any short slug for requirement documents. Informational; used for the stored filename. | [optional] |
1353
1497
 
1354
1498
  ### Return type
1355
1499