Punchout To BuyerQuest - OCI Inbound and Outbound
    • Dark
      Light
    • PDF

    Punchout To BuyerQuest - OCI Inbound and Outbound

    • Dark
      Light
    • PDF

    Article Summary

    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. 

    FieldSample ValueField Location in BQ Is Required
    CATALOG_URLindex.php/run/oci/  
    sap-client001  
    sap-languageE  
    usernameDisney_UAT  
    passwordDisney_UAT  
    useridSAP_TEST_USERUser's External ID Yes
    fnameSAP
    User's First Name  
    Yes
    lnameTesterUser's Last Name Yes
    email[email protected]User's Contact Email Yes
    groupGeneralThis 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
     
    server208.69.122.165  
    repositoryTypeM  
    catalogPunchout Catalog  
    languageEN  
    uilanguageEN  
    datalanguageEN  
    maskEN  
    namesearch   
    OCI_VERSION4.0  
    OPI_VERSION1.0  
    returntarget_parent  
    HOOK_URLhttps://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 NameDescriptionIs RequiredBQ Table.fieldGateway Variable*Sample Field Value
    NEW_ITEM-VENDORMATSupplier SKUYessales_flat_quote_
    item.sku
    SKU0020-SIGN
    NEW_ITEM-EXT_PRODUCT_IDSupplier SKUYessales_flat_
    quote-item.sku
    SKU0020-SIGN
    NEW_ITEM-DESCRIPTIONNameYessales_flat_quote_
    item.name
    NameBench Warning Flags Sign 18in x 24in
    NEW_ITEM-QUANTITY Yessales_flat_quote_
    item.qty
    Quantity1.0000
    NEW_ITEM-PRICEContract PriceYessales_flat_quote_
    item.price
    Price185.00
    NEW_ITEM-UNITUnit of MeasureYessales_flat_quote_
    item.unit_of_measure
    UOMEA
    NEW_ITEM-MATGROUPUNSPSCYessales_flat_quote_
    item.unspsc
    UNSPSC24102006
    NEW_ITEM-CURRENCYBase CurrencyYessales_flat_quote_
    item.base_currency
     USD
    ci_sessionsession IDYesSYSTEM GENERATED BaXgm2wzhbuZjBSLiHnPpFDTIsFo3mPW5aVQ
    NEW_ITEM-EXT_CUSTOM_OPTIONSelected values for an item configured with custom optionsNo  Shirt size=Large
    |Embroidered Name=George
    NEW_ITEM-AMAZON-OFFERIDAmazon item offer IDNo  

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

    Additional Available Optional Data Elements 

    Field NameDescriptionIs RequiredBQ Table.fieldGateway Variable*
    ManufacturerNameManufacturer NameNosales_flat_quote_item.XXXManufacturerName
    ManufacturerPartIDManufacturer Part IDNosales_flat_quote_item.XXXManufacturerPartNumber
    LeadTimeLead TimeNosales_flat_quote_item.XXXLeadTime
    PriceUnitPrice UnitNosales_flat_quote_item.XXXPriceUnit
    alternative_source_idAlternative Source IDNosales_flat_quote_item.XXXAlternativeSourceID
    source_system_idSource System IDNosales_flat_quote_item.XXXSourceSystemID
    SupplierPartAuxiliaryIDSupplier Part Auxiliary IDNosales_flat_quote_item.XXXSupplierPartAuxiliaryID
    ItemAttachmentAttachmentNosales_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 

    Screen Shot 2016-03-23 at 11_12_46 AM.png


    Was this article helpful?