Open APIs

 View Only
  • 1.  FieldOperationProductSpec and ShippingProductSpec

    TM Forum Member
    Posted Mar 19, 2020 09:50
    Hi All,
    The SID document, there are types of product specifications defined such as FieldOperationProductSpec and ShippingProductSpec. Are these supposed to be standalone product specifications for the purpose of appointment and shipping, or are these to be tagged along with an existing product specification (which may be goods). 
    e.g. Assume there's a broadband offering 
    Approach 1:
    ProductOffering
    	name: Plan A
    	productSpec
    		name: Broadband
    
    		productSpec
    			name: Modem
    			prodSpecChar
    				name: Speed​

    Now if Broadband product spec is somehow tagged as FieldOperationProductSpec requiring installation, we could send the product order as
    ProductOrder
    	orderItem
    		action: add
    		productOffering
    			name: Plan A
    		productSpec
    			name: Broadband
    		appointment
    			validFor
    				startDate: tomorrow
    			relatedPlace
    				role: installation
    				address1
    				address2
    		orderItem
    			productSpec
    				name: Modem
    			product
    				char
    					Speed: 100Mbps​

    This would create two products in the product inventory (one root product pointing to the Plan 1 offering and Broadband spec, and another sub product pointing to modem, assuming we use same product to point to both offering and composite spec).


    Now, if the appointment itself is modeled as a separate ProductSpecification, this would look like
    Approach 2:
    ProductOffering
    	name: Plan A
    	productSpec
    		name: Broadband
    
    		productSpec
    			name: Modem
    			prodSpecChar
    				name: Speed
    		productSpec
    			name: InstallationSpec
    			@type: FieldOperationProductSpec
    			productSpecChar
    				appointment
    ​
    and the order
    ProductOrder
    	orderItem
    		action: add
    		productOffering
    			name: Plan A
    		productSpec
    			name: Broadband
    
    		orderItem
    			product
    				productSpec
    					name: InstallationSpec
    					char
    						appointment
    							validFor
    								startDate: tomorrow
    							relatedPlace
    								address1
    								address2
    		orderItem
    			productSpec
    				name: Modem
    			product
    				char
    					Speed: 100Mbps​

    i.e. One extra product will be created in product inventory whose sole purpose is to serve as an installation address. Semantically, is this modeling correct as the installation is used only while order item fullfillment initially and won't be used to track in inventory?

    Which approach should be taken while modelling the product in catalog?. The same question remains in case of shipping.

    ------------------------------
    Shibin CK
    Tecnotree
    ------------------------------


  • 2.  RE: FieldOperationProductSpec and ShippingProductSpec

    TM Forum Member
    Posted Mar 22, 2020 03:10
    Hi Shibin
    To my best understanding, these product specification subclasses are not part of the normative Information Framework (SID), but rather illustrative.
    You could consult the guidebook addendum GB922 Product, found here , to see suggested modeling approaches in general (I am not sure if your particular case is covered there).

    SID leads @Cecile Ludwichowski and @Dirk Rejahl might have a more focused opinion on that.

    Hope it helps​​​​​​

    ------------------------------
    Jonathan Goldberg
    Amdocs Management Limited
    Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer.
    ------------------------------



  • 3.  RE: FieldOperationProductSpec and ShippingProductSpec

    TM Forum Member
    Posted Mar 22, 2020 09:09
    Hi Jonathan,
    Thank you. If we ignore the spec types for a moment, the crux of the question is
    If a product (e.g. Broadband) requires an installation, should that installation details be a separate product or should it be just a part of the order item corresponding to the broadband product?

    ------------------------------
    Shibin CK
    Tecnotree
    ------------------------------



  • 4.  RE: FieldOperationProductSpec and ShippingProductSpec

    TM Forum Member
    Posted Apr 22, 2020 09:07
    I would also like to know whether Shibin is correct in saying that an installation should have its own product. Currently, I'm modelling it as a related party with a defined role (i.e. role = "installation-address") but I'd like to know whether there's a more standard, or idiomatic, way of using the TMF622 API for this use case.

    ------------------------------
    Ben R
    TDC
    ------------------------------