POST product/pricing?customerNumber={customerNumber}

Product pricing returns SPA adjusted customer pricing, MSRP, dealer authorized flag, available and on order quantities. SPA information includes flag indicating pricing is SPA adjusted, SPA description, flag indicating there is a SPA restriction, SPA restriction description. SPA restrictions can include expiration date, min/max quantities.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
customerNumber

string

None.

Body Parameters

Pricing request including list of items

PricingRequest
NameDescriptionTypeAdditional information
CustomerNumber

Your ScanSource customer number

string

None.

Warehouse

Specifies the warehouse for the given region 1710 - North America 2510 - Europe

string

None.

BusinessUnit

Optionally specify the ScanSource business unit
1712 – ScanSource POS / Barcode
1713 – ScanSource Catalyst
1714 – ScanSource Communications
1715 – ScanSource Security
1718 – ScanSource Networking
2512 – ScanSource EU POS / Barcode
2514 – ScanSource EU Communications
1154 - ScanSource Imago UK
1224 - ScanSource Imago FR
1234 - ScanSource Video Corp FR
1782 - ScanSource LA POS / Barcode
1784 - ScanSource LA Communications
5512 - ScanSource MX POS / Barcode
5514 - ScanSource MX Communications

string

None.

DealID1

For deal specific SPAs, specify up to 3 deal IDs

string

None.

Lines

array of lines

Collection of PricingRequestLine

Required

Request Formats

application/json, text/json

Sample:
{
  "CustomerNumber": "sample string 1",
  "Warehouse": "sample string 2",
  "BusinessUnit": "sample string 3",
  "DealID1": "sample string 4",
  "Lines": [
    {
      "ItemNumber": "sample string 1",
      "PartNumberType": 0,
      "Quantity": 2,
      "DealIDs": [
        "sample string 1",
        "sample string 2"
      ]
    },
    {
      "ItemNumber": "sample string 1",
      "PartNumberType": 0,
      "Quantity": 2,
      "DealIDs": [
        "sample string 1",
        "sample string 2"
      ]
    }
  ]
}

application/xml, text/xml

Sample:
<PricingRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <CustomerNumber>sample string 1</CustomerNumber>
  <Warehouse>sample string 2</Warehouse>
  <BusinessUnit>sample string 3</BusinessUnit>
  <DealID1>sample string 4</DealID1>
  <Lines>
    <PricingRequestLine>
      <ItemNumber>sample string 1</ItemNumber>
      <PartNumberType>Unknown</PartNumberType>
      <Quantity>2</Quantity>
      <DealIDs>
        <string>sample string 1</string>
        <string>sample string 2</string>
      </DealIDs>
    </PricingRequestLine>
    <PricingRequestLine>
      <ItemNumber>sample string 1</ItemNumber>
      <PartNumberType>Unknown</PartNumberType>
      <Quantity>2</Quantity>
      <DealIDs>
        <string>sample string 1</string>
        <string>sample string 2</string>
      </DealIDs>
    </PricingRequestLine>
  </Lines>
</PricingRequest>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'PricingRequest'.

Response Information

Resource Description

Product array

Collection of Product
NameDescriptionTypeAdditional information
ItemNumber

Item # that was passed into request

string

None.

Cost

decimal number

None.

UnitPrice

Customer SPA adjusted price per unit

decimal number

None.

UnitPriceCurrencyCode

Currency code for Unit Price. USD – US Dollars, CAD- Canadian Dollars, EUR- Euro, GBP- British Pound

string

None.

ExtendedTotal

Customer SPA adjust price for given quantity

decimal number

None.

ExtendedTotalCurrency

Currency code for Extended Total. USD – US Dollars, CAD- Canadian Dollars, EUR- Euro, GBP- British Pound

string

None.

MSRP

Manufacturer’s Suggested Retail Price

decimal number

None.

MSRPCurrencyCode

Currency code for MSRP. USD – US Dollars, CAD- Canadian Dollars, EUR- Euro, GBP- British Pound

string

None.

DealerAuthorized

Flag indicating if you are authorized to purchase product

boolean

None.

SPA

Flag indicating there is a SPA applied

boolean

None.

SPADescription

Description of SPA when there is SPA applied

string

None.

SPARestriction

Flag indicating there is a SPA restriction such as expiration date or min/max quantities

boolean

None.

SPARestrictionDescription

When SPARestriction is set, this is the verbal description

string

None.

QuantityAvailable

Available to promise quantity

integer

None.

TotalInventory

Unrestricted Quantity

integer

None.

QuantityOnOrder

If product is on order with the vendor this will indicate the quantity

integer

None.

PricingError

Flag indicating there was a problem with the pricing call

boolean

None.

PricingErrorDesc

If there was an error with the pricing call this will include a verbal description. Such as item # not found.

string

None.

InventoryDisplay

Verbal description of available inventory. Contains actual inventory # if it stock, otherwise “Call for ETA” or “On Order”.

string

None.

DealInfos

Deal SPA information

