Purchase requisition sync

With the purchase requisition sync, your purchase requisitions created in SAP Ariba are imported into Fairmarkit, and request for quote events are created. When you award your event, Fairmarkit sends the awarded data back to SAP Ariba, and your purchase requisition is updated.

Note: The SAP Ariba integration provides a number of configurations to customize your integration. See SAP Ariba requisition import configurations and SAP Ariba integration - optional configurations.

Import to Fairmarkit

Based on a scheduled job, Fairmarkit will import your purchase requisitions created in SAP Ariba and create request for quote events in Fairmarkit. This scheduled job can be adjusted to run at your requested interval.

The scheduled job does the following:

• Finds all your submitted purchase requisitions.
• Maps your SAP Ariba data to for use in Fairmarkit.
• Creates a request for quote event in Fairmarkit.

Export to SAP Ariba

When your award your request for quote event, Fairmarkit sends the award data back to SAP Ariba and the purchase requisition is updated. This process works in real-time, and you should see your update within a few seconds. During this process, the following will happen:

Note: Depending on your needs, you can request comments and additional approvers to be added.

Note: Bundling is not currently supported for the export to SAP Ariba.

• Event awarded in Fairmarkit.
• Maps your Fairmarkit data to use in SAP Ariba.
• Updates purchase requisition in SAP Ariba.

How is data mapped?

When you import to Fairmarkit or export back to SAP Ariba, the data is mapped to ensure that it ends up in the correct fields in each application. For more information, see How is data mapped?

SAP Ariba & Fairmarkit data mapping

	SAP Ariba field The field name in SAP Ariba	JSON Path The data in the API JSON file.	Description A description of the data.	Fairmarkit use Description of how data is used in Fairmarkit.
		ApprovalRequests__Approver__UniqueName		This is optional and can be used to filter requisitions currently in the approval queue and assigned to Fairmarkit.
*	Billing Address	LineItems__BillIngAddress	Billing Address code	This is metadata used when exported back to SAP Ariba.
	Deliver to	LineItems__DeliverTo
	Commodity Code	LineItems__Description.CommonCommodityCode__Name	Level 1 Commodity Name	Category Parent Name
	Commodity Code ID (not displayed in UI)	LineItems__Description.CommonCommodityCode__UniqueName	Commodity UNSPSC Code	UNSPSC Predicted Item Categories - Parent Identifier/external ID
*	Item description	LineItems__Description.Description	Line level detail indicating requisitioned item or service.	Item Title
*	Price	LineItems__Description.Price__Amount	Unit price for the requisitioned item or service.	Item Benchmark Price
*	Currency	LineItems__Description.Price__Currency__UniqueName	Uses the currency of the last line item to set the currency for the Fairmarkit request for quote event.	Currency (request for quote event)
	Supplier Part #	LineItems__Description.SupplierPartNumber		Manufacturer Part Number
*	Unit	LineItems__Description.UnitOfMeasure__UniqueName	Unit of Measure Note: Default to "each" is not supported by Fairmarkit	UOM
	Need-by Date	LineItems__NeedBy	In SAP AribaAriba, this is selected on the Requisition level, but it displays on the line item level in the API. Uses the Need-by Date of the last line item to set the Preferred Delivery Date (on the header level) for the Fairmarkit request for quote event.	Preferred Delivery Date
*	No.	LineItems__NumberInCollection	Used to order the line items in the Fairmarkit request for quote event. When the data is exported back to SAP Ariba, this is used to make sure the correct line item is updated.	This metadata is used to order line items and when exporting to SAP Ariba to ensure the correct line item is updated.
	Parent No.	LineItems__ParentLineNumber	Used for special logic for sub items/services.	Specific item logic
*	Qty	LineItems__Quantity	Quantity of a line item	Quantity
	Service Item (checkbox)	LineItems__ServiceDetails.RequiresServiceEntry	Used to determine item type as service.	Specific service logic
		LineItems__ServiceDetails.ServiceEndDate	Used to modify event title in Fairmarkit (e.g. "{item title} {start date} - {end date}").	Item Title
		LineItems__ServiceDetails.ServiceStartDate	Used to modify event title in Fairmarkit (e.g. "{item title} {start date} - {end date}").	Item Title
	ShipTo (Plant)	LineItems__ShipTo__City	SAP Ariba sets the address at the line item level, but this value is set at the header level on a Fairmarkit event. Uses the first line item's shipping address.	City
	Not visible in UI	LineItems__ShipTo__Country__UniqueName	SAP Ariba sets the address at the line item level, but this value is set at the header level on a Fairmarkit event. Uses the first line item's shipping address.	Country
	Not visible in UI	LineItems__ShipTo__Lines	SAP Ariba sets the address at the line item level, but this value is set at the header level on a Fairmarkit event. Uses the first line item's shipping address.	Address1
	Not visible in UI	LineItems__ShipTo__PostalCode	SAP Ariba sets the address at the line item level, but this value is set at the header level on a Fairmarkit event. Uses the first line item's shipping address.
	Accounting - by Line Item - Bill to:	LineItems__ShipTo__State	SAP Ariba sets the address at the line item level, but this value is set at the header level on a Fairmarkit event. Uses the first line item's shipping address.	State
	Vendor Name	LineItems__Supplier__Name	Vendor name. This is during the import to Fairmarkit, but it is not used when exporting back to SAP Ariba.	Item Benchmark Supplier
	Vendor ID	LineItems__Supplier__UniqueName	Vendor ID. This is not used during the import to Fairmarkit, but it is used when exporting back to SAP Ariba.	External Supplier ID
*	Title	Name	Title of the requisition in Ariba	Requisition Title
	On Behalf Of	Requester__UniqueName		Requester
	Status	StatusString	Status Submitted for filtering and used server-side.	filtering / approvals
	Cart Summary	TotalCost__Amount	Sum of Requisition Spend. This is during the import to Fairmarkit, but it is not used when exporting back to SAP Ariba.	Total Amount
*	PR ID	UniqueName	Numeric identifier of the requisition	External RFQ ID