NewCrop LLC V7 Update1 Services Demo

Click here for Update1 WSDL

Note: For web methods that return XML, NewCrop reserves the right to add additional elements at the end of the current list - make sure you consider this during coding. Also, you can request a schema in the web service results so you can always have the latest schema.

Quick start steps:
  1. Review the Update1 Services link below
  2. Enter your PartnerName, Name, and Password and press Save Credentials
    (demo can be used as PartnerName, Name, and Password for testing)
  3. Enter your AccountID, SiteID, and PatientID (if required)
    (demo can be used for AccountID and SiteID for testing)
  4. Press Submit at the desired web method

Featured GetPatientFullMedicationHistory6 GetAccountStatusV2 GetPatientAllergyHistoryV4
Patient GetPatientFullMedicationHistory4 (old) GetPatientFullMedicationHistory5 (old) GetPatientFullMedicationHistory6 (XML)
GetCompleteMedicationHistory GetPBMDrugHistoryV2 GetPatientAllergyHistory2
GetPatientFreeFormAllergyHistory GetPBMEligibilityV2 V3 (5010) GetPatientAllergyHistoryV3
GetPatientAllergyHistoryV4 GetPBMDrugHistoryV3 GetPatientAllergyLog
GetSessionPatients GetPatientsByTimeRange
Renewals GetRenewalResponseStatus GenerateTestRenewalRequest GetAllRenewalRequestsDetailV4
GetAllRenewalRequestsV2 GetRenewalRequestDetail ProcessRenewalRequest
GetAllRenewalRequestsV3 GetRenewalRequestDetailV5 GetRenewalBatchStatusV2
CreateRenewalBatch CompleteRenewalBatch V2 GetRenewalBatchStatus
Clinical FormularyAlternativesWithDrugInfo2 DrugDiseaseInteraction FormularyCoverageV3
GetCounselingMessages GetSideEffects DrugSearchWithFormularyWithFavoritesV2
DrugSearchWithFormularyWithFavoritesV3 GetMeaningfulUsePatientEncounterInfo SendClinicalMessage
CreateRxBatch CompleteRxBatch  V2 GetRxBatchStatus
CreateDigitalSigningBatch CompleteDigitalSigningBatch V2 GetDigitalSigningBatchStatus
GetDigitallySignedMessage
Reports GetDailyScriptReport (old) GetDailyScriptReportV2 (old) GetDailyScriptReportV3
GenerateMeaningfulUseUtilizationReport GetMeaningfulUseUtilizationReport GetDailyMeaningfulUseReport
Transactions GetPrescriptionTransmissionStatusByPatient GetPrescriptionTransmissionStatus GetPrescriptionTransmissionStatusV2
GetSubmittedMessageTransactionStatus ResolveFailedPrescriptionTransmission
Misc SendMissingHealthplanInformation GetMostRecentDownloadUrl HealthplanSearchV2
GetAccountStatusDetail GetAccountStatusV2 RegisterLicensedPrescriberV2
LicensedPrescriberStatusV2 GetPrescriberFavorites SetDrugDatabaseType
MU 2015 SendCancelRx CheckCancelRxStatus ConfirmCancelRx
GetAllRxFillsSummary GetRxFillDetail ConfirmRxFillReceipt
GetAllRxChangesSummary / V2 GetRxChangeDetail ConfirmRxChangeReceipt
SendRxChangeDenyResponse CreateRxChangeApprovalResponse CompleteRxChangeApproval V2
CheckRxChangeDeliveryStatus
Destination URL: https://preproduction.newcropaccounts.com/v7/webservices/update1.asmx
PartnerName: Name: Password:
Results: (displayed after you press the Submit button)


The following fields are used for the following web methods:
AccountID:
SiteID:
PatientID:
ProviderID / ProviderType /
A combination of the following are used for the next four methods
StartDate:
EndDate:
PrescriptionStatus:   C = Completed Prescription, P = Pending Medication (% = Both Complete and Pending can be used for GetPatientFullMedicationHistory6)
PrescriptionSubStatus:
% = All meds (Returns all meds regardless of the sub status)
A = NS (Returns only meds that have a 'NS' - Needs staff sub status)
U = DR (Returns only meds that have a 'DR' - Needs doctor review sub status)
P = Renewal Request that has been selected for processing on the NewCrop screens - it has not yet been denied, denied and re-written or accepted
S = Standard Rx (Returns only meds that have an 'InProc' - InProcess sub status)
D = DrugSet source - indicates the prescription was created by selecting the medication from the DrugSet selection box on the ComposeRx page
O = Outside Prescription - indicates the prescription was created on the MedEntry page
PrescriptionArchive:

 N = Not archived (i.e. Current Medication) Y = Archived (i.e. Previous Mediation), % = Both Not Archived and Archived
