xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField SalesCRMRewardsClaimsInventoryProcurementWarehouse 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
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/Visit Task Activity — entity reference
REFERENCE · Last reviewed

Visit Task Activity — entity reference

One data-capture step under a VisitTask (visitTaskId, with visitId denormalized): the runtime instance of a VisitTaskTemplateActivity (visitTaskTemplateActivityId). A generic multi-type row - activityType decides the mobile renderer (checklist via checklistTemplateId, entity-form captures like Lead Capture / Log Case / Custom Form, photo and merchandising-audit captures that feed shelf-vision evaluation, order taking, payment collection) and the typed value slots (textValue, numericValue, currencyValue, dateValue, booleanValue, geolocationValue, longTextValue, email, phone, url) hold what was captured. The service auto-flips Status to Completed when any captured value changes on a not-yet-completed row. Writes are gated to the assigned rep, including inserts, because the mobile client materializes template activities as inserts already in an execution state. Links created documents back via orderId, serviceOrderId, deliveryOrderId, invoiceId, paymentId and productDemoId.

Fields

FieldLabelTypeRequiredWhat it does
ActivityNameActivity NameText
ActivityTypeActivity TypePickListPicks the capture behavior and mobile renderer: checklist types work through checklistTemplateId, entity-form types (Lead Capture, Log Case, Custom Form) open a create form for the target entity, photo/merchandising types capture images that shelf-vision evaluation consumes, and order/payment types create business documents linked back to the activity. Values: Take Order, Checklist, Digital Signature, Photo Capture, General Task, Stock Check, Payment Collection, Returns Pickup, Merchandising Audit, Asset Verification, Competitor Capture, New Outlet Registration, Parts Consumption, Meter Reading, Proof of Delivery, Time & Expense, Barcode Scan, Safety Compliance, Schedule Follow-up, Lead Capture, Log Case, Custom Form, Product Demo, Generate Invoice, Delivery Fulfillment, Service Order Execution.
BooleanValueBoolean ValueBooleanYes
ChecklistTemplateIdChecklist TemplateLookup → ChecklistTemplateThe questionnaire a checklist-type activity fills. Answers are stored as CheckListLine rows related to this activity by default, or to the visit's service order when the template activity routes them there.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
CurrencyValueCurrency ValueCurrency
DateDateTimeOnly
DateTimeValueDate Time ValueDateAndTime
DateValueDate ValueDateAndTime
DecimalValueDecimal ValueNumber
DeliveryOrderIdDelivery OrderLookup → DeliveryOrder
DurationDurationCalculated (calculated)
EmailEmailText
EndTimeEnd TimeTimeOnly
FieldNameField NameText
FieldValueField ValueText
FormLayoutIdForm LayoutExternalIdCreate-layout override for entity-form activity types, copied from the template activity so runtime rows carry it too; absent means the target entity's default Create layout is used.
GeolocationValueGeo Location ValueText
IdIdGuidYes
InvoiceIdInvoiceLookup → Invoice
IsActivityCompletedIs Activity CompletedBoolean
IsDisabledIs DisabledBooleanYes
IsHiddenIs HdenBooleanYes
LongTextValueLong Text ValueMultiLineTextHolds the full capture JSON stamped at completion (fields, lines, readings depending on the renderer), while textValue carries the short human summary. Parse it rather than treating it as free text.
ModifiedByIdModified ByLookup → UserAccountYes
NameNameText
NumericValueNumeric ValueNumber
ObjectNameObject NamePickListFor entity-form activity types: the metadata entity the capture creates (copied from the template's designer-authored target). The Custom Form type has no fixed entity and relies entirely on this field. Values: Sale Order, Sale Invoice, Repair Order.
OrderIdOrderLookup → Order
OwnerIdOwnerLookup → UserAccountYes
PaymentIdPaymentLookup → Payment
PerformAutomaticallyPerform AutomaticallyBooleanYes
PhonePhoneText
PlannedDurationPlanned DurationCalculated (calculated)
PlannedEndTimePlanned End TimeDate
PlannedStartTimePlanned Start TimeTimeOnly
ProductDemoIdProduct DemoLookup → ProductDemo
RecordTypeIdRecord TypeGuid, hidden
RNAExternalIdRNA ExternalText
SequenceNumberSequence NumberNumber
ServiceOrderIdService OrderLookup → ServiceOrder
StartTimeStart TimeTimeOnly
StatusStatusPickListAuto-managed: the service flips a not-yet-completed activity to Completed as soon as any captured value slot changes (text, numeric, currency, dates, boolean, geolocation, linked document ids and so on). Status timestamps mirror the visit-task pattern - Completed stamps endTime. Values: Started, Draft.
TextValueText ValueText
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes
URLURLText
VisitIdVisitLookup → Visit
VisitTaskIdVisit TaskLookup → VisitTask
VisitTaskTemplateActivityIdVisit Task Template ActivityLookup → VisitTaskTemplateActivity

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete
EditEditEditEdit
EditEntityEditEditEditEntity
EditInLineEditEditInlineEdit
EditInListEditEditInlineEdit In List Header
NewNewNewNew