Skip to main content

Main Odoo Modules – Required Field Mapping

With our Gravity Forms to Odoo, you can easily send data from your WordPress forms to key Odoo modules. Below is a guide covering the most relevant modules, the mandatory fields required for successful integration, and optional fields you can map for enhanced functionality.

CRM Leads & Opportunities (crm.lead)

Convert form submissions into leads or opportunities automatically.

Use Case: Contact forms, demo requests, quote inquiries.

Required Fields

Odoo FieldDescriptionGravity Forms Field Type
nameLead/Opportunity NameText
typeLead or Opportunity TypeHidden/Select
email_fromEmail of ContactEmail
phonePhone NumberPhone

CRM Leads required fields mapping example

Optional Fields

  • description: Additional notes
  • partner_name: Company name
  • priority: Importance level
  • source_id: Source of the lead
Odoo FieldDescriptionGravity Forms Field Type
contact_nameContact NameText
descriptionDescription of the LeadParagraph Text
priorityPriority LevelDropdown
tag_idsTagsCheckbox/Select

Contacts & Companies (res.partner)

Sync customers, vendors, or companies collected from forms.

Use Case: Registration forms, contact management.

Required Fields

Odoo FieldDescriptionGravity Forms Field Type
nameFull Name or CompanyText

Optional Fields

Odoo FieldDescriptionGravity Forms Field Type
streetStreet AddressText
cityCityText
country_idCountryDropdown/Hidden
vatVAT NumberText
emailEmail AddressEmail
phonePhone NumberPhone
company_typeIndividual or companySelection

Countries (res.country)

Link Gravity Forms dropdowns to Odoo's built-in country list.

Use Case: Address forms, country-specific logic.

Required Fields

Odoo FieldDescriptionGravity Forms Field Type
nameCountry labelText
codeISO codeText
phoe_codeCountry code ReferenceNumber

Optional Fields

Odoo FieldDescriptionGravity Forms Field Type
address_formatDefines how the address is displayed for this country using templates.Text
name_positionSets whether the contact name appears before or after the company name.Text
vat_labelCustom label for the VAT field. Use this field if you want to change VAT labelText
state_requiredIndicates if the state/province field is mandatory.Selection
zip_requiredIndicates if the postal code field is mandatory.Selection

Sales Orders (sale.order)*

Generate sales orders or quotations directly from form data.

Use Case: Order forms, B2B quote requests.

Required Fields

Odoo FieldDescriptionGravity Forms Field Type
nameCustomer's NameText
partner_idCustomerText / Number
order_lineOrder Line ItemsRepeater / Nested

Invoices / Journal Entry (account.move)*

Send data to create draft invoices based on submissions.

Use Case: Subscription signups, service payments.

Required Fields

Odoo FieldDescriptionGravity Forms Field Type
partner_idCustomerHidden/Select
journal_idJournalSelect/Hidden
invoice_line_idsItemsRepeater / Nested
move_typeInvoice type (out_invoice, in_invoice, etc.)Hidden / Select
invoice_dateInvoice DateDate

Optional Fields

Odoo FieldDescriptionGravity Forms Field Type
payment_referencePayment RefText
invoice_dateInvoice DateDate Picker
payment_term_idPayment TermsDropdown/Select
refCustomer referenceText
invoice_date_dueDue dateDate
invoice_source_emailEmail source (e.g., from external system)Email / Text
narrationInternal notesParagraph / HTML

Delivery Orders (stock.picking)

Trigger inventory movements such as deliveries or transfers.

Use Case: Shipping requests, internal transfers.

Required Fields

  • location_id: Source location
  • location_dest_id: Destination location
  • picking_type_id: Operation type
Odoo FieldDescriptionGravity Forms Field Type
location_idSource LocationDropdown/Hidden
location_dest_idDestination LocationDropdown/Hidden

Optional Fields

  • move_lines: Specific product transfers
  • scheduled_date
Odoo FieldDescriptionGravity Forms Field Type
move_linesStock ItemsRepeater/Nested
scheduled_dateDelivery DateDate Picker

Tasks (project.task) – Project (project.project)

Create tasks or projects for teams based on internal or external form submissions.

Use Case: Feature requests, bug reports, project tracking.

Required Fields

Odoo FieldDescriptionGravity Forms Field Type
nameTask TitleText

Optional Fields

Odoo FieldDescriptionGravity Forms Field Type
deadlineTask DeadlineDate Picker
descriptionTask DescriptionParagraph Text

Helpdesk Tickets (helpdesk.ticket)**

Transform form responses into tickets for customer support.

Use Case: Support requests, warranty claims.

Required Fields

Odoo FieldDescriptionGravity Forms Field Type
nameTicket TitleText
partner_idCustomerHidden/Select

Optional Fields

Odoo FieldDescriptionGravity Forms Field Type
tag_idsTagsCheckbox/Select
priorityPriority LevelDropdown
stage_idTicket StageDropdown/Hidden

Users (res.users)

Assign tasks, leads, or tickets to specific people based on logic.

Use Case: Round-robin assignment, department-based routing.

Required Fields

  • user_id or assigned_user_id: ID of the user
Odoo FieldDescriptionGravity Forms Field Type
loginUsernameText
nameCustomer's nameText
emailCustomer's emailText

* Not supported 100%, contact our support for more info

** Need Odoo Upgrade