Verde Fulfillment USA Integration
IN THIS GUIDE
This integration allows you to connect to Verde Fulfillment USA's VeraCore-backed warehouses.
Order Desk can import orders from your shopping cart(s), apply custom information and then submit them to Verde Fulfillment USA for fulfillment. When orders are shipped, the tracking details will be sent back to Order Desk and back to your shopping cart(s) if your store is set up for it.
This guide explains how to set up and use the Verde Fulfillment USA integration.
To connect to Verde Fulfillment USA, click on the Manage Integrations link in the left sidebar and under the Fulfillment tab find and enable the Verde Fulfillment USA integration.
Once enabled, enter your Verde Fulfillment USA username and password and click to connect.
After you have connected the integration, you can apply any necessary details or preferences to the settings.
Default Mail Class
Choose the shipping class you want Verde Fulfillment USA to use for your orders.
If you need to apply specific methods for certain orders, match your method names to the names Verde Fulfillment USA uses in the Shipping Class Match section below.
After Import, Move To
Select the folder you want orders to be moved into after they are successfully sent to Verde Fulfillment USA.
You can use one of the default folders already in your store or create your own. Read the Working with Folders guide for more information.
After Shipment, Move To
Select the folder you want orders to be moved into as Verde Fulfillment USA sends shipment details back to Order Desk.
If Canceled, Move To
Select the folder you want orders to be moved into if they are canceled at Verde Fulfillment USA.
For more information, see the Working with Folders guide.
Check for Shipments
Choose the time interval for how often you want Order Desk to check for new shipments in Verde Fulfillment USA.
To send the source name of your orders into VeraCore, set that value here. This will also need to be set up within your VeraCore OMS for the value to pass through.
This can be set on a case-by-case basis for different orders using SourceCode as order metadata or checkout data, details below.
Send Customer Email Address to Verde Fulfillment USA
Select if you want the email address on the orders to be sent to Verde Fulfillment USA.
Check Verde Fulfillment USA for Backorder Status
Select this setting to schedule a daily appointment to check Verde Fulfillment USA for orders that have been set to the backorder status. You can edit the time the appointment runs from the View Appointments page in your Order Desk store, but it will only run once a day.
The appointment itself will not take any action on backorders. To have Order Desk take action when an order is reported as backordered by Verde Fulfillment USA, use the Rule Builder to create a rule on the event When Order Backordered at Verde Fulfillment USA and set any actions you want to have taken in the rule.
Once an order has been noted as backordered, Order Desk will stop checking to see if the order exits backer status. The next event expected is that the order is shipped, at which point the shipment details will be sent into Order Desk.
Send Price Details to Verde Fulfillment USA
If you want to send your price details to Verde Fulfillment USA with your orders, select this. Before enabling this, please set Tax Calculation Method to 3rd Party Tax Total in the OMS Basic System Information.
Automatically Send Imported Orders to Verde Fulfillment USA
If selected, every order that is added to Order Desk will automatically be sent to Verde Fulfillment USA.
Select this setting only if all orders will be sent to Verde Fulfillment USA. If any orders will not be sent, or if you need a delay between when an order is imported into Order Desk and when it is sent to Verde Fulfillment USA do not select this.
Inventory Management Settings
Enable if you want your inventory stock counts to be pulled in from Verde Fulfillment USA.
For more information, see the How to Work with Inventory Counts guide.
Sync Update Interval
If Sync Inventory is enabled, choose how often you want Order Desk to check Verde Fulfillment USA for inventory updates.
Inventory Location Name
If you want to set a specific inventory location name for the products you have at Verde Fulfillment USA, set that name here. As Verde Fulfillment USA sends back reports, your custom name will be added as the location.
For more information on what these product settings in the Verde Fulfillment USA integration are for and how to use them, read the Fulfillment Integration Product Settings guide.
Shipping Class Match
If the shipping methods you set up in your shopping cart(s) don't match the shipping method names Verde Fulfillment USA uses, they won't know what methods you intend for them to use. When this happens, the default mail class applied above will be used instead for all of your orders.
To tell Verde Fulfillment USA what methods you want them to use, you will need to match your method names to theirs. This can be done in the shipping class match section. For detailed instructions on setting this up, please read through the shipping class match guide.
Notes and Limitations
- Submitted SKUs are compared against Offers in the VeraCore system.
- If the first name in an order is longer than 15 characters, the first name will be sent as an empty field and the full name will be sent in the last name field instead.
- Verde Fulfillment USA has a 20 character limit for the order ID. Any order number that is longer than 20 characters will be sent with the last 20 characters as the order ID.
The following fields can be added as checkout data or order metadata to be passed through to Verde Fulfillment USA on an order by order basis:
|Field Name||Field Description|
|BillingCode||Default is Sender. Set BillThirdParty or Recipient if necessary.|
|CancelDate||Default is one year from the current date. To change the default date, set a time in this format: +2weeks.|
|Carrier||Overwrite the carrier set in the shipping class match settings.|
|Mode||Overwrite the shipping mode (Service ID) from the shipping class match settings.|
|PONumber||Set a custom PO Number. If not entered, the Order ID will be sent.|
|InvoiceNumber||Set the invoice number for the order.|
|SCACCode||Set the SCAC code for the order.|
|ShippingAccount||Set the third party shipping account number to be used for the order.|
|ShippingAccountZip||Set the zip code associated with the third party shipping account.|
|RetailerID|| Set the Retailer ID for the order.
|RetailerName||Set the retailer name if necessary.|
|RequireDeliveryConfirmation||Set to 1 if you'd like to receive delivery confirmation for your order.|
|RequireReturnReceipt||Set to 1 if you require a return receipt for your order.|
|Insured||Set to 1 if you'd like your order to be insured.|
|DeliveryConfirmationType||Choose how you want the delivery for your order to be confirmed. Accepted values are delivery, signature, adult_signature, direct_signature and none. Please note that these values are case sensitive.|
|DryIceWeight||Set the weight of dry ice.|
|InsuranceAmount||Set the value of the insurance paid for the order.|
|InsuranceType||Set the type of insurance that you want on the order. Accepted values are 106 for "Carrier" insurance and 107 for "Third-party" insurance.|
|InternationalContentsType||Set the kind of goods that are in your international shipments. For example, you can choose documents, gift, merchandise, returned_goods, sample or none.|
|InternationalNonDelivery||Choose how your international orders should be handled in case they are not delivered. The options available include treat_as_abandoned, return_to_sender, and none. Please note that these values are case sensitive.|
|IsResidential|| Set to 1 to for residential delivery .
|SaturdayDelivery||Set to 1 to for a Saturday delivery.|
|ExpectedDate||If this field is present, Order Desk checks for the expected ship date value and sends that data with your order.|
|EarliestShipDate||If this field is present, Order Desk checks for the earliest ship date value and sends that data with your order.|
If you are unfamiliar with checkout data, see the How to Work with Checkout Data guide.
Item Level Details
The following can be set as item metadata or variations on the items in your orders.
|Field Name||Field Description|
|notes||Any information added as comments will be sent to Verde Fulfillment USA.|
If you are unfamiliar with how to add item metadata or variations to your items in Order Desk, see the How to Work with Inventory Details guide.