.. _acquisition_source.json#/:

acquisition_source
==================

.. container:: title

 Origin of the metadata in the record

:MARC: ``541``

Only the first source is stored: if the record later gets enriched with
metadata coming from a second source, the `acquisition_source` is not
updated.

:type: ``object``

**Properties:** :ref:`acquisition_source.json#/properties/datetime`, :ref:`acquisition_source.json#/properties/email`, :ref:`acquisition_source.json#/properties/internal_uid`, :ref:`acquisition_source.json#/properties/method`, :ref:`acquisition_source.json#/properties/orcid`, :ref:`acquisition_source.json#/properties/source`, :ref:`acquisition_source.json#/properties/submission_number`


.. _acquisition_source.json#/properties/datetime:

datetime
++++++++

.. container:: title

 Date on which the metadata was obtained

:MARC: ``541__d``

This does not necessarily coincide with the creation date of the
record, as there might be some delay between the moment the
original information is obtained and a record is finally created in
the system.

:type: ``string``

:format: ``date-time``

:minLength: ``1``


.. _acquisition_source.json#/properties/email:

email
+++++

.. container:: title

 Email address associated to the submitter's account

:MARC: ``541__b``

This only gets populated when `method` is `submitter`.

:type: ``string``

:format: ``email``

:minLength: ``1``


.. _acquisition_source.json#/properties/internal_uid:

internal_uid
++++++++++++

.. container:: title

 Inspire user ID of the submitter

:MARC: ``541__a`` with ``inspire:uid:`` prefix.

This only gets populated when `method` is `submitter`.

:type: ``integer``


.. _acquisition_source.json#/properties/method:

method
++++++

.. container:: title

 How the medata was obtained

Possible values are:

`submitter`
    when obtained from a user submission. In this case, `orcid`,
    `internal_uid` and `email` store identifiers of the submitter,
    and `submission_number` an ID of the submission.

`oai`
    when obtained by OAI-PMH harvesting.

`batchuploader`
    when obtained through the batch uploader.

`hepcrawl`
    when obtained from a hepcrawl crawler. In this case, `source`
    stores the publisher or the repository that was crawled.

`beard`
    when created after author disambiguation

:type: ``string``

:minLength: ``1``

**Allowed values:** 

- submitter
- oai
- batchuploader
- hepcrawl
- beard


.. _acquisition_source.json#/properties/orcid:

orcid
+++++

.. container:: title

 ORCID of the submitter

:MARC: ``541__a`` with ``orcid:`` prefix

This only gets populated when `method` is `submitter`.

:type: ``string``

:pattern: ``^\d{4}-\d{4}-\d{4}-\d{3}[0-9X]$``

:minLength: ``1``


.. _acquisition_source.json#/properties/source:

source
++++++

:Reference: :ref:`source.json#/`


.. _acquisition_source.json#/properties/submission_number:

submission_number
+++++++++++++++++

.. container:: title

 Holding pen record ID of the submission

:MARC: ``541__e``

This only gets populated when `method` is `submitter`.

:type: ``string``

:minLength: ``1``