When a Zippykind account uses the API or the Zippykind uploader to create delivery tickets, they have a certain amount of control over the values they add to a property. For example, the Transaction Type which in the API is labeled as trans_type and in the Zippykind uploader is labeled Transaction Type needs to either be “delivery” or “pickup”, without the quotes. Not following this format will result in your delivery ticket not populating correctly in the drivers app. Additionally, if coordinates are provided for a delivery ticket that are not numeric but let’s say are alphabetic, the delivery ticket will not populate correctly in the drivers app.

The easiest way to tell if there was an issue with the transaction type is to look at the delivery tickets in the Tickets Manager of the dispatch software for the day in question and make sure the Transaction Type column for each ticket has a value of delivery or pickup and nothing more.

An example of an improperly formatted address is:

1200 E. Broadway st
Tempe AZ
85251
United States

An example of a properly formatted address is:

1200 E. Broadway st, Tempe AZ, 85251, United States

You will notice that the properly formatted address doesn’t have any line breaks and you will also notice that the street address, city, state/province and postal code have a comma followed by a space.  The properly formatted address should follow the following format.

Street Address 1 Street Address 2, City, State or Province, Postal Code, Country

When you fill out the registration form to create your Zippykind account, you are asked for a FULL Company Address.  If you only provided the street address or an incomplete address, the wrong coordinates will be fetched for your company location and an inaccurate will be shown on the dashboard map.

Solution

Please click on My Profile from the main menu.  Fill in your full company address in the field labeled Company Address.  Click the Update Profile button towards the bottom (you don’t need to provide a password or confirm password).  Then log out and log back in (towards the bottom of the main menu).  You should then see your company marker in the correct location.

Street Number Street Address, City or Province, State, Postal Code Country

Make sure you leave a space after each comma.

Unless you have enabled Product Name Inputs in the general settings of your Zippykind account, you will have an issue when you go to edit a delivery ticket that has been created through Zapier and has Order Items attached to the delivery ticket.  The order items will disappear from the delivery ticket once you update the delivery ticket.  This is caused by the Item Product ID that you are passing through the Zap not matching the External Product ID in the Zippykind Products Manager.

When a request is made from Zapier to create a delivery ticket and order items are sent with the request, Zippykind looks for the Product ID by making a connection to the External Product ID.  If none is found, the order item is still created but the Product ID is not saved with the Order Item which will cause an issue when you edit a ticket because Zippykind wont know how to pre-populate the Product Information under the Order Details tab as shown below.

The Solution

To fix this issue, simply make sure the External Product ID that is used when you added your products to the Products Manager match the Item Product ID being sent from Zapier.  Take a look at the red highlighted input fields in the screenshots below.

Zapier Zap

Zippykind New Product

Below is an example of a proper tag:
[CustomerName]

Below is an example of an improper tag which has unnecessary markup in the HTML:
[<gwmw class=”ginger-module-highlighter-mistake-type-1″ id=”gwmw-15813490834904369989394″>CustomerName</gwmw>]

Check your email template:
Click on the Source button in the HTML editor after you have created your notification template to see if any unnecessary markup has been wrapped around your tags.  If you see an unecessary HTML markup, remove it so that your tag begins and ends with a bracket (i.e. [ ]) directly wrapped around your tags (i.e. [CustomerName]).

Step 1) Purchase a Woocommerce Zapier plugin. 
Some users use this Woocommerce/Zapier plugin which is the most affordable option, but we recommend contacting the plugin developer of whichever plugin you choose to make sure the Woocommerce plugin that you are purchasing is compatible with your version of WooCommerce and WordPress.  We are not responsible for making sure your plugin works correctly, please consult with the plugin developer regarding support.  When you purchase the plugin, install it into your Woocommerce site and you should be given instructions by the plugin developer on how to connect your new plugin to your Zapier account.

Step 2) Create an account at Zapier.com
Zapier usually offers a free trial so that you can test your account prior to subscribing.  Accept our Zapier Invite to start using our Zapier template.

Step 3) Get familiar with Zapier.
Watch our Zapier Video Tutorial, which will help you understand how to edit the Zapier template.  The video tutorial shows a Shopify integration using Zapier, but the process to connect a WooCommerce store to Zippykind is very similar which is why we recommend watching the video tutorial in this step.  You will first want to accept our Zapier template invitation using the link provided in the previous step and then you should see the newly accepted Zap in your Zap page in Zapier.  A Zap is a template that we’ve created that lets you “map” the data that flows in from Woocommerce to Zippykind.  For example, if the Woocommerce plugin labeled the customer’s name as “cus_name” and we label it “customer_name”, the Zapier template lets you connect/”map” these two fields together so when the data flows through it knows how to format the data before sending it to Zippykind.

Step 4) Generate an API key.
Log into your Zippykind account and click on API Connect from the main menu and then click on the Keys tab.   While connecting your Zapier template to your Zippykind account, you will be asked for your Zippykind API key, provide the API key that was generated during this step.

