@shipengine/connect-carrier-api 4.1.0 → 4.1.1

package/lib/models/importer-records/importer-of-record.d.ts

@@ -8,7 +8,7 @@ export declare class ImporterOfRecord {
     /** @description Indicates Company Name of the owner or purchaser of the products being imported into a destination country*/
     company_name?: string;
     /** @description Indicates address line one of the owner or purchaser of the products being imported into a destination country*/
-    address_line1: string;
+    address_line1?: string;
     /** @description Indicates address  of the owner or purchaser of the products being imported into a destination country*/
     address_line2?: string;
     /** @description Indicates City  or Locality  of the owner or purchaser of the products being imported into a destination country */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipengine/connect-carrier-api",
-  "version": "4.1.0",
+  "version": "4.1.1",
   "description": "This is the typescript/javascript definitions for carrier api",
   "homepage": "https://connect.shipengine.com",
   "main": "./lib/index.js",
@@ -34,6 +34,7 @@
     "@types/sanitize-html": "^2.6.2",
     "prettier": "^2.8.8",
     "typescript": "^4.9.5",
+    "vite": "^4.3.9",
     "vitest": "^0.23.4"
   },
   "optionalDependencies": {

package/spec.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "Shipping API",
     "description": "This API specification describes the canonical ShipEngine Shipping API connector module.",
-    "version": "1.17.3"
+    "version": "1.18.1"
   },
   "paths": {
     "/Register": {
@@ -576,7 +576,7 @@
         "tags": [
           "Tracking"
         ],
-        "description": "This method returns imported tracking events for a connection, and should only be implemented if you support\r\nimporting tracking data in bulk via file exchange or API requests.\r\n            \r\nAny information needed to retrieve tracking data for a connection should be collected in your registration\r\nform and will be made available as metadata in the request.",
+        "description": "This method should yield imported tracking events for a connection. It should\r\nonly be implemented if you support importing tracking data in bulk via file\r\nexchange or API requests.\r\nAny information needed to retrieve tracking data for a connection should be\r\ncollected in your registration form and will be made available as metadata in\r\nthe request.\r\nSee the [Tracking Overview](https://connect.shipengine.com/shipping/tracking/)\r\nfor implementation details.",
         "operationId": "ImportTrackingEvents",
         "requestBody": {
           "description": "An object containing information about the connection to import tracking events for.",
@@ -604,6 +604,37 @@
           }
         }
       }
+    },
+    "/ValidateShipment": {
+      "post": {
+        "tags": [
+          "Validations"
+        ],
+        "description": "This method validates a shipment against carrier constraints for selected service.",
+        "operationId": "ValidateShipment",
+        "requestBody": {
+          "description": "An object containing information about the shipment and selected services to validate.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ValidateShipmentRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "This object model represents the response from a successful validate shipment request.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ValidateShipmentResponse"
+                }
+              }
+            }
+          }
+        }
+      }
     }
   },
   "components": {
@@ -819,6 +850,39 @@
         },
         "additionalProperties": false
       },
+      "BillTo": {
+        "required": [
+          "postal_code",
+          "country_code"
+        ],
+        "type": "object",
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/AddressWithContact"
+          }
+        ],
+        "properties": {
+          "bill_to_party": {
+            "$ref": "#/components/schemas/BillToParty"
+          },
+          "account_number": {
+            "type": "string",
+            "description": "Specified if there is an account number associated with the Bill To Party, and the Bill To Party is\r\nnot the account holder.",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Bill to is a generic object used for billing a part of the shipment, duties, taxes, or otherwise to a party\r\nother than the shipper (the shipper is considered the default party responsible).  CarrierApi.Common.Request.CarrierApi.Common.Models.BillTo\r\nextends CarrierApi.Common.Models.Addresses.AddressWithContact since address fields are often required when associating billing to\r\nanother account.  Additionally, this allows for a contact to be specified, if necessary."
+      },
+      "BillToParty": {
+        "enum": [
+          "shipper",
+          "recipient",
+          "third_party_account"
+        ],
+        "type": "string",
+        "description": "The type of party responsible for a given category of charges associated with a shipment, such as shipping charges or import duties."
+      },
       "BillingCategories": {
         "enum": [
           "uncategorized",
@@ -838,7 +902,9 @@
           "oversize",
           "returns",
           "notifications",
-          "tip"
+          "tip",
+          "duties_and_taxes",
+          "brokerage_fee"
         ],
         "type": "string"
       },
@@ -889,76 +955,6 @@
         },
         "additionalProperties": false
       },
