Skip to content
Documentation Menu
WP connect > Gravity Forms to Odoo Documentation > Main Odoo Modules - Required Field Mapping

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
Mapping CRM module

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

📸 [Insert screenshot of mapping example]


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

📸 [Insert screenshot of a stock picking setup]


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%

** Need Odoo Upgrade