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

Delivery Order — entity reference

The outbound dispatch document for goods leaving a branch: the customer, the billing, shipping and delivery addresses, the Delivery Order Lines being sent and the transport and e-way bill details. It is normally created by an action on another document - Allocation Delivery or Picked Delivery on a fulfilment or sales order, Delivery on a sales order (only for lines already invoiced or allocated) or on an invoice, or a change to the approved or rejected quantity of a Part To Part claim line. Creating it moves no stock: Post Inventory posts the unposted lines to the inventory ledger as Outward movements, and Post General Ledger books the lines' gross value as Unbilled Dispatch against Inventory Asset. Create Invoice bills lines that came from allocation or picking, and Release Shipment creates a shipment for a receiving branch in the same tenant. The shipped record layout shows only Post Inventory, Post General Ledger, Print DO, Edit and Delete; the other actions must be added to the layout header.

Fields

FieldLabelTypeRequiredWhat it does
AccountIdAccountLookup → AccountThe customer receiving the goods, copied from the source order, fulfilment or invoice and locked after creation. On a claim delivery it is the claim's supplier. Release Shipment needs a branch whose partner account is this account.
AccountNameAccount NameText
ApprovedPartApproved PartBooleanTrue on the delivery order built from the approved quantities of a claim's Part To Part lines. Each change to a line's approved quantity adds another line to this one delivery order per claim.
ApproximateDistanceApproximate DistanceDecimal
BillingAddressBilling AddressText
BillingCityBilling CityPickListValues: Pune, Mumbai, Chandigarh.
BillingCityPlaceIdBilling CityLookup → PlaceValues: Pune, Chandigarh, Mumbai.
BillingContactAddressIdBilling AddressLookup → ContactAddress
BillingCountryBilling CountryPickListValues: India.
BillingPostalCodeBilling Postal CodeText
BillingRegionBilling RegionText
BillingStateBilling StatePickListValues: Haryana, Maharashtra, New Delhi, Punjab.
BillingStreetBilling StreetText
BillReturnIdBill ReturnLookup → BillReturn
BranchIdBranchLookup → BranchThe dispatching branch. It must belong to the partner account when the record is created and cannot be changed afterwards. Its stock is relieved when the lines are posted.
ClaimIdClaimLookup → ClaimThe warranty claim whose Part To Part lines produced this delivery. A claim has at most one approved-parts and one rejected-parts delivery order.
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DeliveredDateTimeDelivered Date TimeDateAndTimeThe moment the goods were handed over. It is not on the shipped forms and nothing sets it automatically; when present on a delivery for a service order, repeat-repair checks use it as the handover time.
DeliveryCityDelivery CityPickList
DeliveryContactAddressIdDelivery AddressLookup → ContactAddress
DeliveryCountryDelivery CountryPickListValues: India.
DeliveryDateDelivery DateDateThe actual delivery date, entered by the user. Nothing fills it automatically.
DeliveryDoneByResourceIdDelivery ByLookup → ResourceThe resource who makes the delivery. It must be a valid resource on save and is kept for reference; it does not assign visits.
DeliveryLocationDelivery LocationTextA free-text description of where to deliver, not coordinates. Route and distance calculations deliberately ignore it and take the planned position from the ship-to account's stored geolocation instead.
DeliveryPostalCodeDelivery Postal CodeText
DeliveryRegionDelivery RegionText
DeliveryStateDelivery StatePickListThe state or province of the ship-to address, held as free text. No code writes it; it is read once, when visit planning copies it onto the generated Visit as VisitState.
DeliveryStreetDelivery StreetText
DiscountDiscountCurrencyA header discount. Changing it spreads the discount across the delivery order lines again.
DiscountGroupIdDiscount GroupLookup → DiscountGroup
DocumentDateDocument DateDateThe accounting date of the dispatch. Set to the creation date by every delivery action except claim deliveries, which leave it empty, and locked after the first save. Post General Ledger dates its journal with it.
EWayBillDateE-Way Bill DateDateAndTime
EWayBillNumberE-Way Bill NumberTextThe e-way bill number for the consignment, recorded by the user. The E Way Bill action on delivery orders generates nothing.
ExternalIdExternalText
FailedItemTreatmentFailed Item TreatmentPickList
GeneralLedgerIdGeneral LedgerLookup → GeneralLedger
GLAccountIdGL AccountLookup → GLAccount
GSTINGSTINTextThe customer's GST number. Filled from the billing contact address, otherwise from the account, when empty, and format-checked on every save.
IdIdGuidYes
InventoryFulfilmentIdInventory FulfillmentLookup → InventoryFulfilmentThe fulfilment whose allocation or picking lines produced this delivery order. One delivery order is created per fulfilment per run.
InvoiceIdInvoiceLookup → InvoiceThe invoice this delivery was created from in an invoice-first process. Posting its lines reduces the invoice's pending-delivery stock instead of a plain Outward movement.
IsCancelledCancelledBoolean
IsConfirmedConfirmedBoolean
IsDeliveredDeliveredBooleanNot set by any shipped process. Visit planning only picks up delivery orders where it is not true, so delivery orders stay eligible for Order Delivery visits.
IsGLPostedIs GL PostedBooleanNot written by Post General Ledger; look for the journal sourced from the delivery order instead.
IsGLPostingApprovedIs GL Posting ApprovedBooleanSet to true by Post General Ledger just before the journal is posted.
IsILPostedIL PostedBooleanA header-level inventory-posted flag that no code writes. Inventory posted state is tracked per line by DeliveryOrderLine.InventoryLedgerId, which is also what the posting action filters on.
IsILPostingApprovedIL Posting ApprovedCalculated (calculated)An approval gate for inventory posting that is never enforced: the handler collects the approved records on update but discards the result without acting on it, and PerformInventoryPosting does not consult it. Setting it true does not authorise anything on its own.
IsInJobQueueIn Job QueueBoolean
IsShipmentReleasedShipment ReleasedBooleanNot written by Release Shipment. Each run of Release Shipment creates a new shipment, so check the shipments named after this document instead.
JobInterfaceQueueIdJob QueueLookup → InterfaceQueue
JobQueueIdJob QueueLookup
LRDateLR DateDateAndTime
LRNumberLR NumberTextThe carrier's lorry receipt or consignment note number.
ModifiedByIdModified ByLookup → UserAccountYes
NameDocument NumberTextThe document number, generated by the Delivery Order document name setting (default series DN). Released shipments are named SHP- followed by this number.
OrderIdOrderLookup → OrderThe sales order being delivered. Locked after creation. Create Invoice moves this order's Document State to Invoiced or Partially Invoiced.
OwnerIdOwnerLookup → UserAccountYes
PartnerAccountIdPartner AccountLookup → AccountThe selling company that owns the document. Copied from the source, checked against the branch on creation and locked afterwards. It becomes the supplier on a released shipment, and Post General Ledger needs GL Posting Enabled on it.
PerformPopulateChecklistPerform Populate ChecklistBooleanNot used. Run the Populate Checklist action instead.
PerformReleaseShipmentPerform Release ShipmentBooleanNot used. Run the Release Shipment action instead.
PlaceOfSupplyPlace of SupplyPickListThe destination state for GST. Filled from the billing contact address, otherwise from the account, when empty; compared with Source of Supply to decide Tax Supply Type. Values: Haryana, Maharashtra, Gujarat, Rajasthan.
PorterContactNumberPorter Contact NumberText
PriceAsOnDatePrice As On DateDate
PriceListIdPrice ListLookup → PriceList
RecordTypeIdRecord TypeGuid, hidden
RejectedPartRejected PartBooleanTrue on the delivery order built from the rejected quantities of a claim's Part To Part lines; the counterpart of Approved Part.
RemarksRemarksText
RequestedDeliveryBranchTimeSlotBookingIdRequested Delivery Time Slot BookingLookup → BranchTimeSlotBooking
RequestedDeliveryBranchTimeSlotIdRequested Delivery Time SlotLookup → BranchTimeSlot
RequestedDeliveryDateRequested Delivery DateDateThe date the customer asked for. Kept separate from the scheduled and actual delivery dates.
RequestedDeliveryDateTimeRequested Delivery Date TimeDateAndTime
RequestedDeliveryTimeRequested Delivery TimeTimeOnly
RoundOffRound OffCurrencyTotalAmount is computed purely from the line roll-ups.
ScheduledDeliveryDateScheduled Delivery DateDateThe date the warehouse plans to deliver, entered by the user.
ScheduledDeliveryDateTimeScheduled Delivery Date TimeDateAndTimeThe planned delivery time used by visit planning: an Order Delivery visit plan picks up delivery orders whose time falls in its window, or that have none, and uses it as the visit's planned start. It is not on the shipped forms.
ServiceOrderIdService OrderLookup → ServiceOrderThe service order this delivery serves, set when a picked delivery is made for a fulfilment raised from a service order.
ShippingAddressShipping AddressText
ShippingCityShipping CityPickListValues: Pune, Mumbai, Chandigarh.
ShippingCityPlaceIdShipping CityLookup → PlaceValues: Pune, Chandigarh, Mumbai.
ShippingContactAddressIdShipping AddressLookup → ContactAddress
ShippingCountryShipping CountryPickListValues: India.
ShippingPostalCodeShipping Postal CodeText
ShippingRegionShipping RegionText
ShippingStateShipping StatePickListValues: Haryana, Maharashtra, New Delhi, Punjab.
ShippingStreetShipping StreetText
SourceOfSupplySource of SupplyPickListThe origin state for GST, filled from the dispatching branch when empty. Values: Rajasthan, Haryana, Maharashtra, Gujarat.
StatusStatusPickListThe dispatch stage. The seeded business rule Set Delivery Order Status To Delivered sets it to Delivered on a save once every line is posted to the inventory ledger, which drives the Pending and Delivered views. The shipped picklist values are inactive, so users do not pick it by hand. Values: Insurance Issued.
Tax1Tax1Currency
Tax1NameTax Name 1Text
Tax1RateTax Rate 1Currency
Tax1TypeTax Type 1Text
TaxSupplyTypeTax Supply TypePickListThe GST supply classification, recalculated on every save for India GST: Exempt, Export or SEZ from the GST registration type of the billing address or account, otherwise Outside State when Place of Supply differs from Source of Supply and Within State when they match. A value picked by hand is overwritten. Values: Within State, Outside State.
TotalAmountTotal AmountCalculated (calculated)Calculated as TotalLineAmount plus line tax, falling back to TotalTaxAmount2 when TotalLineTaxAmount is zero. It ignores the header Discount and RoundOff fields, so it is not necessarily the amount invoiced.
TotalDiscountAmountTotal Discount AmountCalculated (calculated)
TotalLineAmountTotal Line AmountCalculated (calculated)
TotalLineBaseAmountTotal Line Base AmountCalculated (calculated)
TotalLineGrossAmountTotal Line Gross AmountCalculated (calculated)The sum of the lines' GrossAmount (line amount plus tax, less post-tax discounts). This is the figure PerformGLPosting books, as Dr Unbilled Dispatch / Cr Inventory Asset.
TotalLineTaxAmountTotal Line Tax AmountCalculated (calculated)
TotalTaxAmountTotal Tax Posting AmountCalculated (calculated)Calculated as the line tax total plus the header Tax1, and labelled Total Tax Posting Amount. It pairs with TotalTaxAmount2, which is the same line total minus Tax1 - the two are a plus and minus pair, not two independent tax totals.
TotalTaxAmount2Total Tax AmountCalculated (calculated)
TransportDocumentDateTransport Document DateDateAndTime
TransportDocumentNumberTransport Document No.Text
TransporterGSTINTransporter GSTINTextThe carrier's GST number, format-checked on save.
TransporterNameTransporter NameText
TransportModeTransport ModeTextHow the goods travel, as free text (for example Road, Rail, Air or Ship). It is recorded only.
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes
VehicleNumberVehicle NumberTextThe vehicle registration carrying the goods, format-checked on save. It is not linked to any asset or fleet record.
VisitIdVisitLookup → VisitA visit linked to the delivery. Visit planning skips delivery orders where it is set, but generating an Order Delivery visit does not set it.

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 page.
EditInListEditEditEdit
EditListHeaderEditEditInlineEditListHeader
EWayBillE Way BillServerActionHas no server behaviour for delivery orders and generates no e-way bill. Record the e-way bill number and date in the e-Way Bill panel instead.
NewNewNewNew
PerformCreateInvoiceCreate InvoiceServerAction (PerformCreateInvoice)Creates an invoice, one per sales order, from the delivery lines that still have quantity to invoice and came from an allocation or picking line; other lines are skipped. Refused when no line has quantity to invoice, or when the linked order lines are already fully invoiced. Not on the shipped record layout.
PerformGLPostingPost General LedgerServerAction (PerformGLPosting)Books the total of the lines' gross amounts as Unbilled Dispatch against Inventory Asset, dated with the Document Date, when GL Posting Enabled is on for the partner account. Running it again reverses the earlier journal and posts a new one.
PerformInventoryPostingPost InventoryServerAction (PerformInventoryPosting)Posts every line not yet posted to the inventory ledger as an Outward movement, releasing the picked, allocated or pending-delivery quantity behind it according to the line's source, and books the cost of goods sold. Refused when every line is already posted.
PerformPopulateChecklistPopulate ChecklistServerAction (PerformPopulateChecklist)Copies the lines of every checklist template whose Type is Delivery onto the delivery order as checklist lines. Creates nothing when no such template exists and adds another set on every run. Not on the shipped record layout.
PerformReleaseShipmentRelease ShipmentServerAction (PerformReleaseShipment)Creates a shipment named SHP- plus the document number for the branch whose partner account is the delivery's account, with one line per delivery line. Refused when no line has quantity or no such branch exists. Each run creates another shipment. Not on the shipped record layout.
PrintDOPrint DOPrintPrints the Delivery Order Report for the record through the browser's print dialog; changes no data.
SelectiveReleaseShipmentSelective Release ShipmentServerAction (SelectiveReleaseShipment)Creates a shipment for the chosen lines and quantities, each quantity checked against the line quantity. Uses the SelectivePostDelivery action layout, whose shipped lines list needs row selection switched on. Not on the shipped record layout.

Lookup filters

FilterLookup fieldNotes
Branch For Partner AccountBranchIdPartnerAccountId = __target.PartnerAccountId
Customer Account FilterAccountId
Executive FilterDeliveryDoneByResourceId
Partner Account FilterPartnerAccountId