# Документы в заказах

### Методы для работы с документами

#### Создание счета

Позволяет перевозчику и грузовладельцу создать счет для Заказа, оформленного через систему АТИ-Доки, для сделки в статусах: исполнение, документы и оплата, в архиве

<a id="post-v1.2-orders-documents-{parentDocumentId}-invoice"></a>

Создание счета

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/orders/documents/string/invoice' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/orders/documents.openapi.json)

**Пример ответа (200)**

```json
{
  "document_id": "string",
  "url": "string"
}
```

**Описание полей ответа**
- `document_id` — ID документа
- `url` — Адрес просмотра договора

**Пример ответа (4XX)**

```json
{
  "reason": "string",
  "error": "string"
}
```

**Описание полей ответа**
- `reason` — Причина ошибки
- `error` — Ключ ошибки


#### Создание акта

Позволяет перевозчику и грузовладельцу создать двухсторонний акт для Заказа, оформленного через систему АТИ-Доки, для сделки в статусах: исполнение, документы и оплата, в архиве

<a id="post-v1.2-orders-documents-{parentDocumentId}-act"></a>

Создание акта

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/orders/documents/string/act' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/orders/documents.openapi.json)

**Пример ответа (200)**

```json
{
  "document_id": "string",
  "url": "string"
}
```

**Описание полей ответа**
- `document_id` — ID документа
- `url` — Адрес просмотра договора

**Пример ответа (4XX)**

```json
{
  "reason": "string",
  "error": "string"
}
```

**Описание полей ответа**
- `reason` — Причина ошибки
- `error` — Ключ ошибки


#### Создание уведомления о расторжении

Позволяет перевозчику и грузовладельцу создать уведомление об отклонении Заказа, оформленного через систему АТИ-Доки, для сделки в исполнении

<a id="post-v1.2-orders-documents-{parentDocumentId}-unilateral_dissolution"></a>

Создание уведомления о расторжении

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/orders/documents/string/unilateral_dissolution' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/orders/documents.openapi.json)

**Пример ответа (200)**

```json
{
  "document_id": "string",
  "url": "string"
}
```

**Описание полей ответа**
- `document_id` — ID документа
- `url` — Адрес просмотра договора

**Пример ответа (4XX)**

```json
{
  "reason": "string",
  "error": "string"
}
```

**Описание полей ответа**
- `reason` — Причина ошибки
- `error` — Ключ ошибки


#### Настройка доступа к документу заказа

<a id="put-v1.2-orders-docs-{documentId}-access"></a>

Настройка доступа к документу заказа

**Пример запроса (curl):**

```bash
curl 'https://api.ati.su/v1.2/orders/docs/3fa85f64-5717-4562-b3fc-2c963f66afa6/access' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "access": {},
  "timeslots_warehouse_ids": [
    0
  ]
}'
```

**OpenAPI схема:** [JSON](https://ati.su/developers/raw/api/orders/documents.openapi.json)

**Описание полей запроса**
- `access` — Доступ к документу
- `timeslots_warehouse_ids` — Список складов с Временными окнами с доступом к документу

**Пример ответа (200)**

```json
{}
```

**Пример ответа (4XX)**

```json
{
  "reason": "string",
  "error": "string"
}
```

**Описание полей ответа**
- `reason` — Причина ошибки
- `error` — Ключ ошибки