-      "BillTo": {
-        "required": [
-          "postal_code",
-          "country_code"
-        ],
-        "type": "object",
-        "allOf": [
-          {
-            "$ref": "#/components/schemas/AddressWithContact"
-          }
-        ],
-        "properties": {
-          "bill_to_party": {
-            "$ref": "#/components/schemas/BillToParty"
-          },
-          "account_number": {
-            "type": "string",
-            "description": "Specified if there is an account number associated with the Bill To Party, and the Bill To Party is\r\nnot the account holder.",
-            "nullable": true
-          }
-        },
-        "additionalProperties": false,
-        "description": "Bill to is a generic object used for billing a part of the shipment, duties, taxes, or otherwise to a party\r\nother than the shipper (the shipper is considered the default party responsible).  CarrierApi.Common.Request.CarrierApi.Common.Models.BillTo\r\nextends CarrierApi.Common.Models.Addresses.AddressWithContact since address fields are often required when associating billing to\r\nanother account.  Additionally, this allows for a contact to be specified, if necessary."
-      },
-      "BillToParty": {
-        "enum": [
-          "shipper",
-          "recipient",
-          "third_party_account"
-        ],
-        "type": "string",
-        "description": "The type of party responsible for a given category of charges associated with a shipment, such as shipping charges or import duties."
-      },
-      "CancellationDetails": {
-        "required": [
-          "reason"
-        ],
-        "type": "object",
-        "properties": {
-          "reason": {
-            "$ref": "#/components/schemas/CancellationReason"
-          },
-          "cancellation_options": {
-            "type": "object",
-            "additionalProperties": {
-              "type": "string"
-            },
-            "description": "Additional properties about the cancellation",
-            "nullable": true
-          },
-          "remarks": {
-            "type": "string",
-            "description": "Remarks about why the customer is cancelling the pickup",
-            "nullable": true
-          }
-        },
-        "additionalProperties": false,
-        "description": "This model contains the explanation of why a user is cancelling a pickup."
-      },
-      "CancellationReason": {
-        "enum": [
-          "other",
-          "not_ready",
-          "cost_too_high",
-          "service_too_slow",
-          "carrier_failed_pickup"
-        ],
-        "type": "string",
-        "description": "An enumeration of common reasons cancellations occur"
-      },
       "CancelNotificationRequest": {
         "required": [
           "transaction_id"
@@ -1092,6 +1088,44 @@
         "additionalProperties": false,
         "description": "This model represents a response for a successful cancel pickup request."
       },
+      "CancellationDetails": {
+        "required": [
+          "reason"
+        ],
+        "type": "object",
+        "properties": {
+          "reason": {
+            "$ref": "#/components/schemas/CancellationReason"
+          },
+          "cancellation_options": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string",
+              "nullable": true
+            },
+            "description": "Additional properties about the cancellation",
+            "nullable": true
+          },
+          "remarks": {
+            "type": "string",
+            "description": "Remarks about why the customer is cancelling the pickup",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "This model contains the explanation of why a user is cancelling a pickup."
+      },
+      "CancellationReason": {
+        "enum": [
+          "other",
+          "not_ready",
+          "cost_too_high",
+          "service_too_slow",
+          "carrier_failed_pickup"
+        ],
+        "type": "string",
+        "description": "An enumeration of common reasons cancellations occur"
+      },
       "CodPaymentType": {
         "enum": [
           "any",
@@ -1821,6 +1855,14 @@
         "additionalProperties": false,
         "description": "This model represents the dimensions for a package represented in its original unit, inches, and centimeters."
       },
+      "DimensionUnit": {
+        "enum": [
+          "inches",
+          "centimeters"
+        ],
+        "type": "string",
+        "description": "This model represents the supported units for dimensions."
+      },
       "Dimensions": {
         "type": "object",
         "properties": {
@@ -1846,14 +1888,6 @@
         "additionalProperties": false,
         "description": "This model represents the measurements for dimensions."
       },
-      "DimensionUnit": {
-        "enum": [
-          "inches",
-          "centimeters"
-        ],
-        "type": "string",
-        "description": "This model represents the supported units for dimensions."
-      },
       "DisplayScheme": {
         "enum": [
           "label",
@@ -2311,6 +2345,18 @@
         "additionalProperties": false,
         "description": "A key value pair, allowing custom properties to be stored."
       },
+      "ImportTrackingEventsRequest": {
+        "required": [
+          "transaction_id"
+        ],
+        "type": "object",
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/BaseRequest"
+          }
+        ],
+        "additionalProperties": false
+      },
       "ImportedTrackingEvent": {
         "type": "object",
         "properties": {
@@ -2405,18 +2451,6 @@
         "additionalProperties": false,
         "description": "Basic structure for a Importer Record"
       },
-      "ImportTrackingEventsRequest": {
-        "required": [
-          "transaction_id"
-        ],
-        "type": "object",
-        "allOf": [
-          {
-            "$ref": "#/components/schemas/BaseRequest"
-          }
-        ],
-        "additionalProperties": false
-      },
       "InboundDataContentTypes": {
         "enum": [
           "tracking"
@@ -3430,6 +3464,29 @@
         "additionalProperties": false,
         "description": "The address that should be displayed as the return address, only if the shipping provider supports\r\nthis functionality."
       },
+      "ShipTo": {
+        "required": [
+          "postal_code",
+          "country_code"
+        ],
+        "type": "object",
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/AddressWithContact"
+          }
+        ],
+        "properties": {
+          "tax_identifiers": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TaxIdentifier"
+            },
+            "description": "Tax IDs associated with the consignee.",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false
+      },
       "ShipmentIdentifier": {
         "type": "object",
         "properties": {
@@ -3548,29 +3605,6 @@
         "additionalProperties": false,
         "description": "This model represents a shipment that has already been shipped, and contains\r\nsummary information about the shipment."
       },
-      "ShipTo": {
-        "required": [
-          "postal_code",
-          "country_code"
-        ],
-        "type": "object",
-        "allOf": [
-          {
-            "$ref": "#/components/schemas/AddressWithContact"
-          }
-        ],
-        "properties": {
-          "tax_identifiers": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/TaxIdentifier"
-            },
-            "description": "Tax IDs associated with the consignee.",
-            "nullable": true
-          }
-        },
-        "additionalProperties": false
-      },
       "StandardizedStatusCodes": {
         "enum": [
           "UN",
@@ -3981,6 +4015,85 @@
         "additionalProperties": false,
         "description": "This model represents the successful response from a validate inbound data request."
       },
+      "ValidateShipmentError": {
+        "type": "object",
+        "properties": {
+          "field_name": {
+            "type": "string",
+            "description": "This is validated field name.",
+            "nullable": true,
+            "example": "ship_to.postal_code"
+          },
+          "field_value": {
+            "type": "string",
+            "description": "This is a validated field value.",
+            "nullable": true,
+            "example": "85001"
+          },
+          "carrier_error_code": {
+            "$ref": "#/components/schemas/ValidationErrorCodes"
+          },
+          "message": {
+            "type": "string",
+            "description": "A user friendly message about this error.",
+            "nullable": true,
+            "example": "Receiver postal code cannot be null"
+          }
+        },
+        "additionalProperties": false,
+        "description": "This model represented a validation error"
+      },
+      "ValidateShipmentRequest": {
+        "required": [
+          "service_code",
+          "ship_datetime",
+          "is_return_label",
+          "is_residential",
+          "packages",
+          "ship_to",
+          "ship_from",
+          "transaction_id"
+        ],
+        "type": "object",
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/CreateLabelRequest"
+          }
+        ],
+        "additionalProperties": false
+      },
+      "ValidateShipmentResponse": {
+        "type": "object",
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/BaseResponse"
+          }
+        ],
+        "properties": {
+          "validation_errors": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ValidateShipmentError"
+            },
+            "description": "This is the validation results list contains list of carrier data constrain issues for requested service.",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "This model represents the successful response from carrier validate shipment data request."
+      },
+      "ValidationErrorCodes": {
+        "enum": [
+          "unspecified",
+          "field_value_required",
+          "invalid_field_value",
+          "invalid_string_length",
+          "invalid_date",
+          "return_label_not_supported"
+        ],
+        "type": "string",
+        "description": "A list of standard validation error identifiers for errors the module can return"
+      },
       "VoidLabelsRequest": {
         "required": [
           "void_requests",
@@ -4185,6 +4298,10 @@
       "name": "Account Setup",
       "description": ""
     },
+    {
+      "name": "Validations",
+      "description": ""
+    },
     {
       "name": "Rating",
       "description": ""

package/src/models/importer-records/importer-of-record.ts

@@ -9,7 +9,7 @@ export class ImporterOfRecord {
   /** @description Indicates Company Name of the owner or purchaser of the products being imported into a destination country*/
   company_name?: string;
   /** @description Indicates address line one of the owner or purchaser of the products being imported into a destination country*/
-  address_line1!: string;
+  address_line1?: string;
   /** @description Indicates address  of the owner or purchaser of the products being imported into a destination country*/
   address_line2?: string;
   /** @description Indicates City  or Locality  of the owner or purchaser of the products being imported into a destination country */