Customer Creation During Order Import

BigCommerce customers are created (or matched) automatically while their orders are being imported into Odoo. This keeps your Odoo customer database aligned with real sales activity, every contact in Odoo corresponds to a real customer who placed an order, without any manual import step.

How Customers Are Resolved

For every imported BigCommerce order, the connector reads the customer’s billing and shipping addresses and follows this flow:

  1. Search for an existing customer using fields like email, name, address, city, state, ZIP, country, and phone. This avoids creating duplicates when the same customer reorders.

  2. Create the customer (type Contact) from the billing address if no match is found (from the first shipping address when the order has no billing address), plus an Invoice contact below it.

  3. Create a separate company contact when both of the following are true:

    • The instance setting Create Company Contact? is enabled.

    • The BigCommerce billing address, or a shipping address, contains a company name.

    The new individual contact is then linked to the company as a child contact.

  4. Create a Delivery contact for each shipping address, as a child of the shipping company, the billing company or the customer.

  5. Stop the import of the order when it has no billing or shipping data to build a customer from. The log line says so.

What Information Is Brought In

The connector brings the following customer details from BigCommerce into Odoo:

  • First and last name (combined into the contact’s name)

  • Email address

  • Phone number

  • Street, street 2, city, ZIP code

  • State and country

  • Linked Company contact (when Create Company Contact? is enabled on the instance and a company is provided on the order)

  • Address type, Contact, Invoice, or Delivery, depending on whether the address is the billing or shipping address

Configuration Reference

The following instance-level settings control customer creation behavior, see Customer Configurations for details.

  • Create Company Contact?: Enable for B2B stores.

  • Receivable Account: Default account used on newly created customers.

Note

  • Customer matching uses the company name only when searching for an existing company contact. Individual contacts are matched by email, name, and address.

  • Guest BigCommerce orders that have a billing address but no email are imported with a contact created from the billing address, without an email.

See also