Documentation You are here: start » v » 2.0 » shipping

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
v:2.0:shipping [2019/04/26 01:14] – [Custom Shipping Endpoint] marijav:2.0:shipping [2023/07/12 14:05] (current) – [Custom Shipping Code] adam
Line 32: Line 32:
  
 Beginning in FoxyCart 2.0, it is possible to dynamically customise the package dimensions sent to the selected carriers. [[v:2.0:snippets:dynamically_set_shipping_box_dimensions|Review this snippet]] for further details on how to do that. Beginning in FoxyCart 2.0, it is possible to dynamically customise the package dimensions sent to the selected carriers. [[v:2.0:snippets:dynamically_set_shipping_box_dimensions|Review this snippet]] for further details on how to do that.
- 
-We are planning a rebuild of our shipping functionality for a future version, so please [[http://requests.foxycart.com/forums/4162-general-requests/suggestions/33314-super-ship|add a comment with your needs]] and vote for this feature request. 
  
 === Supporting Multiple Packages Per Shipment === === Supporting Multiple Packages Per Shipment ===
Line 69: Line 67:
  
 ** USPS ** ** USPS **
-  * **USPS Retail Ground** //(formerly Standard Post)// is generally only available for shipment zones 5-9 within the US. [[https://www.usps.com/ship/standard-post.htm|Full details]]. If you're looking for a full domestic rate, look at the First Class or Priority Mail rates.+  * **USPS Retail Ground** //(formerly Standard Post)// is generally only available for shipment zones 5-9 within the US. [[https://www.usps.com/ship/mail-shipping-services.htm#p5|Full details]], and you can [[https://postcalc.usps.com/DomesticZoneChart|check your zones here]]. If you're looking for a full domestic rate, look at the First Class or Priority Mail rates.
  
  
Line 153: Line 151:
 </WRAP> </WRAP>
  
-=== Passing custom fields to the custom shipping endpoint ===+ 
 + 
 +=== Common Errors === 
 + 
 +**"Error: This store has not been setup correctly to calculate shipping to this location with this weight."** 
 + 
 +If you receive this error in your store, that means that either no rates were returned from your custom endpoint, or it didn't return a valid JSON object. 
 + 
 +  - Firstly ensure that your endpoint is set to return at least one rate or an error for all requests. 
 +  - If you are - ensure that only the JSON output is printed on the page. You can't have any other text on the page. 
 + 
 +==== Custom Shipping Code ==== 
 + 
 +The [[v:2.0:shipping:custom_code|Custom Shipping Code]] option allows you to enter custom code into your store's Foxy administration which can add new rates, or modify or remove existing rates from other shipping carriers configured for your store. This provides you with complete flexibility in what rates are available for your customers. 
 + 
 +The code also has access to an object providing information about the current customer's cart - including the products in the cart, their address details, details about the transaction like currency and language, as well as any existing rates returned from other configured carriers. 
 + 
 +This feature currently relies on adding javascript code to handle the custom logic - but in the future will also support an interface for setting up custom rates and conditions. 
 + 
 +[[v:2.0:shipping:custom_code|Review this page for more details]] on configuring the Custom Shipping Code option for your store. 
 + 
 +==== Passing custom fields to the custom shipping endpoint ====
  
 By default - any custom session attributes currently in the customers session will be included in the payload within the ''fx:custom_fields'' node. This includes anything added to the cart session using ''h:'' prepended before the attribute in an add to cart. By default - any custom session attributes currently in the customers session will be included in the payload within the ''fx:custom_fields'' node. This includes anything added to the cart session using ''h:'' prepended before the attribute in an add to cart.
Line 189: Line 208:
 }); });
 </code> </code>
- 
-=== Common Errors === 
- 
-**"Error: This store has not been setup correctly to calculate shipping to this location with this weight."** 
- 
-If you receive this error in your store, that means that either no rates were returned from your custom endpoint, or it didn't return a valid JSON object. 
- 
-  - Firstly ensure that your endpoint is set to return at least one rate or an error for all requests. 
-  - If you are - ensure that only the JSON output is printed on the page. You can't have any other text on the page. 
- 
-==== Custom Shipping Code ==== 
- 
-The [[v:2.0:shipping:custom_code|Custom Shipping Code]] option allows you to enter custom code into your store's Foxy administration which can add new rates, or modify or remove existing rates from other shipping carriers configured for your store. This provides you with complete flexibility in what rates are available for your customers. 
- 
-The code also has access to an object providing information about the current customer's cart - including the products in the cart, their address details, details about the transaction like currency and language, as well as any existing rates returned from other configured carriers. 
- 
-This feature currently relies on adding javascript code to handle the custom logic - but in the future will also support an interface for setting up custom rates and conditions. 
- 
-[[v:2.0:shipping:custom_code|Review this page for more details]] on configuring the Custom Shipping Code option for your store. 
- 
 ==== Handling Fees ==== ==== Handling Fees ====
 Handling fees, like flat rates, are configured per category, but can be applied in a few different ways: Handling fees, like flat rates, are configured per category, but can be applied in a few different ways:
Line 217: Line 216:
  
 When paired with a flat fee, the handling fee can become quite a powerful tool for adjusting shipping costs. Handling fees also work with live rates, but <wrap important>note that handing fees do not apply if a category is set to "no shipping"</wrap>. When paired with a flat fee, the handling fee can become quite a powerful tool for adjusting shipping costs. Handling fees also work with live rates, but <wrap important>note that handing fees do not apply if a category is set to "no shipping"</wrap>.
 +
 +===== Currency Conversion =====
 +
 +For our integrated carriers - USPS, FedEx and UPS - the returned rate is in USD. If your store's [[.:template_sets|template set]] uses a different currency, then the rates are converted from USD to the currency set in the template set.
 +
 +Rates returned from either the custom code or custom endpoints are not converted. You will need to set those according to the currency of the cart, which is included [[:payload|in the payload that the custom code receives]].
  
 ===== Fulfillment Houses ===== ===== Fulfillment Houses =====
Line 222: Line 227:
  
 ===== Feature Requests, Plans, and Known Limitations ===== ===== Feature Requests, Plans, and Known Limitations =====
-There are many common requests that can be achieved with FoxyCart, but require a little bit of code to make work. Please view [[:v:0.6.0:docs:advanced:forum|this list of links]], and [[http://forum.foxycart.com/|ask in our forum]] if you don't see what you're looking for (or if you need help). +There are many common requests that can be achieved with FoxyCart, but require a little bit of code to make work. Please [[https://foxy.io/contact|contact us]] if you don't see what you're looking for (or if you need help).
- +
-We are planning a rebuild of our shipping functionality for a future version, so please [[http://requests.foxycart.com/forums/4162-general-requests/suggestions/33314-super-ship|add a comment with your needs]] so we can be sure our new solution handles your situation.+
  
  
 ==== Specific Workarounds ==== ==== Specific Workarounds ====
   * [[.:snippets:|Code snippets]]   * [[.:snippets:|Code snippets]]

Page Tools

Site Tools