Note: This field will contain values other than Y,N in future releases.

The following field may be used with any web method below that returns XML:
Include Schema?:  Allowed values: Y, or N
GetPatientFullMedicationHistory6
Retrieves a given set of patient prescriptions based on the given search criteria. When used to retrieve current medications, the startDate argument specified above is ignored. For patient safety reasons, all current medications should always be returned.
Meaningful Use Return Fields Descriptions:
PrintLeaflet: Indicates whether or not a patient leaflet was printed.
T=True, F=False
DeaClassCode: Indicates the DEA drug schedule.
0 = No DEA Class Code Assigned
2 = Class 2 Scheduled Drug
3 = Class 3 Scheduled Drug
4 = Class 4 Scheduled Drug
5 = Class 5 Scheduled Drug
9 = No Value
PharmacyType: Indicates if the receiving pharmacy is electronic, fax, or not selected.
1 = Electronic
2 = Fax
0 = No Pharmacy Selected
PharmacyDetailType: Indicates the network to which the receiving pharmacy belongs
1 = Surescripts
2 = RxHub (Merged with Surescripts)
3 = NewCrop (i.e. Direct Fax or Printed)
FinalDestinationType: Indicates the transmission method from NewCrop to the receiving entity
0 = Not Transmitted
1 = Print
2 = Fax
3 = Electronic/Surescripts Retail
4 = Electronic/Surescripts Mail Order
5 = Test
FinalStatusType: Indicates the prescription status
1 = Success
2 = Error
3 = Queued
4 = Unknown
5 = Verified
Other Return Field Descriptions:
DeaGenericNamedCode: Indicates if the drug is Brand or Generic.
0 = Non-drug item, such as medical supplies and bulk chemicals
1 = Generic
2 = Brand
3 = Alternative
4 = Related products span multiple Generic Drug Name Codes
9 = No Value
1 AccountGuid uniqueidentifier NOT NULL
2 AccountName nvarchar(100) NOT NULL
3 ExternalAccountID varchar(50) NULL
4 SiteID varchar(50) NULL
5 PatientGUID uniqueidentifier NOT NULL
6 FullName nvarchar(144) NULL
7 ExternalPatientID nvarchar(50) NULL
8 PrescriptionDate datetime NOT NULL
9 DrugID varchar(20) NOT NULL
10 DrugTypeID char NOT NULL
11 DrugName varchar(30) NOT NULL
12 DrugInfo varchar(200) NULL
13 Strength varchar(15) NULL
14 StrengthUOM varchar(15) NULL
15 DosageNumberDescription nvarchar(50) NULL
16 DosageForm nvarchar(50) NULL
17 Route nvarchar(50) NULL
18 DosageFrequencyDescription nvarchar(50) NULL
19 Dispense nvarchar(100) NULL
20 TakeAsNeeded char NOT NULL
21 DispenseAsWritten char NOT NULL
22 Refills tinyint NOT NULL
23 Status char NOT NULL
24 SubStatus char NOT NULL
25 Archive char NOT NULL
26 PrescriptionGuid uniqueidentifier NOT NULL
27 OrderGUID uniqueidentifier NULL
28 PrescriptionNotes nvarchar(255) NULL
29 PharmacistNotes nvarchar(255) NULL
30 ExternalPhysicianID nvarchar(50) NULL
31 PhysicianName nvarchar(176) NULL
32 DateMovedToPreviousMedications varchar(1) NOT NULL
33 FormularyType varchar(20) NULL
34 FormularyTypeID varchar(1) NOT NULL
35 FormularyMember varchar(50) NULL
36 FormularyId varchar(50) NULL
37 FormularyStatus varchar(2) NULL
38 ModifiedSig bit NULL
39 ModifiedSigStatus varchar(1) NULL
40 ExternalPrescriptionID varchar(50) NOT NULL
41 EpisodeIdentifier varchar(40) NOT NULL
42 EncounterIdentifier varchar(40) NOT NULL
43 ExternalSource varchar(1) NULL
44 ExternalDrugConcept varchar(105) NULL
45 ExternalDrugName varchar(35) NULL
46 ExternalDrugStrength varchar(35) NULL
47 ExternalDrugStrengthUOM varchar(35) NULL
48 ExternalDrugStrengthWithUOM varchar(35) NULL
49 ExternalDrugDosageForm varchar(35) NULL
50 ExternalDrugRoute varchar(35) NULL
51 ExternalDrugIdentifier varchar(35) NULL
52 ExternalDrugIdentifierType varchar(35) NULL
53 ExternalDrugSchedule varchar(1) NULL
54 ExternalDrugOTC varchar(1) NULL
55 DosageNumberTypeID smallint NOT NULL
56 DosageFormTypeId tinyint NOT NULL
57 DosageRouteTypeId tinyint NOT NULL
58 DosageFrequencyTypeID smallint NOT NULL
59 DaysSupply int NOT NULL
60 PrescriptionTimestamp datetime NOT NULL
61 OriginalPrescriptionGuid uniqueidentifier NOT NULL
62 ExternalUserID nvarchar(50) NOT NULL
63 ExternalUserType varchar(1) NOT NULL
64 DeaGenericNamedCode varchar(1) NOT NULL
65 Diagnosis varchar(20) NOT NULL
66 DiagnosisSource varchar(6) NOT NULL
67 DiagnosisName nvarchar(200) NOT NULL
68 DispenseNumberQualifier varchar(50) NOT NULL
69 DispenseNumberQualifierDescription varchar(50) NOT NULL
70 LocationName nvarchar(100) NOT NULL
71 GenericName varchar(30) NOT NULL
72 PatientFriendlySIG varchar(140) NOT NULL
73 PrintLeaflet varchar(1) NOT NULL
74 DeaClassCode varchar(1) NOT NULL
75 PharmacyType int NOT NULL
76 PharmacyDetailType tinyint NOT NULL
77 FinalDestinationType tinyint NOT NULL
78 FinalStatusType tinyint NOT NULL
79 PatientID nvarchar(50) NULL
80 PatientIDType varchar(1) NOT NULL
81 rxcui numeric(11, 0) NULL
GetAllRenewalRequestsV2
Retrieves all pending renewal requests for an account.

