How to send delivery order emails to GetSwift
What is GetSwift?
GetSwift is a delivery management software for real-time delivery dispatching, managing & tracking in a smart, simple interface.
GetSwift core features include:
- automated dispatching,
- smart routing,
- real time job tracking,
- real time service tracking,
- proof of delivery,
- white label booking form,
- live management dashboard,
- iOS and Android apps for couriers
- API to integrate with third parties.
What is Parseur?
Parseur is an email parser software that automates your data entry process by turning each email into workable data through a simple point & click interface. With Parseur, extracting data from emails and documents has never been so easy!
Parseur allows you to capture incoming delivery order emails, create templates to extract relevant information and send it to GetSwift.
Delivery Platforms supported by Parseur
Parseur comes loaded with a set of ready-made templates supporting all major delivery platforms.
Parseur can automatically extract data from:
- Wix for restaurants
- ...and more!
If your platform of choice isn't in this list, you can manually add a template (see below) or contact us to see how we could add out-of-the-box support for it.
Step 1: Create a Parseur account and a new mailbox
If you're new to using Parseur, get started by reading our tutorial on how to set up your first Parseur mailbox. Once done, you should have a Parseur mailbox that looks like this: firstname.lastname@example.org
You must redirect all food order emails to this email address so that Parseur, then GetSwift, could process the orders automatically. The following article covers how to set up automatic email forwarding.
Step 2: Use our read-made Food Delivery templates
When creating your mailbox, make sure to select "Food delivery orders" when asked for the type of documents you'll send. This way you will take advantage of our ready-made food delivery templates.
If you forwarded an email from one of our supported platform but it wasn't parsed automatically, contact us on the chat, and we'll be happy to help!
Step 3 (optional): Create your custom template to work with GetSwift
If you want to create your own template to work with GetSwift, you can use our powerful template editor to add support to any delivery email.
First, get comfortable using the template editor by reading our getting started article.
Most importantly for the GetSwift integration to work, while creating your template(s), you have to give specific names to your fields so that GetSwift know what to do with them.
Here is the list of all the field names (you don't have to specify all of them, of course) :
Information about the pickup:
- pickupTime (date and time)
- pickupName (text)
- pickupPhone (text)
- pickupEmail (text)
- pickupDescription (text)
- pickupAddress (text)
- pickupCity (text) : merged into pickupAddress
- pickupState (text): merged into pickupAddress
- pickupZip (text): merged into pickupAddress
- pickupStateProvince (text)
- pickupCountry (text)
- pickupSuburbLocality (text)
- pickupPostcode (text)
- pickupLatitude (decimal number)
- pickupLongitude (decimal number)
Information about the dropoff:
- dropoffEarliestTime (date and time)
- dropoffLatestTime (date and time)
- dropoffDate (date): added before dropoffEarliestTime and dropoffLatestTime (only use when these fields don't contain the date)
- dropoffName (text)
- dropoffPhone (text)
- dropoffEmail (text)
- dropoffDescription (text)
- dropoffAddress (text)
- dropoffCity (text): merged into dropoffAddress
- dropoffState (text): merged into dropoffAddress
- dropoffZip (text): merged into dropoffAddress
- dropoffStateProvince (text)
- dropoffCountry (text)
- dropoffSuburbLocality (text)
- dropoffPostcode (text)
- dropoffLatitude (decimal number)
- dropoffLongitude (decimal number)
General information about the delivery:
- reference (text)
- getSwiftTemplate (text): see note below
- deliveryInstructions (text)
- unitNumber (text): merged into deliveryInstructions
- crossStreet (text): merged into deliveryInstructions
- grandTotal (text): merged into deliveryInstructions
- paymentMode (text): merged into deliveryInstructions
- source (text): merged into deliveryInstructions
- itemsRequirePurchase (true/false)
- items (list):
- quantity (integer, GetSwift does not handle fractional quantities yet)
- description (text)
- sku (text)
- price (decimal number)
- extra (text): merged into description
- subTotal (decimal number, only used if items list is missing)
- customerFee (decimal number)
- customerReference (text)
- tax (decimal number)
- taxInclusivePrice (decimal number)
- tip (decimal number)
- driverFeePercentage (decimal number)
- driverMatchCode (text)
- deliverySequence (integer)
These fields match those found on the GetSwift API.
Important: For a delivery job to be valid, GetSwift needs a minimum of a pickup address and a drop off address.
Note: You don't always have the full pickup address of the restaurant or shop mentioned in the delivery order email. You can get around that by creating Templates in GetSwift and pre-filling the pickup address. In that case, you have to perfectly match your GetSwift template name with the content captured in the getSwiftTemplate field. Typically, your GetSwift template name should be the name of your restaurant (or pickup location) as it appears in the delivery email. Feel free to contact us through the chat if you need any help with that feature.
Step 4: Set up your GetSwift API key
Log in to your GetSwift account.
Then navigate to the Integration > API Settings page, generate an API key and copy it into the clipboard.
Back on Parseur:
- go to the Export section of your mailbox
- click on the GetSwift tab
- paste your GetSwift API key into the field
- optionally, if you have a default driver fee percentage, you can enter it as well
- Click Save.
Step 5: Test sending delivery order emails to GetSwift
If all is in order, you should see your order emails turn into deliveries jobs on your GetSwift account.
If you get the Export Failed status, click on the magnifying glass icon to view the logs and see what went wrong.
If your orders were already processed before you added the GetSwift key, click on the double-arrow refresh icon to reprocess a document and send to GetSwift again.
Frequent Problems and Solutions
Problem: My scheduled order was sent to GetSwift with the wrong time or did not get into GetSwift
Solution: Make sure that your time zone is properly set in your account settings. Your time zone should match the time zone of your pick-up and drop-off addresses.
Problem: Parseur displays "Export failed"
Solution: there can be several reasons why an export failed. To get more information, click on the magnifying glass icon to see the logs and open the message about the failed export. Check the answers below to solve most common solutions to export problems.
Problem: My emails did not contain the whole address, just the name of the place to pickup from or drop off to.
Solution: Make sure that you have created a template in GetSwift with relevant pickup and/or drop off addresses with the name matching the content of the getSwiftTemplate field exactly.
Problem: the order went through GetSwift but was wrongly tagged (wrong country or city).
Solution: Try adding more address details if you have them (like the country, city or zip). If that doesn't help, please contact GetSwift for more information.
Problem: GetSwift sends back an error code 500 with no error message.
Solution: This usually happens when GetSwift was not able to geolocate the address you sent. Try adding more address details if you have them. Also, put any company name or apartment/unit number out of the address and into their own fields. If that doesn't help, please contact GetSwift for more information.
Feel free to ask for help on the chat system in the bottom right corner of your screen.