ultracart_api 3.11.14 → 3.11.16
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 +27 -5
- data/docs/CartUpsellAfter.md +3 -1
- data/docs/ConversationVirtualAgentCapabilities.md +2 -0
- data/docs/CustomReport.md +17 -0
- data/docs/CustomReportAccountConfig.md +16 -0
- data/docs/CustomReportAccountConfigResponse.md +12 -0
- data/docs/CustomReportExecutionParameter.md +10 -0
- data/docs/CustomReportExecutionRequest.md +8 -0
- data/docs/CustomReportParameter.md +13 -0
- data/docs/CustomReportParameterOption.md +9 -0
- data/docs/CustomReportQuery.md +13 -0
- data/docs/CustomReportResponse.md +12 -0
- data/docs/CustomReportTooltip.md +9 -0
- data/docs/CustomReportsResponse.md +12 -0
- data/docs/DatawarehouseApi.md +403 -0
- data/docs/Item.md +1 -1
- data/docs/OrderApi.md +98 -65
- data/docs/WebhookApi.md +0 -16
- data/lib/ultracart_api/api/datawarehouse_api.rb +439 -0
- data/lib/ultracart_api/api/order_api.rb +111 -82
- data/lib/ultracart_api/api/webhook_api.rb +0 -24
- data/lib/ultracart_api/models/cart_upsell_after.rb +25 -5
- data/lib/ultracart_api/models/conversation_virtual_agent_capabilities.rb +55 -1
- data/lib/ultracart_api/models/custom_report.rb +271 -0
- data/lib/ultracart_api/models/custom_report_account_config.rb +261 -0
- data/lib/ultracart_api/models/custom_report_account_config_response.rb +221 -0
- data/lib/ultracart_api/models/custom_report_execution_parameter.rb +202 -0
- data/lib/ultracart_api/models/custom_report_execution_request.rb +186 -0
- data/lib/ultracart_api/models/custom_report_parameter.rb +231 -0
- data/lib/ultracart_api/models/custom_report_parameter_option.rb +193 -0
- data/lib/ultracart_api/models/custom_report_query.rb +231 -0
- data/lib/ultracart_api/models/custom_report_response.rb +221 -0
- data/lib/ultracart_api/models/custom_report_tooltip.rb +193 -0
- data/lib/ultracart_api/models/custom_reports_response.rb +224 -0
- data/lib/ultracart_api/models/item.rb +1 -1
- data/lib/ultracart_api/version.rb +1 -1
- data/lib/ultracart_api.rb +11 -0
- metadata +24 -2
data/docs/OrderApi.md
CHANGED
@@ -5,6 +5,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
5
5
|
Method | HTTP request | Description
|
6
6
|
------------- | ------------- | -------------
|
7
7
|
[**adjust_order_total**](OrderApi.md#adjust_order_total) | **POST** /order/orders/{order_id}/adjust_order_total/{desired_total} | Adjusts an order total
|
8
|
+
[**block_refund_on_order**](OrderApi.md#block_refund_on_order) | **GET** /order/orders/{order_id}/refund_block | Set a refund block on an order
|
8
9
|
[**cancel_order**](OrderApi.md#cancel_order) | **POST** /order/orders/{order_id}/cancel | Cancel an order
|
9
10
|
[**delete_order**](OrderApi.md#delete_order) | **DELETE** /order/orders/{order_id} | Delete an order
|
10
11
|
[**duplicate_order**](OrderApi.md#duplicate_order) | **POST** /order/orders/{order_id}/duplicate | Duplicate an order
|
@@ -25,10 +26,10 @@ Method | HTTP request | Description
|
|
25
26
|
[**is_refundable_order**](OrderApi.md#is_refundable_order) | **GET** /order/orders/{order_id}/refundable | Determine if an order can be refunded
|
26
27
|
[**process_payment**](OrderApi.md#process_payment) | **POST** /order/orders/{order_id}/process_payment | Process payment
|
27
28
|
[**refund_order**](OrderApi.md#refund_order) | **PUT** /order/orders/{order_id}/refund | Refund an order
|
28
|
-
[**refund_order_completely**](OrderApi.md#refund_order_completely) | **PUT** /order/orders/{order_id}/refund_completely | Refund an order completely
|
29
29
|
[**replacement**](OrderApi.md#replacement) | **POST** /order/orders/{order_id}/replacement | Replacement order
|
30
30
|
[**resend_receipt**](OrderApi.md#resend_receipt) | **POST** /order/orders/{order_id}/resend_receipt | Resend receipt
|
31
31
|
[**resend_shipment_confirmation**](OrderApi.md#resend_shipment_confirmation) | **POST** /order/orders/{order_id}/resend_shipment_confirmation | Resend shipment confirmation
|
32
|
+
[**unblock_refund_on_order**](OrderApi.md#unblock_refund_on_order) | **GET** /order/orders/{order_id}/refund_unblock | Remove a refund block on an order
|
32
33
|
[**update_accounts_receivable_retry_config**](OrderApi.md#update_accounts_receivable_retry_config) | **POST** /order/accountsReceivableRetryConfig | Update A/R Retry Configuration
|
33
34
|
[**update_order**](OrderApi.md#update_order) | **PUT** /order/orders/{order_id} | Update an order
|
34
35
|
[**validate_order**](OrderApi.md#validate_order) | **POST** /order/validate | Validate
|
@@ -87,6 +88,59 @@ Name | Type | Description | Notes
|
|
87
88
|
|
88
89
|
|
89
90
|
|
91
|
+
# **block_refund_on_order**
|
92
|
+
> block_refund_on_order(order_id, opts)
|
93
|
+
|
94
|
+
Set a refund block on an order
|
95
|
+
|
96
|
+
Sets a refund block on an order to prevent a user from performing a refund. Commonly used when a chargeback has been received.
|
97
|
+
|
98
|
+
### Example
|
99
|
+
```ruby
|
100
|
+
# load the gem
|
101
|
+
require 'ultracart_api'
|
102
|
+
|
103
|
+
# Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
|
104
|
+
simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
|
105
|
+
api_instance = UltracartClient::OrderApi.new_using_api_key(simple_key, false, false)
|
106
|
+
|
107
|
+
|
108
|
+
order_id = 'order_id_example' # String | The order id to block a refund on.
|
109
|
+
|
110
|
+
opts = {
|
111
|
+
block_reason: 'block_reason_example' # String | Block reason code (optional)
|
112
|
+
}
|
113
|
+
|
114
|
+
begin
|
115
|
+
#Set a refund block on an order
|
116
|
+
api_instance.block_refund_on_order(order_id, opts)
|
117
|
+
rescue UltracartClient::ApiError => e
|
118
|
+
puts "Exception when calling OrderApi->block_refund_on_order: #{e}"
|
119
|
+
end
|
120
|
+
```
|
121
|
+
|
122
|
+
### Parameters
|
123
|
+
|
124
|
+
Name | Type | Description | Notes
|
125
|
+
------------- | ------------- | ------------- | -------------
|
126
|
+
**order_id** | **String**| The order id to block a refund on. |
|
127
|
+
**block_reason** | **String**| Block reason code (optional) | [optional]
|
128
|
+
|
129
|
+
### Return type
|
130
|
+
|
131
|
+
nil (empty response body)
|
132
|
+
|
133
|
+
### Authorization
|
134
|
+
|
135
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
136
|
+
|
137
|
+
### HTTP request headers
|
138
|
+
|
139
|
+
- **Content-Type**: application/json
|
140
|
+
- **Accept**: application/json
|
141
|
+
|
142
|
+
|
143
|
+
|
90
144
|
# **cancel_order**
|
91
145
|
> BaseResponse cancel_order(order_id, opts)
|
92
146
|
|
@@ -1211,12 +1265,12 @@ Name | Type | Description | Notes
|
|
1211
1265
|
|
1212
1266
|
|
1213
1267
|
|
1214
|
-
# **
|
1215
|
-
>
|
1268
|
+
# **replacement**
|
1269
|
+
> OrderReplacementResponse replacement(order_id, replacement)
|
1216
1270
|
|
1217
|
-
|
1271
|
+
Replacement order
|
1218
1272
|
|
1219
|
-
|
1273
|
+
Create a replacement order based upon a previous order
|
1220
1274
|
|
1221
1275
|
### Example
|
1222
1276
|
```ruby
|
@@ -1228,26 +1282,17 @@ simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
|
|
1228
1282
|
api_instance = UltracartClient::OrderApi.new_using_api_key(simple_key, false, false)
|
1229
1283
|
|
1230
1284
|
|
1231
|
-
order_id = 'order_id_example' # String | The order id to
|
1285
|
+
order_id = 'order_id_example' # String | The order id to generate a replacement for.
|
1286
|
+
|
1287
|
+
replacement = UltracartClient::OrderReplacement.new # OrderReplacement | Replacement order details
|
1232
1288
|
|
1233
|
-
opts = {
|
1234
|
-
reject_after_refund: false, # BOOLEAN | Reject order after refund
|
1235
|
-
skip_customer_notification: false, # BOOLEAN | Skip customer email notification
|
1236
|
-
auto_order_cancel: false, # BOOLEAN | Cancel associated auto orders
|
1237
|
-
manual_refund: false, # BOOLEAN | Consider a manual refund done externally
|
1238
|
-
reverse_affiliate_transactions: true, # BOOLEAN | Reverse affiliate transactions
|
1239
|
-
issue_store_credit: false, # BOOLEAN | Issue a store credit instead of refunding the original payment method, loyalty must be configured on merchant account
|
1240
|
-
auto_order_cancel_reason: 'auto_order_cancel_reason_example', # String | Reason for auto orders cancellation
|
1241
|
-
refund_reason: 'refund_reason_example', # String | Reason for refund
|
1242
|
-
reject_reason: 'reject_reason_example' # String | Reason for reject
|
1243
|
-
}
|
1244
1289
|
|
1245
1290
|
begin
|
1246
|
-
#
|
1247
|
-
result = api_instance.
|
1291
|
+
#Replacement order
|
1292
|
+
result = api_instance.replacement(order_id, replacement)
|
1248
1293
|
p result
|
1249
1294
|
rescue UltracartClient::ApiError => e
|
1250
|
-
puts "Exception when calling OrderApi->
|
1295
|
+
puts "Exception when calling OrderApi->replacement: #{e}"
|
1251
1296
|
end
|
1252
1297
|
```
|
1253
1298
|
|
@@ -1255,20 +1300,12 @@ end
|
|
1255
1300
|
|
1256
1301
|
Name | Type | Description | Notes
|
1257
1302
|
------------- | ------------- | ------------- | -------------
|
1258
|
-
**order_id** | **String**| The order id to
|
1259
|
-
**
|
1260
|
-
**skip_customer_notification** | **BOOLEAN**| Skip customer email notification | [optional] [default to false]
|
1261
|
-
**auto_order_cancel** | **BOOLEAN**| Cancel associated auto orders | [optional] [default to false]
|
1262
|
-
**manual_refund** | **BOOLEAN**| Consider a manual refund done externally | [optional] [default to false]
|
1263
|
-
**reverse_affiliate_transactions** | **BOOLEAN**| Reverse affiliate transactions | [optional] [default to true]
|
1264
|
-
**issue_store_credit** | **BOOLEAN**| Issue a store credit instead of refunding the original payment method, loyalty must be configured on merchant account | [optional] [default to false]
|
1265
|
-
**auto_order_cancel_reason** | **String**| Reason for auto orders cancellation | [optional]
|
1266
|
-
**refund_reason** | **String**| Reason for refund | [optional]
|
1267
|
-
**reject_reason** | **String**| Reason for reject | [optional]
|
1303
|
+
**order_id** | **String**| The order id to generate a replacement for. |
|
1304
|
+
**replacement** | [**OrderReplacement**](OrderReplacement.md)| Replacement order details |
|
1268
1305
|
|
1269
1306
|
### Return type
|
1270
1307
|
|
1271
|
-
[**
|
1308
|
+
[**OrderReplacementResponse**](OrderReplacementResponse.md)
|
1272
1309
|
|
1273
1310
|
### Authorization
|
1274
1311
|
|
@@ -1276,17 +1313,17 @@ Name | Type | Description | Notes
|
|
1276
1313
|
|
1277
1314
|
### HTTP request headers
|
1278
1315
|
|
1279
|
-
- **Content-Type**: application/json
|
1316
|
+
- **Content-Type**: application/json
|
1280
1317
|
- **Accept**: application/json
|
1281
1318
|
|
1282
1319
|
|
1283
1320
|
|
1284
|
-
# **
|
1285
|
-
>
|
1321
|
+
# **resend_receipt**
|
1322
|
+
> BaseResponse resend_receipt(order_id)
|
1286
1323
|
|
1287
|
-
|
1324
|
+
Resend receipt
|
1288
1325
|
|
1289
|
-
|
1326
|
+
Resend the receipt for an order on the UltraCart account.
|
1290
1327
|
|
1291
1328
|
### Example
|
1292
1329
|
```ruby
|
@@ -1298,17 +1335,15 @@ simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
|
|
1298
1335
|
api_instance = UltracartClient::OrderApi.new_using_api_key(simple_key, false, false)
|
1299
1336
|
|
1300
1337
|
|
1301
|
-
order_id = 'order_id_example' # String | The order id to
|
1302
|
-
|
1303
|
-
replacement = UltracartClient::OrderReplacement.new # OrderReplacement | Replacement order details
|
1338
|
+
order_id = 'order_id_example' # String | The order id to resend the receipt for.
|
1304
1339
|
|
1305
1340
|
|
1306
1341
|
begin
|
1307
|
-
#
|
1308
|
-
result = api_instance.
|
1342
|
+
#Resend receipt
|
1343
|
+
result = api_instance.resend_receipt(order_id)
|
1309
1344
|
p result
|
1310
1345
|
rescue UltracartClient::ApiError => e
|
1311
|
-
puts "Exception when calling OrderApi->
|
1346
|
+
puts "Exception when calling OrderApi->resend_receipt: #{e}"
|
1312
1347
|
end
|
1313
1348
|
```
|
1314
1349
|
|
@@ -1316,12 +1351,11 @@ end
|
|
1316
1351
|
|
1317
1352
|
Name | Type | Description | Notes
|
1318
1353
|
------------- | ------------- | ------------- | -------------
|
1319
|
-
**order_id** | **String**| The order id to
|
1320
|
-
**replacement** | [**OrderReplacement**](OrderReplacement.md)| Replacement order details |
|
1354
|
+
**order_id** | **String**| The order id to resend the receipt for. |
|
1321
1355
|
|
1322
1356
|
### Return type
|
1323
1357
|
|
1324
|
-
[**
|
1358
|
+
[**BaseResponse**](BaseResponse.md)
|
1325
1359
|
|
1326
1360
|
### Authorization
|
1327
1361
|
|
@@ -1334,12 +1368,12 @@ Name | Type | Description | Notes
|
|
1334
1368
|
|
1335
1369
|
|
1336
1370
|
|
1337
|
-
# **
|
1338
|
-
> BaseResponse
|
1371
|
+
# **resend_shipment_confirmation**
|
1372
|
+
> BaseResponse resend_shipment_confirmation(order_id)
|
1339
1373
|
|
1340
|
-
Resend
|
1374
|
+
Resend shipment confirmation
|
1341
1375
|
|
1342
|
-
Resend
|
1376
|
+
Resend shipment confirmation for an order on the UltraCart account.
|
1343
1377
|
|
1344
1378
|
### Example
|
1345
1379
|
```ruby
|
@@ -1351,15 +1385,15 @@ simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
|
|
1351
1385
|
api_instance = UltracartClient::OrderApi.new_using_api_key(simple_key, false, false)
|
1352
1386
|
|
1353
1387
|
|
1354
|
-
order_id = 'order_id_example' # String | The order id to resend the
|
1388
|
+
order_id = 'order_id_example' # String | The order id to resend the shipment notification for.
|
1355
1389
|
|
1356
1390
|
|
1357
1391
|
begin
|
1358
|
-
#Resend
|
1359
|
-
result = api_instance.
|
1392
|
+
#Resend shipment confirmation
|
1393
|
+
result = api_instance.resend_shipment_confirmation(order_id)
|
1360
1394
|
p result
|
1361
1395
|
rescue UltracartClient::ApiError => e
|
1362
|
-
puts "Exception when calling OrderApi->
|
1396
|
+
puts "Exception when calling OrderApi->resend_shipment_confirmation: #{e}"
|
1363
1397
|
end
|
1364
1398
|
```
|
1365
1399
|
|
@@ -1367,7 +1401,7 @@ end
|
|
1367
1401
|
|
1368
1402
|
Name | Type | Description | Notes
|
1369
1403
|
------------- | ------------- | ------------- | -------------
|
1370
|
-
**order_id** | **String**| The order id to resend the
|
1404
|
+
**order_id** | **String**| The order id to resend the shipment notification for. |
|
1371
1405
|
|
1372
1406
|
### Return type
|
1373
1407
|
|
@@ -1384,12 +1418,12 @@ Name | Type | Description | Notes
|
|
1384
1418
|
|
1385
1419
|
|
1386
1420
|
|
1387
|
-
# **
|
1388
|
-
>
|
1421
|
+
# **unblock_refund_on_order**
|
1422
|
+
> unblock_refund_on_order(order_id)
|
1389
1423
|
|
1390
|
-
|
1424
|
+
Remove a refund block on an order
|
1391
1425
|
|
1392
|
-
|
1426
|
+
Removes a refund block on an order to prevent a user from performing a refund.
|
1393
1427
|
|
1394
1428
|
### Example
|
1395
1429
|
```ruby
|
@@ -1401,15 +1435,14 @@ simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
|
|
1401
1435
|
api_instance = UltracartClient::OrderApi.new_using_api_key(simple_key, false, false)
|
1402
1436
|
|
1403
1437
|
|
1404
|
-
order_id = 'order_id_example' # String | The order id to
|
1438
|
+
order_id = 'order_id_example' # String | The order id to unblock a refund on.
|
1405
1439
|
|
1406
1440
|
|
1407
1441
|
begin
|
1408
|
-
#
|
1409
|
-
|
1410
|
-
p result
|
1442
|
+
#Remove a refund block on an order
|
1443
|
+
api_instance.unblock_refund_on_order(order_id)
|
1411
1444
|
rescue UltracartClient::ApiError => e
|
1412
|
-
puts "Exception when calling OrderApi->
|
1445
|
+
puts "Exception when calling OrderApi->unblock_refund_on_order: #{e}"
|
1413
1446
|
end
|
1414
1447
|
```
|
1415
1448
|
|
@@ -1417,11 +1450,11 @@ end
|
|
1417
1450
|
|
1418
1451
|
Name | Type | Description | Notes
|
1419
1452
|
------------- | ------------- | ------------- | -------------
|
1420
|
-
**order_id** | **String**| The order id to
|
1453
|
+
**order_id** | **String**| The order id to unblock a refund on. |
|
1421
1454
|
|
1422
1455
|
### Return type
|
1423
1456
|
|
1424
|
-
|
1457
|
+
nil (empty response body)
|
1425
1458
|
|
1426
1459
|
### Authorization
|
1427
1460
|
|
data/docs/WebhookApi.md
CHANGED
@@ -186,14 +186,6 @@ api_instance = UltracartClient::WebhookApi.new_using_api_key(simple_key, false,
|
|
186
186
|
webhook_oid = 56 # Integer | The webhook oid to retrieve log summaries for.
|
187
187
|
|
188
188
|
opts = {
|
189
|
-
request_id: 'request_id_example', # String |
|
190
|
-
begin_date: 'begin_date_example', # String |
|
191
|
-
end_date: 'end_date_example', # String |
|
192
|
-
status: 'status_example', # String |
|
193
|
-
event: 'event_example', # String |
|
194
|
-
order_id: 'order_id_example', # String |
|
195
|
-
request: 'request_example', # String |
|
196
|
-
duration: 56, # Integer |
|
197
189
|
_limit: 100, # Integer | The maximum number of records to return on this one API call.
|
198
190
|
_offset: 0, # Integer | Pagination of the record set. Offset is a zero based index.
|
199
191
|
_since: '_since_example' # String | Fetch log summaries that have been delivered since this date/time.
|
@@ -213,14 +205,6 @@ end
|
|
213
205
|
Name | Type | Description | Notes
|
214
206
|
------------- | ------------- | ------------- | -------------
|
215
207
|
**webhook_oid** | **Integer**| The webhook oid to retrieve log summaries for. |
|
216
|
-
**request_id** | **String**| | [optional]
|
217
|
-
**begin_date** | **String**| | [optional]
|
218
|
-
**end_date** | **String**| | [optional]
|
219
|
-
**status** | **String**| | [optional]
|
220
|
-
**event** | **String**| | [optional]
|
221
|
-
**order_id** | **String**| | [optional]
|
222
|
-
**request** | **String**| | [optional]
|
223
|
-
**duration** | **Integer**| | [optional]
|
224
208
|
**_limit** | **Integer**| The maximum number of records to return on this one API call. | [optional] [default to 100]
|
225
209
|
**_offset** | **Integer**| Pagination of the record set. Offset is a zero based index. | [optional] [default to 0]
|
226
210
|
**_since** | **String**| Fetch log summaries that have been delivered since this date/time. | [optional]
|