Note: Spare elements in the results convey additional information specified as follows:

Spare1 - The Pharmacist Message from the original new prescription
Spare2 - The Dispense Number Qualifier:R or PRN: Refill Count. Values are separated by ":" for parsing purposes

  For example, U2:R:2 translates to U2=Tablet, R=Number of Refills, 2=Quantity for the number of refills
  BO:PRN: translates to BO=Bottle, PRN=Take as Needed, No value or 0 will be used when PRN is specified

Spare3 - The NDC for the requested drug (if provided by the pharmacy software system)
Spare4 - :Message Reference Number:R:LeftForExternalDoctorID:LeftByExternalStaffID: The first character is used for parsing purposes

  For example, :PH456:DRID123:STID123: translates to PH456=Message Reference Number, which is the prescription number   assigned by the pharmacy software system. It's used to identify the refill response, or the follow up new prescription message sent after the   renewal request is "Denied - NewRx to follow". DRID123=The EMR's unique identifier for the doctor the renewal request was left for review   STID123=The EMR's unique identifier for the staff who left the renewal request for doctor review.

Spare5 - Not yet used
Enter your unique location ID:
 Optional
Enter your unique licensed prescriber ID:
 Optional
1 AccountName nvarchar(100) NULL
2 LocationName nvarchar(100) NULL
3 DoctorFullName nvarchar(176) NULL
4 PharmacyStoreName varchar(50) NULL
5 PharmacyStore varchar(20) NULL
6 Response nvarchar(255) NULL
7 ResponseDetail nvarchar(255) NULL
8 ResponsePersonName varchar(200) NULL
9 NDCHealthRefreqTID uniqueidentifier NOT NULL
10 TransactionID varchar(50) NULL
11 AccountGuid uniqueidentifier NULL
12 LocationGuid uniqueidentifier NULL
13 DoctorGuid uniqueidentifier NULL
14 PharmacyGuid uniqueidentifier NULL
15 Message varchar(5000) NULL
16 ReceivedTimestamp datetime NULL
17 Valid tinyint NULL
18 ResponseCode varchar(10) NULL
19 ResponseCodeDetail varchar(10) NULL
20 ResponseFreeText varchar(70) NULL
21 ResponseTimestamp datetime NULL
22 ResponseUserGuid uniqueidentifier NULL
23 ResponseUserType char NULL
24 PatientGuid uniqueidentifier NULL
25 PatientFirstName varchar(35) NULL
26 PatientMiddleName varchar(35) NULL
27 PatientLastName varchar(35) NULL
28 PatientDOB varchar(8) NULL
29 PatientGender varchar(1) NULL
30 DrugInfo varchar(105) NULL
31 SentTimestamp datetime NULL
32 SentStatus varchar(10) NULL
33 SentStatusMessage varchar(300) NULL
34 NumberOfRefills varchar(10) NULL
35 CompositeTransaction varchar(30) NULL
36 ReviewUserGuid uniqueidentifier NULL
37 ReviewUserType char NULL
38 ReviewTimestamp datetime NULL
39 Pon varchar(50) NULL
40 Sig varchar(140) NULL
41 Quantity varchar(15) NULL
42 QuantityType varchar(2) NULL
43 PharmacyInfo varchar(334) NULL
44 PharmacyFullInfo varchar(301) NULL
45 LocationExternalId varchar(50) NULL
46 DoctorExternalId nvarchar(50) NULL
47 Pharmacy_NCPDP varchar(10) NULL
48 Spare1 varchar(210) NULL
49 Spare2 varchar(20) NULL
50 Spare3 varchar(11) NULL
51 Spare4 varchar(512) NULL
52 Spare5 varchar(?) NULL
GetAllRenewalRequestsV3
Retrieves all pending renewal requests for an account, allowing retrieval by a specific renewal date
Note: Spare elements in the results convey additional information specified as follows:

