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

Transfer — entity reference

A stock transfer between branches, and optionally between companies, in your organisation. Type decides the document's role and its lines. An Outward transfer carries Transfer Outward Lines. Releasing it takes the stock out of the source and puts it in transit to the destination, and generates a separate Inward transfer with one Transfer Inward Line per released line. The two documents are cross-linked through Inward Document and Outward Document. The destination receives the inward transfer and then posts it with Post Inventory, which moves the stock out of transit into the line's storage location. A Single Step transfer carries Transfer Lines and posts the source and destination effects together, with no transit. Inward transfers cannot be created by hand. Progress is shown by the calculated Outward Released, Inward Received and IL Posted flags; Status follows seeded business rules on save.

Fields

FieldLabelTypeRequiredWhat it does
BranchIdFrom BranchLookup → BranchYesThe source branch whose stock the transfer reduces. Shown as From Branch.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DocumentDateDocument DateDateAndTimeSet to the moment the transfer is first saved. A seeded validation refuses any later change.
ExecutiveResourceIdExecutiveLookup → ResourceNot used by any transfer process.
ExternalIdExternalText, unique
FieldSalesIdField SalesLookup → FieldSalesThe van-sales run that created this transfer through its load, take-in or unload actions.
IdIdGuidYes
InwardTransferIdInward DocumentLookup → TransferOn an outward transfer, the inward transfer created by its most recent release. Each release creates its own inward transfer, so earlier ones are found on the Related tab.
IsILPostedIL PostedCalculated (calculated)Calculated: the transfer has lines and every line, of any kind, carries an inventory ledger entry.
IsInwardPostedInward PostedCalculated (calculated)Calculated: the transfer has inward lines and every one carries an inventory ledger entry.
IsInwardReceivedInward ReceivedBooleanCalculated: the transfer has inward lines and every one is marked received, that is, has nothing left to receive.
IsOutwardReleasedOutward ReleasedCalculated (calculated)Calculated: the transfer has outward lines and none has pending release quantity left. Release Outward is refused once it is on.
ModifiedByIdModified ByLookup → UserAccountYes
NameDocument NumberTextThe document number, generated by the Transfer Name Setting: series TR, the date as day-month-year and a six-digit counter, joined by hyphens.
OutwardTransferIdOutward DocumentLookup → TransferOn an inward transfer, the outward transfer whose release created it.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdFrom Partner AccountLookup → AccountYesThe source company. Shown as From Partner Account.
PerformILPostingPerform IL PostingBooleanNot used. Posting is done by the Post Inventory and Selective Transfer actions.
PerformInwardPostingPerform Inward PostingBooleanNot used. Posting is done by the Post Inventory action.
PerformInwardReceivePerform Inward ReceiveBooleanNot used. Receiving is done by the Inward Recieve and Selective Inward Receive actions.
PerformOutwardReleasePerform Outward ReleaseBooleanNot used. Releasing is done by the Release Outward and Selective Release Outward actions.
PurchaseRequisitionIdPurchase RequisitionLookup → RequisitionThe requisition this transfer was created from by Release Transfer or Selective Release Transfer. The outward lines' quantities count towards the requisition lines' Stock Transfer Quantity.
ReceivedResourceIdReceived ByLookup → ResourceThe person expected to accept the goods. Optional and not needed to release. The release copies it onto the generated inward transfer. When set, the person must be allowed for the source company and branch through their partner-resource assignments.
ReceivedTimeReceived TimeDateTyped by hand; no action fills it in. A seeded validation refuses a Received Time earlier than Transfer Time.
RecordTypeIdRecord TypeGuid, hidden
StatusStatusPickListThe stepper value. Starts as Draft. Seeded business rules set Released when every outward line is fully released, and Received when every inward line is received, every outward line is fully closed, or every single-step line is posted. These rules run on save, so Status can trail an action until the next save. The Pending Approval and Approved values are never set by the system and are for a tenant-built approval process. Values: Draft, Pending Approval - Outward, Approved - Outward, Released, Pending Approval - Inward, Approved - Inward, Received.
ToBranchIdTo BranchLookup → BranchYesThe destination branch. The in-transit balance is held against it, and lot copies made at release belong to it.
ToPartnerAccountIdTo Partner AccountLookup → AccountThe destination company for a transfer between companies. Leave it blank for a move inside one company; lot copies are then owned by the From Partner Account. A two-step transfer needs To Branch or To Partner Account.
TotalClosedQuantityTotal Closed QuantityCalculated (calculated)
TotalQuantityTotal QuantityCalculated (calculated)Calculated sum of line quantities for the line set that matches Type: inward lines for Inward, outward lines for Outward, transfer lines for Single Step.
TransferredByResourceIdTransferred ByLookup → ResourceThe person who sends the goods. Optional. When set, the person must be allowed for the source company and branch through their partner-resource assignments.
TransferTimeTransfer TimeDateAndTimeSet to the moment the transfer is first saved, replacing any value typed on the New form. It can be edited afterwards and is not moved by the release.
TypeTypePickListYesOutward, Inward or Single Step. Outward is the source document of a two-step move; Inward is generated only by releasing an outward transfer (saving one by hand is refused); Single Step posts both ends at once. Values: Inward, Single Step, Outward.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes

Actions

ActionLabelTypeWhat it does
BulkDeleteDeleteDeleteDelete
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete
EditEditEditEdit
EditEntityEditEditInlineEdit
EditEntityDetailsEditEditEdit Entity
EditInLinesEditEditInlineEdit
NewNewNewNew
PerformILPostingPost InventoryServerAction (PerformILPosting)Post Inventory (single step): approves every single-step line for posting; each unposted line then posts its outward and inward effects together and gets a destination lot copy. Does nothing on outward or inward transfers.
PerformInventoryPostingPost InventoryServerAction (PerformInventoryPosting)Post Inventory: posts every line of the transfer's own line set that has no ledger entry yet. On an inward transfer it needs at least one received line, posts each line's full Quantity into its storage location, takes it out of transit and records shortage, damage and excess separately.
PerformInwardReceiveInward RecieveServerAction (PerformInwardReceive)Inward Recieve: receives every inward line's pending quantity, adds it to Received Quantity and writes it back to the outward line's Closed Quantity. It does not post stock.
PerformOutwardReleaseRelease OutwardServerAction (PerformOutwardRelease)Release Outward: releases every outward line's pending quantity. It posts the Transfer Outward entries, adds the quantity to the destination's in-transit balance, copies lots for the destination and creates a new Inward transfer. Refused on a transfer that is not Outward, has no lines, or is already fully released.
SelectiveInwardReceiveSelective Inward ReceiveServerAction (SelectiveInwardReceive)Selective Inward Receive: receives the ticked inward lines for the quantity entered (not capped; above the line quantity it shows as excess). It does not post stock and does not record damage; enter Damaged Quantity on the line itself.
SelectiveOutwardReleaseSelective Release OutwardServerAction (SelectiveOutwardRelease)Selective Release Outward: releases only the ticked outward lines, each for its Requested Quantity (above zero and no more than the pending release quantity), and creates a new Inward transfer for them.
SelectiveTransferPostingSelective TransferServerAction (SelectiveTransferPosting)Selective Transfer: posts the ticked single-step lines, adding each line's Requested Quantity to its Received Quantity. Only for Single Step transfers.

Validations

ValidationApplies toError messageNotes
Restrict Inward CreateType, ErrorInward Document cannot be generated without an Outward Transfer Document.Restrict Inward Create
Branch Rule ValidationBranchId, Error, inactiveBranch can't be sameBranch can't be same
XM_DocumentDateChangeValidationDocumentDate, ErrorYou cannot change Document DateYou cannot change Document Date
XM_ReceivedTimeRuleValidationReceivedTime, ErrorReceived Time should be greater than transfer timeReceived Time should be greater than transfer time
Required FieldsErrorSelection of To Partner Account and To Branch is mandatory.Selection of To Partner Account and To Branch is mandatory.
XM_TimeValidationTransferTime, ErrorTransfer Time can't be less than received timeTransfer Time can't be less than received time

Lookup filters

FilterLookup fieldNotes
FromBranch For Partner AccountBranchId
To Branch For Partner AccountToBranchId