Send Refill Request

POST

https://webservice.bcsbestrx.com/bcswebservice/v2/webrefillservice/SendRefillRequest

INFO

This endpoint is used to send a refill request.

Request

Header Params

Content-Type

string

optional

Example:

application/json; charset=utf-8

Body Params application/json

UserName

string

optional

Username is provided by BestRx. Only required for Technology Partners working with multiple pharmacies.

Example:

applehealth

APIKey

string

required

API Key is assigned by BestRx to Each Pharmacy or Technology Partners.

Example:

d346e99f44f14920aba723039cf19608

PharmacyNumber

string

required

Pharmacy NPI Number

Example:

1234567890

LastName

string

required

Patient Last Name

Example:

SMITH

DOB

string

required

Patient Date of Birth (YYYY-MM-DD or ISO 8601 Format)

Examples:

1990-12-311990-12-31T23:59:59Z

Phone

string

optional

Patient Phone Number

Example:

6308939210

RequestDateTime

string <date-time>

required

Date and Time (ISO8601 Format) at the time Refill Request

Example:

2023-12-31T23:59:59Z

DeliveryOption

enum<string>

optional

Options for Delivery. Delivery = 1, Pickup = 2, Mail = 3

Allowed values:

123

Default:

Example:

RequestType

enum<string>

required

Request Type will specify where that request came from (Mobile = 1, Web = 2)

Allowed values:

Example:

RxInRefillRequest

object

required

RxNo

number

required

Prescription number

Example:

100001

Notes

string

optional

Any Notes or Remarks related to Refill Request

Example:

Any Notes or Remarks related to Refill Request

Example

{
  "userName": "Telecom",
  "APIKey": "1abc2d3e4fghi5jklm6nopq7rstu890vwxyz",
  "PharmacyNumber": "1234567890",
  "LastName": "Smith",
  "DOB": "1990-12-31",
  "Phone": "6308939210",
  "RequestDateTime": "2023-12-31T23:59:59Z",
  "DeliveryOption": 1,
  "RequestType": 1,
  "RxInRefillRequest": [
    {
      "RxNo": 100001
    }
  ],
  "Notes": "Need Prescription Refilled Soon"
}

Responses

🟢200OK

application/json

Body

RxInRefillResponse

object

required

It is an array of prescriptions submitted in the request parameters. It will have status and status detail which indicates whether the prescription refill is successfully submitted or not.

RxNo

number

required

Prescription number which is submitted in the request parameters

Status

string

required

Indicates whether the refill request submitted successfully or
rejected, or it might require contacting doctor for refill
authorization. Below are the examples of different status.

OK = Valid Refill Request
1Y = Prescription is 1 year past written date
DS = Discontinued/Inactive Rx
EX = Rx is Expired
IR = Invalid Rx Number
NR = 6 Months past written date - controlled drug
NR = No Refill Left - Contact doctor to authorize refill
NR = Refills not allowed for narcotics
TR = Transferred Rx
TS = Refill Too Soon
RS = Request Submitted

Note: RS Status will return when web service cannot connect to
pharmacy client for reason like no internet connection etc.

StatusDesc

string

required

Status will have its own Status description to provide more information. Below are the examples of different status descriptions.

Note: RS Status will return when web service cannot connect to pharmacy client for reason like no internet connection etc.

Examples

Valid Refill RequestRefill Too Soon

{
  "RxInRefillResponse": [
    {
      "RxNo": 100001,
      "Status": "OK",
      "StatusDesc": "Valid Refill Request"
    }
  ]
}

🟠400Bad Request

Modified at 2024-07-26 16:17:19

GetPatientProfile

Overview