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.
Files changed (39) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +27 -5
  3. data/docs/CartUpsellAfter.md +3 -1
  4. data/docs/ConversationVirtualAgentCapabilities.md +2 -0
  5. data/docs/CustomReport.md +17 -0
  6. data/docs/CustomReportAccountConfig.md +16 -0
  7. data/docs/CustomReportAccountConfigResponse.md +12 -0
  8. data/docs/CustomReportExecutionParameter.md +10 -0
  9. data/docs/CustomReportExecutionRequest.md +8 -0
  10. data/docs/CustomReportParameter.md +13 -0
  11. data/docs/CustomReportParameterOption.md +9 -0
  12. data/docs/CustomReportQuery.md +13 -0
  13. data/docs/CustomReportResponse.md +12 -0
  14. data/docs/CustomReportTooltip.md +9 -0
  15. data/docs/CustomReportsResponse.md +12 -0
  16. data/docs/DatawarehouseApi.md +403 -0
  17. data/docs/Item.md +1 -1
  18. data/docs/OrderApi.md +98 -65
  19. data/docs/WebhookApi.md +0 -16
  20. data/lib/ultracart_api/api/datawarehouse_api.rb +439 -0
  21. data/lib/ultracart_api/api/order_api.rb +111 -82
  22. data/lib/ultracart_api/api/webhook_api.rb +0 -24
  23. data/lib/ultracart_api/models/cart_upsell_after.rb +25 -5
  24. data/lib/ultracart_api/models/conversation_virtual_agent_capabilities.rb +55 -1
  25. data/lib/ultracart_api/models/custom_report.rb +271 -0
  26. data/lib/ultracart_api/models/custom_report_account_config.rb +261 -0
  27. data/lib/ultracart_api/models/custom_report_account_config_response.rb +221 -0
  28. data/lib/ultracart_api/models/custom_report_execution_parameter.rb +202 -0
  29. data/lib/ultracart_api/models/custom_report_execution_request.rb +186 -0
  30. data/lib/ultracart_api/models/custom_report_parameter.rb +231 -0
  31. data/lib/ultracart_api/models/custom_report_parameter_option.rb +193 -0
  32. data/lib/ultracart_api/models/custom_report_query.rb +231 -0
  33. data/lib/ultracart_api/models/custom_report_response.rb +221 -0
  34. data/lib/ultracart_api/models/custom_report_tooltip.rb +193 -0
  35. data/lib/ultracart_api/models/custom_reports_response.rb +224 -0
  36. data/lib/ultracart_api/models/item.rb +1 -1
  37. data/lib/ultracart_api/version.rb +1 -1
  38. data/lib/ultracart_api.rb +11 -0
  39. 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
- # **refund_order_completely**
1215
- > OrderResponse refund_order_completely(order_id, opts)
1268
+ # **replacement**
1269
+ > OrderReplacementResponse replacement(order_id, replacement)
1216
1270
 
1217
- Refund an order completely
1271
+ Replacement order
1218
1272
 
1219
- Perform a refund operation on an order and then update the order if successful.
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 refund.
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
- #Refund an order completely
1247
- result = api_instance.refund_order_completely(order_id, opts)
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->refund_order_completely: #{e}"
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 refund. |
1259
- **reject_after_refund** | **BOOLEAN**| Reject order after refund | [optional] [default to false]
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
- [**OrderResponse**](OrderResponse.md)
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; charset=UTF-8
1316
+ - **Content-Type**: application/json
1280
1317
  - **Accept**: application/json
1281
1318
 
1282
1319
 
1283
1320
 
1284
- # **replacement**
1285
- > OrderReplacementResponse replacement(order_id, replacement)
1321
+ # **resend_receipt**
1322
+ > BaseResponse resend_receipt(order_id)
1286
1323
 
1287
- Replacement order
1324
+ Resend receipt
1288
1325
 
1289
- Create a replacement order based upon a previous order
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 generate a replacement for.
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
- #Replacement order
1308
- result = api_instance.replacement(order_id, replacement)
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->replacement: #{e}"
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 generate a replacement for. |
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
- [**OrderReplacementResponse**](OrderReplacementResponse.md)
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
- # **resend_receipt**
1338
- > BaseResponse resend_receipt(order_id)
1371
+ # **resend_shipment_confirmation**
1372
+ > BaseResponse resend_shipment_confirmation(order_id)
1339
1373
 
1340
- Resend receipt
1374
+ Resend shipment confirmation
1341
1375
 
1342
- Resend the receipt for an order on the UltraCart account.
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 receipt for.
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 receipt
1359
- result = api_instance.resend_receipt(order_id)
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->resend_receipt: #{e}"
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 receipt for. |
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
- # **resend_shipment_confirmation**
1388
- > BaseResponse resend_shipment_confirmation(order_id)
1421
+ # **unblock_refund_on_order**
1422
+ > unblock_refund_on_order(order_id)
1389
1423
 
1390
- Resend shipment confirmation
1424
+ Remove a refund block on an order
1391
1425
 
1392
- Resend shipment confirmation for an order on the UltraCart account.
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 resend the shipment notification for.
1438
+ order_id = 'order_id_example' # String | The order id to unblock a refund on.
1405
1439
 
1406
1440
 
1407
1441
  begin
1408
- #Resend shipment confirmation
1409
- result = api_instance.resend_shipment_confirmation(order_id)
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->resend_shipment_confirmation: #{e}"
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 resend the shipment notification for. |
1453
+ **order_id** | **String**| The order id to unblock a refund on. |
1421
1454
 
1422
1455
  ### Return type
1423
1456
 
1424
- [**BaseResponse**](BaseResponse.md)
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]