Spare1 - The Pharmacist Message from the original new prescription
Spare2 - The Dispense Number Qualifier:R or PRN: Refill Count. Values are separated by ":" for parsing purposes

  For example, U2:R:2 translates to U2=Tablet, R=Number of Refills, 2=Quantity for the number of refills
  BO:PRN: translates to BO=Bottle, PRN=Take as Needed, No value or 0 will be used when PRN is specified

Spare3 - The NDC for the requested drug (if provided by the pharmacy software system)
Spare4 - :Message Reference Number:R:LeftForExternalDoctorID:LeftByExternalStaffID: The first character is used for parsing purposes

  For example, :PH456:DRID123:STID123: translates to PH456=Message Reference Number, which is the prescription number   assigned by the pharmacy software system. It's used to identify the refill response, or the follow up new prescription message sent after the   renewal request is "Denied - NewRx to follow". DRID123=The EMR's unique identifier for the doctor the renewal request was left for review   STID123=The EMR's unique identifier for the staff who left the renewal request for doctor review.

Spare5 - Not yet used
Enter your unique location ID:
 Optional
Enter your unique licensed prescriber ID:
 Optional
Enter the renewal request date (CCYYMMDD format - Defines the date renewal request was received from the pharmacy):
 Optional
1 AccountName nvarchar(100) NULL
2 LocationName nvarchar(100) NULL
3 DoctorFullName nvarchar(176) NULL
4 PharmacyStoreName varchar(50) NULL
5 PharmacyStore varchar(20) NULL
6 Response nvarchar(255) NULL
7 ResponseDetail nvarchar(255) NULL
8 ResponsePersonName varchar(200) NULL
9 NDCHealthRefreqTID uniqueidentifier NOT NULL
10 TransactionID varchar(50) NULL
11 AccountGuid uniqueidentifier NULL
12 LocationGuid uniqueidentifier NULL
13 DoctorGuid uniqueidentifier NULL
14 PharmacyGuid uniqueidentifier NULL
15 Message varchar(5000) NULL
16 ReceivedTimestamp datetime NULL
17 Valid tinyint NULL
18 ResponseCode varchar(10) NULL
19 ResponseCodeDetail varchar(10) NULL
20 ResponseFreeText varchar(70) NULL
21 ResponseTimestamp datetime NULL
22 ResponseUserGuid uniqueidentifier NULL
23 ResponseUserType char NULL
24 PatientGuid uniqueidentifier NULL
25 PatientFirstName varchar(35) NULL
26 PatientMiddleName varchar(35) NULL
27 PatientLastName varchar(35) NULL
28 PatientDOB varchar(8) NULL
29 PatientGender varchar(1) NULL
30 DrugInfo varchar(105) NULL
31 SentTimestamp datetime NULL
32 SentStatus varchar(10) NULL
33 SentStatusMessage varchar(300) NULL
34 NumberOfRefills varchar(10) NULL
35 CompositeTransaction varchar(30) NULL
36 ReviewUserGuid uniqueidentifier NULL
37 ReviewUserType char NULL
38 ReviewTimestamp datetime NULL
39 Pon varchar(50) NULL
40 Sig varchar(140) NULL
41 Quantity varchar(15) NULL
42 QuantityType varchar(2) NULL
43 PharmacyInfo varchar(334) NULL
44 PharmacyFullInfo varchar(301) NULL
45 LocationExternalId varchar(50) NULL
46 DoctorExternalId nvarchar(50) NULL
47 Pharmacy_NCPDP varchar(10) NULL
48 Spare1 varchar(210) NULL
49 Spare2 varchar(20) NULL
50 Spare3 varchar(11) NULL
51 Spare4 varchar(512) NULL
52 Spare5 varchar(?) NULL
GetMostRecentDownloadUrl
Retrieves a URL to where the latest NewCrop supplied data or documentation can be downloaded.
NOTE!!! Drug Database Download URLs are from PRODUCTION .  Some of the DrugIDs used with some Preproduction web services may not exist/be found because we DO NOT update the FDB Drug Database on the Preproduction Server due to certification requirements and formulary testing. If you receive a <Status> of FAIL, with a <Message> containing "Unknown drug: 583676", then this is why. Please use a different DrugID. You can always check the status of the drug via the "Drug DB Lookup" feature in the Preproduction Customer Maintenance Portal.
Top
Desired Download:  (See table below for allowed values)
Allowed Values:
Download File Name Download Description
1 NCFull-CCYYMM.zip Contains several tables including FirstDataBank drug index, healthplan index, allergy index, and pharmacy index
2 NCNDC-CCYYMM.zip Provides the ability to obtain a FirstDataBank drug id from a validated representative NDC
3 - Obsolete NCRxNorm-CCYYMM.zip Contains the RxNorm drug and allergy indexes - Obsolete
4 RxCUI2MEDID.zip Provides the ability to obtain a FirstDataBank drug id from an RxNorm drug id - Obsolete
5 NCPharms-CCYYMMDD.zip Contains the latest pharmacy index, which is updated nightly
6 CodifiedSig.zip Contains tables that allows partner systems to display the exact same SIG options as NewCrop. The SIG selection options include dosage number, form, route, frequency, and action. For example: Take 1 tablet(s) by mouth BID
7 NCOffline-CCYYMM.zip Contains tables that allows drug-drug interactions to be performed locally in a disconnected state
8 NCOfflineAllergy-CCYYMM.zip Contains tables that allows drug-allergy interactions to be performed locally in a disconnected state
9 NCFull-Multum-CCYYMM.zip Contains several tables including Multum drug index, allergy index, and NDC mapping
10 NCAgePrecautions-CCYYMM.zip Contains tables that allows drug-pediatric and drug-geriatric interactions to be performed locally in a disconnected state
11 NCDrugDisease-CCYYMM.zip Contains tables that allows drug-disease to be performed locally in a disconnected state
12 NCPharms2-CCYYMM.zip Contains the pharmacy extended table which is updated nightly
13 NCFDB-RxNorm-XXXX.zip Contains the FDB-RxNorm crosswalk mapping tables for allergies and medications.
LicensedPrescriberStatusV2
Returns the registration status of a Licensed Prescriber.
<spare1> will contain the prescriber's IDP Status and EPCS Status separated by a separator character (:). The separator character will be in the first character position e.g. <spare1>:2:5</spare1>

IDP Status Values:
NoIDP = 0
IDPQueued = 1
IDPSuccess = 2
IDPFailed = 3

EPCS Status Values:
Undefined = 0 (Default value on Insert)
GrantEPCSAccess = 1 (User shows in grant access control)
GrantedEPCSAccess = 4 (User shows in grant finalizer control)
GrantedEPCSAccessAndTFA = 5 (User shows in revoke access control)
RevokedEPCSAccess = 6 (User shows in revoke finalizer control)
RevokedEPCSAccessAndTFA = 7 (User shows in regrant access control)
RegrantEPCSAccess = 8 (User shows in grant finalizer control (note RegrantEPCSAccess acts the same as GrantedEPCSAccess))

NOTE:  If a prescriber is only registered with NewCrop, or registered but inactive with SureScripts, then all scripts are transmitted via fax if the account has faxing enabled.  If a prescriber is registered and active with SureScripts, they can transmit scripts electronically to electronically enabled pharmacies.  Faxing is used as a backup mechanism to electronically enabled pharmacies and is the primary transmission method for non electronic pharmacies when the account has faxing enabled.

Please be sure that your users understand why their scripts may be transmitted via fax due to their registration status.
Top
    
licensedPrescriberID:    
locationID: