{"version":"https:\/\/jsonfeed.org\/version\/1","title":"Inbound Document Specification > Docman Help","home_page_url":"https:\/\/help.docman.com\/knowledge-base\/inbound-document-specification\/","feed_url":"https:\/\/help.docman.com\/knowledge-base\/inbound-document-specification\/feed\/json","author":{"name":"nextSTL","url":"https:\/\/help.docman.com"},"items":[{"title":"Inbound Document Specification","date_published":"2018-06-21T14:27:02Z","date_modified":"2020-07-01T17:34:12Z","id":"https:\/\/help.docman.com\/knowledge-base\/inbound-document-specification\/","url":"https:\/\/help.docman.com\/knowledge-base\/inbound-document-specification\/","author":{"name":"Oliver Edwards","url":"","avatar":"https:\/\/secure.gravatar.com\/avatar\/916760a3861c94b0f12d9658070815ac6150c9ba5291c9b5304733d70e0fdb9e?s=96&d=mm&r=g"},"summary":"\nIntroduction\n\n\n\nThis article describes the Docman API Inbound Document Model and should be used with the \"Post Document\" method in either the Docman 10 or Docman Connect services in Docman API. The table below explains each field, data type, if the \u2026","content_html":"\n

Introduction<\/h1>\n\n\n\n

This article describes the Docman API Inbound Document Model and should be used with the \"Post Document\" method in either the Docman 10 or Docman Connect services in Docman API. The table below explains each field, data type, if the field is mandatory in either Docman 10 or Docman Connect it also has a small description .<\/p>\n\n\n\n

The model should be built and formatted in a JSON string and included in the body of the \"Post Document\" method. The model is built up with numerous different objects. If the Data type in the inbound document model  is \" X Object\" then \"X Object\" will be described further down the article.<\/p>\n\n\n\n

Inbound Document Model<\/h1>\n\n\n\n

Docman10_InboundDocumentModel_Example<\/a><\/p>\n\n\n\n

Field<\/td>Type<\/td>Mandatory<\/td>Description<\/td><\/tr>
CaptureSource<\/td>Enum<\/td>Docman 10: Yes<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

The API capture source for Docman 10 is \u2018100\u2019\n

 <\/p>\n

The API capture source for Docman Connect is \u20182\u2019<\/p>\n<\/td><\/tr>

Sender<\/td>Sender Object<\/td>Docman 10: Yes<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Object which holds details of the Sender<\/td><\/tr>
RecipientOdsCode<\/td>String<\/td>Docman 10: Yes<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

ODS Code of the recipient organisation\n

 <\/p>\n

Max length 10<\/p>\n<\/td><\/tr>

Patient<\/td>Patient Object<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Object which holds details of the patient<\/td><\/tr>
Document<\/td>Document Object<\/td>Docman 10: Yes<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Object which holds the document details and content<\/td><\/tr>
ActionRequired<\/td>Boolean<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

Flag which denotes the Sender deems an action is required<\/td><\/tr>
MedicationChanged<\/td>Boolean<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

Flag which denotes that the sender has changed the patient\u2019s medication<\/td><\/tr>
Urgent<\/td>Boolean<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

Flag which denotes the document is urgent<\/td><\/tr>
ClinicalCodes<\/td>List \u2013 ClinicalCode Object<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

List of ClinicalCode objects which are to be sent into the clinical system<\/td><\/tr>
Notes<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

Notes from Sender\n

 <\/p>\n

Max Length 255<\/p>\n<\/td><\/tr>

Revision<\/td>Boolean<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: Not used<\/strong><\/p>\n<\/td>

\n

Flag to denote the Document is a revision - the Document.Guid property should hold the Document to be revised GUID<\/p>\n<\/td><\/tr>

OverrideSpineCheck<\/td>Boolean<\/td> Docman 10: No<\/strong>  

Docman Connect: Yes<\/strong><\/td>		Value True overrides the Spine Check. False or excluding the line uses the Spine Check<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

<\/p>\n\n\n\n

Document Object<\/h2>\n\n\n\n
Field<\/td>Type<\/td>Mandatory<\/td>Description<\/td><\/tr>
Guid<\/td>Guid<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: Not Used<\/strong><\/p>\n<\/td>

Document GUID, leave blank for new documents. For revisions enter GUID of document to be revised and enable Revision property.<\/td><\/tr>
Description<\/td>String<\/td> <\/strong>\n

 <\/p>\n

Docman 10: Yes<\/strong><\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Document Description\n

 <\/p>\n

Max length 255<\/p>\n<\/td><\/tr>

EventDate<\/td>Date\/Time<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Date and Time of the related event.\n

 <\/p>\n

Date must NOT be in the future<\/p>\n<\/td><\/tr>

Folder<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

Folder description which will be mapped to DM10 folder Id using a case insensitive lookup if a mapping exists\n

 <\/p>\n

Max length 50<\/p>\n<\/td><\/tr>

FilingSectionFolder<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

Filing folder description which will be mapped to DM10 filing folder Id using a case insensitive lookup if a mapping exists\n

 <\/p>\n

Max length 50<\/p>\n<\/td><\/tr>

FileContent<\/td>Byte array<\/td>Docman 10: Yes<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Physical file content as Bytes<\/td><\/tr>
FileExtension<\/td>String<\/td>Docman 10: Yes<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

File extension of the Physical File \u2013 the full stop should be omitted but will be removed if present.\n

 <\/p>\n

Max length 10<\/p>\n<\/td><\/tr>

FileHash<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

SHA1 file has derived from the file content bytes\n

 <\/p>\n

Max length 40<\/p>\n

Optional and will be allocated if omitted<\/p>\n<\/td><\/tr>

LocalHubId<\/td>Integer<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

Id from Local Hub Document Table<\/td><\/tr>
ExternalSystemId<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

System ID from sending system<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Patient Object<\/h2>\n\n\n\n
Field<\/td>Type<\/td>Mandatory<\/td>Description<\/td><\/tr>
Identifier<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

Patients national identifier \u2013 used as part of patient lookup\n

 <\/p>\n

Either NHS or CHI Number<\/p>\n

Validated with MOD11<\/p>\n

Max length 10<\/p>\n<\/td><\/tr>

FamilyName<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Surname of patient \u2013 used as part of patient lookup\n

 <\/p>\n

Max length 255<\/p>\n<\/td><\/tr>

GivenNames<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Patient\u2019s forenames \u2013 used as part of patient lookup\n

 <\/p>\n

Max length 255<\/p>\n<\/td><\/tr>

Gender<\/td>Enum \u2013 ePatientGender<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Patient\u2019s gender\u2013 used as part of patient lookup\n

 <\/p>\n

Validated against the range of enum values if supplied \u2013 defaults to unknown<\/p>\n

Valid Values:<\/p>\n

0 \u2013 Unspecified<\/p>\n

10 \u2013 Male<\/p>\n

20 \u2013 Female<\/p>\n<\/td><\/tr>

BirthDate<\/td>Date<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

DOB of the patient \u2013 used as part of patient lookup\n

 <\/p>\n

No future dates<\/p>\n<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Sender Object<\/h2>\n\n\n\n
Field<\/td>Type<\/td>Mandatory<\/td>Description<\/td><\/tr>
OdsCode<\/td>String<\/td>Docman 10: Yes<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

ODS code of sending organisation\n

 <\/p>\n

Max length 10<\/p>\n<\/td><\/tr>

Organisation<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Description of Organisation\n

 <\/p>\n

Max length 255<\/p>\n<\/td><\/tr>

Department<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Sending department name\n

 <\/p>\n

Max length 255<\/p>\n<\/td><\/tr>

Person<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Person clinically responsible for the document\n

 <\/p>\n

Max length 255<\/p>\n<\/td><\/tr>

Group<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

Name of Sender Group to associate the document with in the Connect Console.
Group must already exist.\n

 <\/p>\n

Max length 50<\/p>\n<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Clinical Code Object<\/h2>\n\n\n\n
Field<\/td>Type<\/td>Mandatory<\/td>Description<\/td><\/tr>
Scheme<\/td>Enum \u2013 eCodeScheme<\/td>Docman 10: Yes<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Type of coding system.  Read 2 or Snomed\n

 <\/p>\n

Validated against the range of enum values
Read = 0
Snomed = 2<\/p>\n<\/td><\/tr>

Code<\/td>String<\/td>Docman 10: Yes<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Clinical code \u2013 either Read code or Snomed Concept Id<\/td><\/tr>
Description<\/td>String<\/td>Docman 10: Yes<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Either Read Term or Snomed Description<\/td><\/tr>
DescriptionId<\/td>String<\/td>Docman 10: Yes<\/strong>\n

 <\/p>\n

Docman Connect: Yes<\/strong><\/p>\n<\/td>

Either Read TermId or Snomed Description Id<\/td><\/tr>
Value<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

Associated clinical value\n

 <\/p>\n

REQUIRED if ValueUnit set<\/p>\n<\/td><\/tr>

ValueUnit<\/td>String<\/td>Docman 10: No<\/strong>\n

 <\/p>\n

Docman Connect: No<\/strong><\/p>\n<\/td>

Associated clinical value unit of measure\n

 <\/p>\n

REQUIRED if Value set<\/p>\n<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

<\/p>\n","tags":[]}]}