CarrierExpanded Data Type

CarrierPrime with embedded shipping zones and their destinations. Use this representation to fetch the full carrier configuration in one call.

Available Since
1.3.0
Properties
Name Type Description
zones array of ShippingZoneExpanded A list of Destination Zones.
localizations array of CarrierLocalized A list of localization objects.
Inherited from Carrier
NameTypeDescription
id number Unique numeric identifier for the carrier.
name string The name of the shipping service as seen by merchants and their customers.
description string The description of the shipping service. For example: Includes tracking and insurance.
phoneRequired boolean Whether the customer must provide a phone number.
moduleProvider ShippingModuleProvider The shipping integration provider used to calculate rates and book shipments for this carrier.
customProvider string Identifier of a custom (non-standard) shipping provider, used when moduleProvider is not set.
premium boolean Whether this carrier offers a premium service level (e.g. express delivery or enhanced handling).
emdorsement string USPS endorsement instruction printed on the label to control undeliverable mail handling.
ddp boolean Whether this carrier delivers Delivered Duty Paid (DDP) — the sender covers import duties and taxes.
showTicketLogo boolean Whether the carrier's logo is printed on the packing slip or production ticket.
customApiUser string API username for direct carrier API integration when using a custom provider.
customApiKey string API key for direct carrier API integration when using a custom provider.
htmlTemplate string Custom HTML template used for carrier-specific label or notification content.
mainCarrier Carrier Parent carrier this carrier is derived from, when this is a sub-carrier or variant of another carrier.
perProduct boolean When true, shipping cost is calculated per ordered product rather than per order.
Used in
GET /accounts/{accountId}/shops/{shopId}/carriers/expanded/{carrierId} response
CarrierExpanded (JSON) 
{
  "carrierExpanded" : {
    "zones" : {
      "carrierZoneExpanded" : [ {
        "destinations" : {
          "carrierDestination" : [ {
            "id" : 12345,
            "country" : { }
          }, {
            "id" : 12345,
            "country" : { }
          } ]
        },
        "prices" : {
          "carrierPrice" : [ {
            "id" : 12345,
            "price" : 5.0,
            "weightLimit" : -1.0,
            "country" : { }
          }, {
            "id" : 12345,
            "price" : 5.0,
            "weightLimit" : -1.0,
            "country" : { }
          } ]
        },
        "id" : 12345,
        "name" : "Western Europe"
      }, {
        "destinations" : {
          "carrierDestination" : [ {
            "id" : 12345,
            "country" : { }
          }, {
            "id" : 12345,
            "country" : { }
          } ]
        },
        "prices" : {
          "carrierPrice" : [ {
            "id" : 12345,
            "price" : 5.0,
            "weightLimit" : -1.0,
            "country" : { }
          }, {
            "id" : 12345,
            "price" : 5.0,
            "weightLimit" : -1.0,
            "country" : { }
          } ]
        },
        "id" : 12345,
        "name" : "Western Europe"
      } ]
    },
    "localizations" : {
      "carrierLocalized" : [ {
        "id" : 12345,
        "name" : "UPS",
        "description" : "...",
        "language" : {
          "id" : 12345,
          "code" : "en",
          "name" : "English"
        }
      }, {
        "id" : 12345,
        "name" : "UPS",
        "description" : "...",
        "language" : {
          "id" : 12345,
          "code" : "en",
          "name" : "English"
        }
      } ]
    },
    "id" : 12345,
    "name" : "UPS",
    "description" : "Standard domestic shipping method",
    "phoneRequired" : true,
    "moduleProvider" : {
      "id" : 12345,
      "name" : "Standard",
      "provider" : "ups",
      "serviceType" : "standard",
      "moduleType" : {
        "id" : 12345,
        "name" : "SPOD"
      }
    },
    "customProvider" : "...",
    "premium" : true,
    "emdorsement" : "...",
    "ddp" : true,
    "showTicketLogo" : true,
    "customApiUser" : "...",
    "customApiKey" : "...",
    "htmlTemplate" : "...",
    "mainCarrier" : {
      "id" : 12345,
      "name" : "UPS",
      "description" : "Standard domestic shipping method",
      "phoneRequired" : true,
      "moduleProvider" : {
        "id" : 12345,
        "name" : "Standard",
        "provider" : "ups",
        "serviceType" : "standard",
        "moduleType" : { }
      },
      "customProvider" : "...",
      "premium" : true,
      "emdorsement" : "...",
      "ddp" : true,
      "showTicketLogo" : true,
      "customApiUser" : "...",
      "customApiKey" : "...",
      "htmlTemplate" : "...",
      "mainCarrier" : { },
      "perProduct" : true
    },
    "perProduct" : true
  }
}
CarrierExpanded Data Type

