Get Item Details - BestRx APIs

INFO

This endpoint is used to get the details of an item from BestPOS system.

Request

Header Params

Content-Type

string

optional

Example:

application/json; charset=utf-8

Body Params application/json

PharmacyNumber

string

required

Pharmacy NPI Number

Example:

1234567890

APIKey

string

required

This API key is different from Vendor API Key. Use BestRxConnect Add-On API Key.

Example:

AbcXyZ1234519b64fd174a2dcf797

ItemSKUInfo

array[string]

required

Array of Item SKUs

Example

{
  "PharmacyNumber": "1234567890",
  "APIKey": "AbcXyZAbcXyZ1234519b64fd174a2dcf79712345",
  "ItemSKUInfo": [
    "043194900442",
    "015012691030"
  ]
}

Responses

🟢200OK

application/json

Body

Data

array [object {7}]

required

Array for POS Item Info

SKU

string

required

Item SKU

Description

string | null

required

Long Description of an Item

ShortDescription

string | null

required

Short Description of an Item

QtyOnHand

integer

required

Quantity on Hand. If the item can sale by case it will return # of cases. If it is sale by unit than it will return # of units available.

TaxRate

number

required

Tax Rate of an Item

RegPrice

number

required

Regular Price of an Item (Retial Price)

Status

string

required

This field will be blank when info found in pharmacy item file otherwise it will return “Inactive SKU” OR “Item not found or Invalid SKU”.

IsValid

boolean

required

True when Successful OR False when Failed

Messages

array[string]

required

Contains messages when failed. When API service cannot connect to pharmacy database it will return “Connection to Pharmacy Server is not available. Please contact Pharmacy”

Examples

SuccessItem Not FoundInactive SKU

{
  "Data": [
    {
      "SKU": "043194900442",
      "Description": "COSMOPOLITAN #90044",
      "ShortDescription": "COSMOPOLITAN",
      "QtyOnHand": 56,
      "TaxRate": 10,
      "RegPrice": 1.99,
      "Status": ""
    },
    {
      "SKU": "015012691030",
      "Description": "TEA & COOKIES",
      "ShortDescription": "TEA & COOKIES",
      "QtyOnHand": 0,
      "TaxRate": 10,
      "RegPrice": 5.99,
      "Status": ""
    }
  ],
  "IsValid": true,
  "Messages": []
}

🟠401Unauthorized