New: payments, credit notes, tax mapping and order reconciliation for Zoho Books — see all features
Customer Sync

Guest, POS, and Draft Orders: Which Zoho Contact Gets the Order?

Every Zoho sales order and invoice needs a contact, but many Shopify orders have no customer attached. See how Zync matches customers by email, phone, or name and what it does with guest, POS, and draft orders.

The orders that have nobody attached

Zoho will not let you save a sales order or an invoice without a contact. Shopify is far more relaxed. A point of sale order rung up at a market stall often has no customer at all. A draft order created by staff can be completed without one. An order imported from another channel may carry an address and nothing else.

That mismatch has to be resolved somewhere, and if your connector does not make the decision visible, it makes one for you. The usual results are a pile of near-identical contacts called things like Walk-in and Walk in Customer, or orders that silently never arrive.

Zync puts the decision in one place. Under Orders, on the Documents & Accounting tab, the Customers on orders section controls how an order finds its Zoho contact and what happens when it has no customer.

How an order finds its Zoho contact

When an order syncs, the contact is resolved before any document is created. The steps are simple and always in this order:

  • If the Shopify customer is already linked, use the link. Zync stores the Zoho contact ID on the Shopify customer in the custom.zoho_contact_id metafield. A linked customer goes straight to that contact with no searching.
  • If not, search Zoho using the method you chose under Match customers by.
  • If nothing matches, create the contact in Zoho with the name, email, phone, and billing address from the order.
  • Save the link on the Shopify customer so the next order skips the search.

The first step is what keeps things stable over time. Matching rules matter for the first order from a customer. After that the link does the work, which is also why changing the matching rule later does not disturb customers who are already connected. The mechanics of those links are described in how records are linked.

Matching by email, phone, or name

Match customers by has three options.

  • Email. The default. Zync looks for a Zoho contact with the same email address. If the order has no email it falls back to the name. This fits most online stores, where checkout collects an email every time.
  • Phone number (then email). Zync looks for a contact with the same phone number first, then tries the email. Phone matching ignores formatting, so +91 98765 43210 and 9876543210 are treated as the same customer. This fits stores where the phone number is the real identifier: cash on delivery, WhatsApp ordering, and retail counters where people give a number but not an email.
  • Name. Zync matches on the contact name only. This fits wholesale or B2B setups where the Zoho contact is a company and the name is controlled, and it is the riskiest choice for consumer stores, where two different people can easily share a name.

If your Zoho contacts were built from phone-based records and your store collects emails, email matching will find nothing and create new contacts. Pick the identifier your existing Zoho data actually has. For a deeper look at the email path, see customer sync without duplicate contacts.

Three policies for orders with no customer

The second setting is Orders with no customer (guest, POS, draft). It applies only when the Shopify order has no customer record attached.

Create a contact from the billing details

This is the default. Zync takes the name from the billing address, or the shipping address if there is no billing address, plus the order's email, and finds or creates a Zoho contact from them using the same matching rule as everything else.

Choose it when guest orders still represent identifiable people you may want to see again in your books. The cost is more contacts. Every distinct guest becomes one.

Bill one shared contact

Every order with no customer is billed to a single Zoho contact. Nothing is created per order.

Choose it when the individual does not matter for accounting. A busy retail counter is the classic case: hundreds of anonymous sales that you want in Zoho as revenue, not as hundreds of contacts nobody will ever look at.

Skip the order

Orders with no customer are not synced. Each one is recorded on the Logs page with the status Skipped and the reason, so it is a visible decision and not a gap.

Choose it when those orders are accounted for some other way, for example a daily POS summary journal entered by your accountant, and syncing them individually would double count.

The shared contact name

Below the policy is Shared contact name, which defaults to Shopify Guest. It plays two slightly different roles depending on the policy.

With Bill one shared contact, it is the name of that one contact. Zync creates it in Zoho the first time it is needed and reuses it for every later order.

With Create a contact from the billing details, it is the fallback. Some orders have no billing name and no email either, so there is nothing to build a contact from. Those orders go to the shared contact instead of failing.

If you already have a contact in Zoho for this purpose, such as Walk-in Customer or Cash Sales, type that exact name. Zync will find and use your existing contact instead of creating a second one. The field is hidden when the policy is set to skip, since no contact is needed.

What gets written to Zoho

When Zync does create a contact for an order, it is a customer-type contact with:

  • The contact name, taken from the customer or the billing address.
  • Email and phone, when the order has them.
  • A primary contact person built from the same name, email, and phone.
  • A billing address from the order.