CarrierPrime with embedded shipping zones and their destinations. Use this representation to fetch the full carrier configuration in one call.

Available Since
1.3.0
Properties
Name Type Description
carrierLocalized list of CarrierLocalized A list of localization objects.
carrierZoneExpanded list of ShippingZoneExpanded A list of Destination Zones.
Inherited from Carrier
NameTypeDescription
customApiKey string API key for direct carrier API integration when using a custom provider.
customApiUser string API username for direct carrier API integration when using a custom provider.
customProvider string Identifier of a custom (non-standard) shipping provider, used when moduleProvider is not set.
ddp boolean Whether this carrier delivers Delivered Duty Paid (DDP) — the sender covers import duties and taxes.
description string The description of the shipping service. For example: Includes tracking and insurance.
emdorsement string USPS endorsement instruction printed on the label to control undeliverable mail handling.
htmlTemplate string Custom HTML template used for carrier-specific label or notification content.
id int Unique numeric identifier for the carrier.
mainCarrier Carrier Parent carrier this carrier is derived from, when this is a sub-carrier or variant of another carrier.
moduleProvider ShippingModuleProvider The shipping integration provider used to calculate rates and book shipments for this carrier.
name string The name of the shipping service as seen by merchants and their customers.
perProduct boolean When true, shipping cost is calculated per ordered product rather than per order.
phoneRequired boolean Whether the customer must provide a phone number.
premium boolean Whether this carrier offers a premium service level (e.g. express delivery or enhanced handling).
showTicketLogo boolean Whether the carrier's logo is printed on the packing slip or production ticket.
Used in
GET /accounts/{accountId}/shops/{shopId}/carriers/expanded/{carrierId} response
CarrierExpanded (XML) 
<carrierExpanded>
  <zones>
    <carrierZoneExpanded>
      <destinations>
        <carrierDestination>
          <id>...</id>
          <country/>
        </carrierDestination>
      </destinations>
      <prices>
        <carrierPrice>
          <id>...</id>
          <price>5.00</price>
          <weightLimit>-1</weightLimit>
          <country/>
        </carrierPrice>
      </prices>
      <id>...</id>
      <name>Western Europe</name>
    </carrierZoneExpanded>
  </zones>
  <localizations>
    <carrierLocalized>
      <id>...</id>
      <name>UPS</name>
      <description>...</description>
      <language>
        <id>...</id>
        <code>en</code>
        <name>English</name>
      </language>
    </carrierLocalized>
  </localizations>
  <id>...</id>
  <name>UPS</name>
  <description>Standard domestic shipping method</description>
  <phoneRequired>true</phoneRequired>
  <moduleProvider>
    <id>...</id>
    <name>Standard</name>
    <provider>ups</provider>
    <serviceType>standard</serviceType>
    <moduleType/>
  </moduleProvider>
  <customProvider>...</customProvider>
  <premium>...</premium>
  <emdorsement>...</emdorsement>
  <ddp>...</ddp>
  <showTicketLogo>...</showTicketLogo>
  <customApiUser>...</customApiUser>
  <customApiKey>...</customApiKey>
  <htmlTemplate>...</htmlTemplate>
  <mainCarrier/>
  <perProduct>...</perProduct>
</carrierExpanded>