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 a billing contact if no match is found.

  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 contains a company name.

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

  4. Create a shipping contact as a child of the billing contact (or company), when the BigCommerce shipping address differs from the billing address.

  5. Fall back to the default customer configured on the instance when the order has no customer information at all (rare — typically guest checkouts in special configurations).

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 company creation is enabled 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.

  • Anonymous (guest) BigCommerce orders that contain only a billing address but no email are imported under the instance’s default customer so the order is never lost.

See also