# DR74 - Upload accounting documents

Documents filenames must be distinct.If several formats are required for a document request, they must all be uploaded at once.A maximum of 50 documents can be uploaded simultaneously.

Endpoint: POST /api/document-request/documents/upload

## Query parameters:

  - `shop_id` (integer)
    Use this parameter when your user has access to several shops. If not specified, the shop_id from your default shop will be used.

## Request fields (multipart/form-data):

  - `documents_input` (object, required)
    Information about documents to be uploaded

  - `documents_input.requests` (array, required)
    The details of the files to be uploaded

  - `documents_input.requests.document_number` (string, required)
    The accounting document number

  - `documents_input.requests.due_date` (string)
    The accounting document due date

  - `documents_input.requests.files` (array, required)
    The files details for each required format

  - `documents_input.requests.files.format` (string, required)
    The document format
    Enum: "PDF", "cXML"

  - `documents_input.requests.files.name` (string, required)
    The document file name

  - `documents_input.requests.issue_date` (string)
    The accounting document issue date

  - `documents_input.requests.request_id` (string, required)
    The document request identifier on which to upload the document

  - `documents_input.requests.total_amount_excluding_taxes` (number)
    The total document amount (excluding taxes)

  - `documents_input.requests.total_tax_amount` (number)
    The total tax amount of the document

  - `files` (array, required)
    The files to be uploaded. Use multipart/form-data with name 'files'. The file names must contain only US-ASCII characters.

## Response 200 fields (application/json):

  - `requests` (array, required)
    Details of the documents for each request as they were sent

  - `requests.errors` (array)
    Error if upload failed for the corresponding document

  - `requests.errors.code` (string, required)
    Error code

  - `requests.errors.field` (string, required)
    Name of the field on the input object

  - `requests.errors.message` (string, required)
    Error message

  - `requests.input` (object, required)
    Reminder of the inputed API request elements, to help understand possible error messages

  - `requests.input.document_number` (string, required)
    The accounting document number

  - `requests.input.due_date` (string)
    The accounting document due date

  - `requests.input.files` (array, required)
    The files details for each required format

  - `requests.input.files.format` (string, required)
    The document format
    Enum: "PDF", "cXML"

  - `requests.input.files.name` (string, required)
    The document file name

  - `requests.input.issue_date` (string)
    The accounting document issue date

  - `requests.input.request_id` (string, required)
    The document request identifier on which to upload the document

  - `requests.input.total_amount_excluding_taxes` (number)
    The total document amount (excluding taxes)

  - `requests.input.total_tax_amount` (number)
    The total tax amount of the document