Contacts: Managing Contacts
The purpose of this document is to review the process of creating or importing a new contact within Odoo’s Contacts app. We will also review how to configure the record to include multiple people at a single company, multiple billing and/or shipping addresses, and how to designate them as a customer, vendor, or both.
A company is capable of having multiple representatives filed together for ease of communication. Whether you're trying to reach the CEO or the Janitor, if they are represented within Odoo, you can easily manage the relationship.
For the purpose of clarity, we recommend building the parent Company contact first. The autofill function is very specific, and if one user inputs a middle initial into a customer name, a new record will be created. Luckily, Odoo has a 'Merge Contacts' option for cleaning up extra records.
Navigate to the Contacts App.
Create a New Contact
Creating a new contact is very useful for populating fields in later stages of Odoo work. If the records are completed consistently, it can make navigation, changes to orders, and communication a breeze!
Let's create a sample Company and a few employees.
First, you want to Create a new record and fill in the necessary details.
We've added the address, email, phone number, and language. We'll leave the image on one of Odoo's default/placeholder images. However, you can customize that image to be the company logo. If the employees have a photo associated with their email (via Gravatar), it will update when the record is saved. This Memphis bakery will have three contacts by the end of this document.
Good to Know!
As you can see from window above, when this contact is complete, we will be able to see upcoming opportunities, meetings, the customer's ledger, previous sales, invoices, and current active/archive status. Several other apps will provide navigation from this screen as well, including the Helpdesk app
To distinguish between an Individual or Company, simply toggle between the two options above the Name Field.
If an individual is created as a solo entity, they can later be added to a company using the dropdown below the Name field. Simply create a record for the company and then edit the existing contact record.
Configuring a Contact Record
Certain Odoo apps will add configuration tabs at the bottom of the contact record.
Here's a visual overview of the tabs:
Good to Know!
The address entered under the company record will become the default address for contacts created within that company. It is possible and often necessary to add shipping addresses for warehouses, retail locations, or unique event sites such as conference venues. This is covered under the Creating Multiple Addresses topic later in this document.
Creating Nested/Child Contacts
Click the Edit button. The first tab at the bottom of the card will be Contacts & Addresses. Click on the Add button. Enter your contact's information and Save & Close or, if you have more contacts to add, click the Save & New to move directly to a blank contact form.
Creating Multiple Addresses
It is possible that your customer operates from multiple locations or needs their product delivered to a specific warehouse or address that is different from the default parent contact address. We can designate billing, shipping, other, and private addresses for use in creating sales orders.
If we Edit this record again, we will be able to create a third entry. Let's say this is a family business! Let's get Mara on board as a shipping address.
Click the button under Contacts & Addresses that reads Add.
When we save this contact, the address can be selected on an order. Save & Close and note the truck icon on the secondary address! This is similar to the icon that appears on the Delivery Smart button when an order is confirmed.
A full walk-through of Merging and Deduplication is available.
Scenario One: If multiple contacts were created before a company was built to contain them, they can be re-assigned to the company once it has been created using the drop down under the contact's name. If they are relevant, and the contact information is valid, it is far better to manually re-assign these errant contacts to the company than to merge them.
Scenario Two: Multiple records of the same person were created, either inside or outside the company record.
You will see a new window asking you to select the destination record. We will choose the most complete record. You have the option to simply delete the extra lines by clicking on the remove icon to the right. Select Merge Contacts.
Odoo will assume the Destination Contact is correct, and any information that is different on the contacts you are merging will be overwritten. Not only will you lose the individual's contact card, merging will fill any blank in the Destination Contact with the information available, potentially assigning someone's phone number or email to the wrong individual.
Once the record is created, there will be an Action menu available to you at the top of the screen.
Delete: Will erase this record from your database as long as there are no sales, invoices or stock movements associated with it. We suggest Archiving it instead so that it is still searchable.
Duplicate: Will Duplicate the record.
Grant Portal Access: Provides the contact access to an online account where they can access quotations, sale orders and invoices as well as manage their payment methods.
Send SMS: Sends an SMS message. Note that SMS messages require service credits. For more information, please refer to Odoo’s SMS Pricing.
Process Follow-ups: Selecting this action sends a payment reminder to the contact with a list of due/past due invoices. It also downloads a PDF of the payment reminder to your computer for printing and sending purposes.
Importing Contacts from a Spreadsheet
A great way to build your contacts database quickly is with Odoo's Import and Export function. Odoo is capable of exporting data for use as a template, and while it may take some trial and error to find the combination that works best for your scenario, once you've determined the necessary fields they can be saved as a favorite.
We recommend building at least three contacts to completion manually, to maximize your opportunity to import the data you want. Filter your contacts by Company to begin. Check the Name box to select all.
Good to Know!
There are submenus in the offered fields. If you click on the next to each option, you will be presented with a dropdown of sub-options that are specific to that field. Note that while we have fields for Name, Email, Phone, etc., the sheet will only display the Company information unless we add the contact variation. The variations will read Contacts/Name, Contacts/Email, etc.
Here, we've filtered out our sample companies by industry. Even in this limited view, we can see that a few fields are blank. Rather than sort through every record manually, we are going to select all, and then click the Action menu button at the top and choose the Export option.
Now you're ready to EXPORT TO FILE.
Highlighted on the image below is the best option for building an Odoo compatible sheet in your chosen program. The fields we've selected contain the information that we would like on each Contact record. With this as our template, we can save this fields list for later reference.
The below images are the raw data that we end up with. As you can see, the fields exported in the order they appeared in the window, which can help you navigate the spreadsheet you've created.
Resist the temptation to rename the columns! While it's okay to fill in blank cells with missing data, Odoo needs those column references exactly as they are. These correspond to fields in Odoo with specific names.
We have added more detail to our existing records, as well as added two entirely new lines for the Beale Street Bake Shop. After saving our work, we will return to our Odoo window and prepare to IMPORT.
The identifying field '__export__.res_partner' MUST be filled for every entry you try to re-import to Odoo, as this is how it matches up to an existing contact instead of creating a new contact.
There is a Test Import button that will run the file against Odoo's import parameters and flag any discrepancies. You have the option at this time to cherry pick which fields you are updating, but given the nature of this example, we want everything.
Good to go! Let's hit the Import button! A quick check of the new records we made shows that our two new records were added without issue! If you ever need to change this data, you can simply edit the contacts within Odoo.