ultracart_api 4.1.105 → 4.1.109
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 +19 -2
- data/docs/BulkApi.md +335 -0
- data/docs/BulkJob.md +46 -0
- data/docs/BulkJobRequest.md +24 -0
- data/docs/BulkJobResponse.md +26 -0
- data/docs/BulkJobsResponse.md +28 -0
- data/docs/BulkRecord.md +30 -0
- data/docs/BulkRecordsResponse.md +28 -0
- data/docs/BulkUploadUrlResponse.md +32 -0
- data/lib/ultracart_api/api/bulk_api.rb +460 -0
- data/lib/ultracart_api/models/bulk_job.rb +418 -0
- data/lib/ultracart_api/models/bulk_job_request.rb +284 -0
- data/lib/ultracart_api/models/bulk_job_response.rb +256 -0
- data/lib/ultracart_api/models/bulk_jobs_response.rb +269 -0
- data/lib/ultracart_api/models/bulk_record.rb +326 -0
- data/lib/ultracart_api/models/bulk_records_response.rb +269 -0
- data/lib/ultracart_api/models/bulk_upload_url_response.rb +287 -0
- data/lib/ultracart_api/version.rb +1 -1
- data/lib/ultracart_api.rb +8 -0
- metadata +18 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 071a2350e3bd48bb2f14f0199f4dc7bf0ae3733e506d89a252eeaae422c2cc44
|
|
4
|
+
data.tar.gz: 1490837ec8c94afddc7a0a084a9a5a5d851fef6d77b0452430d4f91235b435f6
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: bd8c96724564468c45f276ce2ff6b1ee07047c4fc34d989f3ec398b3fb520666ce8ac6acda0f6a059d6dc0f7967d6245da8472b697d97ed96701522ce17e8c7e
|
|
7
|
+
data.tar.gz: 0a769e3a330a708d6af9027e569d9cc23507a91e4535b9ce37c040769545701fd6ef8a02dc285f4153f3c60176bfbffd93d7a34ac8e3eaa47eac1955374ce2f4
|
data/README.md
CHANGED
|
@@ -7,7 +7,7 @@ Note: Every method has a sample for every language. See https://github.com/Ultr
|
|
|
7
7
|
This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
|
|
8
8
|
|
|
9
9
|
- API version: 2.0.0
|
|
10
|
-
- Package version: 4.1.
|
|
10
|
+
- Package version: 4.1.109
|
|
11
11
|
- Build package: org.openapitools.codegen.languages.RubyClientCodegen
|
|
12
12
|
- For more information, please visit [http://www.ultracart.com/api/](http://www.ultracart.com/api/)
|
|
13
13
|
|
|
@@ -16,7 +16,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
|
|
|
16
16
|
gemfile:
|
|
17
17
|
|
|
18
18
|
```shell
|
|
19
|
-
gem 'ultracart_api', '4.1.
|
|
19
|
+
gem 'ultracart_api', '4.1.109'
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
install:
|
|
@@ -106,6 +106,12 @@ Class | Method | HTTP request | Description
|
|
|
106
106
|
*UltracartClient::AutoOrderApi* | [**update_auto_order_item_properties**](docs/AutoOrderApi.md#update_auto_order_item_properties) | **PUT** /auto_order/auto_orders/{auto_order_oid}/items/{auto_order_item_oid}/properties | Update an auto order item properties
|
|
107
107
|
*UltracartClient::AutoOrderApi* | [**update_auto_order_properties**](docs/AutoOrderApi.md#update_auto_order_properties) | **PUT** /auto_order/auto_orders/{auto_order_oid}/properties | Update an auto order properties
|
|
108
108
|
*UltracartClient::AutoOrderApi* | [**update_auto_orders_batch**](docs/AutoOrderApi.md#update_auto_orders_batch) | **PUT** /auto_order/auto_orders/batch | Update multiple auto orders
|
|
109
|
+
*UltracartClient::BulkApi* | [**bulk_cancel_job**](docs/BulkApi.md#bulk_cancel_job) | **DELETE** /bulk/{object}/{job_id} | Request cancellation of a bulk job
|
|
110
|
+
*UltracartClient::BulkApi* | [**bulk_generate_upload_url**](docs/BulkApi.md#bulk_generate_upload_url) | **POST** /bulk/{object}/upload-url | Generate a presigned upload URL for a bulk payload
|
|
111
|
+
*UltracartClient::BulkApi* | [**bulk_get_job**](docs/BulkApi.md#bulk_get_job) | **GET** /bulk/{object}/{job_id} | Retrieve a bulk job's status and counts
|
|
112
|
+
*UltracartClient::BulkApi* | [**bulk_get_job_records**](docs/BulkApi.md#bulk_get_job_records) | **GET** /bulk/{object}/{job_id}/records | Paginate a bulk job's per-record results
|
|
113
|
+
*UltracartClient::BulkApi* | [**bulk_list_jobs**](docs/BulkApi.md#bulk_list_jobs) | **GET** /bulk/{object} | List bulk jobs for the calling merchant
|
|
114
|
+
*UltracartClient::BulkApi* | [**bulk_submit_job**](docs/BulkApi.md#bulk_submit_job) | **POST** /bulk/{object} | Submit a bulk job
|
|
109
115
|
*UltracartClient::ChannelPartnerApi* | [**cancel_order_by_channel_partner_order_id**](docs/ChannelPartnerApi.md#cancel_order_by_channel_partner_order_id) | **DELETE** /channel_partner/cancel/by_channel_partner_order_id/{order_id} | Cancel channel partner order by channel partner order id
|
|
110
116
|
*UltracartClient::ChannelPartnerApi* | [**cancel_order_by_ultra_cart_order_id**](docs/ChannelPartnerApi.md#cancel_order_by_ultra_cart_order_id) | **DELETE** /channel_partner/cancel/by_ultracart_order_id/{order_id} | Cancel channel partner order by UltraCart order id
|
|
111
117
|
*UltracartClient::ChannelPartnerApi* | [**delete_channel_partner_ship_to_preference**](docs/ChannelPartnerApi.md#delete_channel_partner_ship_to_preference) | **DELETE** /channel_partner/channel_partners/{channel_partner_oid}/ship_to_preferences/{channel_partner_ship_to_preference_oid} | Delete a ship to preference record for the channel partner.
|
|
@@ -761,6 +767,13 @@ Class | Method | HTTP request | Description
|
|
|
761
767
|
- [UltracartClient::BrowserDevice](docs/BrowserDevice.md)
|
|
762
768
|
- [UltracartClient::BrowserOS](docs/BrowserOS.md)
|
|
763
769
|
- [UltracartClient::BrowserUserAgent](docs/BrowserUserAgent.md)
|
|
770
|
+
- [UltracartClient::BulkJob](docs/BulkJob.md)
|
|
771
|
+
- [UltracartClient::BulkJobRequest](docs/BulkJobRequest.md)
|
|
772
|
+
- [UltracartClient::BulkJobResponse](docs/BulkJobResponse.md)
|
|
773
|
+
- [UltracartClient::BulkJobsResponse](docs/BulkJobsResponse.md)
|
|
774
|
+
- [UltracartClient::BulkRecord](docs/BulkRecord.md)
|
|
775
|
+
- [UltracartClient::BulkRecordsResponse](docs/BulkRecordsResponse.md)
|
|
776
|
+
- [UltracartClient::BulkUploadUrlResponse](docs/BulkUploadUrlResponse.md)
|
|
764
777
|
- [UltracartClient::Cart](docs/Cart.md)
|
|
765
778
|
- [UltracartClient::CartAffiliate](docs/CartAffiliate.md)
|
|
766
779
|
- [UltracartClient::CartAffirmCheckoutResponse](docs/CartAffirmCheckoutResponse.md)
|
|
@@ -1793,6 +1806,10 @@ Not every change is committed to every SDK.
|
|
|
1793
1806
|
|
|
1794
1807
|
| Version | Date | Comments |
|
|
1795
1808
|
| --: | :-: | --- |
|
|
1809
|
+
| 4.1.109 | 07/03/2026 | bulk import endpoints (alpha) |
|
|
1810
|
+
| 4.1.108 | 07/03/2026 | bulk import endpoints (alpha) |
|
|
1811
|
+
| 4.1.107 | 07/03/2026 | bulk import endpoints (alpha) |
|
|
1812
|
+
| 4.1.106 | 07/03/2026 | bulk import endpoints (alpha) |
|
|
1796
1813
|
| 4.1.105 | 07/01/2026 | conversation - updatePbxCall support additional zoho desk values |
|
|
1797
1814
|
| 4.1.104 | 06/30/2026 | conversations - customer snapshot zoho desk tickets included |
|
|
1798
1815
|
| 4.1.103 | 06/18/2026 | affiliate api alpha |
|
data/docs/BulkApi.md
ADDED
|
@@ -0,0 +1,335 @@
|
|
|
1
|
+
# UltracartClient::BulkApi
|
|
2
|
+
|
|
3
|
+
All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
4
|
+
|
|
5
|
+
| Method | HTTP request | Description |
|
|
6
|
+
| ------ | ------------ | ----------- |
|
|
7
|
+
| [**bulk_cancel_job**](BulkApi.md#bulk_cancel_job) | **DELETE** /bulk/{object}/{job_id} | Request cancellation of a bulk job |
|
|
8
|
+
| [**bulk_generate_upload_url**](BulkApi.md#bulk_generate_upload_url) | **POST** /bulk/{object}/upload-url | Generate a presigned upload URL for a bulk payload |
|
|
9
|
+
| [**bulk_get_job**](BulkApi.md#bulk_get_job) | **GET** /bulk/{object}/{job_id} | Retrieve a bulk job's status and counts |
|
|
10
|
+
| [**bulk_get_job_records**](BulkApi.md#bulk_get_job_records) | **GET** /bulk/{object}/{job_id}/records | Paginate a bulk job's per-record results |
|
|
11
|
+
| [**bulk_list_jobs**](BulkApi.md#bulk_list_jobs) | **GET** /bulk/{object} | List bulk jobs for the calling merchant |
|
|
12
|
+
| [**bulk_submit_job**](BulkApi.md#bulk_submit_job) | **POST** /bulk/{object} | Submit a bulk job |
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
## bulk_cancel_job
|
|
16
|
+
|
|
17
|
+
> bulk_cancel_job(object, job_id)
|
|
18
|
+
|
|
19
|
+
Request cancellation of a bulk job
|
|
20
|
+
|
|
21
|
+
Queued jobs cancel immediately (200). In-progress jobs finalize as cancelled between records (202); already-processed records stand.
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
### Examples
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
(No example for this operation).
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
#### Using the bulk_cancel_job_with_http_info variant
|
|
31
|
+
|
|
32
|
+
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
|
33
|
+
|
|
34
|
+
> <Array(nil, Integer, Hash)> bulk_cancel_job_with_http_info(object, job_id)
|
|
35
|
+
|
|
36
|
+
```ruby
|
|
37
|
+
begin
|
|
38
|
+
# Request cancellation of a bulk job
|
|
39
|
+
data, status_code, headers = api_instance.bulk_cancel_job_with_http_info(object, job_id)
|
|
40
|
+
p status_code # => 2xx
|
|
41
|
+
p headers # => { ... }
|
|
42
|
+
p data # => nil
|
|
43
|
+
rescue UltracartClient::ApiError => e
|
|
44
|
+
puts "Error when calling BulkApi->bulk_cancel_job_with_http_info: #{e}"
|
|
45
|
+
end
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
### Parameters
|
|
49
|
+
|
|
50
|
+
| Name | Type | Description | Notes |
|
|
51
|
+
| ---- | ---- | ----------- | ----- |
|
|
52
|
+
| **object** | **String** | Object type | |
|
|
53
|
+
| **job_id** | **String** | The bulk job id | |
|
|
54
|
+
|
|
55
|
+
### Return type
|
|
56
|
+
|
|
57
|
+
nil (empty response body)
|
|
58
|
+
|
|
59
|
+
### Authorization
|
|
60
|
+
|
|
61
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
62
|
+
|
|
63
|
+
### HTTP request headers
|
|
64
|
+
|
|
65
|
+
- **Content-Type**: Not defined
|
|
66
|
+
- **Accept**: application/json
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
## bulk_generate_upload_url
|
|
70
|
+
|
|
71
|
+
> <BulkUploadUrlResponse> bulk_generate_upload_url(object)
|
|
72
|
+
|
|
73
|
+
Generate a presigned upload URL for a bulk payload
|
|
74
|
+
|
|
75
|
+
Returns a presigned S3 PUT URL the merchant uploads NDJSON to, plus the s3_key to pass to submit.
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
### Examples
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
(No example for this operation).
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
#### Using the bulk_generate_upload_url_with_http_info variant
|
|
85
|
+
|
|
86
|
+
This returns an Array which contains the response data, status code and headers.
|
|
87
|
+
|
|
88
|
+
> <Array(<BulkUploadUrlResponse>, Integer, Hash)> bulk_generate_upload_url_with_http_info(object)
|
|
89
|
+
|
|
90
|
+
```ruby
|
|
91
|
+
begin
|
|
92
|
+
# Generate a presigned upload URL for a bulk payload
|
|
93
|
+
data, status_code, headers = api_instance.bulk_generate_upload_url_with_http_info(object)
|
|
94
|
+
p status_code # => 2xx
|
|
95
|
+
p headers # => { ... }
|
|
96
|
+
p data # => <BulkUploadUrlResponse>
|
|
97
|
+
rescue UltracartClient::ApiError => e
|
|
98
|
+
puts "Error when calling BulkApi->bulk_generate_upload_url_with_http_info: #{e}"
|
|
99
|
+
end
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
### Parameters
|
|
103
|
+
|
|
104
|
+
| Name | Type | Description | Notes |
|
|
105
|
+
| ---- | ---- | ----------- | ----- |
|
|
106
|
+
| **object** | **String** | Object type | |
|
|
107
|
+
|
|
108
|
+
### Return type
|
|
109
|
+
|
|
110
|
+
[**BulkUploadUrlResponse**](BulkUploadUrlResponse.md)
|
|
111
|
+
|
|
112
|
+
### Authorization
|
|
113
|
+
|
|
114
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
115
|
+
|
|
116
|
+
### HTTP request headers
|
|
117
|
+
|
|
118
|
+
- **Content-Type**: Not defined
|
|
119
|
+
- **Accept**: application/json
|
|
120
|
+
|
|
121
|
+
|
|
122
|
+
## bulk_get_job
|
|
123
|
+
|
|
124
|
+
> <BulkJobResponse> bulk_get_job(object, job_id)
|
|
125
|
+
|
|
126
|
+
Retrieve a bulk job's status and counts
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
### Examples
|
|
130
|
+
|
|
131
|
+
|
|
132
|
+
(No example for this operation).
|
|
133
|
+
|
|
134
|
+
|
|
135
|
+
#### Using the bulk_get_job_with_http_info variant
|
|
136
|
+
|
|
137
|
+
This returns an Array which contains the response data, status code and headers.
|
|
138
|
+
|
|
139
|
+
> <Array(<BulkJobResponse>, Integer, Hash)> bulk_get_job_with_http_info(object, job_id)
|
|
140
|
+
|
|
141
|
+
```ruby
|
|
142
|
+
begin
|
|
143
|
+
# Retrieve a bulk job's status and counts
|
|
144
|
+
data, status_code, headers = api_instance.bulk_get_job_with_http_info(object, job_id)
|
|
145
|
+
p status_code # => 2xx
|
|
146
|
+
p headers # => { ... }
|
|
147
|
+
p data # => <BulkJobResponse>
|
|
148
|
+
rescue UltracartClient::ApiError => e
|
|
149
|
+
puts "Error when calling BulkApi->bulk_get_job_with_http_info: #{e}"
|
|
150
|
+
end
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
### Parameters
|
|
154
|
+
|
|
155
|
+
| Name | Type | Description | Notes |
|
|
156
|
+
| ---- | ---- | ----------- | ----- |
|
|
157
|
+
| **object** | **String** | Object type | |
|
|
158
|
+
| **job_id** | **String** | The bulk job id | |
|
|
159
|
+
|
|
160
|
+
### Return type
|
|
161
|
+
|
|
162
|
+
[**BulkJobResponse**](BulkJobResponse.md)
|
|
163
|
+
|
|
164
|
+
### Authorization
|
|
165
|
+
|
|
166
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
167
|
+
|
|
168
|
+
### HTTP request headers
|
|
169
|
+
|
|
170
|
+
- **Content-Type**: Not defined
|
|
171
|
+
- **Accept**: application/json
|
|
172
|
+
|
|
173
|
+
|
|
174
|
+
## bulk_get_job_records
|
|
175
|
+
|
|
176
|
+
> <BulkRecordsResponse> bulk_get_job_records(object, job_id, opts)
|
|
177
|
+
|
|
178
|
+
Paginate a bulk job's per-record results
|
|
179
|
+
|
|
180
|
+
|
|
181
|
+
### Examples
|
|
182
|
+
|
|
183
|
+
|
|
184
|
+
(No example for this operation).
|
|
185
|
+
|
|
186
|
+
|
|
187
|
+
#### Using the bulk_get_job_records_with_http_info variant
|
|
188
|
+
|
|
189
|
+
This returns an Array which contains the response data, status code and headers.
|
|
190
|
+
|
|
191
|
+
> <Array(<BulkRecordsResponse>, Integer, Hash)> bulk_get_job_records_with_http_info(object, job_id, opts)
|
|
192
|
+
|
|
193
|
+
```ruby
|
|
194
|
+
begin
|
|
195
|
+
# Paginate a bulk job's per-record results
|
|
196
|
+
data, status_code, headers = api_instance.bulk_get_job_records_with_http_info(object, job_id, opts)
|
|
197
|
+
p status_code # => 2xx
|
|
198
|
+
p headers # => { ... }
|
|
199
|
+
p data # => <BulkRecordsResponse>
|
|
200
|
+
rescue UltracartClient::ApiError => e
|
|
201
|
+
puts "Error when calling BulkApi->bulk_get_job_records_with_http_info: #{e}"
|
|
202
|
+
end
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
### Parameters
|
|
206
|
+
|
|
207
|
+
| Name | Type | Description | Notes |
|
|
208
|
+
| ---- | ---- | ----------- | ----- |
|
|
209
|
+
| **object** | **String** | Object type | |
|
|
210
|
+
| **job_id** | **String** | The bulk job id | |
|
|
211
|
+
| **status** | **String** | Filter by per-record result status (success, failed, duplicate) | [optional] |
|
|
212
|
+
| **cursor** | **String** | Opaque pagination cursor | [optional] |
|
|
213
|
+
| **limit** | **Integer** | Page size (default 100, max 1000) | [optional] |
|
|
214
|
+
|
|
215
|
+
### Return type
|
|
216
|
+
|
|
217
|
+
[**BulkRecordsResponse**](BulkRecordsResponse.md)
|
|
218
|
+
|
|
219
|
+
### Authorization
|
|
220
|
+
|
|
221
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
222
|
+
|
|
223
|
+
### HTTP request headers
|
|
224
|
+
|
|
225
|
+
- **Content-Type**: Not defined
|
|
226
|
+
- **Accept**: application/json
|
|
227
|
+
|
|
228
|
+
|
|
229
|
+
## bulk_list_jobs
|
|
230
|
+
|
|
231
|
+
> <BulkJobsResponse> bulk_list_jobs(object, opts)
|
|
232
|
+
|
|
233
|
+
List bulk jobs for the calling merchant
|
|
234
|
+
|
|
235
|
+
|
|
236
|
+
### Examples
|
|
237
|
+
|
|
238
|
+
|
|
239
|
+
(No example for this operation).
|
|
240
|
+
|
|
241
|
+
|
|
242
|
+
#### Using the bulk_list_jobs_with_http_info variant
|
|
243
|
+
|
|
244
|
+
This returns an Array which contains the response data, status code and headers.
|
|
245
|
+
|
|
246
|
+
> <Array(<BulkJobsResponse>, Integer, Hash)> bulk_list_jobs_with_http_info(object, opts)
|
|
247
|
+
|
|
248
|
+
```ruby
|
|
249
|
+
begin
|
|
250
|
+
# List bulk jobs for the calling merchant
|
|
251
|
+
data, status_code, headers = api_instance.bulk_list_jobs_with_http_info(object, opts)
|
|
252
|
+
p status_code # => 2xx
|
|
253
|
+
p headers # => { ... }
|
|
254
|
+
p data # => <BulkJobsResponse>
|
|
255
|
+
rescue UltracartClient::ApiError => e
|
|
256
|
+
puts "Error when calling BulkApi->bulk_list_jobs_with_http_info: #{e}"
|
|
257
|
+
end
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
### Parameters
|
|
261
|
+
|
|
262
|
+
| Name | Type | Description | Notes |
|
|
263
|
+
| ---- | ---- | ----------- | ----- |
|
|
264
|
+
| **object** | **String** | Object type | |
|
|
265
|
+
| **status** | **String** | Filter by job status | [optional] |
|
|
266
|
+
| **cursor** | **String** | Opaque pagination cursor | [optional] |
|
|
267
|
+
| **limit** | **Integer** | Page size (default 100, max 1000) | [optional] |
|
|
268
|
+
|
|
269
|
+
### Return type
|
|
270
|
+
|
|
271
|
+
[**BulkJobsResponse**](BulkJobsResponse.md)
|
|
272
|
+
|
|
273
|
+
### Authorization
|
|
274
|
+
|
|
275
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
276
|
+
|
|
277
|
+
### HTTP request headers
|
|
278
|
+
|
|
279
|
+
- **Content-Type**: Not defined
|
|
280
|
+
- **Accept**: application/json
|
|
281
|
+
|
|
282
|
+
|
|
283
|
+
## bulk_submit_job
|
|
284
|
+
|
|
285
|
+
> <BulkJobResponse> bulk_submit_job(object, bulk_job)
|
|
286
|
+
|
|
287
|
+
Submit a bulk job
|
|
288
|
+
|
|
289
|
+
Submits a job referencing a previously uploaded NDJSON object. One active job per merchant; additional submissions queue. The bulk surface is write-only (insert / upsert); it has no bulk read or export operation.
|
|
290
|
+
|
|
291
|
+
|
|
292
|
+
### Examples
|
|
293
|
+
|
|
294
|
+
|
|
295
|
+
(No example for this operation).
|
|
296
|
+
|
|
297
|
+
|
|
298
|
+
#### Using the bulk_submit_job_with_http_info variant
|
|
299
|
+
|
|
300
|
+
This returns an Array which contains the response data, status code and headers.
|
|
301
|
+
|
|
302
|
+
> <Array(<BulkJobResponse>, Integer, Hash)> bulk_submit_job_with_http_info(object, bulk_job)
|
|
303
|
+
|
|
304
|
+
```ruby
|
|
305
|
+
begin
|
|
306
|
+
# Submit a bulk job
|
|
307
|
+
data, status_code, headers = api_instance.bulk_submit_job_with_http_info(object, bulk_job)
|
|
308
|
+
p status_code # => 2xx
|
|
309
|
+
p headers # => { ... }
|
|
310
|
+
p data # => <BulkJobResponse>
|
|
311
|
+
rescue UltracartClient::ApiError => e
|
|
312
|
+
puts "Error when calling BulkApi->bulk_submit_job_with_http_info: #{e}"
|
|
313
|
+
end
|
|
314
|
+
```
|
|
315
|
+
|
|
316
|
+
### Parameters
|
|
317
|
+
|
|
318
|
+
| Name | Type | Description | Notes |
|
|
319
|
+
| ---- | ---- | ----------- | ----- |
|
|
320
|
+
| **object** | **String** | Object type | |
|
|
321
|
+
| **bulk_job** | [**BulkJobRequest**](BulkJobRequest.md) | Bulk job submission | |
|
|
322
|
+
|
|
323
|
+
### Return type
|
|
324
|
+
|
|
325
|
+
[**BulkJobResponse**](BulkJobResponse.md)
|
|
326
|
+
|
|
327
|
+
### Authorization
|
|
328
|
+
|
|
329
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
330
|
+
|
|
331
|
+
### HTTP request headers
|
|
332
|
+
|
|
333
|
+
- **Content-Type**: application/json; charset=UTF-8
|
|
334
|
+
- **Accept**: application/json
|
|
335
|
+
|
data/docs/BulkJob.md
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# UltracartClient::BulkJob
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **completed_at** | **String** | When the job reached a terminal status | [optional] |
|
|
8
|
+
| **duplicate_count** | **Integer** | Records short-circuited as duplicates | [optional] |
|
|
9
|
+
| **error_code** | **String** | Job-level failure code when status is failed | [optional] |
|
|
10
|
+
| **fail_count** | **Integer** | Records that failed | [optional] |
|
|
11
|
+
| **job_id** | **String** | Public-facing job id (uc-bulk-<ulid>) | [optional] |
|
|
12
|
+
| **object** | **String** | Object type this job processes | [optional] |
|
|
13
|
+
| **operation** | **String** | Mutation mode this job runs (the bulk surface is write-only) | [optional] |
|
|
14
|
+
| **processed_records** | **Integer** | Records processed so far | [optional] |
|
|
15
|
+
| **queue_position** | **Integer** | Position behind the merchant's active job (queued jobs only) | [optional] |
|
|
16
|
+
| **results_summary_url** | **String** | Presigned S3 URL to the full per-record results NDJSON (set when finished) | [optional] |
|
|
17
|
+
| **started_at** | **String** | When the worker started the job | [optional] |
|
|
18
|
+
| **status** | **String** | Job status | [optional] |
|
|
19
|
+
| **submitted_at** | **String** | When the job was submitted | [optional] |
|
|
20
|
+
| **success_count** | **Integer** | Records that landed | [optional] |
|
|
21
|
+
| **total_records** | **Integer** | Total records counted on the first pass (null until counted) | [optional] |
|
|
22
|
+
|
|
23
|
+
## Example
|
|
24
|
+
|
|
25
|
+
```ruby
|
|
26
|
+
require 'ultracart_api'
|
|
27
|
+
|
|
28
|
+
instance = UltracartClient::BulkJob.new(
|
|
29
|
+
completed_at: null,
|
|
30
|
+
duplicate_count: null,
|
|
31
|
+
error_code: null,
|
|
32
|
+
fail_count: null,
|
|
33
|
+
job_id: null,
|
|
34
|
+
object: null,
|
|
35
|
+
operation: null,
|
|
36
|
+
processed_records: null,
|
|
37
|
+
queue_position: null,
|
|
38
|
+
results_summary_url: null,
|
|
39
|
+
started_at: null,
|
|
40
|
+
status: null,
|
|
41
|
+
submitted_at: null,
|
|
42
|
+
success_count: null,
|
|
43
|
+
total_records: null
|
|
44
|
+
)
|
|
45
|
+
```
|
|
46
|
+
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# UltracartClient::BulkJobRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **operation** | **String** | Mutation mode - insert (create only) or upsert (create or update). Defaults to insert. This is always a mutation verb — the bulk surface writes only and has no read / query mode. upsert is currently supported for customer only. | [optional] |
|
|
8
|
+
| **s3_key** | **String** | The s3_key returned by the upload-url endpoint | [optional] |
|
|
9
|
+
| **webhook_secret** | **String** | Optional shared secret echoed in the completion POST's Authorization header | [optional] |
|
|
10
|
+
| **webhook_url** | **String** | Optional URL to POST once, on completion | [optional] |
|
|
11
|
+
|
|
12
|
+
## Example
|
|
13
|
+
|
|
14
|
+
```ruby
|
|
15
|
+
require 'ultracart_api'
|
|
16
|
+
|
|
17
|
+
instance = UltracartClient::BulkJobRequest.new(
|
|
18
|
+
operation: null,
|
|
19
|
+
s3_key: null,
|
|
20
|
+
webhook_secret: null,
|
|
21
|
+
webhook_url: null
|
|
22
|
+
)
|
|
23
|
+
```
|
|
24
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::BulkJobResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **bulk_job** | [**BulkJob**](BulkJob.md) | | [optional] |
|
|
8
|
+
| **error** | [**Error**](Error.md) | | [optional] |
|
|
9
|
+
| **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
|
|
10
|
+
| **success** | **Boolean** | Indicates if API call was successful | [optional] |
|
|
11
|
+
| **warning** | [**Warning**](Warning.md) | | [optional] |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'ultracart_api'
|
|
17
|
+
|
|
18
|
+
instance = UltracartClient::BulkJobResponse.new(
|
|
19
|
+
bulk_job: null,
|
|
20
|
+
error: null,
|
|
21
|
+
metadata: null,
|
|
22
|
+
success: null,
|
|
23
|
+
warning: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# UltracartClient::BulkJobsResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **bulk_jobs** | [**Array<BulkJob>**](BulkJob.md) | Bulk jobs | [optional] |
|
|
8
|
+
| **error** | [**Error**](Error.md) | | [optional] |
|
|
9
|
+
| **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
|
|
10
|
+
| **next_cursor** | **String** | Opaque cursor for the next page, null when exhausted | [optional] |
|
|
11
|
+
| **success** | **Boolean** | Indicates if API call was successful | [optional] |
|
|
12
|
+
| **warning** | [**Warning**](Warning.md) | | [optional] |
|
|
13
|
+
|
|
14
|
+
## Example
|
|
15
|
+
|
|
16
|
+
```ruby
|
|
17
|
+
require 'ultracart_api'
|
|
18
|
+
|
|
19
|
+
instance = UltracartClient::BulkJobsResponse.new(
|
|
20
|
+
bulk_jobs: null,
|
|
21
|
+
error: null,
|
|
22
|
+
metadata: null,
|
|
23
|
+
next_cursor: null,
|
|
24
|
+
success: null,
|
|
25
|
+
warning: null
|
|
26
|
+
)
|
|
27
|
+
```
|
|
28
|
+
|
data/docs/BulkRecord.md
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# UltracartClient::BulkRecord
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **action** | **String** | On an upsert success, whether the record was inserted or updated | [optional] |
|
|
8
|
+
| **error_code** | **String** | Error code on a failed record | [optional] |
|
|
9
|
+
| **error_message** | **String** | Human-readable detail on a failed record | [optional] |
|
|
10
|
+
| **line_number** | **Integer** | Original NDJSON line number | [optional] |
|
|
11
|
+
| **merchant_record_id** | **String** | The merchant-supplied dedupe key for this record | [optional] |
|
|
12
|
+
| **status** | **String** | Per-record verdict | [optional] |
|
|
13
|
+
| **uc_id** | **String** | UltraCart-side id created on success or matched on duplicate | [optional] |
|
|
14
|
+
|
|
15
|
+
## Example
|
|
16
|
+
|
|
17
|
+
```ruby
|
|
18
|
+
require 'ultracart_api'
|
|
19
|
+
|
|
20
|
+
instance = UltracartClient::BulkRecord.new(
|
|
21
|
+
action: null,
|
|
22
|
+
error_code: null,
|
|
23
|
+
error_message: null,
|
|
24
|
+
line_number: null,
|
|
25
|
+
merchant_record_id: null,
|
|
26
|
+
status: null,
|
|
27
|
+
uc_id: null
|
|
28
|
+
)
|
|
29
|
+
```
|
|
30
|
+
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# UltracartClient::BulkRecordsResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **error** | [**Error**](Error.md) | | [optional] |
|
|
8
|
+
| **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
|
|
9
|
+
| **next_cursor** | **String** | Opaque cursor for the next page, null when exhausted | [optional] |
|
|
10
|
+
| **records** | [**Array<BulkRecord>**](BulkRecord.md) | Per-record results | [optional] |
|
|
11
|
+
| **success** | **Boolean** | Indicates if API call was successful | [optional] |
|
|
12
|
+
| **warning** | [**Warning**](Warning.md) | | [optional] |
|
|
13
|
+
|
|
14
|
+
## Example
|
|
15
|
+
|
|
16
|
+
```ruby
|
|
17
|
+
require 'ultracart_api'
|
|
18
|
+
|
|
19
|
+
instance = UltracartClient::BulkRecordsResponse.new(
|
|
20
|
+
error: null,
|
|
21
|
+
metadata: null,
|
|
22
|
+
next_cursor: null,
|
|
23
|
+
records: null,
|
|
24
|
+
success: null,
|
|
25
|
+
warning: null
|
|
26
|
+
)
|
|
27
|
+
```
|
|
28
|
+
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# UltracartClient::BulkUploadUrlResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **error** | [**Error**](Error.md) | | [optional] |
|
|
8
|
+
| **expires_at** | **String** | When the presigned URL expires | [optional] |
|
|
9
|
+
| **max_records** | **Integer** | Per-job record cap | [optional] |
|
|
10
|
+
| **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
|
|
11
|
+
| **s3_key** | **String** | Opaque reference to pass back on POST /rest/v2/bulk/{object} | [optional] |
|
|
12
|
+
| **success** | **Boolean** | Indicates if API call was successful | [optional] |
|
|
13
|
+
| **upload_url** | **String** | Presigned S3 PUT URL (short-lived) | [optional] |
|
|
14
|
+
| **warning** | [**Warning**](Warning.md) | | [optional] |
|
|
15
|
+
|
|
16
|
+
## Example
|
|
17
|
+
|
|
18
|
+
```ruby
|
|
19
|
+
require 'ultracart_api'
|
|
20
|
+
|
|
21
|
+
instance = UltracartClient::BulkUploadUrlResponse.new(
|
|
22
|
+
error: null,
|
|
23
|
+
expires_at: null,
|
|
24
|
+
max_records: null,
|
|
25
|
+
metadata: null,
|
|
26
|
+
s3_key: null,
|
|
27
|
+
success: null,
|
|
28
|
+
upload_url: null,
|
|
29
|
+
warning: null
|
|
30
|
+
)
|
|
31
|
+
```
|
|
32
|
+
|