1. Field Service Management
  2. FSM Configuration
  3. FSM Configuration Reference
  4. FSM Record Model Configuration
  5. FSM Item Fulfillment Model Reference

FSM Item Fulfillment Model Reference

Note:

This reference is intended for administrators and developers who work with Item Fulfillment model mappings and processing behavior.

The Item Fulfillment model represents itemfulfillment and inherits the Transaction base. It sets prototype.inventory to "items". The prototype.defaults property is empty. Its map adds the source transaction, read-only shipping address, and Item line information.

Standard default structure (JSON fragment):

          {
  "models/itemfulfillment": {
    "prototype": {
      "record": "itemfulfillment",
      "map": {
        "id": "*formulatext:case when {account} is null and lower({item.type.id}) not in ('taxitem', 'taxgroup', 'shipitem') then {internalid} end|internalid",
        "type": "formulatext:nvl({recordtype}, lower({type}))",
        "createdfrom": "createdfrom",
        "createdfromtype": "createdfrom.recordtype|",
        "entity": "entity",
        "customer": "custbody_nx_customer",
        "asset": "custbody_nx_asset",
        "case": "custbody_nx_case",
        "task": "custbody_nx_task",
        "status": "status",
        "date": "trandate",
        "email": "email",
        "contact": "contactprimary.internalid|",
        "purchaseorder": "otherrefnum|",
        "paymentmethod": "paymentmethod",
        "address": "shipaddress|",
        "items": [
          {
            "item": "item|item.item",
            "line": "line|item.line",
            "orderline": "|item.orderline",
            "quantityremaining": "formulanumeric:abs({quantity})|item.quantityremaining",
            "quantity": "formulanumeric:abs({quantity})|item.quantity",
            "location": "location|item.location",
            "asset": "custcol_nx_asset|item.custcol_nx_asset",
            "task": "custcol_nx_task|item.custcol_nx_task",
            "consumable": "custcol_nx_consumable|item.custcol_nx_consumable"
          }
        ]
      },
      "defaults": {},
      "syncentity": false,
      "inventory": "items"
    }
  }
}

For the meaning of the inherited syncentity and inventory properties and guidance on changing these properties, see Transaction Mappings and Processing Properties.

The inherited Project and Project Task mappings vary with Project Management. For the inherited mapping values, see FSM Transaction Base Model Reference. The Item-line mappings isbinitem, usesbins, isserialitem, and islotitem are generated according to the enabled bin, serial, lot, and advanced inventory features. These mappings are omitted from this fixed-value fragment.

The Item map contains Item, line, order-line reference, remaining quantity, quantity, location, Asset, Task, and Consumable links. Bin, serial, and lot properties are added according to enabled inventory features. Quantity mappings read absolute quantities. The model initializes inventory location during creation.

Fulfillment processing controls which transformed lines are received or fulfilled and validates the inventory assignments needed for each selected line. Invalid or missing assignments can leave a line out of the fulfillment. When no lines remain, no fulfillment is submitted. Preserve line identities and inventory feature dependencies.

This reference doesn't supply a custom fulfillment function or a generic model-copy procedure. Adding record: "itemfulfillment" to a new FSM Mobile article doesn't establish the specialized model's behavior.

Additional Information

Related Topics

General Notices