Skip to main content
Buyerquest Community

Punchout To BuyerQuest - OCI Inbound and Outbound

This topic details OCI inbound and outbound fields and their requirements in punchouts to BuyerQuest.

OCI Inbound Fields in Punchout to BuyerQuest

The OCI Inbound fields in a Punchout to BuyerQuest are detailed below. 

Field Sample Value Field Location in BQ  Is Required
CATALOG_URL index.php/run/oci/    
sap-client 001    
sap-language E    
username Disney_UAT    
password Disney_UAT    
userid SAP_TEST_USER User's External ID  Yes
fname SAP
User's First Name  
Yes
lname Tester User's Last Name  Yes
email ociTester@buyerquest.net User's Contact Email  Yes
group General This field will map to BuyerQuest in the back end.

If this field is not set in the inbound message, then a default will need to be configured within the Admin Control Panel at:

System Administration > Settings & Configurations > Manage System Configurations > Marketplace > Punchout Integrations
 
server 208.69.122.165    
repositoryType M    
catalog Punchout Catalog    
language EN    
uilanguage EN    
datalanguage EN    
mask EN    
namesearch      
OCI_VERSION 4.0    
OPI_VERSION 1.0    
returntarget _parent    
HOOK_URL https://uadmin.punchoutcatalogs.net/ gate/ index.php/admin/testconn/response/    

Example OCI Inbound Message

BuyerQuest OCIInboundMessage2018Mar28.png

OCI Outbound from a Punchout to BuyerQuest - Base Data Elements

The fields for OCI outbound data from a Punchout to BuyerQuest are detailed here. 

Field Name Description Is Required BQ Table.field Gateway Variable* Sample Field Value
NEW_ITEM-VENDORMAT Supplier SKU Yes sales_flat_quote_
item.sku
SKU 0020-SIGN
NEW_ITEM-EXT_PRODUCT_ID Supplier SKU Yes sales_flat_
quote-item.sku
SKU 0020-SIGN
NEW_ITEM-DESCRIPTION Name Yes sales_flat_quote_
item.name
Name Bench Warning Flags Sign 18in x 24in
NEW_ITEM-QUANTITY   Yes sales_flat_quote_
item.qty
Quantity 1.0000
NEW_ITEM-PRICE Contract Price Yes sales_flat_quote_
item.price
Price 185.00
NEW_ITEM-UNIT Unit of Measure Yes sales_flat_quote_
item.unit_of_measure
UOM EA
NEW_ITEM-MATGROUP UNSPSC Yes sales_flat_quote_
item.unspsc
UNSPSC 24102006
NEW_ITEM-CURRENCY Base Currency Yes sales_flat_quote_
item.base_currency
  USD
ci_session session ID Yes SYSTEM GENERATED   BaXgm2wzhbuZjBSLiHnPpFDTIsFo3mPW5aVQ
NEW_ITEM-EXT_CUSTOM_OPTION Selected values for an item configured with custom options No     Shirt size=Large
|Embroidered Name=George
NEW_ITEM-AMAZON-OFFERID Amazon item offer ID No    

68IWY2v19Y6C%2BCXOYkEv
W7SAMR1a%2FKTN%2FpJoBlE%2BlYZ83h
HnIqrJqSsjI4bL9G8hqpFQsM1mOzPqrPBNzDiT
jogEXyInMu95St9GEDkiMC7qeK3JGrozMobwqvt
B6c6IHIz2xevDDl4wZY4YoYeXujljMgLuz8sf

Additional Available Optional Data Elements 

Field Name Description Is Required BQ Table.field Gateway Variable*
ManufacturerName Manufacturer Name No sales_flat_quote_item.XXX ManufacturerName
ManufacturerPartID Manufacturer Part ID No sales_flat_quote_item.XXX ManufacturerPartNumber
LeadTime Lead Time No sales_flat_quote_item.XXX LeadTime
PriceUnit Price Unit No sales_flat_quote_item.XXX PriceUnit
alternative_source_id Alternative Source ID No sales_flat_quote_item.XXX AlternativeSourceID
source_system_id Source System ID No sales_flat_quote_item.XXX SourceSystemID
SupplierPartAuxiliaryID Supplier Part Auxiliary ID No sales_flat_quote_item.XXX SupplierPartAuxiliaryID
ItemAttachment Attachment No sales_flat_quote_item.XXX  

Web Form Fields Configured to be Included in OCI Response

Web Form fields may be configured to have data included in the OCI Cart Transfer. Web Form fields configured to be sent in the OCI Response are sent as extrinsics.

The configuration to include the data is made in Web Form Setup by selecting Yes for Send Field Data to ERP in Cart Transfer

An example of a Web Form Field sent as an extrinsic is as follows:

<input type="hidden" name="NEW_ITEM-BASE_CAPACITY[1]" value="4000 mAh">

Note: Some standard fields from Web Forms are sent by default as non-extrinsics. They include Qty, Price, and SKU. 

Example OCI Outbound Message