Expand Tax Provider API to include customs information, duties

Author: theromulans

reference/tax_provider.yml

@@ -939,9 +939,21 @@ components:
           default: false
         tax_properties:
           type: array
-          description: Merchants may opt to include additional properties that a tax provider can choose to support, factoring these values into tax calculation.
+          description: Merchants may opt to include additional properties that a tax provider can choose to support, factoring these values into tax calculation. See [Tax Properties API](/docs/rest-management/tax-properties) for more information on configuring tax properties.
           items:
             $ref: '#/components/schemas/request-item-tax-property'
+        customs_information:
+          type: object
+          description: Merchants may opt to include customs information data in the quote request allowing tax providers to supply calculated duties in addition to taxes. See [Customs Information API](/docs/rest-management/shipping/customs-information) for more information on configuring customs information.
+          properties:
+            country_of_origin:
+              type: string
+              description: The country of manufacture, production, or growth represented in ISO 3166-1 alpha-2 format, when available.
+              example: 'AU'
+            hs_code:
+              type: string
+              description: The item's harmonized tariff code for the document's destination country, when available.
+              example: '817355'
       required:
         - id
         - price
@@ -1262,6 +1274,11 @@ components:
           description: Breakdown of the sales taxes that applied to this item.
           items:
             $ref: '#/components/schemas/SalesTax'
+        duties_summary:
+          type: array
+          description: Breakdown of any duties that applied to this item.
+          items:
+            $ref: '#/components/schemas/Duties'
       required:
         - amount_inclusive
         - amount_exclusive
@@ -1301,6 +1318,16 @@ components:
         - rate
         - amount
       x-internal: false
+    Duties:
+      type: object
+      properties:
+        name:
+          type: string
+          description: The human-readable name of this custom duty. May not be empty.
+        amount:
+          type: number
+          format: double
+          description: The absolute amount that the shopper will be charged for this custom duty.
     item_type:
       type: string
       description: |-