xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/Dealer Onboarding — entity reference
REFERENCE · Last reviewed

Dealer Onboarding — entity reference

Shown on screen as Partner Onboarding (the record was renamed from Dealer Onboarding, and several fields were renamed or dropped since this reference was generated). A Partner Onboarding record is the application a prospective dealer, distributor, service centre or spare-parts partner makes to join the network: the applicant, the firm, the site, banking details and KYC documents. Onboarding Status is the single stage field; users move it by editing it, or a tenant approval process moves it. Moving the record into Under Review checks the requirements configured for its Partner Type (Partner Type Requirements), an approval decision sets Approved or Rejected, and the Activate Partner action promotes or creates the partner account with a head-office branch, a Main storage location and its company set-up, then sets Activated. Applications are numbered in the PO series and live in the Partner Onboarding app.

Fields

FieldLabelTypeRequiredWhat it does
AadharNumberAadhar NumberNumber
ACNumberA/C NumberText
ApplicantContactNumberApplicant Contact NumberTextAnother number for the applicant. Used for the account's phone at activation only when Mobile Number is empty.
ApplicantPermanentAddressApplicant Permanent AddressText
ApplicantPincodeApplicant PincodeNumber
ApplicantResidenceAddressApplicant Resence AddressText
ApplicantResidenceStateApplicant Resence StatePickListValues: None, Delhi, Andhra Pradesh, Arunachal Pradesh, Assam, Bihar, Chhattisgarh, Goa, Gujarat, Haryana, Himachal Pradesh, Jharkhand, Karnataka, Kerala, Madhya Pradesh, Maharashtra, Manipur, Meghalaya, Mizoram, Nagaland, Odisha, Punjab, Rajasthan, Sikkim, Tamil Nadu, Telangana, Tripura, Uttar Pradesh, Uttarakhand, West Bengal, Andaman and Nicobar Islands, Chandigarh, Dadra and Nagar Haveli and Daman and Diu, Lakshadweep, Puducherry, Ladakh, Charlotte, Ohio.
ApplicantResidenceTypeApplicant Resence TypePickListValues: Owned, Rented.
ApplicantWorkspaceAddressApplicant Workspace AddressText
ApprovalByLegalTeamApproval By Legal TeamPickListThe legal team's sign-off, recorded for reference and reporting. Nothing reads it and it does not change Onboarding Status. Values: Approval Pending, Approved, Rejected.
ApprovalByRSMApproval By RSMPickListThe regional sales manager's sign-off, recorded for reference and reporting. Nothing reads it and it does not change Onboarding Status; a tenant approval process decides the outcome. Values: Approval Pending, Approved, Rejected.
ApprovalStatusByLegalApproval Status By LegalPickListA second legal sign-off field with Pending Approval instead of Approval Pending as its first value. Nothing reads it; decide which of the two legal fields your team uses. Values: Pending Approval, Approved, Rejected.
AreaLocalitySectorArea / Locality / SectorTextThird part of the site's street address, used by activation for the billing street and default address. Not on the standard forms.
BankerAddressBanker AddressText
BankerNameBanker NameText
CategoryCategoryPickListNo longer on the record. Values: E-Bike.
ChannelHeadApprovalChannel Head ApprovalPickListThe channel head's sign-off, recorded for reference and reporting. Nothing reads it and it does not change Onboarding Status. Values: Pending Approval, Approved, Rejected.
CityCityTextThe site's city. Copied to the account's billing city and to the default address at activation when empty.
CreatedDateTimeCreated DateDateAndTimeYes
CurrentBusinessOfTheFirmCurrent Business Of The FirmText
DateOfBirthDate Of BirthDate
DateOfEstablishmentDate Of EstablishmentDate
DealerCodeDealer CodeTextNow called Partner Code. The partner's code, filled in by Activate Partner when empty: from the Partner Code numbering setting when that is switched on (it is off as shipped), otherwise a code starting DLR- followed by the date and time. It becomes the new account's code and its branch and storage-location names. Once it has a value it cannot be changed.
DealerLeadStatusDealer Lead StatusPickListNo longer on the record. The originating lead keeps its own status; the application records its origin in Lead and Application Source instead. Values: Open - Not Contacted, Working - Contacted, Nurturing, Closed - Lost, Closed - Won.
DealerLocationLatitudeDealer Location LatitudeNumberNo longer on the record under this name.
DealerLocationLongitudeDealer Location LongitudeNumberNo longer on the record under this name.
DealershipLocationDealership LocationPickListNo longer on the record under this name. Values: Main Market, City Outskirts, Any Other.
DealershipLocationAddressDealership Location AddressTextNo longer on the record under this name.
DistrictDistrictText
EmailIdEmailTextThe applicant's email. It fills the account's email at activation when empty, and receives the welcome email with the partner code.
FinancialCapabilityFinancial CapabilityPickListValues: Inventory Funding, Cash Credit Limit, Term Loan, Others.
FirmAddressFirm AddressTextThe firm's address as written on the application. For reference only; activation does not copy it.
FirmBankerNameFirm Banker NameText
FirmPANNumberFirm PAN NumberTextThe firm's PAN. At activation it fills the account's PAN when the account has none.
FirmTypeFirm TypePickListValues: Partnership, Private Limited, Proprietorship, Public Limited, HFCs, Others.
FlatDoorBuildingFlat / Door / BuildingTextFirst part of the site's street address. Activation joins it with Road / Street and Area / Locality / Sector into the account's billing street and the default address. Not on the standard forms.
FrontageOfShowroomFrontage Of ShowroomPickListValues: <20, 20-30, >30.
GenderGenderPickListValues: Male, Female, Others.
GSTNumberGST NumberTextThe firm's GSTIN. At activation it fills the account's GSTIN, and the GSTIN of the default address created for it, when they are empty.
IdIdGuidYes
IsDealerIs DealerTextNo longer on the record. Whether the firm is a live partner is shown by Onboarding Status Activated and by the Account field being set.
LegalHoldReasonLegal Hold ReasonPickListWhy the application is on legal hold. Any value is a hold: Activate Partner is hidden and refused until it is cleared, by emptying the field or with Release Legal Hold. The hold does not change Onboarding Status and does not, by itself, stop the application entering review. Set it directly on the Approval Status tab; the Place Legal Hold button cannot send the reason. Values: Frontage Of The Showroom, Improper Document, Layouts, Showroom & Workshop Photographs.
LOIExpiryDateLOI Expiry DateDateWhen the letter of intent expires. Typed by you; nothing checks it or lapses the application.
LOIExpiryDaysLOI Expiry DaysNumberA number you type for the days left on the letter of intent. It is not calculated from LOI Expiry Date.
LOIIssueDateLOI Issue DateDateWhen the letter of intent was issued. Typed by you; no action issues or extends a letter of intent.
MinimumShowroomAreaSqFtMinimum Showroom Area (Sq Ft)PickListA self-assessed showroom size band. Not checked by anything; use a Facility Norm requirement on Total Showroom Area (Sq Ft) to enforce a minimum. Values: <600, 600-800, 800-1000, >100.
MinimumWorkshopAreaSqFtMinimum Workshop Area (Sq Ft)PickListA self-assessed workshop size band. Not checked by anything; use a Facility Norm requirement on Total Workshop Area (Sq Ft) to enforce a minimum. Values: <200, 200-300, 300-400, >400.
MobileNumberMobile NumberTextThe applicant's mobile number. It fills the account's phone at activation when empty.
MSMEUdyogAadharNoMSME Udyog Aadhar NoTextThe firm's MSME or Udyam registration number. At activation it fills the account's MSME number when empty.
NameDealer Onboarding NoText, uniqueYesThe application number, assigned automatically from the PO numbering series when the application is saved. It is not the applicant's or the firm's name.
NameInBankAccountName In Bank AccountText
NameOfMainProprietorName Of Main ProprietorTextThe person applying on behalf of the firm.
NameOfTheFirmName Of The FirmTextThe firm's legal name. At activation it becomes the name of a newly created partner account and the label of its head-office branch.
OfficeEmailIdOffice EmailText
OnboardingRejectionReasonOnboarding Rejection ReasonPickListWhy the application was declined. When a tenant approval process rejects an application and this is empty, the approver's comment is copied here, or Criteria Not Fulfilled when there is no comment. Values: Improper Documentation, Lack Of Funds, Criteria Not Fulfilled, Poor Infrastructure.
OpportunityIdOpportunityLookup → OpportunityThe partner opportunity the application came from. Once it has a value it cannot be changed. At activation, if this opportunity has an account, that account is promoted to the partner account instead of a new one being created.
PANNumberPAN NumberTextThe applicant's PAN. At activation it fills the account's PAN when Firm PAN Number is empty and the account has none.
PartnerNamePartner NameText
PersonalQualificationOfApplicantPersonal Qualification Of ApplicantPickListValues: Below 12th Pass, 12th Pass, Graduate, Post-Graduate, Any Automobile Degree.
PinCodePin CodeNumberThe site's PIN code. Copied to the account's billing postal code and to the default address at activation when empty.
PropertyAvailableProperty AvailablePickListValues: Lease, Rented, Owned.
RelationshipWithMainPromoterRelationship With Main PromoterText
RemarksRemarksTextFree notes, up to 255 characters. Write the withdrawal reason here when you set Onboarding Status to Withdrawn.
ResidenceStatusResence StatusPickListValues: Owned, Rented.
RoadStreetRoad / StreetTextSecond part of the site's street address, used by activation for the billing street and default address. Not on the standard forms.
ShowroomOwnershipStatusShowroom Ownership StatusPickListValues: Owned, Rented.
SignatoryDesignationSignatory DesignationText
SignatoryNameSignatory NameText
SiteOwnershipSite OwnershipPickListValues: Owned, Rented.
StandaloneFacilityStandalone FacilityPickListValues: Yes, No.
StateStatePickListThe site's state. Copied to the account's billing state and to the default address at activation when empty. Values: None, Delhi, Andhra Pradesh, Arunachal Pradesh, Assam, Bihar, Chhattisgarh, Goa, Gujarat, Haryana, Himachal Pradesh, Jharkhand, Karnataka, Kerala, Madhya Pradesh, Maharashtra, Manipur, Meghalaya, Mizoram, Nagaland, Odisha, Punjab, Rajasthan, Sikkim, Tamil Nadu, Telangana, Tripura, Uttar Pradesh, Uttarakhand, West Bengal, Andaman and Nicobar Islands, Chandigarh, Dadra and Nagar Haveli and Daman and Diu, Lakshadweep, Puducherry, Ladakh, Charlotte, Ohio.
TelephoneNumberTelephone NumberText
TotalDealershipAmountTotal Dealership AmountDecimalThe total investment agreed for the appointment. For reference only.
TotalShowroomAreaSqFtTotal Showroom Area (Sq Ft)NumberThe surveyed showroom area in square feet. A Facility Norm requirement can demand a minimum by naming this field, but requirements whose kind was picked from the current list are not recognised by the review check, so confirm in a sandbox that yours is enforced.
TotalWorkshopAreaSqFtTotal Workshop Area (Sq Ft)NumberThe surveyed workshop area in square feet. A Facility Norm requirement can demand a minimum by naming this field, but requirements whose kind was picked from the current list are not recognised by the review check, so confirm in a sandbox that yours is enforced.
TurnoverOfCurrentBusinessTurnover Of Current BusinessPickListValues: <25, 25-50, 50-75, >75.
TypeTypePickListThe firm's constitution (Partnership, Proprietorship, LLP, Private Ltd., HUF). Values: Partnership, Proprietorship, LLP, Private Ltd., HUF.
TypeOfPropertyDealerType Of Property DealerTextNo longer on the record under this name.
UpdatedDateTimeModified DateDateAndTimeYes
WorkshopOwnershipStatusWorkshop Ownership StatusPickListValues: Owned, Rented.
WorkshopPinCodeWorkshop Pin CodeNumber

Actions

ActionLabelTypeWhat it does
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
EditEditEditEdit
EditInLineEditEditInlineEdit
NewNewNewNew