Page Comparison

...

Documents that a client needs to receive as a result of an order should be send in POST request to endpoint.

This is an example URL: https://saapi.yourlawyersmartadvocate.com:4430/sasvcdevsasvc/SAWebService.svc/Retrieval/Documents
Note that it will be generally different for different clients (SaaS clients can share the same URL).

...

Large binary documents can be sent to URL: https://sa.yourlawyeryourdomain.com:4430/sasvcdevsasvc/SAWebService.svc/Retrieval/UploadDocument?filename={filename}&RecordID={RecordID}&SACaseNumber={SACaseNumber}&SADocumentSubcategoryTypeID={SADocumentSubcategoryTypeID}&TypeName={TypeName}

Parameters:

Filename – a name of an uploaded file
RecordID – SA record ID
SACaseNumber – SmartAdvocate case number

...

PUT request should be send to endpoint: https://saapi.yourlawyersmartadvocate.com:4430/sasvcdevsasvc/SAWebService.svc/Retrieval/MedicalRequests/StatusUpdate

[
    {
        "RecordId": 130983,
        "Status": "Progress"
    },
    {
        "RecordId": 2473,
        "Status": "Completed"
    },
    {
        "RecordId": 3655,
        "Status": "Canceled"
    },
    {
        "RecordId": 498547,
        "Status": "No Records"
    },
    {
        "RecordId": 98547,
        "Status": "Rejected"
    }
]

Fields description:
RecordID(integer) – SA record ID (Record have to marked as Read.)
Status(string)   – Status of request. Request in SA will update depends of settings. 

Response:

if you submit two records in one request and one of those records fails, you will only receive one successfully recorded entry in the response and Status Code 200.

If you submit only one record and the record fails then you will get Status Code 500.

Sending Invoices (costs) to SmartAdvocate (POST request from Retrieval service)

Invoice for servicing service should be send in POST request to endpoint: https://saapi.yourlawyersmartadvocate.com:4430/sasvcdevsasvc/SAWebService.svc/Retrieval/MedicalRequests/Invoice

It will create a records in case Disbursements (costs) section.

JSON structure:

[{
	"RecordID": 30969,
	"Type": "Medical Records",
	"InvoiceNo": "123456P",
	"InvoiceDate": "2020-05-26T00:00:00",
	"Amount": 1235.99,
	"Comments": "test comment",
    "DueDate" : "2020-05-26T00:00:00",
    "Description": "Smithtown hospital X-Ray",
    "PayeeName": "Best Retrieval Provider",
    "CheckNumber": "35648",
    "DocumentID": 9876543
}]

Fields description:
RecordID(integer) – SA record ID
Type(string(100)) – Type of record (should match with client's record otherwise default parameter will be used)
InvoiceNo(string(20)) – Invoice number
InvoiceDate(date) – Invoice date
Amount(decimal) – Invoice Amountamount
Comments(string) – text comments if need to be added to invoice record

DueDate(date) – Invoice due date
Description(string(255)) – Invoice description (for example medical provider name)
PayeeName(string(500)) – Name of payee (should exact match with contact name in SmartAdvocate) CheckNumber(string(255)) – Check number

DocumentID (int) - ID of the uploaded document that needs to be linked to the invoice

Response:

if you submit two records in one request and one of those records fails, you will only receive one successfully recorded entry in the response and Status Code 200.

If you submit only one record and the record fails then you will get Status Code 500.

Sending Invoices (costs) to SmartAdvocate (Alternative Interface without RecordID)

https://saapi.yourlawyersmartadvocate.com:4430/sasvcdevsasvc/SAWebService.svc/Retrieval/MedicalRequests/Invoice

JSON structure:

[{
	"CaseNumber": "9000002",
	"CaseID": 3256,
	"Type": "Medical Records",
	"InvoiceNo": "123456P",
	"InvoiceDate": "2020-05-26T00:00:00",
	"Amount": 1235.99,
	"Comments": "test",
	"DueDate" : "2020-05-26T00:00:00",
    "Description": "Smithtown hospital X-Ray",
    "PayeeName": "Best Retrieval Provider"
}]

Fields description:
CaseNumber(string) – SA Case number
CaseID(decimal) – SA Case ID (You can pass either Case Number or Case ID. If Case Number is present Case ID will be ignored).
Type(string) – Type of record (should match with client's record otherwise default parameter will be used)
InvoiceNo(string) – Invoice number
InvoiceDate(date) – Invoice date
Amount(decimal) – Invoice Amountamount
Comments(string) – text comments if need to be added to invoice record

DueDate(date) – Invoice due date
Description(string(255)) – Invoice description (for example medical provider name)
PayeeName(string(500)) – Name of payee (should exact match with contact name in SmartAdvocate)

Sending message from retrieval service (POST request from Retrieval service)

...

Message should be send in POST request to endpoint: https://saapi.yourlawyersmartadvocate.com:4430/sasvcdevsasvc/SAWebService.svc/Retrieval/MedicalRequests/Message

JSON structure:

[
    {
        "RecordID": 123465,
        "Message": "test"
    }
]

Fields description:
RecordID(integer) – SA record ID
Message (string) – message

Response:

if you submit two records in one request and one of those records fails, you will only receive one successfully recorded entry in the response and Status Code 200.

If you submit only one record and the record fails then you will get Status Code 500.

Add retrieval service Note to Medical request (POST request from Retrieval service)

...

Message should be send in POST request to endpoint: https://saapi.yourlawyersmartadvocate.com:4430/sasvcdevsasvc/SAWebService.svc/Retrieval/MedicalRequests/RequestNote

JSON structure:

[
    {
        "RecordID": 123465,
        "Message": "test"
    }
]

Fields description:
RecordID(integer) – SA record ID
Message (string) – message

ResponceResponse:

[
  {
    "ID": null,
    "RecordId": 30983,
    "Message": "test123/r/ntest"
  }
]

...

Message should be send in PUT request to endpoint: https://saapi.yourlawyersmartadvocate.com:4430/sasvcdevsasvc/SAWebService.svc/Retrieval/MedicalRequests/RequestNote

JSON structure:

[
    {
        "RecordID": 123465,
        "Message": "test"
    }
]

Fields description:
RecordID (integer) – SA record ID
Message (string) – message

ResponceResponse:

[
  {
    "ID": null,
    "RecordId": 30983,
    "Message": "test"
  }
]

Add Retrieval Service Order Id(Number) to Medical request (POST request from Retrieval service)

Retrieval service Order Id (number) should be send in POST request to the endpoint: https://api.smartadvocate.com/sasvc/SAWebService.svc/Retrieval/MedicalRequests/InsertOrderID

JSON structure:

[
    {
        "RecordId": 11585,
        "OrderId": "123xyz"
    }
]

Fields description:
RecordID (integer) – SA record ID
OrderID (string) – Retrieval Order ID (Number)

Create a copy of Medical Request (POST request from Retrieval service)

Medical request will be copied. Usually this request is needed when the Retrieval Service has to split the request into 2

POST request should be send to the endpoint: https://api.smartadvocate.com/sasvc/SAWebService.svc/Retrieval/MedicalRequests/Copy

JSON structure:

{
    "RecordId":11585,
    "OrderId":"123xyz3",
    "Message":"test copy",
    "Status":"Completed"
}

Fields description:
RecordID (integer) – SA record ID of the Medical Request to be copied.

Following parameters will be used to update the new (copy) Medical Records Request.
OrderID (string) – Retrieval Order ID
Message (string) – Comments to be added to Retrieval Provider Notes of the Medical Records Request
Status (string)  – Status of the request.

Response:

{
  "RecordId":11586
}