diff --git a/CHANGELOG.md b/CHANGELOG.md index 1c1c3fd8d..6c2f1371b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,12 @@ # CHANGELOG +## v8.2.0 (2025-06-18) + +- Adds the following functions + - `shipment.createAndBuyLuma` + - `shipment.buyLuma` + - `luma.getPromise` + ## v8.1.0 (2025-05-29) - Adds `reference` to Claims diff --git a/README.md b/README.md index 246387c6f..ec4abf695 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ Add this to your project's POM: com.easypost easypost-api-client - 8.1.0 + 8.2.0 ``` @@ -25,7 +25,7 @@ Add this to your project's POM: Add this to your project's build file: ```groovy -implementation "com.easypost:easypost-api-client:8.1.0" +implementation "com.easypost:easypost-api-client:8.2.0" ``` **NOTE:** [Google Gson](http://code.google.com/p/google-gson/) is required. diff --git a/VERSION b/VERSION index 8104cabd3..fbb9ea12d 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -8.1.0 +8.2.0 diff --git a/examples b/examples index 394ea5eff..739f96c80 160000 --- a/examples +++ b/examples @@ -1 +1 @@ -Subproject commit 394ea5effde57b304c88999761126953cb1c7e91 +Subproject commit 739f96c80fa211060e0a0b8c13e7371c9a09d66f diff --git a/pom.xml b/pom.xml index fed2b88f0..af9e7e1ae 100644 --- a/pom.xml +++ b/pom.xml @@ -6,7 +6,7 @@ com.easypost easypost-api-client - 8.1.0 + 8.2.0 jar com.easypost:easypost-api-client diff --git a/src/main/java/com/easypost/model/AiResults.java b/src/main/java/com/easypost/model/AiResults.java new file mode 100644 index 000000000..8bfbdcd1a --- /dev/null +++ b/src/main/java/com/easypost/model/AiResults.java @@ -0,0 +1,14 @@ +package com.easypost.model; + +import lombok.Getter; + +@Getter +public final class AiResults { + private String carrier; + private Boolean meetsRulesetRequirements; + private String predictedDeliverByDate; + private Integer predictedDeliverDays; + private String rateId; + private String rateUsd; + private String service; +} diff --git a/src/main/java/com/easypost/model/LumaInfo.java b/src/main/java/com/easypost/model/LumaInfo.java new file mode 100644 index 000000000..d9004a63a --- /dev/null +++ b/src/main/java/com/easypost/model/LumaInfo.java @@ -0,0 +1,12 @@ +package com.easypost.model; + +import java.util.List; +import lombok.Getter; + +@Getter +public final class LumaInfo { + private List aiResults; + private Integer matchingRuleIdx; + private String rulesetDescription; + private Rate lumaSelectedRate; +} diff --git a/src/main/java/com/easypost/model/LumaPromiseResponse.java b/src/main/java/com/easypost/model/LumaPromiseResponse.java new file mode 100644 index 000000000..7d1ff68bb --- /dev/null +++ b/src/main/java/com/easypost/model/LumaPromiseResponse.java @@ -0,0 +1,8 @@ +package com.easypost.model; + +import lombok.Getter; + +@Getter +public class LumaPromiseResponse { + private LumaInfo lumaInfo; +} diff --git a/src/main/java/com/easypost/service/EasyPostClient.java b/src/main/java/com/easypost/service/EasyPostClient.java index 5c1a26efd..1a7fca48a 100644 --- a/src/main/java/com/easypost/service/EasyPostClient.java +++ b/src/main/java/com/easypost/service/EasyPostClient.java @@ -32,6 +32,7 @@ public class EasyPostClient { public final EndShipperService endShipper; public final EventService event; public final InsuranceService insurance; + public final LumaService luma; public final OrderService order; public final ParcelService parcel; public final PaymentMethodService paymentMethod; @@ -143,6 +144,7 @@ public EasyPostClient(String apiKey, int connectTimeoutMilliseconds, int readTim this.endShipper = new EndShipperService(this); this.event = new EventService(this); this.insurance = new InsuranceService(this); + this.luma = new LumaService(this); this.order = new OrderService(this); this.parcel = new ParcelService(this); this.paymentMethod = new PaymentMethodService(this); diff --git a/src/main/java/com/easypost/service/LumaService.java b/src/main/java/com/easypost/service/LumaService.java new file mode 100644 index 000000000..b2e67912f --- /dev/null +++ b/src/main/java/com/easypost/service/LumaService.java @@ -0,0 +1,41 @@ +package com.easypost.service; + +import com.easypost.exception.EasyPostException; +import com.easypost.http.Requestor; +import com.easypost.http.Requestor.RequestMethod; +import com.easypost.model.LumaPromiseResponse; +import com.easypost.model.LumaInfo; + +import java.util.HashMap; +import java.util.Map; + +public class LumaService { + private final EasyPostClient client; + + /** + * LumaService constructor. + * + * @param client The client object. + */ + LumaService(EasyPostClient client) { + this.client = client; + } + + /** + * Get service recommendations from Luma that meet the criteria of your ruleset. + * + * @param params The map of parameters. + * @return LumaInfo object. + * @throws EasyPostException When the request fails. + */ + public LumaInfo getPromise(final Map params) + throws EasyPostException { + Map wrappedParams = new HashMap<>(); + wrappedParams.put("shipment", params); + String endpoint = "luma/promise"; + + LumaPromiseResponse response = Requestor.request(RequestMethod.POST, endpoint, wrappedParams, + LumaPromiseResponse.class, client); + return response.getLumaInfo(); + } +} diff --git a/src/main/java/com/easypost/service/ShipmentService.java b/src/main/java/com/easypost/service/ShipmentService.java index 4c6283992..8c8b80c9b 100644 --- a/src/main/java/com/easypost/service/ShipmentService.java +++ b/src/main/java/com/easypost/service/ShipmentService.java @@ -375,7 +375,7 @@ public Shipment generateForm(final String id, final String formType, final Map retrieveEstimatedDeliveryDate(final String id, final String plannedShipDate) @@ -396,7 +396,7 @@ public List retrieveEstimatedDeliveryDate(final String id * * @param id The id of the shipment. * @param desiredDeliveryDate The desired delivery date. - * @return EstimatedDeliveryDate object. + * @return List of RecommendShipDateForShipmentResult objects. * @throws EasyPostException When the request fails. */ public List recommendShipDate(final String id, final String desiredDeliveryDate) @@ -409,4 +409,39 @@ public List recommendShipDate(final String i RecommendShipDateResponse.class, client); return response.getRates(); } + + /** + * Create and buy a Luma Shipment in one call. + * + * @param params The map of parameters. + * @return Shipment object. + * @throws EasyPostException When the request fails. + */ + public Shipment createAndBuyLuma(final Map params) + throws EasyPostException { + Map wrappedParams = new HashMap<>(); + wrappedParams.put("shipment", params); + String endpoint = "shipments/luma"; + + Shipment response = Requestor.request(RequestMethod.POST, endpoint, wrappedParams, + Shipment.class, client); + return response; + } + + /** + * Buy a Shipment with Luma. + * + * @param id The ID of shipment. + * @param params The map of parameters. + * @return Shipment object. + * @throws EasyPostException When the request fails. + */ + public Shipment buyLuma(final String id, final Map params) + throws EasyPostException { + String endpoint = "shipments/" + id + "/luma"; + + Shipment response = Requestor.request(RequestMethod.POST, endpoint, params, + Shipment.class, client); + return response; + } } diff --git a/src/test/cassettes/luma/get_promise.json b/src/test/cassettes/luma/get_promise.json new file mode 100644 index 000000000..9590cb630 --- /dev/null +++ b/src/test/cassettes/luma/get_promise.json @@ -0,0 +1,91 @@ +[ + { + "recordedAt": 1750095923, + "request": { + "body": "{\n \"shipment\": {\n \"parcel\": {\n \"length\": 10.0,\n \"width\": 8.0,\n \"weight\": 15.4,\n \"height\": 4.0\n },\n \"planned_ship_date\": \"2025-06-16\",\n \"to_address\": {\n \"zip\": \"90277\",\n \"country\": \"US\",\n \"city\": \"Redondo Beach\",\n \"phone\": \"REDACTED\",\n \"name\": \"Elizabeth Swan\",\n \"street1\": \"179 N Harbor Dr\",\n \"state\": \"CA\",\n \"email\": \"test@example.com\"\n },\n \"from_address\": {\n \"zip\": \"94107\",\n \"country\": \"US\",\n \"city\": \"San Francisco\",\n \"phone\": \"REDACTED\",\n \"name\": \"Jack Sparrow\",\n \"street1\": \"388 Townsend St\",\n \"street2\": \"Apt 20\",\n \"state\": \"CA\",\n \"email\": \"test@example.com\"\n },\n \"ruleset_name\": \"cheapest_delivery\"\n }\n}", + "method": "POST", + "headers": { + "Accept-Charset": [ + "UTF-8" + ], + "User-Agent": [ + "REDACTED" + ], + "Content-Type": [ + "application/json" + ] + }, + "uri": "https://api.easypost.com/v2/luma/promise" + }, + "response": { + "body": "{\n \"luma_info\": {\n \"matching_rule_idx\": 0.0,\n \"ruleset_description\": \"Buy the cheapest rate that satisfies all of the following:\\nRule 0\\n \\nOtherwise buy the cheapest rate\",\n \"luma_selected_rate\": {\n \"carrier\": \"USPS\",\n \"rate\": \"6.07\",\n \"service\": \"GroundAdvantage\",\n \"carrier_account_id\": \"ca_f09befdb2e9c410e95c7622ea912c18c\",\n \"currency\": \"USD\",\n \"luma_predicted_deliver_by_date\": \"2025-06-19\"\n },\n \"ai_results\": [\n {\n \"meets_ruleset_requirements\": true,\n \"carrier\": \"USPS\",\n \"predicted_deliver_by_date\": \"2025-06-19\",\n \"service\": \"GroundAdvantage\",\n \"rate_usd\": \"6.07\",\n \"predicted_deliver_days\": 3.0\n },\n {\n \"meets_ruleset_requirements\": true,\n \"carrier\": \"USPS\",\n \"predicted_deliver_by_date\": \"2025-06-17\",\n \"service\": \"Express\",\n \"rate_usd\": \"34.15\",\n \"predicted_deliver_days\": 1.0\n },\n {\n \"meets_ruleset_requirements\": true,\n \"carrier\": \"USPS\",\n \"predicted_deliver_by_date\": \"2025-06-18\",\n \"service\": \"Priority\",\n \"rate_usd\": \"7.42\",\n \"predicted_deliver_days\": 2.0\n }\n ]\n }\n}", + "httpVersion": null, + "headers": { + "null": [ + "HTTP/1.1 200 OK" + ], + "content-length": [ + "873" + ], + "expires": [ + "0" + ], + "x-node": [ + "bigweb38nuq" + ], + "x-frame-options": [ + "SAMEORIGIN" + ], + "x-download-options": [ + "noopen" + ], + "x-permitted-cross-domain-policies": [ + "none" + ], + "x-backend": [ + "easypost" + ], + "pragma": [ + "no-cache" + ], + "strict-transport-security": [ + "max-age\u003d31536000; includeSubDomains; preload" + ], + "x-xss-protection": [ + "1; mode\u003dblock" + ], + "x-content-type-options": [ + "nosniff" + ], + "x-ep-request-uuid": [ + "6ebfb8b068505833e2baa4f8006d7fcc" + ], + "x-proxied": [ + "intlb4nuq ec99f2d065", + "extlb1nuq 99aac35317" + ], + "referrer-policy": [ + "strict-origin-when-cross-origin" + ], + "x-runtime": [ + "0.172372" + ], + "content-type": [ + "application/json; charset\u003dutf-8" + ], + "x-version-label": [ + "easypost-202506161725-4166f0359d-master" + ], + "cache-control": [ + "private, no-cache, no-store" + ] + }, + "status": { + "code": 200, + "message": "OK" + }, + "uri": "https://api.easypost.com/v2/luma/promise" + }, + "duration": 284 + } +] \ No newline at end of file diff --git a/src/test/cassettes/shipment/buy_luma.json b/src/test/cassettes/shipment/buy_luma.json new file mode 100644 index 000000000..2941fa382 --- /dev/null +++ b/src/test/cassettes/shipment/buy_luma.json @@ -0,0 +1,183 @@ +[ + { + "recordedAt": 1750095933, + "request": { + "body": "{\n \"shipment\": {\n \"parcel\": {\n \"length\": 10.0,\n \"width\": 8.0,\n \"weight\": 15.4,\n \"height\": 4.0\n },\n \"to_address\": {\n \"zip\": \"90277\",\n \"country\": \"US\",\n \"city\": \"Redondo Beach\",\n \"phone\": \"REDACTED\",\n \"name\": \"Elizabeth Swan\",\n \"street1\": \"179 N Harbor Dr\",\n \"state\": \"CA\",\n \"email\": \"test@example.com\"\n },\n \"from_address\": {\n \"zip\": \"94107\",\n \"country\": \"US\",\n \"city\": \"San Francisco\",\n \"phone\": \"REDACTED\",\n \"name\": \"Jack Sparrow\",\n \"street1\": \"388 Townsend St\",\n \"street2\": \"Apt 20\",\n \"state\": \"CA\",\n \"email\": \"test@example.com\"\n }\n }\n}", + "method": "POST", + "headers": { + "Accept-Charset": [ + "UTF-8" + ], + "User-Agent": [ + "REDACTED" + ], + "Content-Type": [ + "application/json" + ] + }, + "uri": "https://api.easypost.com/v2/shipments" + }, + "response": { + "body": "{\n \"insurance\": null,\n \"fees\": [],\n \"batch_id\": null,\n \"batch_message\": null,\n \"batch_status\": null,\n \"created_at\": \"2025-06-16T17:45:32Z\",\n \"mode\": \"test\",\n \"reference\": null,\n \"usps_zone\": 4.0,\n \"is_return\": false,\n \"updated_at\": \"2025-06-16T17:45:32Z\",\n \"selected_rate\": null,\n \"options\": {\n \"date_advance\": 0.0,\n \"currency\": \"USD\",\n \"payment\": {\n \"type\": \"SENDER\"\n }\n },\n \"tracker\": null,\n \"return_address\": {\n \"zip\": \"94107\",\n \"country\": \"US\",\n \"city\": \"San Francisco\",\n \"created_at\": \"2025-06-16T17:45:32+00:00\",\n \"verifications\": {},\n \"mode\": \"test\",\n \"federal_tax_id\": null,\n \"state_tax_id\": null,\n \"carrier_facility\": null,\n \"residential\": null,\n \"updated_at\": \"2025-06-16T17:45:32+00:00\",\n \"phone\": \"REDACTED\",\n \"name\": \"Jack Sparrow\",\n \"company\": null,\n \"street1\": \"388 Townsend St\",\n \"id\": \"adr_b390dd994ad911f0abbfac1f6bc539aa\",\n \"street2\": \"Apt 20\",\n \"state\": \"CA\",\n \"email\": \"test@example.com\",\n \"object\": \"Address\"\n },\n \"id\": \"shp_5571541b585f4e6c832beebed7396fcc\",\n \"from_address\": {\n \"zip\": \"94107\",\n \"country\": \"US\",\n \"city\": \"San Francisco\",\n \"created_at\": \"2025-06-16T17:45:32+00:00\",\n \"verifications\": {},\n \"mode\": \"test\",\n \"federal_tax_id\": null,\n \"state_tax_id\": null,\n \"carrier_facility\": null,\n \"residential\": null,\n \"updated_at\": \"2025-06-16T17:45:32+00:00\",\n \"phone\": \"REDACTED\",\n \"name\": \"Jack Sparrow\",\n \"company\": null,\n \"street1\": \"388 Townsend St\",\n \"id\": \"adr_b390dd994ad911f0abbfac1f6bc539aa\",\n \"street2\": \"Apt 20\",\n \"state\": \"CA\",\n \"email\": \"test@example.com\",\n \"object\": \"Address\"\n },\n \"customs_info\": null,\n \"postage_label\": null,\n \"parcel\": {\n \"mode\": \"test\",\n \"updated_at\": \"2025-06-16T17:45:32Z\",\n \"predefined_package\": null,\n \"length\": 10.0,\n \"width\": 8.0,\n \"created_at\": \"2025-06-16T17:45:32Z\",\n \"weight\": 15.4,\n \"id\": \"prcl_a7f70c36a6514c54906327289d5c9173\",\n \"object\": \"Parcel\",\n \"height\": 4.0\n },\n \"refund_status\": null,\n \"buyer_address\": {\n \"zip\": \"90277\",\n \"country\": \"US\",\n \"city\": \"Redondo Beach\",\n \"created_at\": \"2025-06-16T17:45:32+00:00\",\n \"verifications\": {},\n \"mode\": \"test\",\n \"federal_tax_id\": null,\n \"state_tax_id\": null,\n \"carrier_facility\": null,\n \"residential\": null,\n \"updated_at\": \"2025-06-16T17:45:32+00:00\",\n \"phone\": \"REDACTED\",\n \"name\": \"Elizabeth Swan\",\n \"company\": null,\n \"street1\": \"179 N Harbor Dr\",\n \"id\": \"adr_b38dfaae4ad911f0abb8ac1f6bc539aa\",\n \"street2\": null,\n \"state\": \"CA\",\n \"email\": \"test@example.com\",\n \"object\": \"Address\"\n },\n \"rates\": [\n {\n \"carrier_account_id\": \"ca_f09befdb2e9c410e95c7622ea912c18c\",\n \"list_rate\": \"34.15\",\n \"created_at\": \"2025-06-16T17:45:33Z\",\n \"delivery_days\": 1.0,\n \"list_currency\": \"USD\",\n \"shipment_id\": \"shp_5571541b585f4e6c832beebed7396fcc\",\n \"mode\": \"test\",\n \"carrier\": \"USPS\",\n \"delivery_date\": null,\n \"delivery_date_guaranteed\": false,\n \"retail_rate\": \"39.10\",\n \"retail_currency\": \"USD\",\n \"updated_at\": \"2025-06-16T17:45:33Z\",\n \"rate\": \"34.15\",\n \"service\": \"Express\",\n \"billing_type\": \"easypost\",\n \"est_delivery_days\": 1.0,\n \"currency\": \"USD\",\n \"id\": \"rate_22cbea381a6840479dfd708d12d15c27\",\n \"object\": \"Rate\"\n },\n {\n \"carrier_account_id\": \"ca_f09befdb2e9c410e95c7622ea912c18c\",\n \"list_rate\": \"8.34\",\n \"created_at\": \"2025-06-16T17:45:33Z\",\n \"delivery_days\": 2.0,\n \"list_currency\": \"USD\",\n \"shipment_id\": \"shp_5571541b585f4e6c832beebed7396fcc\",\n \"mode\": \"test\",\n \"carrier\": \"USPS\",\n \"delivery_date\": null,\n \"delivery_date_guaranteed\": false,\n \"retail_rate\": \"9.90\",\n \"retail_currency\": \"USD\",\n \"updated_at\": \"2025-06-16T17:45:33Z\",\n \"rate\": \"7.42\",\n \"service\": \"Priority\",\n \"billing_type\": \"easypost\",\n \"est_delivery_days\": 2.0,\n \"currency\": \"USD\",\n \"id\": \"rate_28560fbf722f44e69677eb8ec43da58a\",\n \"object\": \"Rate\"\n },\n {\n \"carrier_account_id\": \"ca_f09befdb2e9c410e95c7622ea912c18c\",\n \"list_rate\": \"6.57\",\n \"created_at\": \"2025-06-16T17:45:33Z\",\n \"delivery_days\": 3.0,\n \"list_currency\": \"USD\",\n \"shipment_id\": \"shp_5571541b585f4e6c832beebed7396fcc\",\n \"mode\": \"test\",\n \"carrier\": \"USPS\",\n \"delivery_date\": null,\n \"delivery_date_guaranteed\": false,\n \"retail_rate\": \"8.85\",\n \"retail_currency\": \"USD\",\n \"updated_at\": \"2025-06-16T17:45:33Z\",\n \"rate\": \"6.07\",\n \"service\": \"GroundAdvantage\",\n \"billing_type\": \"easypost\",\n \"est_delivery_days\": 3.0,\n \"currency\": \"USD\",\n \"id\": \"rate_b84d7ad131c240279e4c9ed023b8440d\",\n \"object\": \"Rate\"\n }\n ],\n \"scan_form\": null,\n \"to_address\": {\n \"zip\": \"90277\",\n \"country\": \"US\",\n \"city\": \"Redondo Beach\",\n \"created_at\": \"2025-06-16T17:45:32+00:00\",\n \"verifications\": {},\n \"mode\": \"test\",\n \"federal_tax_id\": null,\n \"state_tax_id\": null,\n \"carrier_facility\": null,\n \"residential\": null,\n \"updated_at\": \"2025-06-16T17:45:32+00:00\",\n \"phone\": \"REDACTED\",\n \"name\": \"Elizabeth Swan\",\n \"company\": null,\n \"street1\": \"179 N Harbor Dr\",\n \"id\": \"adr_b38dfaae4ad911f0abb8ac1f6bc539aa\",\n \"street2\": null,\n \"state\": \"CA\",\n \"email\": \"test@example.com\",\n \"object\": \"Address\"\n },\n \"tracking_code\": null,\n \"messages\": [],\n \"order_id\": null,\n \"forms\": [],\n \"status\": \"unknown\",\n \"object\": \"Shipment\"\n}", + "httpVersion": null, + "headers": { + "null": [ + "HTTP/1.1 201 Created" + ], + "content-length": [ + "4325" + ], + "expires": [ + "0" + ], + "x-node": [ + "bigweb56nuq" + ], + "x-frame-options": [ + "SAMEORIGIN" + ], + "x-download-options": [ + "noopen" + ], + "x-permitted-cross-domain-policies": [ + "none" + ], + "x-backend": [ + "easypost" + ], + "pragma": [ + "no-cache" + ], + "strict-transport-security": [ + "max-age\u003d31536000; includeSubDomains; preload" + ], + "x-xss-protection": [ + "1; mode\u003dblock" + ], + "x-content-type-options": [ + "nosniff" + ], + "x-ep-request-uuid": [ + "afd263fa6850583ce2baa979006f9a3b" + ], + "x-proxied": [ + "intlb3nuq ec99f2d065", + "extlb2nuq 99aac35317" + ], + "referrer-policy": [ + "strict-origin-when-cross-origin" + ], + "x-runtime": [ + "0.268752" + ], + "location": [ + "/api/v2/shipments/shp_5571541b585f4e6c832beebed7396fcc" + ], + "content-type": [ + "application/json; charset\u003dutf-8" + ], + "x-version-label": [ + "easypost-202506161725-4166f0359d-master" + ], + "cache-control": [ + "private, no-cache, no-store" + ] + }, + "status": { + "code": 201, + "message": "Created" + }, + "uri": "https://api.easypost.com/v2/shipments" + }, + "duration": 389 + }, + { + "recordedAt": 1750095934, + "request": { + "body": "{\n \"planned_ship_date\": \"2025-06-16\",\n \"ruleset_name\": \"cheapest_delivery\"\n}", + "method": "POST", + "headers": { + "Accept-Charset": [ + "UTF-8" + ], + "User-Agent": [ + "REDACTED" + ], + "Content-Type": [ + "application/json" + ] + }, + "uri": "https://api.easypost.com/v2/shipments/shp_5571541b585f4e6c832beebed7396fcc/luma" + }, + "response": { + "body": "{\n \"insurance\": \"50.00\",\n \"fees\": [\n {\n \"amount\": \"0.00000\",\n \"refunded\": false,\n \"type\": \"LabelFee\",\n \"charged\": true,\n \"object\": \"Fee\"\n },\n {\n \"amount\": \"6.07000\",\n \"refunded\": false,\n \"type\": \"PostageFee\",\n \"charged\": true,\n \"object\": \"Fee\"\n },\n {\n \"amount\": \"0.50000\",\n \"refunded\": false,\n \"type\": \"InsuranceFee\",\n \"charged\": true,\n \"object\": \"Fee\"\n }\n ],\n \"batch_id\": null,\n \"batch_message\": null,\n \"batch_status\": null,\n \"created_at\": \"2025-06-16T17:45:32Z\",\n \"tax_identifiers\": null,\n \"mode\": \"test\",\n \"reference\": null,\n \"luma_info\": {\n \"matching_rule_idx\": 0.0,\n \"ruleset_description\": \"Buy the cheapest rate that satisfies all of the following:\\nRule 0\\n \\nOtherwise buy the cheapest rate\",\n \"ai_results\": [\n {\n \"meets_ruleset_requirements\": true,\n \"carrier\": \"USPS\",\n \"rate_id\": \"rate_22cbea381a6840479dfd708d12d15c27\",\n \"predicted_deliver_by_date\": \"2025-06-17\",\n \"service\": \"Express\",\n \"rate_usd\": \"34.15\",\n \"predicted_deliver_days\": 1.0\n },\n {\n \"meets_ruleset_requirements\": true,\n \"carrier\": \"USPS\",\n \"rate_id\": \"rate_28560fbf722f44e69677eb8ec43da58a\",\n \"predicted_deliver_by_date\": \"2025-06-18\",\n \"service\": \"Priority\",\n \"rate_usd\": \"7.42\",\n \"predicted_deliver_days\": 2.0\n },\n {\n \"meets_ruleset_requirements\": true,\n \"carrier\": \"USPS\",\n \"rate_id\": \"rate_b84d7ad131c240279e4c9ed023b8440d\",\n \"predicted_deliver_by_date\": \"2025-06-19\",\n \"service\": \"GroundAdvantage\",\n \"rate_usd\": \"6.07\",\n \"predicted_deliver_days\": 3.0\n }\n ]\n },\n \"usps_zone\": 4.0,\n \"is_return\": null,\n \"selected_rate\": {\n \"carrier_account_id\": \"ca_f09befdb2e9c410e95c7622ea912c18c\",\n \"list_rate\": \"6.57\",\n \"created_at\": \"2025-06-16T17:45:34Z\",\n \"delivery_days\": 3.0,\n \"list_currency\": \"USD\",\n \"shipment_id\": \"shp_5571541b585f4e6c832beebed7396fcc\",\n \"mode\": \"test\",\n \"carrier\": \"USPS\",\n \"delivery_date\": null,\n \"delivery_date_guaranteed\": false,\n \"retail_rate\": \"8.85\",\n \"retail_currency\": \"USD\",\n \"updated_at\": \"2025-06-16T17:45:34Z\",\n \"rate\": \"6.07\",\n \"service\": \"GroundAdvantage\",\n \"billing_type\": \"easypost\",\n \"est_delivery_days\": 3.0,\n \"currency\": \"USD\",\n \"id\": \"rate_b84d7ad131c240279e4c9ed023b8440d\",\n \"object\": \"Rate\"\n },\n \"updated_at\": \"2025-06-16T17:45:34Z\",\n \"return_address\": {\n \"zip\": \"94107\",\n \"country\": \"US\",\n \"city\": \"San Francisco\",\n \"created_at\": \"2025-06-16T17:45:32+00:00\",\n \"verifications\": {},\n \"mode\": \"test\",\n \"federal_tax_id\": null,\n \"state_tax_id\": null,\n \"carrier_facility\": null,\n \"residential\": null,\n \"updated_at\": \"2025-06-16T17:45:32+00:00\",\n \"phone\": \"REDACTED\",\n \"name\": \"Jack Sparrow\",\n \"company\": null,\n \"street1\": \"388 Townsend St\",\n \"id\": \"adr_b390dd994ad911f0abbfac1f6bc539aa\",\n \"street2\": \"Apt 20\",\n \"state\": \"CA\",\n \"email\": \"test@example.com\",\n \"object\": \"Address\"\n },\n \"options\": {\n \"date_advance\": 0.0,\n \"currency\": \"USD\",\n \"payment\": {\n \"type\": \"SENDER\"\n }\n },\n \"tracker\": {\n \"fees\": [],\n \"carrier_detail\": null,\n \"created_at\": \"2025-06-16T17:45:34Z\",\n \"weight\": null,\n \"tracking_details\": [],\n \"shipment_id\": \"shp_5571541b585f4e6c832beebed7396fcc\",\n \"tracking_code\": \"9400100208303109991627\",\n \"status_detail\": \"unknown\",\n \"mode\": \"test\",\n \"public_url\": \"https://track.easypost.com/djE6dHJrX2Q0YWIyZTM2MjI3NjRhNTdiYjM2OGZkZGQ5OThlNWE1\",\n \"est_delivery_date\": null,\n \"carrier\": \"USPS\",\n \"updated_at\": \"2025-06-16T17:45:34Z\",\n \"signed_by\": null,\n \"id\": \"trk_d4ab2e3622764a57bb368fddd998e5a5\",\n \"object\": \"Tracker\",\n \"status\": \"unknown\"\n },\n \"id\": \"shp_5571541b585f4e6c832beebed7396fcc\",\n \"from_address\": {\n \"zip\": \"94107\",\n \"country\": \"US\",\n \"city\": \"San Francisco\",\n \"created_at\": \"2025-06-16T17:45:32+00:00\",\n \"verifications\": {},\n \"mode\": \"test\",\n \"federal_tax_id\": null,\n \"state_tax_id\": null,\n \"carrier_facility\": null,\n \"residential\": null,\n \"updated_at\": \"2025-06-16T17:45:32+00:00\",\n \"phone\": \"REDACTED\",\n \"name\": \"Jack Sparrow\",\n \"company\": null,\n \"street1\": \"388 Townsend St\",\n \"id\": \"adr_b390dd994ad911f0abbfac1f6bc539aa\",\n \"street2\": \"Apt 20\",\n \"state\": \"CA\",\n \"email\": \"test@example.com\",\n \"object\": \"Address\"\n },\n \"customs_info\": null,\n \"postage_label\": {\n \"label_resolution\": 300.0,\n \"date_advance\": 0.0,\n \"label_size\": \"4x6\",\n \"integrated_form\": \"none\",\n \"label_pdf_url\": null,\n \"created_at\": \"2025-06-16T17:45:34Z\",\n \"label_type\": \"default\",\n \"label_url\": \"https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20250616/e81214e9e5fce34674a2a22e8e74f214bd.png\",\n \"label_file\": null,\n \"label_epl2_url\": null,\n \"label_file_type\": \"image/png\",\n \"updated_at\": \"2025-06-16T17:45:34Z\",\n \"id\": \"pl_d6da6de57d8d4c5e9dde46d54a24e523\",\n \"label_zpl_url\": null,\n \"label_date\": \"2025-06-16T17:45:34Z\",\n \"object\": \"PostageLabel\"\n },\n \"parcel\": {\n \"mode\": \"test\",\n \"updated_at\": \"2025-06-16T17:45:32Z\",\n \"predefined_package\": null,\n \"length\": 10.0,\n \"width\": 8.0,\n \"created_at\": \"2025-06-16T17:45:32Z\",\n \"weight\": 15.4,\n \"id\": \"prcl_a7f70c36a6514c54906327289d5c9173\",\n \"object\": \"Parcel\",\n \"height\": 4.0\n },\n \"buyer_address\": {\n \"zip\": \"90277-2506\",\n \"country\": \"US\",\n \"city\": \"REDONDO BEACH\",\n \"created_at\": \"2025-06-16T17:45:32+00:00\",\n \"verifications\": {\n \"delivery\": {\n \"success\": true,\n \"details\": {\n \"latitude\": 33.8436,\n \"time_zone\": \"America/Los_Angeles\",\n \"longitude\": -118.39177\n },\n \"errors\": []\n },\n \"zip4\": {\n \"success\": true,\n \"details\": null,\n \"errors\": []\n }\n },\n \"mode\": \"test\",\n \"federal_tax_id\": null,\n \"state_tax_id\": null,\n \"carrier_facility\": null,\n \"residential\": false,\n \"updated_at\": \"2025-06-16T17:45:33+00:00\",\n \"phone\": \"REDACTED\",\n \"name\": \"ELIZABETH SWAN\",\n \"company\": null,\n \"street1\": \"179 N HARBOR DR\",\n \"id\": \"adr_b38dfaae4ad911f0abb8ac1f6bc539aa\",\n \"street2\": \"\",\n \"state\": \"CA\",\n \"email\": \"TEST@EXAMPLE.COM\",\n \"object\": \"Address\"\n },\n \"refund_status\": null,\n \"rates\": [\n {\n \"carrier_account_id\": \"ca_f09befdb2e9c410e95c7622ea912c18c\",\n \"list_rate\": \"34.15\",\n \"created_at\": \"2025-06-16T17:45:33Z\",\n \"delivery_days\": 1.0,\n \"list_currency\": \"USD\",\n \"shipment_id\": \"shp_5571541b585f4e6c832beebed7396fcc\",\n \"mode\": \"test\",\n \"carrier\": \"USPS\",\n \"delivery_date\": null,\n \"delivery_date_guaranteed\": false,\n \"retail_rate\": \"39.10\",\n \"retail_currency\": \"USD\",\n \"updated_at\": \"2025-06-16T17:45:33Z\",\n \"rate\": \"34.15\",\n \"service\": \"Express\",\n \"billing_type\": \"easypost\",\n \"est_delivery_days\": 1.0,\n \"currency\": \"USD\",\n \"id\": \"rate_22cbea381a6840479dfd708d12d15c27\",\n \"object\": \"Rate\"\n },\n {\n \"carrier_account_id\": \"ca_f09befdb2e9c410e95c7622ea912c18c\",\n \"list_rate\": \"8.34\",\n \"created_at\": \"2025-06-16T17:45:33Z\",\n \"delivery_days\": 2.0,\n \"list_currency\": \"USD\",\n \"shipment_id\": \"shp_5571541b585f4e6c832beebed7396fcc\",\n \"mode\": \"test\",\n \"carrier\": \"USPS\",\n \"delivery_date\": null,\n \"delivery_date_guaranteed\": false,\n \"retail_rate\": \"9.90\",\n \"retail_currency\": \"USD\",\n \"updated_at\": \"2025-06-16T17:45:33Z\",\n \"rate\": \"7.42\",\n \"service\": \"Priority\",\n \"billing_type\": \"easypost\",\n \"est_delivery_days\": 2.0,\n \"currency\": \"USD\",\n \"id\": \"rate_28560fbf722f44e69677eb8ec43da58a\",\n \"object\": \"Rate\"\n },\n {\n \"carrier_account_id\": \"ca_f09befdb2e9c410e95c7622ea912c18c\",\n \"list_rate\": \"6.57\",\n \"created_at\": \"2025-06-16T17:45:33Z\",\n \"delivery_days\": 3.0,\n \"list_currency\": \"USD\",\n \"shipment_id\": \"shp_5571541b585f4e6c832beebed7396fcc\",\n \"mode\": \"test\",\n \"carrier\": \"USPS\",\n \"delivery_date\": null,\n \"delivery_date_guaranteed\": false,\n \"retail_rate\": \"8.85\",\n \"retail_currency\": \"USD\",\n \"updated_at\": \"2025-06-16T17:45:33Z\",\n \"rate\": \"6.07\",\n \"service\": \"GroundAdvantage\",\n \"billing_type\": \"easypost\",\n \"est_delivery_days\": 3.0,\n \"currency\": \"USD\",\n \"id\": \"rate_b84d7ad131c240279e4c9ed023b8440d\",\n \"object\": \"Rate\"\n }\n ],\n \"scan_form\": null,\n \"to_address\": {\n \"zip\": \"90277-2506\",\n \"country\": \"US\",\n \"city\": \"REDONDO BEACH\",\n \"created_at\": \"2025-06-16T17:45:32+00:00\",\n \"verifications\": {\n \"delivery\": {\n \"success\": true,\n \"details\": {\n \"latitude\": 33.8436,\n \"time_zone\": \"America/Los_Angeles\",\n \"longitude\": -118.39177\n },\n \"errors\": []\n },\n \"zip4\": {\n \"success\": true,\n \"details\": null,\n \"errors\": []\n }\n },\n \"mode\": \"test\",\n \"federal_tax_id\": null,\n \"state_tax_id\": null,\n \"carrier_facility\": null,\n \"residential\": false,\n \"updated_at\": \"2025-06-16T17:45:33+00:00\",\n \"phone\": \"REDACTED\",\n \"name\": \"ELIZABETH SWAN\",\n \"company\": null,\n \"street1\": \"179 N HARBOR DR\",\n \"id\": \"adr_b38dfaae4ad911f0abb8ac1f6bc539aa\",\n \"street2\": \"\",\n \"state\": \"CA\",\n \"email\": \"TEST@EXAMPLE.COM\",\n \"object\": \"Address\"\n },\n \"tracking_code\": \"9400100208303109991627\",\n \"messages\": [],\n \"forms\": [],\n \"object\": \"Shipment\",\n \"status\": \"unknown\"\n}", + "httpVersion": null, + "headers": { + "null": [ + "HTTP/1.1 200 OK" + ], + "content-length": [ + "7367" + ], + "expires": [ + "0" + ], + "x-node": [ + "bigweb35nuq" + ], + "x-frame-options": [ + "SAMEORIGIN" + ], + "x-download-options": [ + "noopen" + ], + "x-permitted-cross-domain-policies": [ + "none" + ], + "x-backend": [ + "easypost" + ], + "pragma": [ + "no-cache" + ], + "strict-transport-security": [ + "max-age\u003d31536000; includeSubDomains; preload" + ], + "x-xss-protection": [ + "1; mode\u003dblock" + ], + "x-content-type-options": [ + "nosniff" + ], + "x-ep-request-uuid": [ + "afd263fe6850583de2baa97b006f9acd" + ], + "x-proxied": [ + "intlb4nuq ec99f2d065", + "extlb2nuq 99aac35317" + ], + "referrer-policy": [ + "strict-origin-when-cross-origin" + ], + "x-runtime": [ + "1.367404" + ], + "content-type": [ + "application/json; charset\u003dutf-8" + ], + "x-version-label": [ + "easypost-202506161725-4166f0359d-master" + ], + "cache-control": [ + "private, no-cache, no-store" + ] + }, + "status": { + "code": 200, + "message": "OK" + }, + "uri": "https://api.easypost.com/v2/shipments/shp_5571541b585f4e6c832beebed7396fcc/luma" + }, + "duration": 1472 + } +] \ No newline at end of file diff --git a/src/test/cassettes/shipment/create_and_buy_luma.json b/src/test/cassettes/shipment/create_and_buy_luma.json new file mode 100644 index 000000000..b81335d2d --- /dev/null +++ b/src/test/cassettes/shipment/create_and_buy_luma.json @@ -0,0 +1,91 @@ +[ + { + "recordedAt": 1750095937, + "request": { + "body": "{\n \"shipment\": {\n \"parcel\": {\n \"length\": 10.0,\n \"width\": 8.0,\n \"weight\": 15.4,\n \"height\": 4.0\n },\n \"carrier\": \"USPS\",\n \"planned_ship_date\": \"2025-06-16\",\n \"to_address\": {\n \"zip\": \"94107\",\n \"country\": \"US\",\n \"city\": \"San Francisco\",\n \"phone\": \"REDACTED\",\n \"name\": \"Jack Sparrow\",\n \"street1\": \"388 Townsend St\",\n \"street2\": \"Apt 20\",\n \"state\": \"CA\",\n \"email\": \"test@example.com\"\n },\n \"carrier_accounts\": [\n \"ca_f09befdb2e9c410e95c7622ea912c18c\"\n ],\n \"from_address\": {\n \"zip\": \"90277\",\n \"country\": \"US\",\n \"city\": \"Redondo Beach\",\n \"phone\": \"REDACTED\",\n \"name\": \"Elizabeth Swan\",\n \"street1\": \"179 N Harbor Dr\",\n \"state\": \"CA\",\n \"email\": \"test@example.com\"\n },\n \"ruleset_name\": \"cheapest_delivery\"\n }\n}", + "method": "POST", + "headers": { + "Accept-Charset": [ + "UTF-8" + ], + "User-Agent": [ + "REDACTED" + ], + "Content-Type": [ + "application/json" + ] + }, + "uri": "https://api.easypost.com/v2/shipments/luma" + }, + "response": { + "body": "{\n \"customs_info\": null,\n \"insurance\": \"50.00\",\n \"postage_label\": {\n \"label_resolution\": 300.0,\n \"date_advance\": 0.0,\n \"label_size\": \"4x6\",\n \"integrated_form\": \"none\",\n \"label_pdf_url\": null,\n \"created_at\": \"2025-06-16T17:45:37Z\",\n \"label_type\": \"default\",\n \"label_url\": null,\n \"label_file\": \"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\",\n \"label_epl2_url\": null,\n \"label_file_type\": null,\n \"updated_at\": \"2025-06-16T17:45:37Z\",\n \"id\": \"pl_40234f8c82284c89b68ddb4661ca345d\",\n \"label_zpl_url\": null,\n \"label_date\": \"2025-06-16T17:45:37Z\",\n \"object\": \"PostageLabel\"\n },\n \"parcel\": {\n \"mode\": \"test\",\n \"updated_at\": \"2025-06-16T17:45:36Z\",\n \"predefined_package\": null,\n \"length\": 10.0,\n \"width\": 8.0,\n \"created_at\": \"2025-06-16T17:45:36Z\",\n \"weight\": 15.4,\n \"id\": \"prcl_95ead285a19c41c78096ce53f9a65ea9\",\n \"object\": \"Parcel\",\n \"height\": 4.0\n },\n \"fees\": [\n {\n \"amount\": \"0.00000\",\n \"refunded\": false,\n \"type\": \"LabelFee\",\n \"charged\": true,\n \"object\": \"Fee\"\n },\n {\n \"amount\": \"6.07000\",\n \"refunded\": false,\n \"type\": \"PostageFee\",\n \"charged\": true,\n \"object\": \"Fee\"\n },\n {\n \"amount\": \"0.50000\",\n \"refunded\": false,\n \"type\": \"InsuranceFee\",\n \"charged\": true,\n \"object\": \"Fee\"\n }\n ],\n \"created_at\": \"2025-06-16T17:45:36Z\",\n \"to_address\": {\n \"zip\": \"94107-1670\",\n \"country\": \"US\",\n \"city\": \"SAN FRANCISCO\",\n \"created_at\": \"2025-06-16T17:45:36+00:00\",\n \"verifications\": {\n \"delivery\": {\n \"success\": true,\n \"details\": {\n \"latitude\": 37.77551,\n \"time_zone\": \"America/Los_Angeles\",\n \"longitude\": -122.39697\n },\n \"errors\": []\n },\n \"zip4\": {\n \"success\": true,\n \"details\": null,\n \"errors\": []\n }\n },\n \"mode\": \"test\",\n \"federal_tax_id\": null,\n \"state_tax_id\": null,\n \"carrier_facility\": null,\n \"residential\": true,\n \"updated_at\": \"2025-06-16T17:45:36+00:00\",\n \"phone\": \"REDACTED\",\n \"name\": \"JACK SPARROW\",\n \"company\": null,\n \"street1\": \"388 TOWNSEND ST APT 20\",\n \"id\": \"adr_b5c8d3b64ad911f0aec9ac1f6bc539aa\",\n \"street2\": \"\",\n \"state\": \"CA\",\n \"email\": \"TEST@EXAMPLE.COM\",\n \"object\": \"Address\"\n },\n \"tracking_code\": \"9400100208303109991634\",\n \"tax_identifiers\": null,\n \"mode\": \"test\",\n \"reference\": null,\n \"luma_info\": {\n \"matching_rule_idx\": 0.0,\n \"ruleset_description\": \"Buy the cheapest rate that satisfies all of the following:\\nRule 0\\n \\nOtherwise buy the cheapest rate\",\n \"ai_results\": [\n {\n \"meets_ruleset_requirements\": true,\n \"carrier\": \"USPS\",\n \"rate_id\": \"rate_4f2d82d062404510a5014ecda00128df\",\n \"predicted_deliver_by_date\": \"2025-06-19\",\n \"service\": \"Priority\",\n \"rate_usd\": \"7.42\",\n \"predicted_deliver_days\": 3.0\n },\n {\n \"meets_ruleset_requirements\": true,\n \"carrier\": \"USPS\",\n \"rate_id\": \"rate_03a8866aefc94098b0749f91671f981e\",\n \"predicted_deliver_by_date\": \"2025-06-19\",\n \"service\": \"GroundAdvantage\",\n \"rate_usd\": \"6.07\",\n \"predicted_deliver_days\": 3.0\n },\n {\n \"meets_ruleset_requirements\": true,\n \"carrier\": \"USPS\",\n \"rate_id\": \"rate_b51c7bddfdd4464288c2e85fc5263f5a\",\n \"predicted_deliver_by_date\": \"2025-06-17\",\n \"service\": \"Express\",\n \"rate_usd\": \"34.15\",\n \"predicted_deliver_days\": 1.0\n }\n ]\n },\n \"selected_rate\": {\n \"carrier_account_id\": \"ca_f09befdb2e9c410e95c7622ea912c18c\",\n \"list_rate\": \"6.57\",\n \"created_at\": \"2025-06-16T17:45:37Z\",\n \"delivery_days\": 3.0,\n \"list_currency\": \"USD\",\n \"shipment_id\": \"shp_a4398d9b962c434496bfdba2a0d7ca6a\",\n \"mode\": \"test\",\n \"carrier\": \"USPS\",\n \"delivery_date\": null,\n \"delivery_date_guaranteed\": false,\n \"retail_rate\": \"8.85\",\n \"retail_currency\": \"USD\",\n \"updated_at\": \"2025-06-16T17:45:37Z\",\n \"rate\": \"6.07\",\n \"service\": \"GroundAdvantage\",\n \"billing_type\": \"easypost\",\n \"est_delivery_days\": 3.0,\n \"currency\": \"USD\",\n \"id\": \"rate_18f9606c7e274ddda005a2c6aba6fdfa\",\n \"object\": \"Rate\"\n },\n \"updated_at\": \"2025-06-16T17:45:37Z\",\n \"messages\": [],\n \"id\": \"shp_a4398d9b962c434496bfdba2a0d7ca6a\",\n \"from_address\": {\n \"zip\": \"90277\",\n \"country\": \"US\",\n \"city\": \"Redondo Beach\",\n \"created_at\": \"2025-06-16T17:45:36+00:00\",\n \"verifications\": {},\n \"mode\": \"test\",\n \"federal_tax_id\": null,\n \"state_tax_id\": null,\n \"carrier_facility\": null,\n \"residential\": null,\n \"updated_at\": \"2025-06-16T17:45:36+00:00\",\n \"phone\": \"REDACTED\",\n \"name\": \"Elizabeth Swan\",\n \"company\": null,\n \"street1\": \"179 N Harbor Dr\",\n \"id\": \"adr_b5cb171d4ad911f0aeceac1f6bc539aa\",\n \"street2\": null,\n \"state\": \"CA\",\n \"email\": \"test@example.com\",\n \"object\": \"Address\"\n },\n \"forms\": [],\n \"object\": \"Shipment\"\n}", + "httpVersion": null, + "headers": { + "null": [ + "HTTP/1.1 200 OK" + ], + "content-length": [ + "72561" + ], + "expires": [ + "0" + ], + "x-node": [ + "bigweb39nuq" + ], + "x-frame-options": [ + "SAMEORIGIN" + ], + "x-download-options": [ + "noopen" + ], + "x-permitted-cross-domain-policies": [ + "none" + ], + "x-backend": [ + "easypost" + ], + "pragma": [ + "no-cache" + ], + "strict-transport-security": [ + "max-age\u003d31536000; includeSubDomains; preload" + ], + "x-xss-protection": [ + "1; mode\u003dblock" + ], + "x-content-type-options": [ + "nosniff" + ], + "x-ep-request-uuid": [ + "afd263ff68505840e2baa9c1006f9f1d" + ], + "x-proxied": [ + "intlb4nuq ec99f2d065", + "extlb2nuq 99aac35317" + ], + "referrer-policy": [ + "strict-origin-when-cross-origin" + ], + "x-runtime": [ + "0.833157" + ], + "content-type": [ + "application/json; charset\u003dutf-8" + ], + "x-version-label": [ + "easypost-202506161725-4166f0359d-master" + ], + "cache-control": [ + "private, no-cache, no-store" + ] + }, + "status": { + "code": 200, + "message": "OK" + }, + "uri": "https://api.easypost.com/v2/shipments/luma" + }, + "duration": 947 + } +] \ No newline at end of file diff --git a/src/test/java/com/easypost/Fixtures.java b/src/test/java/com/easypost/Fixtures.java index 9608649bd..a3a1b0546 100644 --- a/src/test/java/com/easypost/Fixtures.java +++ b/src/test/java/com/easypost/Fixtures.java @@ -382,4 +382,22 @@ public static String desiredDeliveryDate() { public static Billing billing() { return Objects.requireNonNull(getFixtureData()).billing; } + + /** + * Get the Luma ruleset name fixture data. + * + * @return The Luma ruleset name fixture data + */ + public static String lumaRulesetName() { + return Objects.requireNonNull(getFixtureData()).luma.rulesetName; + } + + /** + * Get the Luma planned ship date fixture data. + * + * @return The Luma planned ship date fixture data + */ + public static String lumaPlannedShipDate() { + return "2025-06-16"; + } } diff --git a/src/test/java/com/easypost/LumaTest.java b/src/test/java/com/easypost/LumaTest.java new file mode 100644 index 000000000..5527abb00 --- /dev/null +++ b/src/test/java/com/easypost/LumaTest.java @@ -0,0 +1,42 @@ +package com.easypost; + +import com.easypost.exception.EasyPostException; +import com.easypost.model.LumaInfo; +import org.junit.jupiter.api.BeforeAll; +import org.junit.jupiter.api.Test; + +import java.util.Map; + +import static org.junit.jupiter.api.Assertions.assertNotNull; + +public final class LumaTest { + private static TestUtils.VCR vcr; + + /** + * Set up the testing environment for this file. + * + * @throws EasyPostException when the request fails. + */ + @BeforeAll + public static void setup() throws EasyPostException { + vcr = new TestUtils.VCR("luma", TestUtils.ApiKey.TEST); + } + + /** + * Test that we get service recommendations from Luma based on your ruleset. + * + * @throws EasyPostException when the request fails. + */ + @Test + public void testGetPromise() throws EasyPostException { + vcr.setUpTest("get_promise"); + + Map shipmentData = Fixtures.basicShipment(); + shipmentData.put("ruleset_name", Fixtures.lumaRulesetName()); + shipmentData.put("planned_ship_date", Fixtures.lumaPlannedShipDate()); + + LumaInfo response = vcr.client.luma.getPromise(shipmentData); + + assertNotNull(response.getLumaSelectedRate()); + } +} diff --git a/src/test/java/com/easypost/ShipmentTest.java b/src/test/java/com/easypost/ShipmentTest.java index e7be8ee88..18360718a 100644 --- a/src/test/java/com/easypost/ShipmentTest.java +++ b/src/test/java/com/easypost/ShipmentTest.java @@ -725,4 +725,46 @@ public void testRetrieveRecommendDate() throws EasyPostException { assertNotNull(estimatedDeliveryDate.getEasypostTimeInTransitData()); } } + + /** + * Test that we create and buy a Shipment with Luma. + * + * @throws EasyPostException when the request fails. + */ + @Test + public void testCreateAndBuyLuma() throws EasyPostException { + vcr.setUpTest("create_and_buy_luma"); + + Map shipmentData = Fixtures.oneCallBuyShipment(); + shipmentData.remove("service"); + shipmentData.put("ruleset_name", Fixtures.lumaRulesetName()); + shipmentData.put("planned_ship_date", Fixtures.lumaPlannedShipDate()); + + Shipment shipment = vcr.client.shipment.createAndBuyLuma(shipmentData); + + assertNotNull(shipment.getPostageLabel()); + } + + /** + * Test that we buy a Shipment with Luma. + * + * @throws EasyPostException when the request fails. + */ + @Test + public void testBuyLuma() throws EasyPostException { + vcr.setUpTest("buy_luma"); + + Shipment shipment = vcr.client.shipment.create(Fixtures.basicShipment()); + + Map params = new HashMap(); + params.put("ruleset_name", Fixtures.lumaRulesetName()); + params.put("planned_ship_date", Fixtures.lumaPlannedShipDate()); + + Shipment boughtShipment = vcr.client.shipment.buyLuma( + shipment.getId(), + params + ); + + assertNotNull(boughtShipment.getPostageLabel()); + } } diff --git a/src/test/java/com/easypost/fixtures/FixtureStructure.java b/src/test/java/com/easypost/fixtures/FixtureStructure.java index 9f7c2ace1..ea4fc94b9 100644 --- a/src/test/java/com/easypost/fixtures/FixtureStructure.java +++ b/src/test/java/com/easypost/fixtures/FixtureStructure.java @@ -10,6 +10,7 @@ import com.easypost.fixtures.components.CustomsItems; import com.easypost.fixtures.components.FormOptions; import com.easypost.fixtures.components.Insurances; +import com.easypost.fixtures.components.Luma; import com.easypost.fixtures.components.Orders; import com.easypost.fixtures.components.PageSizes; import com.easypost.fixtures.components.Parcels; @@ -54,6 +55,9 @@ public final class FixtureStructure { @SerializedName ("insurances") public Insurances insurances; + @SerializedName ("luma") + public Luma luma; + @SerializedName ("orders") public Orders orders; diff --git a/src/test/java/com/easypost/fixtures/components/Luma.java b/src/test/java/com/easypost/fixtures/components/Luma.java new file mode 100644 index 000000000..d79be36ce --- /dev/null +++ b/src/test/java/com/easypost/fixtures/components/Luma.java @@ -0,0 +1,9 @@ +package com.easypost.fixtures.components; + +import com.google.gson.annotations.SerializedName; + +public final class Luma { + @SerializedName ("ruleset_name") + public String rulesetName; + +}