Codes

String will returned predefined codes when you make a request to the LCF endpoint. These predefined codes indicate the carrier, service level, and package type used to acheive a low cost fulfillment.

Carrier Codes

String will return one of the following carrier codes in order to indicate what carrier you should use to ship your package. If you're using a carrier not incldued in this list, please contact the String team to discuss adding support for your carrier. String can support any carrier with an API.

• usps
• ups
• fedex
• dhl

Service Codes

String will return one of the following service codes to indicate what service level you should use to ship your package. Each carrier has it's own unique codes that will not be returned for other carriers.

USPS Service Codes

• usps_first_class_mail USPS will convert this to Ground Advantage by default
• usps_priority_mail
• usps_priority_mail_express
• usps_ground_advantage

UPS Service Codes

• ups_ground
• ups_3_day_select
• ups_2nd_day_air
• ups_2nd_day_air_am
• ups_next_day_air_saver
• ups_next_day_air
• ups_next_day_air_early_am
• ups_mail_innovations_first_class For Mail Innovations shipments under 1lb
• ups_mail_innovations_priority_mail For Mail Innovations shipments over 1lb
• ups_surepost_less_than_1lb For SurePost shipments under 1lb
• ups_surepost_1_lb_or_greater For SurePost shipments over 1lb

FedEx Service Codes

• fedex_ground
• fedex_home_delivery
• fedex_2day
• fedex_2day_am
• fedex_express_saver
• fedex_standard_overnight
• fedex_priority_overnight
• fedex_first_overnight
• fedex_smart_post_parcel_select

DHL Service Codes

• smartmail_parcels_ground For SmartMail standard shipments under 1lb
• smartmail_parcels_expedited For SmartMail expedited shipments under 1lb
• dhl_sm_parcel_expedited_max
• smartmail_parcel_plus_ground
• smartmail_parcel_plus_expedited

Package Codes

String will return one of the following package type codes to indicate how your parcel will be rated by the carrier selected. This is important because String can select between flat rate options offered by carriers and standard rates based on the size and weight of your package. In some cases, carriers let you use your own packaging for flat rate serivces. For example FedEx One Rate allows this for qualfiying packages.

In addition to the package code, String will also include details about the parcel you should use to make sure your shipping label is configured properly. This information will be retruned to you as an object with key 'parcel'. Please refer to 'API REFERENCE' -> 'Least Cost Fulfillment' for an example of how package information is returned to you via the API.

Generic Package Codes

• package Your own custom packaging.

USPS Package Codes

• usps_flat_rate_envelope You must use a USPS Flat Rate Envelope to ship this parcel.
• small_flat_rate_box You must use a USPS Small Flat Rate Box to ship this parcel.
• medium_flat_rate_box You must use a USPS Medium Flat Rate Box to ship this parcel.
• large_flat_rate_box You must use a USPS Large Flat Rate Box to ship this parcel.

UPS Package Codes

• ups_express_pak You must use a UPS Pak to ship this parcel.
• ups_express_box You must use a UPS Express Box to ship this parcel.
• ups_express_box_small You must use a UPS Express Box Small to ship this parcel.
• ups_express_box_medium You must use a UPS Express Box Medium to ship this parcel.
• ups_25_kg_box You must use a UPS 25kg Box to ship this parcel.
• ups_10_kg_box You must use a UPS 10kg Box to ship this parcel.

FedEx Package Codes

• fedex_envelope You must use a FedEx Envelope to ship this parcel.
• fedex_pak_onerate You can use your own packaging if approved by FedEx.
• fedex_small_box_onerate You can use your own packaging if approved by FedEx.
• fedex_medium_box_onerate You can use your own packaging if approved by FedEx.
• fedex_large_box_onerate You can use your own packaging if approved by FedEx.
• fedex_extra_large_box_onerate You can use your own packaging if approved by FedEx.

DHL Package Codes

At this time, DHL does not offer any flat rate packaging options for DHL Smartmail shipments. You must use your own packaging to ship with DHL Smartmail.

• package You must use your own packaging to ship this parcel.