getExternalDocumentIdsFull
getExternalDocumentIdsFull submits a request consisting of a ScholarOne submission integration key and date range no longer than one week. The response includes details on all attempted external submissions associated with the provided integration key and within the specified date range.
Required Parameters
- from_time
- to_time
- Integration_key (For submission integrators, this is the value contained in the element in the header of the .go file)
Optional Parameters
- Locale ID
- _type
Resource
- api/s1m/v2/submissions/full/externaldocids
Request Parameters
Request Element/ Example or Default Value getExternalDocumentIdsFull | Type | Description | Req |
|---|---|---|---|
username | String | "Profile” Username. | Yes |
Password | String | The API Key | Yes |
from_time
| dateTime | Indicates the start date for the specified date range. | Yes |
to_time
| dateTime | Indicates the end date for the specified date range. | Yes |
integration_key | String | The submission integration key uniquely identifying integration. This is the value contained in the element in the header of the .go file | Yes |
site_name | String | Site short name. The short name is the abbreviated or truncated name of the journal, society, publisher, or family. | Yes |
url | String | The Web Service URL, which identifies the specific service to handle the request. | Yes |
locale_id | Integer | The unique identifier for a specific language. The value of the locale_id must match to the specific language as defined in the caller’s ScholarOne Manuscripts profile. | No |
_type | String | The data type requested from the Service xml or json. This defaults to xml | No |
Response Elements
Response Element getExternalDocumentIdsFull | Type | Description | Example or default value |
|---|---|---|---|
Status | String | State of a given request call | Can be one of SUCCESS, FAILURE, or MAINTENANCE.
|
callID | String | The CALL_ID is the unique identifier for a given Web Services call. Generated by the ScholarOne Web Services application. |
|
profileCallId | String | An id value that is set by the client for call tracking. Set by the request’s external_id element. |
|
dateTimeProcessed | dateTime | The datetime when ScholarOne processed the ingestion package. |
|
documentId | Integer | The document ID of the created draft (returned only upon successful ingestion). |
|
externalDocumentId | String | The unique identifier assigned by the sending system to the document. |
|
failureErrorCode | Integer | The error code associated with the ingestion failure experienced (only appears for failures) |
|
siteShortName | String | Short name of the ingestion's target site on ScholarOne. |
|
submissionId | String | Displays the manuscript ID for drafts that have been successfully submitted and ingested intoS1 from their initial draft state. If the ingestion process has not yet been completed, the field will display "Draft" instead. | |
transferDocumentId | String | A unique identifier assigned to a document upon successful ingestion from the draft state. This ID remains consistent across document versions and journal transfers. | |
Updated 3 months ago