Collection of DealResponse

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "ItemNumber": "sample string 1",
    "Cost": 1.0,
    "UnitPrice": 2.0,
    "UnitPriceCurrencyCode": "sample string 3",
    "ExtendedTotal": 4.0,
    "ExtendedTotalCurrency": "sample string 5",
    "MSRP": 6.0,
    "MSRPCurrencyCode": "sample string 7",
    "DealerAuthorized": true,
    "SPA": true,
    "SPADescription": "sample string 10",
    "SPARestriction": true,
    "SPARestrictionDescription": "sample string 12",
    "QuantityAvailable": 13,
    "TotalInventory": 14,
    "QuantityOnOrder": 15,
    "PricingError": true,
    "PricingErrorDesc": "sample string 17",
    "InventoryDisplay": "sample string 18",
    "DealInfos": [
      {
        "DealID": "sample string 1",
        "DealDescription": "sample string 2",
        "DealExpirationDate": "sample string 3",
        "DealError": true,
        "DealErrorDesc": "sample string 5"
      },
      {
        "DealID": "sample string 1",
        "DealDescription": "sample string 2",
        "DealExpirationDate": "sample string 3",
        "DealError": true,
        "DealErrorDesc": "sample string 5"
      }
    ]
  },
  {
    "ItemNumber": "sample string 1",
    "Cost": 1.0,
    "UnitPrice": 2.0,
    "UnitPriceCurrencyCode": "sample string 3",
    "ExtendedTotal": 4.0,
    "ExtendedTotalCurrency": "sample string 5",
    "MSRP": 6.0,
    "MSRPCurrencyCode": "sample string 7",
    "DealerAuthorized": true,
    "SPA": true,
    "SPADescription": "sample string 10",
    "SPARestriction": true,
    "SPARestrictionDescription": "sample string 12",
    "QuantityAvailable": 13,
    "TotalInventory": 14,
    "QuantityOnOrder": 15,
    "PricingError": true,
    "PricingErrorDesc": "sample string 17",
    "InventoryDisplay": "sample string 18",
    "DealInfos": [
      {
        "DealID": "sample string 1",
        "DealDescription": "sample string 2",
        "DealExpirationDate": "sample string 3",
        "DealError": true,
        "DealErrorDesc": "sample string 5"
      },
      {
        "DealID": "sample string 1",
        "DealDescription": "sample string 2",
        "DealExpirationDate": "sample string 3",
        "DealError": true,
        "DealErrorDesc": "sample string 5"
      }
    ]
  }
]

application/xml, text/xml

Sample:
<ArrayOfProduct xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Product>
    <ItemNumber>sample string 1</ItemNumber>
    <Cost>1</Cost>
    <UnitPrice>2</UnitPrice>
    <UnitPriceCurrencyCode>sample string 3</UnitPriceCurrencyCode>
    <ExtendedTotal>4</ExtendedTotal>
    <ExtendedTotalCurrency>sample string 5</ExtendedTotalCurrency>
    <MSRP>6</MSRP>
    <MSRPCurrencyCode>sample string 7</MSRPCurrencyCode>
    <DealerAuthorized>true</DealerAuthorized>
    <SPA>true</SPA>
    <SPADescription>sample string 10</SPADescription>
    <SPARestriction>true</SPARestriction>
    <SPARestrictionDescription>sample string 12</SPARestrictionDescription>
    <QuantityAvailable>13</QuantityAvailable>
    <TotalInventory>14</TotalInventory>
    <QuantityOnOrder>15</QuantityOnOrder>
    <PricingError>true</PricingError>
    <PricingErrorDesc>sample string 17</PricingErrorDesc>
    <InventoryDisplay>sample string 18</InventoryDisplay>
    <DealInfos>
      <DealResponse>
        <DealID>sample string 1</DealID>
        <DealDescription>sample string 2</DealDescription>
        <DealExpirationDate>sample string 3</DealExpirationDate>
        <DealError>true</DealError>
        <DealErrorDesc>sample string 5</DealErrorDesc>
      </DealResponse>
      <DealResponse>
        <DealID>sample string 1</DealID>
        <DealDescription>sample string 2</DealDescription>
        <DealExpirationDate>sample string 3</DealExpirationDate>
        <DealError>true</DealError>
        <DealErrorDesc>sample string 5</DealErrorDesc>
      </DealResponse>
    </DealInfos>
  </Product>
  <Product>
    <ItemNumber>sample string 1</ItemNumber>
    <Cost>1</Cost>
    <UnitPrice>2</UnitPrice>
    <UnitPriceCurrencyCode>sample string 3</UnitPriceCurrencyCode>
    <ExtendedTotal>4</ExtendedTotal>
    <ExtendedTotalCurrency>sample string 5</ExtendedTotalCurrency>
    <MSRP>6</MSRP>
    <MSRPCurrencyCode>sample string 7</MSRPCurrencyCode>
    <DealerAuthorized>true</DealerAuthorized>
    <SPA>true</SPA>
    <SPADescription>sample string 10</SPADescription>
    <SPARestriction>true</SPARestriction>
    <SPARestrictionDescription>sample string 12</SPARestrictionDescription>
    <QuantityAvailable>13</QuantityAvailable>
    <TotalInventory>14</TotalInventory>
    <QuantityOnOrder>15</QuantityOnOrder>
    <PricingError>true</PricingError>
    <PricingErrorDesc>sample string 17</PricingErrorDesc>
    <InventoryDisplay>sample string 18</InventoryDisplay>
    <DealInfos>
      <DealResponse>
        <DealID>sample string 1</DealID>
        <DealDescription>sample string 2</DealDescription>
        <DealExpirationDate>sample string 3</DealExpirationDate>
        <DealError>true</DealError>
        <DealErrorDesc>sample string 5</DealErrorDesc>
      </DealResponse>
      <DealResponse>
        <DealID>sample string 1</DealID>
        <DealDescription>sample string 2</DealDescription>
        <DealExpirationDate>sample string 3</DealExpirationDate>
        <DealError>true</DealError>
        <DealErrorDesc>sample string 5</DealErrorDesc>
      </DealResponse>
    </DealInfos>
  </Product>
</ArrayOfProduct>