The Supersession Unity API endpoint will be created to allow users to Create, Update and Delete Supersessions Fusion.

• A Supersession record is considered a record that will allow a user to identify a valid part number in Fusion that will be replaced by another valid Part Number in Fusion.
• These records will be able to be found in the Fusion form, INV91600 Cross Reference and Supersession

POST Request

https://api.karmak.io/api/unity/{version}/unityapi/partsinventory/CreateSupersession

PUT Request

https://api.karmak.io/api/unity/{version}/unityapi/partsinventory/UpdateSupersession

DELETE Request

https://api.karmak.io/api/unity/{version}/unityapi/partsinventory/DeleteSupersession

Specifications

POST

• The POST method will be used to create Supersession records in Fusion.
• Only one Supersession record will be allowed in a single request call.
• A combination of the following must be passed in to identify a unique record when attempting to create a Supersession record.  If one of these combinations aren’t passed in the Request should fail.
  • From Part Number, From Supplier, Branch, To Part Number, To Supplier
  • From Part Number, From Supplier, All Branches, To Part Number, To Supplier
• A response will be provided with a message section that will outline a success or any issues that prevented the Supersession from being created.
• The Fusion Username used in the Unity API call will be used as the Add and Last Update User of the Supersession created.
• The Date and Time the Unity API call was made will be used as the Add Date and Last Update of the Supersession created.
• The Supersession record will be created in Fusion following the standard create logic of the INV91600 Cross Reference and Supersession form in Fusion outside of any specific rules listed in this section and the POST/PUT Request Fields Section below.

PUT

• The PUT method will be used to update Supersession records in Fusion.
• Only one Supersession record will be allowed in a single request call.
• A combination of the following must be passed in the Supersession Identity section to identify a unique record when attempting to update a Supersession record.  If one of these combinations aren’t passed in the Request should fail.
  • From Part Number, From Supplier, Branch, To Part Number, To Supplier
  • From Part Number, From Supplier, All Branches, To Part Number, To Supplier
• A response will be provided with a message section that will outline a success or any issues that prevented the supersession from being updated.
• The Fusion Username used in the Unity API call will be used as the Last Update User of the Supersession updated.
• The Date and Time the Unity API call was made will be used as the Last Update Date of the Supersession updated.

DELETE

• The DELETE method will be used to delete Supersession records in Fusion.
• Only one Supersession record will be allowed in a single request call.
• A combination of the following must be passed in the Supersession Identity section to identify a unique record when attempting to delete a Supersession record.  If one of these combinations aren’t passed in the Request should fail.
  • From Part Number, From Supplier, Branch, To Part Number, To Supplier
  • From Part Number, From Supplier, All Branches, To Part Number, To Supplier
• A response will be provided with a message section that will outline a success or any issues that prevented the Supersession from being deleted.

POST/PUT/DELETE Request Fields

POST JSON Request Sample

{
	"fromPartNumber":"\#10BRUSH",
	"fromSupplier":"3M",
	"fromBranch":"01",
	"toPartNumber": "3719K",
	"toSupplier":"abc",
	"supersessionType":"Zero Available",
	"supersessionDate":null,
	"movePicksandSales":true,
	"movePicksandSalesImmediate":true,
	"changeFromPartStockStatusWhenSuperseded":true,
	"changeFromPartStockStatusImmediately":false,
	"newStockStatus":"Superseded",
	"changeOpenOrderInfoWhenSuperseded":true,
	"changeOpenOrderInfoImmediately":false,
	"setFromPartInactive":true,
	"printMessageOnInvoice":false,
	"allBranches":false,
	"crossReferenceMessage":"",
	"MovePartQuantitiesWhenSuperseded":false,
	"MovePartQuantitiesImmediately":false
}

POST JSON Response Sample

{
	"Status": "Part supersession created successfully.",
	"Message": null
}

PUT JSON Request Sample

{
	"Identity":
	{
		"fromPartNumber":"WHI332644",
		"fromSupplier":"3M",
		"Branch":"03",
		"toPartNumber": "WHI332644P",
		"toSupplier":"3M"
	},
	"fromPartNumber":"MPOP2",
	"fromSupplier":"00OP2"

}

PUT JSON Response Sample

{
	"Status": "Part supersession updated successfully.",
	"Message": null
}

DELETE JSON Request Sample

{
	"Identity":
	{
		"fromPartNumber":"0918-1",
		"fromSupplier":"ZMA",
		"Branch":"01",
		"toPartNumber": "0918-2",
		"toSupplier":"ZMA"
	}
}

DELETE JSON Response Sample

{
	"Status": "Part supersession deleted successfully.",
	"Message": null
}