HTTP Verb/Method:

GET 

URL Format:

http://server/api/documents/{OrderID}

Returns:

This method returns the metadata for all document associated to the specified order (see the Request Return section below).

An error is returned if the document metadata cannot be found.

Parameter

Description

OrderID

Enter the primary key of the requested MoversSuite order (Orders.PriKey).

Property

Description

ContentUrl

Retrieve the actual content of a document using this value through a HTTP GET operation.

Created

Returned here is the creation date of the document.

This date is formatted in “CCYY-MM-DDThh:mm:ss” format (see Document API Date Format).

Modified

The date and time the document was last modified is returned in this property.  This date is updated each time the document is modified, which includes changes to content and/or metadata.

This date is formatted in “CCYY-MM-DDThh:mm:ss” format (see Document API Date Format).

Description

This is the text description of the document.

DocID

This value contains the unique document ID stored within the MoversSuite Document System.

DocumentUrl

Use the value entered here to retrieve the metadata for the document.  Perform the request using an HTTP GET operation to retrieve the data or perform the request as a HTTP PUT operation to update the metadata of the document (refer to the Add Document Metadata method for more information).

Note:

MoversSuite invoices cannot be updated.

ModifiedBy

This property contains the name of the user who last modified this document.

Name

The name of the document or the file name of the document is returned in this property.

Notes

Any notes assigned to the document are returned in this property.

OrderID

This is the identification for the order associated to the document.  The OrderID is typically the primary key of the order in the Orders table (Order.PriKey).

OrderUrl

This property contains the URL that references the metadata for the order associated to the document.  Use an HTTP GET operation referencing this URL to retrieve the metadata (refer to the Orders API service for a related request).

Source

One of the following source types is returned with this property:

“Documents” indicates a document-type file source that can be updated

“Invoices” indicates a MoversSuite invoice and cannot be updated (read-only)

Type

Returned here is the type assigned to the document.  

Document types are defined within Document Type Setup. 

Note: Invoices will be assigned to a Document Type of “MS Invoice.”

WorkTicketNumber

If the document is a work ticket, this property displays the work ticket number assigned to the document.

Work ticket documents are those associated to a Document Type Setup record with the “Does this type include Work Tickets?” flag checked.