Step 6) Map the data and test the connection.
After you have connected your data fields in your Zapier template, you will then want to save the Zapier template and send a test through.  Fetch a test order in the first step of Zapier and then send the test data to Zippykind through Zapier to make sure all the data is being carried through correctly.  Note: If you only want test delivery tickets to be created in your Zippykind account during your testing.  Go to your Zippykind account and click on API Connect from the main menu and enable API Testing by switching the API Testing switch to On which is located in the right column.

Step 7) Enable your Zapier Zap.
Once you have tested your Zapier template and you have ensured that all the data is being carried through correctly, you should then enable the Zap by clicking on the Enable switch toward the top right of your screen in your Zapier account from the Zap edit page.  This option will also be presented to you when you finish editing the template.  Note: When you edit the template, the Zap will be disabled, so make sure to re-enable it each time you edit your template.

That’s it!!!!!!! You should now be able to receive orders from your WooCommerce store to your Zippykind account!

Location services which engages the drivers cell phone GPS uses a lot of battery and as such we have created two options for tracking your driver.  One which uses less battery called Geofence Tracking and another mode which uses more battery called Interval Tracking.

The location services on your drivers phone will not start until your driver has logged into the drivers app.   Once your driver logs into the drivers app, your driver can choose the mode of location tracking that he or she prefers.

Geofence Tracking Mode

The default mode of location tracking is called Geofence Tracking.  Geofence Tracking is more battery efficient because it ignores your drivers location when your driver is stationary and will only start tracking your driver when the driver is in-motion and has traveled outside of your drivers stationary geofence which is 1,000 meters.  For example, if your driver parks at a dropoff location and spends more than 5 minutes at the dropoff location, the drivers app will go from in-motion status to stationary status and no more location updates will be sent from that driver.  The driver will have to travel outside of the geofence (1,000 meters) that has been created for the location tracking to continue.  The geofence is a circle that is drawn around the drivers location with a radius of 1,000 meters. The geofence is not shown to the driver in any visual display, it is created and tracked within the code of the app to determine the drivers in-motion or stationary status.

Geofence mode of tracking is not recommended for short trips as the location services on the drivers phone will be less frequently engaged.

Interval Tracking Mode

Alternatively,  Interval tracking consumes more battery, but offers more reliable and consistent tracking.  Every 30 seconds regardless of stationary or in-motion status, your drivers cell phone will fetch the GPS coordinates of the driver and send them to the Zippykind servers.  Your driver can opt-in to Interval Tracking by clicking on the menu icon towards the top right of the drivers app from the home screen and then select Settings from the menu.  Your driver should see a screen as shown below.  Your driver should toggle on Interval Tracking.  Your driver has now changed their tracking mode to Interval tracking.

Common Issues With Location Updates

• One of the most common reasons why a drivers location isn’t being updated regularly is because the driver is terminating (closing) the Zippykind drivers app.  If you notice that the location of the driver is being updated only when the driver updates the status of a ticket, this is usually because the driver is terminating the app and then reopening the app to make a status update.  Instead of terminating the app, the driver should click on the home button on Android or iPhone which will minimize the app and allow background location tracking to continue.
• Driver has battery saving mode enabled which will throttle the phones GPS location services.  GPS location service on a phone uses quite a bit of battery power and phones that have battery saving mode enabled will throttle down the number of GPS location updates.
• The location tracking relies on your drivers consistent connection to the internet.  The drivers app sends the GPS coordinates of your drivers to the Zippykind servers which is then made available to the customer tracking page and the dispatch operator dashboard map.  If your driver has an intermittent signal because he or she has entered a bad coverage area, the location tracking will be less frequent. Refreshing the dashboard map through the dispatch software or refreshing the drivers tracking page that is sent to the customer doesn’t re-fetch the drivers coordinates, the maps are automatically updated as soon the Zippykind servers receive a location update from the drivers cell phone.
• Driver is using an outdated version of the drivers app.  Ask your driver to search for Zippykind Delivery Driver in the app store and then ask your driver to open the app detail page within the app store.  Your driver should see an Open button if the app is up-to-date or if the app is not up-to-date, the driver should see an Update button.  After clicking the Update button, the app should start to update and will let the driver know once the app has been updated.  Your driver can open the app and click on the menu icon and then click on Settings to view the installed version of the app (i.e Version 1.4.5).  The Installed version should match the version number shown in the app store.
• Drivers cell phone service provider doesn’t offer good coverage.  Some providers offer better coverage than others.  Carriers such as At&t, Verizon, T-mobile and Sprint usually offer reliable coverage depending on your area.

If you are still having issues, please contact us so that we can look closer into the issue.

If you don’t see the push notification in the push logs, that means the Zippykind system didn’t attempt to send the push notification.

The following push notification statuses may be displayed:
1) process = The push notification has been successfully sent to your driver.
2) NotRegistered = The device ID on the drivers phone does not match the device ID that Zippykind has saved for the driver.  To view the device ID that Zippykind has saved for the driver, click on Drivers from the main menu and the device ID will be displayed next to the drivers name.  To view the current device ID that the drivers app is using for the driver, click on the menu icon in the drivers app and then click on Settings.  If the device ID in the drivers app is different than the device ID in the Zippykind system, you should ask your driver to try logging out, closing the app and then reopening the app and logging back in.  This should force the device ID to be resent to the Zippykind system and should update the Zippykind system with the current device ID.