Guest and POS orders tend to have thinner data, and the contact reflects that honestly. Zync does not invent an email or a placeholder phone number.

When Zoho says the contact already exists

Zoho can refuse a new contact whose name is already taken. So what happens when the search by email finds nothing, but a contact with that name is already there?

Zoho rejects the new contact, and Zync treats that as an answer, not an error. It looks up the existing contact by name and links the order to it. The order syncs, no duplicate is created, and the Shopify customer is linked to that contact for next time.

This is the right behaviour most of the time, and it is worth being aware of. If two different customers share a full name and only one of them is in Zoho, the second will be attached to the first's contact. Stores where that is a real risk should make sure contacts are found by email or phone before the name ever comes into play, which in practice means collecting an email or phone at checkout.

Picking a policy for your store

  • Online store with guest checkout. Email matching, and create a contact from the billing details. Guests have an email, so they match cleanly and returning guests land on the same contact.
  • Store with Shopify POS. Decide whether counter sales need named contacts. If not, bill one shared contact and name it to match the contact your accountant already uses.
  • Phone-first markets. Phone number matching, with the billing details policy. Formatting differences between the storefront and Zoho stop mattering.
  • Wholesale with draft orders. Make sure staff attach the customer to the draft order. Then the normal matching applies and the guest policy is only a safety net. Set it to the shared contact or to skip, depending on whether an unattached draft should reach your books.
  • POS summarised elsewhere. Skip the order, and use the order source filter on the Order Settings tab if you want to exclude the POS channel entirely.

Checking what actually happened

Two tools make this easy to verify before it matters.

A dry run on the Backfill tab works out what would happen for each order and writes it to Logs without creating anything in Zoho. Run one over last week's orders and each order that would sync gets a Dry run row listing what would be created for it. The post on backfilling historical orders walks through it.

The Logs page then shows the live result once real orders flow. Filter by the status Skipped to see orders held back and the reason for each, and search to follow what one order did. More on reading that page is in sync logs, retries, and API limits.

Customer sync and customers on orders are separate

It is easy to confuse two features that both produce Zoho contacts.

Customer sync, on the Customers page, sends Shopify customer records to Zoho. Turn on Enable customer auto sync and new and updated customers flow across on their own. The Customer Sync tab lets you sync or resync individuals, sync a selection, or use Sync All Customers for everyone.

Customers on orders only runs as part of an order. It makes sure the order has a contact, creating one if it must.

You do not need customer auto sync for orders to work, because an order always resolves its own contact. And the guest policy never affects customer sync, because a guest has no customer record to sync. The two meet in the middle through the same link: whichever one reaches a customer first stores the Zoho contact ID, and the other reuses it. See customer sync for the full feature.

Next step

Look at your last fifty orders in Shopify and count how many have no customer. If the answer is more than a handful, open Orders, go to Documents & Accounting, and set the policy deliberately. The setting-by-setting reference is in customers on orders.

TopicsCustomer SyncGuest CheckoutShopify POSDraft OrdersZoho ContactsOrder Sync
FAQ

Common questions

What happens to a Shopify order that has no customer?
You choose. Under Orders, on the Documents and Accounting tab, the setting Orders with no customer offers three policies: create a contact from the billing details, bill one shared contact, or skip the order.
What is the shared contact?
A single Zoho contact used for orders with no customer. Its name comes from the Shared contact name setting, which defaults to Shopify Guest. Zync creates it in Zoho the first time it is needed and reuses it afterwards.
Can Zync match customers by phone number instead of email?
Yes. Set Match customers by to Phone number. Zync looks for a Zoho contact with the same phone number first and then tries the email. Phone matching ignores formatting, so a number written with a country code and spaces matches the same digits written plainly.
Will a returning customer get a second Zoho contact?
No. Once a Shopify customer is linked to a Zoho contact, the link is stored on the customer and every later order uses it directly without searching again.
How do I know an order was skipped because it had no customer?
The Logs page shows the order with the status Skipped and the reason that it has no customer and guest orders are set to be skipped. You can filter the page by that status.
Does the guest policy affect customer sync?
No. Customer auto sync, on the Customers page, sends Shopify customer records to Zoho as contacts. The guest policy only decides what an order does when it has no customer record to use.

Connect Shopify and Zoho in an afternoon

Start a free trial, connect your Zoho org, and run a dry-run backfill to see exactly what would land in Zoho. No engineering required.