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/Contact Address — entity reference
REFERENCE · Last reviewed

Contact Address — entity reference

A contact address is one entry in an account's address book: a billing address, a shipping address, or one that serves as both. Every contact address belongs to one account and can name the contact person at that address and an associated branch. The account's address marked Is Default fills new documents automatically: a Billing or Both address fills the billing side and a Shipping or Both address the shipping side. Sales orders, invoices and purchase orders fill on first save; bills, delivery orders and service orders also fill on later saves while the address is empty; on all of these the default contact address comes before the account's own address fields. Quotes and opportunities take the account's own address fields first and use the default contact address only for what they leave blank. Filling never overwrites a value already on the document, and the address text is copied, so editing a contact address does not change documents already raised. For India GST, the billing contact address's Place Of Supply and GSTIN fill a sales document's blanks before the account's, and its GST Registration Type, when set, decides the tax supply type instead of the account's. A branch's postal address is also a contact address, and the selling branch's address prints as the seller address on invoices. Activating a partner onboarding application creates a default Both address on the new partner account. Deleting a contact address sends it to the recycle bin.

Fields

FieldLabelTypeRequiredWhat it does
AccountIdAccountLookup → AccountThe account the address belongs to. Required: an address cannot be saved without an account. Documents raised for this account offer its addresses, and the account's default address fills them automatically.
AddressTypeAddress TypePickListBilling, Shipping or Both. A Billing or Both address can fill a document's billing side and a Shipping or Both address its shipping side when it is the account's default.
BranchIdBranchLookup → BranchAn optional branch the address is associated with. A branch's own postal address is chosen separately, in the Address field on the branch record.
CityCityPickListThe city as a picklist value maintained by the administrator. Copied to a document's billing or shipping city when the address fills it. Values: Pune.
CityPlaceIdCityLookup → PlaceThe city as a record from the optional places master, shown with the label City. Not on the shipped web or mobile address forms. When set, it is copied to the document's city lookup along with the text city; the printed one-line address uses the text city only.
ContactIdContactLookup → ContactThe optional contact person at this address.
CountryCountryPickListThe country as a picklist value maintained by the administrator. Copied to documents when the address fills them. Values: India.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DealerOnboardingIdDealer OnboardingLookup → DealerOnboardingThe partner onboarding application this address was created from. Set automatically when an application is activated and the new partner account has no default address yet; that address is created as a default Both address from the application's address, city, state, PIN code and GST number.
GSTINGSTINLongMultiLineTextThe GST number registered at this address, for a party registered in more than one state. Copied to sales documents whose own GSTIN is blank, ahead of the account's GSTIN. No format check runs on this field when the address is saved. GST reconciliation names a party from the account that owns an address carrying the row's GSTIN when no account carries it.
GSTRegistrationTypeGST Registration TypePickListHow the party is registered for GST at this address. When set on a sales document's billing address it decides the tax supply type instead of the account's value: Out Of Scope and Non GST Supply make the supply Exempt, Overseas and Deemed Exports make it Export, Special Economic Zone (SEZ) makes it SEZ, and any other value leaves it to the place-of-supply comparison. Values: GST Registered- Regular, GST Registered- Composition, GST Unregistered, Consumer, Overseas, Special Economic Zone (SEZ), Deemed Exports, Non GST Supply, Out Of Scope.
IdIdGuidYes
IsDefaultIs DefaultBooleanMarks the address that new documents use automatically for the account, on the side its Address Type allows. Off by default. Saving an address as default in the back office does not switch other defaults off, so keep one default per side per account; with two, either may be used.
LastModifiedByLast Modified ByLookup
ModifiedByIdModified ByLookup → UserAccountYes
NameNameTextThe label that identifies the address in lists and lookups. Required on the mobile form. Addresses created automatically are named after their street.
OwnerIdOwnerLookup → UserAccountYes
PlaceOfSupplyPlace Of SupplyPickListThe GST state for supplies billed to this address. Copied to sales documents whose own place of supply is blank, ahead of the account's value, and compared with the branch's source of supply to decide between within-state and outside-state supply.
PostalCodePostal CodeTextThe postal or PIN code. Copied to documents when the address fills them.
RecordTypeIdRecord TypeGuid, hidden
RegionRegionTextA free-text region or district. Copied to documents when the address fills them.
StateStatePickListThe state as a picklist value maintained by the administrator. Copied to documents when the address fills them. Values: Maharashtra.
StreetStreetTextStreet, building and locality, up to 200 characters. Copied to documents when the address fills them.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete the selected records.
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete in a list page
EditEditEditEdit
EditInLineEditEditInlineEdit in list header
EditInListEditEditInlineEdit
EditPopupEditEditEditPopup
NewNewNewNew
NewInLineNewNewInlineNewInLine
  • UserAccount — looks up via CreatedById
  • Place — looks up via CityPlaceId
  • Account — looks up via AccountId
  • UserAccount — looks up via OwnerId
  • Branch — looks up via BranchId
  • Contact — looks up via ContactId
  • Item — looks up via ItemId
  • UserAccount — looks up via ModifiedById
  • Opportunity — referenced by via ShippingAddressId
  • Branch — referenced by via ContactAddressId
  • Opportunity — referenced by via BillingContactAddressId
  • ServiceOrder — referenced by via BillingAddressId
  • DeliveryOrder — referenced by via DeliveryContactAddressId
  • Bill — referenced by via ShippingContactAddressId
  • Opportunity — referenced by via BillingAddressId
  • Opportunity — referenced by via PickUpAddressId
  • DealerOnboarding — referenced by via DealerOnboardingId
  • Asset — referenced by via InstallationAddressContactAddressId
  • Opportunity — referenced by via DropOffAddressId
  • Order — referenced by via ShippingContactAddressId
  • DeliveryOrder — referenced by via BillingContactAddressId
  • ServiceOrder — referenced by via ShippingAddressId
  • Invoice — referenced by via ShippingContactAddressId
  • CheckInInspection — referenced by via ContactAddressId
  • Opportunity — referenced by via ShippingContactAddressId
  • DeliveryOrder — referenced by via ShippingContactAddressId
  • Visit — referenced by via VisitContactAddressId
  • Quote — referenced by via BillingContactAddressId
  • PurchaseOrder — referenced by via ShippingContactAddressId
  • PurchaseOrder — referenced by via BillingContactAddressId
  • Invoice — referenced by via BillingContactAddressId
  • Bill — referenced by via BillingContactAddressId
  • Order — referenced by via BillingContactAddressId
  • Quote — referenced by via ShippingContactAddressId