Overview

The Parts Purchase Order API is used to create a Parts Purchase Order in Fusion.

When placing a purchase order the parts and quantities passed to the API are processed as an parts purchase order on the business system and, if successful, the purchase order number is returned.

Requires Updated Fusion Version: 3.62.00 or newer

Validations for Parts Purchase Order

• Only 1 Purchase Order should be allowed to be passed in on the Request at a time
• Set the Purchase Order Status to “In Process” when creating a Parts Purchase Order via Unity. Currently this API will only support creating “In Process” Parts Purchase Orders.
• Set the Purchase Order Number to the “Next Inventory P/O Number” from the Parts Tab of the Branch record that the Purchase Order is created from.
  • Ensure to increment the number on the Branch record once pulling the value to use on the newly created Parts Purchase Order.
• Set the Purchase Order Source on the Fusion Purchase Order to “Unity” when a Purchase Order is created this API.
  • Add the PurchaseOrderSource value of “Unity” to the PurchaseOrderSource Fusion Database Table.
• Set the Inter-Branch Checkbox to True if the FillingLocationID field is populated indicating the user is creating an Inter-Branch Parts Purchase Order.
  • The Backorder Priority should be set to “Inter-Branch” as well in this scenario.
• Set the Add User and Last Update User to the Unity Username from the setup.
• Set the Add Date/Time and Last Update Date/Time to the current time the Parts Purchase Order was created ensuring to take the time zone offset into account.
• If adding an Exchange Part to the Parts Purchase Order, the Inherent Core should be added as well and reflected in the totals.
• The same part is not allowed on the Purchase Order more than once in the Line Item section.
• If adding a Part to the Purchase Order that has a Purchase Conversion set to a value greater than 1, a check should be made to ensure the Quantity being passed in is a multiple of the Part’s Buy Package. If not the part shouldn’t be added and a message should be returned to notify the user.
• If the Purchase Order is being created is set as an Inter-Branch Purchase Order then check the below Branch Parameters at the Filling Branch and compare against the quantity being requested from the Filling Branch to determine whether to allow a part to be placed on order or not. If a part can’t be ordered then a message should be returned to notify the user.
  • Branch Parameter 288 - Commit Last Sell Pack in Filling Branch?
  • Branch Parameter 300 - Allow IB Backorders from Parts Purchase Orders?
  • Branch Parameter 301 - Only allow Request branch to request Order Point Excess from Filling Branch?
• If the Part that was passed in to be added to the Parts Purchase Order has an Alternate Purchase Source Part Setup for the Branch that matches the Purchase Order Branch and is set to “Always Order As” then use the Alternate Purchase Source Part when adding to the Purchase Order.
  • The Alternate Purchase Source Order As Part Number and AP Vendor will be passed back for the specific Part Number.
  • The Cost of the Alternate Purchase Source record should be used if the Cost isn’t passed in.
• If the Create Parts Purchase Order API doesn’t pass in valid information in the lineItems section or if it is populated and the part isn’t validated in Fusion and causing it to not be added to the Parts Purchase Order, then the entire Parts Purchase Order shouldn’t be created in Fusion and a message should be returned.

Request Data Fields

Response Data Fields

POST DATA

/api/unity/{version}/unityapi/PartsPurchaseOrder/Create

SAMPLE REQUEST

{
	"LocationID": "2345644",
	"FillingLocationID": "4",
	"APVendorID": "1234",
	"OrderedBy": "JSmith",
	"SupplierID": "3456",
	"PODate": "2021-01-15",
	"IsDirectShip": "False",
	"lineItems": [{
			"PartID": "1234",
			"Quantity": "10",
			"Cost": "25.00",
			"Message": "Ordered for Stock"
		},
		{
			"PartID": "1212",
			"Quantity": "1",
			"Cost": "4.2940",
			"Message": "Ordered for Shop"
		}
	],
	"Shipping": {
		"CompanyName": "ABC Distributors",
		"AddressLine1": "1 Karmak Plaza",
		"AddressLine2": "",
		"City": "Carlinville",
		"Region": "IL",
		"PostalCode": "62626"
	}
}

SAMPLE RESPOSE

{
	"LocationID": "1",
	"FillingLocationID": "",
	"PartsPurchaseOrderID": "12112",
	"PONumber": "200645",
	"APVendorID": "1234",
	"SupplierID": "3456",
	"OrderedBy": "JSmith",
	"POTotal": "254.2900",
	"lineItems": [{
			"PartID": "1234",
			"PartNumber": "0218GG16",
			"Supplier": "Bendix",
			"Description": "Gasket",
			"Quantity": "10",
			"Cost": "25.0000",
			"ExtendedCost": "250.0000",
			"InherentCoreCost": "25.0000",
			"InherentCoreExtendedCost": "250.0000",
		},
		{
			"PartID": "1212",
			"PartNumber": "0218GG151",
			"Supplier": "Bendix",
			"Description": "Seal",
			"Quantity": "1",
			"Cost": "4.2940",
			"ExtendedCost": "4.2900",
		}
	],
	"messages": [
		"success"
	]
}