# API универсального передаточного документа (УПД)

## Последовательность вызовов для создания черновика титула продавца (первого титула) УПД

1. [Создание документооборота](#post-gw-upd-v4-docflows)
2. [Получение метаданных документооборота](#get-gw-upd-v4-docflows-{docflow_id}-meta)
3. [Обновление метаданных документооборота](#put-gw-upd-v4-docflows-{docflow_id}-meta)
4. [Получение черновика УПД](#get-gw-upd-v4-docflows-{docflow_id}-draft)
5. [Обновление черновика УПД](#put-gw-upd-v4-docflows-{docflow_id}-draft)

## Последовательность вызовов для отправки титула продавца (первого титула) УПД

1. [Обновление тела титула продавца из XML](#put-gw-upd-v4-docflows-{docflow_id}-documents-title-1-xml)
2. [Получение XML титула продавца](#get-gw-upd-v4-docflows-{docflow_id}-documents-title-1-xml)
3. [Отправка титула продавца УПД](#post-gw-edo_orchestrator-v4-docflow-types-upd-docflows-{docflow_id}-documents-title-1-send)

## Последовательность вызовов для создания и отправки извещения о получении (ИОП) УПД

1. [Создание извещения о получении титула продавца УПД](#post-gw-upd-v4-docflows-{docflow_id}-documents-title-1-read-confirmation-xml)
2. [Отправка извещения о получении титула продавца УПД](#post-gw-edo_orchestrator-v4-docflow-types-upd-docflows-{docflow_id}-documents-title-1-read-confirmation-send)

## Последовательность вызовов для создания и отправки титула покупателя (второго титула) УПД

1. [Создание титула покупателя УПД](#put-gw-upd-v4-docflows-{docflow_id}-documents-title-2)
2. [Получение XML титула покупателя УПД](#get-gw-upd-v4-docflows-{docflow_id}-documents-title-2-xml)
3. [Отправка титула покупателя УПД](#post-gw-edo_orchestrator-v4-docflow-types-upd-docflows-{docflow_id}-documents-title-2-send)

## Последовательность вызовов для создания и отправки уведомления об уточнении (УОУ) УПД

1. [Создание уведомления об уточнении титула продавца УПД](#post-gw-upd-v4-docflows-{docflow_id}-documents-title-1-clarification-notification-xml)
2. [Отправка уведомления об уточнении титула продавца УПД](#post-gw-edo_orchestrator-v4-docflow-types-upd-docflows-{docflow_id}-documents-title-1-clarification-notification-send)

## Получение информации по УПД

1. [Получение истории документооборота](#get-gw-upd-v4-docflows-{docflow_id}-history)
2. [Получение тела титула продавца УПД](#get-gw-upd-v4-docflows-{docflow_id}-documents-title-1-body)
3. [Получение тела титула покупателя УПД](#get-gw-upd-v4-docflows-{docflow_id}-documents-title-2-body)

## Действия с УПД

1. [Получение XML-оригинала УПД](#get-gw-upd-v4-docflows-{docflow_id}-original)
2. [Скачивание PDF-файла УПД](#get-gw-upd-v4-docflows-{docflow_id}-pdf)
3. [Скачивание PDF-файла протокола документооборота](#get-gw-upd-v4-docflows-{docflow_id}-pdf)
4. [Получение ZIP-архива документооборота](#get-gw-edo_orchestrator-v4-docflow-types-upd-docflows-{docflow_id}-documents-zip)


## Работа с первым титулом (титулом продавца) УПД

### Создание документооборота УПД

Позволяет создать пустой черновик первого титула УПД.
С этого момента создатель черновика УПД может получать метаинформацию по нему.

Получателем УПД может быть контрагент внутри АТИ-Доков, а также роуминговый.
Если выбран роуминговый, то между отправителем и получателем УПД должна быть настроена роуминговая связь.
Но на данном этапе получателя можно не заполнять.

<a id="post-gw-upd-v4-docflows"></a>

Создание документооборота

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "doctype": "upd_dop",
  "number": "string",
  "date": "1970-01-01",
  "sender_edo_id": "string",
  "receiver": {
    "type": "string",
    "account_id": "string",
    "contact_id": 0,
    "edo_user_id": "string"
  },
  "ati_admin_id": "string"
}'
```

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

**Описание полей запроса**
- `doctype` — Тип документа
- `number` — Номер документа
- `date` — Дата документа
- `sender_edo_id` — EDO ID отправителя документооборота
- `receiver` — Информация о получателе документооборота
- `receiver.account_id` — ID аккаунта
- `receiver.contact_id` — ID контакта
- `receiver.edo_user_id` — ID участника ЭДО
- `ati_admin_id` — Идентификатор ДО, если документ был создан через АтиАдмин

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

```json
{
  "id": "string"
}
```

**Описание полей ответа**
- `id` — ID документооборота

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Получение метаданных документооборота

Позволяет получать метаданные документооборота только создателю черновика.

<a id="get-gw-upd-v4-docflows-{docflow_id}-meta"></a>

Получение метаданных документооборота

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/meta' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

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

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

```json
{
  "doctype": "upd_dop",
  "number": "string",
  "date": "1970-01-01",
  "id": "string",
  "state": "draft",
  "created_at": "1970-01-01T00:00:00.000Z",
  "updated_at": "1970-01-01T00:00:00.000Z",
  "sender": {
    "signature": {
      "certificate_id": "string",
      "mchd_id": "string"
    },
    "user_type": "string",
    "ati_id": "string",
    "firm_name": "string",
    "contact_id": 0,
    "contact_name": "string",
    "edo_user_id": "string"
  },
  "receiver": {
    "signature": {
      "certificate_id": "string",
      "mchd_id": "string"
    },
    "user_type": "string",
    "ati_id": "string",
    "firm_name": "string",
    "contact_id": 0,
    "contact_name": "string",
    "edo_user_id": "string"
  },
  "flags": [
    "can_be_archived"
  ]
}
```

**Описание полей ответа**
- `doctype` — Тип документа
- `number` — Номер документа
- `date` — Дата документа
- `id` — ID документооборота
- `state` — Статус документооборота
- `created_at` — Дата создания документооборота
- `updated_at` — Дата обновления документооборота
- `sender` — Информация об отправителе
- `sender.signature.certificate_id` — ID сертификата в sign_checker-е
- `sender.signature.mchd_id` — ID машиночитаемой доверенности
- `sender.user_type` — Тип пользователя
- `sender.ati_id` — Алиас фирмы участника
- `sender.firm_name` — Название фирмы участника
- `sender.contact_id` — ID контакта
- `sender.contact_name` — Название контакта участника
- `sender.edo_user_id` — ID участника ЭДО
- `receiver` — Информация о получателе
- `receiver.signature.certificate_id` — ID сертификата в sign_checker-е
- `receiver.signature.mchd_id` — ID машиночитаемой доверенности
- `receiver.user_type` — Тип пользователя
- `receiver.ati_id` — Алиас фирмы участника
- `receiver.firm_name` — Название фирмы участника
- `receiver.contact_id` — ID контакта
- `receiver.contact_name` — Название контакта участника
- `receiver.edo_user_id` — ID участника ЭДО
- `flags` — Флаги доступности действий над документооборотом

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Обновление метаданных документооборота

Позволяет обновлять метаданные документооборота:
- только пока он в статусе «черновик» («draft»)
- только создателю черновика

<a id="put-gw-upd-v4-docflows-{docflow_id}-meta"></a>

Обновление метаданных документооборота

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/meta' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "doctype": "upd_dop",
  "number": "string",
  "date": "1970-01-01",
  "sender_edo_id": "string",
  "receiver": {
    "type": "string",
    "account_id": "string",
    "contact_id": 0,
    "edo_user_id": "string"
  }
}'
```

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

**Описание полей запроса**
- `doctype` — Тип документа
- `number` — Номер документа
- `date` — Дата документа
- `sender_edo_id` — EDO ID отправителя документооборота
- `receiver` — Информация о получателе документооборота
- `receiver.account_id` — ID аккаунта
- `receiver.contact_id` — ID контакта
- `receiver.edo_user_id` — ID участника ЭДО

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Получение черновика УПД

Доступно только создателю черновика УПД.

<a id="get-gw-upd-v4-docflows-{docflow_id}-draft"></a>

Получение черновика документооборота

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/draft' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

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

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

```json
{}
```

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Обновление черновика УПД

Доступно только создателю черновика УПД.

<a id="put-gw-upd-v4-docflows-{docflow_id}-draft"></a>

Обновление черновика документооборота

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/draft' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "верс_форм": "string",
  "верс_прог": "string",
  "св_уч_док_обор": {
    "ид_отпр": "string",
    "ид_пол": "string",
    "св_оэд_отпр": {
      "наим_орг": "string",
      "иннюл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{8}",
      "ид_эдо": "string"
    }
  },
  "документ": {
    "функция": "ДОП",
    "по_факт_хж": "string",
    "наим_док_опр": "string",
    "наим_экон_суб_сост": "string",
    "осн_довер_орг_сост": "string",
    "согл_стр_доп_инф": "string",
    "св_сч_факт": {
      "номер_сч_ф": "string",
      "дата_сч_ф": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))",
      "код_окв": "[0-9]{3}",
      "испр_сч_ф": {
        "ном_испр_сч_ф": "number",
        "деф_ном_испр_сч_ф": "string",
        "дата_испр_сч_ф": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))",
        "деф_дата_испр_сч_ф": "string"
      },
      "св_прод": [
        {
          "окпо": "string",
          "структ_подр": "string",
          "инф_для_участ": "string",
          "кратк_назв": "string",
          "ид_св": {
            "св_ип": {
              "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
              "деф_иннфл": "string",
              "св_гос_рег_ип": "string",
              "иные_свед": "string",
              "фио": {
                "фамилия": "string",
                "имя": "string",
                "отчество": "string"
              }
            },
            "св_юл_уч": {
              "наим_орг": "string",
              "иннюл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{8}",
              "деф_иннюл": "string",
              "кпп": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})([0-9]{2})([0-9A-Z]{2})([0-9]{3})"
            },
            "св_ин_не_уч": {
              "наим_орг": "string",
              "идентиф": "string",
              "иные_свед": "string"
            },
            "св_фл_участ_фхж": {
              "гос_рег_ип_выд_дов": "string",
              "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
              "иные_свед": "string",
              "фио": {
                "фамилия": "string",
                "имя": "string",
                "отчество": "string"
              }
            }
          },
          "адрес": {
            "адр_рф": {
              "индекс": "[0-9]{6}",
              "код_регион": "[0-9]{2}",
              "район": "string",
              "город": "string",
              "насел_пункт": "string",
              "улица": "string",
              "дом": "string",
              "корпус": "string",
              "кварт": "string"
            },
            "адр_инф": {
              "код_стр": "[0-9]{3}",
              "адр_текст": "string"
            },
            "код_гар": "string"
          },
          "контакт": {
            "тлф": "string",
            "эл_почта": "string"
          },
          "банк_рекв": {
            "номер_счета": "string",
            "св_банк": {
              "наим_банк": "string",
              "бик": "[0-9]{9}",
              "кор_счет": "string"
            }
          }
        }
      ],
      "груз_от": [
        {
          "груз_отпр": {
            "окпо": "string",
            "структ_подр": "string",
            "инф_для_участ": "string",
            "кратк_назв": "string",
            "ид_св": {
              "св_ип": {
                "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
                "деф_иннфл": "string",
                "св_гос_рег_ип": "string",
                "иные_свед": "string",
                "фио": {
                  "фамилия": "string",
                  "имя": "string",
                  "отчество": "string"
                }
              },
              "св_юл_уч": {
                "наим_орг": "string",
                "иннюл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{8}",
                "деф_иннюл": "string",
                "кпп": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})([0-9]{2})([0-9A-Z]{2})([0-9]{3})"
              },
              "св_ин_не_уч": {
                "наим_орг": "string",
                "идентиф": "string",
                "иные_свед": "string"
              },
              "св_фл_участ_фхж": {
                "гос_рег_ип_выд_дов": "string",
                "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
                "иные_свед": "string",
                "фио": {
                  "фамилия": "string",
                  "имя": "string",
                  "отчество": "string"
                }
              }
            },
            "адрес": {
              "адр_рф": {
                "индекс": "[0-9]{6}",
                "код_регион": "[0-9]{2}",
                "район": "string",
                "город": "string",
                "насел_пункт": "string",
                "улица": "string",
                "дом": "string",
                "корпус": "string",
                "кварт": "string"
              },
              "адр_инф": {
                "код_стр": "[0-9]{3}",
                "адр_текст": "string"
              },
              "код_гар": "string"
            },
            "контакт": {
              "тлф": "string",
              "эл_почта": "string"
            },
            "банк_рекв": {
              "номер_счета": "string",
              "св_банк": {
                "наим_банк": "string",
                "бик": "[0-9]{9}",
                "кор_счет": "string"
              }
            }
          },
          "он_же": "string"
        }
      ],
      "груз_получ": [
        {
          "окпо": "string",
          "структ_подр": "string",
          "инф_для_участ": "string",
          "кратк_назв": "string",
          "ид_св": {
            "св_ип": {
              "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
              "деф_иннфл": "string",
              "св_гос_рег_ип": "string",
              "иные_свед": "string",
              "фио": {
                "фамилия": "string",
                "имя": "string",
                "отчество": "string"
              }
            },
            "св_юл_уч": {
              "наим_орг": "string",
              "иннюл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{8}",
              "деф_иннюл": "string",
              "кпп": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})([0-9]{2})([0-9A-Z]{2})([0-9]{3})"
            },
            "св_ин_не_уч": {
              "наим_орг": "string",
              "идентиф": "string",
              "иные_свед": "string"
            },
            "св_фл_участ_фхж": {
              "гос_рег_ип_выд_дов": "string",
              "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
              "иные_свед": "string",
              "фио": {
                "фамилия": "string",
                "имя": "string",
                "отчество": "string"
              }
            }
          },
          "адрес": {
            "адр_рф": {
              "индекс": "[0-9]{6}",
              "код_регион": "[0-9]{2}",
              "район": "string",
              "город": "string",
              "насел_пункт": "string",
              "улица": "string",
              "дом": "string",
              "корпус": "string",
              "кварт": "string"
            },
            "адр_инф": {
              "код_стр": "[0-9]{3}",
              "адр_текст": "string"
            },
            "код_гар": "string"
          },
          "контакт": {
            "тлф": "string",
            "эл_почта": "string"
          },
          "банк_рекв": {
            "номер_счета": "string",
            "св_банк": {
              "наим_банк": "string",
              "бик": "[0-9]{9}",
              "кор_счет": "string"
            }
          }
        }
      ],
      "св_прд": [
        {
          "номер_прд": "string",
          "дата_прд": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))",
          "сумма_прд": "number"
        }
      ],
      "св_покуп": [
        {
          "окпо": "string",
          "структ_подр": "string",
          "инф_для_участ": "string",
          "кратк_назв": "string",
          "ид_св": {
            "св_ип": {
              "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
              "деф_иннфл": "string",
              "св_гос_рег_ип": "string",
              "иные_свед": "string",
              "фио": {
                "фамилия": "string",
                "имя": "string",
                "отчество": "string"
              }
            },
            "св_юл_уч": {
              "наим_орг": "string",
              "иннюл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{8}",
              "деф_иннюл": "string",
              "кпп": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})([0-9]{2})([0-9A-Z]{2})([0-9]{3})"
            },
            "св_ин_не_уч": {
              "наим_орг": "string",
              "идентиф": "string",
              "иные_свед": "string"
            },
            "св_фл_участ_фхж": {
              "гос_рег_ип_выд_дов": "string",
              "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
              "иные_свед": "string",
              "фио": {
                "фамилия": "string",
                "имя": "string",
                "отчество": "string"
              }
            }
          },
          "адрес": {
            "адр_рф": {
              "индекс": "[0-9]{6}",
              "код_регион": "[0-9]{2}",
              "район": "string",
              "город": "string",
              "насел_пункт": "string",
              "улица": "string",
              "дом": "string",
              "корпус": "string",
              "кварт": "string"
            },
            "адр_инф": {
              "код_стр": "[0-9]{3}",
              "адр_текст": "string"
            },
            "код_гар": "string"
          },
          "контакт": {
            "тлф": "string",
            "эл_почта": "string"
          },
          "банк_рекв": {
            "номер_счета": "string",
            "св_банк": {
              "наим_банк": "string",
              "бик": "[0-9]{9}",
              "кор_счет": "string"
            }
          }
        }
      ],
      "доп_св_фхж1": {
        "ид_гос_кон": "string",
        "наим_окв": "string",
        "курс_вал": "number",
        "обст_форм_счф": "1",
        "инф_прод_гос_зак_казн": {
          "дата_гос_конт": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))",
          "номер_гос_конт": "string",
          "лиц_счет_прод": "string",
          "код_прод_бюдж_класс": "string",
          "код_цели_прод": "string",
          "код_казнач_прод": "string",
          "наим_казнач_прод": "string"
        },
        "св_фактор": {
          "окпо": "string",
          "структ_подр": "string",
          "инф_для_участ": "string",
          "кратк_назв": "string",
          "ид_св": {
            "св_ип": {
              "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
              "деф_иннфл": "string",
              "св_гос_рег_ип": "string",
              "иные_свед": "string",
              "фио": {
                "фамилия": "string",
                "имя": "string",
                "отчество": "string"
              }
            },
            "св_юл_уч": {
              "наим_орг": "string",
              "иннюл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{8}",
              "деф_иннюл": "string",
              "кпп": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})([0-9]{2})([0-9A-Z]{2})([0-9]{3})"
            },
            "св_ин_не_уч": {
              "наим_орг": "string",
              "идентиф": "string",
              "иные_свед": "string"
            },
            "св_фл_участ_фхж": {
              "гос_рег_ип_выд_дов": "string",
              "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
              "иные_свед": "string",
              "фио": {
                "фамилия": "string",
                "имя": "string",
                "отчество": "string"
              }
            }
          },
          "адрес": {
            "адр_рф": {
              "индекс": "[0-9]{6}",
              "код_регион": "[0-9]{2}",
              "район": "string",
              "город": "string",
              "насел_пункт": "string",
              "улица": "string",
              "дом": "string",
              "корпус": "string",
              "кварт": "string"
            },
            "адр_инф": {
              "код_стр": "[0-9]{3}",
              "адр_текст": "string"
            },
            "код_гар": "string"
          },
          "контакт": {
            "тлф": "string",
            "эл_почта": "string"
          },
          "банк_рекв": {
            "номер_счета": "string",
            "св_банк": {
              "наим_банк": "string",
              "бик": "[0-9]{9}",
              "кор_счет": "string"
            }
          }
        },
        "осн_уст_ден_треб": {
          "наим_осн": "string",
          "ном_осн": "string",
          "дата_осн": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))",
          "доп_св_осн": "string",
          "идент_осн": "string"
        }
      },
      "док_подтв_отгр": [
        {
          "наим_док_отгр": "string",
          "ном_док_отгр": "string",
          "дата_док_отгр": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))"
        }
      ],
      "инф_пол_фхж1": {
        "ид_файл_инф_пол": "string",
        "текст_инф": [
          {
            "идентиф": "string",
            "значен": "string"
          }
        ]
      }
    },
    "табл_сч_факт": {
      "свед_тов": [
        {
          "ном_стр": "number",
          "наим_тов": "string",
          "океи__тов": "(?:[0-9]{3})|(?:[0-9]{4})",
          "деф_океи__тов": "string",
          "кол_тов": "number",
          "цена_тов": "number",
          "ст_тов_без_ндс": "number",
          "нал_ст": "0%",
          "ст_тов_уч_нал": "number",
          "деф_ст_тов_уч_нал": "string",
          "акциз": {
            "сум_акциз": "number",
            "без_акциз": "string"
          },
          "сум_нал": {
            "сум_нал": "number",
            "без_ндс": "string",
            "деф_ндс": "string"
          },
          "св_тд": [
            {
              "код_происх": "[0-9]{3}",
              "деф_код_происх": "string",
              "номер_тд": "string"
            }
          ],
          "доп_свед_тов": {
            "пр_тов_раб": "1",
            "доп_призн": "string",
            "наим_ед_изм": "string",
            "кр_наим_стр_пр": "string",
            "надл_отп": "number",
            "характер_тов": "string",
            "сорт_тов": "string",
            "артикул_тов": "string",
            "код_тов": "string",
            "код_кат": "string",
            "код_вид_тов": "string",
            "свед_прослеж": [
              {
                "ном_тов_прослеж": "string",
                "ед_изм_прослеж": "(?:[0-9]{3})|(?:[0-9]{4})",
                "наим_ед_изм_прослеж": "string",
                "кол_в_ед_прослеж": "number",
                "доп_прослеж": "string"
              }
            ],
            "ном_сред_идент_тов": [
              {
                "идент_транс_упак": "string",
                "киз": [
                  "string"
                ],
                "ном_упак": [
                  "string"
                ]
              }
            ]
          },
          "инф_пол_фхж2": [
            {
              "идентиф": "string",
              "значен": "string"
            }
          ]
        }
      ],
      "всего_опл": {
        "ст_тов_без_ндс_всего": "number",
        "ст_тов_уч_нал_всего": "number",
        "деф_ст_тов_уч_нал_всего": "string",
        "сум_нал_всего": {
          "сум_нал": "number",
          "без_ндс": "string",
          "деф_ндс": "string"
        },
        "кол_нетто_вс": "number"
      }
    },
    "св_прод_пер": {
      "св_пер": {
        "сод_опер": "string",
        "вид_опер": "string",
        "дата_пер": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))",
        "дата_нач": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))",
        "дата_окон": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))",
        "осн_пер": [
          {
            "наим_осн": "string",
            "ном_осн": "string",
            "дата_осн": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))",
            "доп_св_осн": "string",
            "идент_осн": "string"
          }
        ],
        "св_лиц_пер": {
          "раб_орг_прод": {
            "должность": "string",
            "иные_свед": "string",
            "осн_полн": "string",
            "фио": {
              "фамилия": "string",
              "имя": "string",
              "отчество": "string"
            }
          },
          "ин_лицо": {
            "пред_орг_пер": {
              "должность": "string",
              "иные_свед": "string",
              "наим_орг_пер": "string",
              "осн_довер_орг_пер": "string",
              "осн_полн_пред_пер": "string",
              "фио": {
                "фамилия": "string",
                "имя": "string",
                "отчество": "string"
              }
            },
            "фл_пер": {
              "иные_свед": "string",
              "осн_довер_фл": "string",
              "фио": {
                "фамилия": "string",
                "имя": "string",
                "отчество": "string"
              }
            }
          }
        },
        "тран_груз": {
          "св_тран_груз": "string",
          "тран_накл": [
            {
              "ном_тран_накл": "string",
              "дата_тран_накл": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))"
            }
          ],
          "перевозчик": {
            "окпо": "string",
            "структ_подр": "string",
            "инф_для_участ": "string",
            "кратк_назв": "string",
            "ид_св": {
              "св_ип": {
                "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
                "деф_иннфл": "string",
                "св_гос_рег_ип": "string",
                "иные_свед": "string",
                "фио": {
                  "фамилия": "string",
                  "имя": "string",
                  "отчество": "string"
                }
              },
              "св_юл_уч": {
                "наим_орг": "string",
                "иннюл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{8}",
                "деф_иннюл": "string",
                "кпп": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})([0-9]{2})([0-9A-Z]{2})([0-9]{3})"
              },
              "св_ин_не_уч": {
                "наим_орг": "string",
                "идентиф": "string",
                "иные_свед": "string"
              },
              "св_фл_участ_фхж": {
                "гос_рег_ип_выд_дов": "string",
                "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
                "иные_свед": "string",
                "фио": {
                  "фамилия": "string",
                  "имя": "string",
                  "отчество": "string"
                }
              }
            },
            "адрес": {
              "адр_рф": {
                "индекс": "[0-9]{6}",
                "код_регион": "[0-9]{2}",
                "район": "string",
                "город": "string",
                "насел_пункт": "string",
                "улица": "string",
                "дом": "string",
                "корпус": "string",
                "кварт": "string"
              },
              "адр_инф": {
                "код_стр": "[0-9]{3}",
                "адр_текст": "string"
              },
              "код_гар": "string"
            },
            "контакт": {
              "тлф": "string",
              "эл_почта": "string"
            },
            "банк_рекв": {
              "номер_счета": "string",
              "св_банк": {
                "наим_банк": "string",
                "бик": "[0-9]{9}",
                "кор_счет": "string"
              }
            }
          }
        },
        "св_пер_вещи": {
          "дата_пер_вещ": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))",
          "св_пер_вещ": "string"
        }
      },
      "инф_пол_фхж3": {
        "ид_файл_инф_пол": "string",
        "текст_инф": [
          {
            "идентиф": "string",
            "значен": "string"
          }
        ]
      }
    },
    "подписант": [
      {
        "обл_полн": "0",
        "статус": "1",
        "осн_полн": "string",
        "осн_полн_орг": "string",
        "фл": {
          "гос_рег_ип_выд_дов": "string",
          "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
          "иные_свед": "string",
          "фио": {
            "фамилия": "string",
            "имя": "string",
            "отчество": "string"
          }
        },
        "ип": {
          "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
          "деф_иннфл": "string",
          "св_гос_рег_ип": "string",
          "иные_свед": "string",
          "фио": {
            "фамилия": "string",
            "имя": "string",
            "отчество": "string"
          }
        },
        "юл": {
          "гос_рег_ип_выд_дов": "string",
          "иннюл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{8}",
          "наим_орг": "string",
          "должн": "string",
          "иные_свед": "string",
          "фио": {
            "фамилия": "string",
            "имя": "string",
            "отчество": "string"
          }
        }
      }
    ]
  }
}'
```

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

**Описание полей запроса**
- `документ.св_сч_факт.св_прод[].ид_св.св_ип` — Сведения об индивидуальном предпринимателе • `иннфл`: ИНН • `деф_иннфл`: ИНН при составлении документа с Функция=СЧФ или Функция=СЧФДОП налоговым агентом, указанным в пунктах 2 и 3 статьи 161 НК РФ, в части информации о продавце/грузоотправителе • `св_гос_рег_ип`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.св_сч_факт.св_прод[].ид_св.св_ип.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_сч_факт.св_прод[].ид_св.св_фл_участ_фхж` — Сведения о физическом лице • `гос_рег_ип_выд_дов`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя, выдавшего доверенность физическому лицу на подписание счета-фактуры • `иннфл`: ИНН физического лица • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.св_сч_факт.св_прод[].ид_св.св_фл_участ_фхж.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_сч_факт.св_прод[].адрес` — Сведения об адресе • `адр_рф`: Адрес, указанный в Едином государственном реестре юридических лиц/почтовый адрес/адрес места жительства индивидуального предпринимателя (реквизиты адреса на территории Российской Федерации) • `адр_инф`: Адрес, указанный в Едином государственном реестре юридических лиц/почтовый адрес/адрес места жительства индивидуального предпринимателя (информация об адресе, в том числе об адресе за пределами территории Российской Федерации) • `код_гар`: Уникальный номер адреса объекта адресации в государственном адресном реестре
- `документ.св_сч_факт.св_прод[].адрес.адр_рф` — Адрес в Российской Федерации • `индекс`: Индекс • `код_регион`: Код региона • `район`: Район • `город`: Город • `насел_пункт`: Населенный пункт • `улица`: Улица • `дом`: Дом • `корпус`: Корпус • `кварт`: Квартира
- `документ.св_сч_факт.св_прод[].адрес.адр_инф` — Информация об адресе, в том числе об адресе за пределами территории Российской Федерации • `код_стр`: Код страны • `адр_текст`: Адрес
- `документ.св_сч_факт.св_прод[].контакт` — Контактные данные • `тлф`: Номер контактного телефона/факс • `эл_почта`: Адрес электронной почты
- `документ.св_сч_факт.груз_от[].груз_отпр` — Сведения об участнике факта хозяйственной жизни • `окпо`: Код в общероссийском классификаторе предприятий и организаций • `структ_подр`: Структурное подразделение • `инф_для_участ`: Информация для участника документооборота • `кратк_назв`: Краткое название • `ид_св`: Идентификационные сведения • `адрес`: Адрес • `контакт`: Контактные данные • `банк_рекв`: Банковские реквизиты
- `документ.св_сч_факт.груз_от[].груз_отпр.ид_св.св_ип` — Сведения об индивидуальном предпринимателе • `иннфл`: ИНН • `деф_иннфл`: ИНН при составлении документа с Функция=СЧФ или Функция=СЧФДОП налоговым агентом, указанным в пунктах 2 и 3 статьи 161 НК РФ, в части информации о продавце/грузоотправителе • `св_гос_рег_ип`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.св_сч_факт.груз_от[].груз_отпр.ид_св.св_ип.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_сч_факт.груз_от[].груз_отпр.ид_св.св_фл_участ_фхж` — Сведения о физическом лице • `гос_рег_ип_выд_дов`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя, выдавшего доверенность физическому лицу на подписание счета-фактуры • `иннфл`: ИНН физического лица • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.св_сч_факт.груз_от[].груз_отпр.ид_св.св_фл_участ_фхж.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_сч_факт.груз_от[].груз_отпр.адрес` — Сведения об адресе • `адр_рф`: Адрес, указанный в Едином государственном реестре юридических лиц/почтовый адрес/адрес места жительства индивидуального предпринимателя (реквизиты адреса на территории Российской Федерации) • `адр_инф`: Адрес, указанный в Едином государственном реестре юридических лиц/почтовый адрес/адрес места жительства индивидуального предпринимателя (информация об адресе, в том числе об адресе за пределами территории Российской Федерации) • `код_гар`: Уникальный номер адреса объекта адресации в государственном адресном реестре
- `документ.св_сч_факт.груз_от[].груз_отпр.адрес.адр_рф` — Адрес в Российской Федерации • `индекс`: Индекс • `код_регион`: Код региона • `район`: Район • `город`: Город • `насел_пункт`: Населенный пункт • `улица`: Улица • `дом`: Дом • `корпус`: Корпус • `кварт`: Квартира
- `документ.св_сч_факт.груз_от[].груз_отпр.адрес.адр_инф` — Информация об адресе, в том числе об адресе за пределами территории Российской Федерации • `код_стр`: Код страны • `адр_текст`: Адрес
- `документ.св_сч_факт.груз_от[].груз_отпр.контакт` — Контактные данные • `тлф`: Номер контактного телефона/факс • `эл_почта`: Адрес электронной почты
- `документ.св_сч_факт.груз_получ[].ид_св.св_ип` — Сведения об индивидуальном предпринимателе • `иннфл`: ИНН • `деф_иннфл`: ИНН при составлении документа с Функция=СЧФ или Функция=СЧФДОП налоговым агентом, указанным в пунктах 2 и 3 статьи 161 НК РФ, в части информации о продавце/грузоотправителе • `св_гос_рег_ип`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.св_сч_факт.груз_получ[].ид_св.св_ип.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_сч_факт.груз_получ[].ид_св.св_фл_участ_фхж` — Сведения о физическом лице • `гос_рег_ип_выд_дов`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя, выдавшего доверенность физическому лицу на подписание счета-фактуры • `иннфл`: ИНН физического лица • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.св_сч_факт.груз_получ[].ид_св.св_фл_участ_фхж.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_сч_факт.груз_получ[].адрес` — Сведения об адресе • `адр_рф`: Адрес, указанный в Едином государственном реестре юридических лиц/почтовый адрес/адрес места жительства индивидуального предпринимателя (реквизиты адреса на территории Российской Федерации) • `адр_инф`: Адрес, указанный в Едином государственном реестре юридических лиц/почтовый адрес/адрес места жительства индивидуального предпринимателя (информация об адресе, в том числе об адресе за пределами территории Российской Федерации) • `код_гар`: Уникальный номер адреса объекта адресации в государственном адресном реестре
- `документ.св_сч_факт.груз_получ[].адрес.адр_рф` — Адрес в Российской Федерации • `индекс`: Индекс • `код_регион`: Код региона • `район`: Район • `город`: Город • `насел_пункт`: Населенный пункт • `улица`: Улица • `дом`: Дом • `корпус`: Корпус • `кварт`: Квартира
- `документ.св_сч_факт.груз_получ[].адрес.адр_инф` — Информация об адресе, в том числе об адресе за пределами территории Российской Федерации • `код_стр`: Код страны • `адр_текст`: Адрес
- `документ.св_сч_факт.груз_получ[].контакт` — Контактные данные • `тлф`: Номер контактного телефона/факс • `эл_почта`: Адрес электронной почты
- `документ.св_сч_факт.св_покуп[].ид_св.св_ип` — Сведения об индивидуальном предпринимателе • `иннфл`: ИНН • `деф_иннфл`: ИНН при составлении документа с Функция=СЧФ или Функция=СЧФДОП налоговым агентом, указанным в пунктах 2 и 3 статьи 161 НК РФ, в части информации о продавце/грузоотправителе • `св_гос_рег_ип`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.св_сч_факт.св_покуп[].ид_св.св_ип.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_сч_факт.св_покуп[].ид_св.св_фл_участ_фхж` — Сведения о физическом лице • `гос_рег_ип_выд_дов`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя, выдавшего доверенность физическому лицу на подписание счета-фактуры • `иннфл`: ИНН физического лица • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.св_сч_факт.св_покуп[].ид_св.св_фл_участ_фхж.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_сч_факт.св_покуп[].адрес` — Сведения об адресе • `адр_рф`: Адрес, указанный в Едином государственном реестре юридических лиц/почтовый адрес/адрес места жительства индивидуального предпринимателя (реквизиты адреса на территории Российской Федерации) • `адр_инф`: Адрес, указанный в Едином государственном реестре юридических лиц/почтовый адрес/адрес места жительства индивидуального предпринимателя (информация об адресе, в том числе об адресе за пределами территории Российской Федерации) • `код_гар`: Уникальный номер адреса объекта адресации в государственном адресном реестре
- `документ.св_сч_факт.св_покуп[].адрес.адр_рф` — Адрес в Российской Федерации • `индекс`: Индекс • `код_регион`: Код региона • `район`: Район • `город`: Город • `насел_пункт`: Населенный пункт • `улица`: Улица • `дом`: Дом • `корпус`: Корпус • `кварт`: Квартира
- `документ.св_сч_факт.св_покуп[].адрес.адр_инф` — Информация об адресе, в том числе об адресе за пределами территории Российской Федерации • `код_стр`: Код страны • `адр_текст`: Адрес
- `документ.св_сч_факт.св_покуп[].контакт` — Контактные данные • `тлф`: Номер контактного телефона/факс • `эл_почта`: Адрес электронной почты
- `документ.св_сч_факт.доп_св_фхж1.св_фактор` — Сведения об участнике факта хозяйственной жизни • `окпо`: Код в общероссийском классификаторе предприятий и организаций • `структ_подр`: Структурное подразделение • `инф_для_участ`: Информация для участника документооборота • `кратк_назв`: Краткое название • `ид_св`: Идентификационные сведения • `адрес`: Адрес • `контакт`: Контактные данные • `банк_рекв`: Банковские реквизиты
- `документ.св_сч_факт.доп_св_фхж1.св_фактор.ид_св.св_ип` — Сведения об индивидуальном предпринимателе • `иннфл`: ИНН • `деф_иннфл`: ИНН при составлении документа с Функция=СЧФ или Функция=СЧФДОП налоговым агентом, указанным в пунктах 2 и 3 статьи 161 НК РФ, в части информации о продавце/грузоотправителе • `св_гос_рег_ип`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.св_сч_факт.доп_св_фхж1.св_фактор.ид_св.св_ип.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_сч_факт.доп_св_фхж1.св_фактор.ид_св.св_фл_участ_фхж` — Сведения о физическом лице • `гос_рег_ип_выд_дов`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя, выдавшего доверенность физическому лицу на подписание счета-фактуры • `иннфл`: ИНН физического лица • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.св_сч_факт.доп_св_фхж1.св_фактор.ид_св.св_фл_участ_фхж.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_сч_факт.доп_св_фхж1.св_фактор.адрес` — Сведения об адресе • `адр_рф`: Адрес, указанный в Едином государственном реестре юридических лиц/почтовый адрес/адрес места жительства индивидуального предпринимателя (реквизиты адреса на территории Российской Федерации) • `адр_инф`: Адрес, указанный в Едином государственном реестре юридических лиц/почтовый адрес/адрес места жительства индивидуального предпринимателя (информация об адресе, в том числе об адресе за пределами территории Российской Федерации) • `код_гар`: Уникальный номер адреса объекта адресации в государственном адресном реестре
- `документ.св_сч_факт.доп_св_фхж1.св_фактор.адрес.адр_рф` — Адрес в Российской Федерации • `индекс`: Индекс • `код_регион`: Код региона • `район`: Район • `город`: Город • `насел_пункт`: Населенный пункт • `улица`: Улица • `дом`: Дом • `корпус`: Корпус • `кварт`: Квартира
- `документ.св_сч_факт.доп_св_фхж1.св_фактор.адрес.адр_инф` — Информация об адресе, в том числе об адресе за пределами территории Российской Федерации • `код_стр`: Код страны • `адр_текст`: Адрес
- `документ.св_сч_факт.доп_св_фхж1.св_фактор.контакт` — Контактные данные • `тлф`: Номер контактного телефона/факс • `эл_почта`: Адрес электронной почты
- `документ.св_сч_факт.доп_св_фхж1.осн_уст_ден_треб` — Основание отгрузки (передачи, уступки) • `наим_осн`: Наименование документа - основания • `ном_осн`: Номер документа - основания • `дата_осн`: Дата документа - основания • `доп_св_осн`: Дополнительные сведения • `идент_осн`: Идентификатор документа - основания
- `документ.табл_сч_факт.свед_тов[].акциз` — Сумма акциза: • `сум_акциз`: Сумма акциза • `без_акциз`: Без акциза
- `документ.табл_сч_факт.свед_тов[].сум_нал` — Сумма НДС • `сум_нал`: Значение • `без_ндс`: Без НДС • `деф_ндс`: Знак прочерка
- `документ.табл_сч_факт.всего_опл.сум_нал_всего` — Сумма НДС • `сум_нал`: Значение • `без_ндс`: Без НДС • `деф_ндс`: Знак прочерка
- `документ.св_прод_пер.св_пер.св_лиц_пер.раб_орг_прод.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_прод_пер.св_пер.св_лиц_пер.ин_лицо.пред_орг_пер.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_прод_пер.св_пер.св_лиц_пер.ин_лицо.фл_пер.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_прод_пер.св_пер.тран_груз.перевозчик` — Сведения об участнике факта хозяйственной жизни • `окпо`: Код в общероссийском классификаторе предприятий и организаций • `структ_подр`: Структурное подразделение • `инф_для_участ`: Информация для участника документооборота • `кратк_назв`: Краткое название • `ид_св`: Идентификационные сведения • `адрес`: Адрес • `контакт`: Контактные данные • `банк_рекв`: Банковские реквизиты
- `документ.св_прод_пер.св_пер.тран_груз.перевозчик.ид_св.св_ип` — Сведения об индивидуальном предпринимателе • `иннфл`: ИНН • `деф_иннфл`: ИНН при составлении документа с Функция=СЧФ или Функция=СЧФДОП налоговым агентом, указанным в пунктах 2 и 3 статьи 161 НК РФ, в части информации о продавце/грузоотправителе • `св_гос_рег_ип`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.св_прод_пер.св_пер.тран_груз.перевозчик.ид_св.св_ип.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_прод_пер.св_пер.тран_груз.перевозчик.ид_св.св_фл_участ_фхж` — Сведения о физическом лице • `гос_рег_ип_выд_дов`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя, выдавшего доверенность физическому лицу на подписание счета-фактуры • `иннфл`: ИНН физического лица • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.св_прод_пер.св_пер.тран_груз.перевозчик.ид_св.св_фл_участ_фхж.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.св_прод_пер.св_пер.тран_груз.перевозчик.адрес` — Сведения об адресе • `адр_рф`: Адрес, указанный в Едином государственном реестре юридических лиц/почтовый адрес/адрес места жительства индивидуального предпринимателя (реквизиты адреса на территории Российской Федерации) • `адр_инф`: Адрес, указанный в Едином государственном реестре юридических лиц/почтовый адрес/адрес места жительства индивидуального предпринимателя (информация об адресе, в том числе об адресе за пределами территории Российской Федерации) • `код_гар`: Уникальный номер адреса объекта адресации в государственном адресном реестре
- `документ.св_прод_пер.св_пер.тран_груз.перевозчик.адрес.адр_рф` — Адрес в Российской Федерации • `индекс`: Индекс • `код_регион`: Код региона • `район`: Район • `город`: Город • `насел_пункт`: Населенный пункт • `улица`: Улица • `дом`: Дом • `корпус`: Корпус • `кварт`: Квартира
- `документ.св_прод_пер.св_пер.тран_груз.перевозчик.адрес.адр_инф` — Информация об адресе, в том числе об адресе за пределами территории Российской Федерации • `код_стр`: Код страны • `адр_текст`: Адрес
- `документ.св_прод_пер.св_пер.тран_груз.перевозчик.контакт` — Контактные данные • `тлф`: Номер контактного телефона/факс • `эл_почта`: Адрес электронной почты
- `документ.подписант[].фл` — Сведения о физическом лице • `гос_рег_ип_выд_дов`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя, выдавшего доверенность физическому лицу на подписание счета-фактуры • `иннфл`: ИНН физического лица • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.подписант[].фл.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.подписант[].ип` — Сведения об индивидуальном предпринимателе • `иннфл`: ИНН • `деф_иннфл`: ИНН при составлении документа с Функция=СЧФ или Функция=СЧФДОП налоговым агентом, указанным в пунктах 2 и 3 статьи 161 НК РФ, в части информации о продавце/грузоотправителе • `св_гос_рег_ип`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `документ.подписант[].ип.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `документ.подписант[].юл.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Обновление тела титула продавца из XML

Доступно только создателю черновика УПД.
Позволяет заполнить черновик данными сразу из готового XML-файла УПД.
XML-файл должен быть валиден.

<a id="put-gw-upd-v4-docflows-{docflow_id}-documents-title-1-xml"></a>

Обновление тела титула продавца из XML

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/documents/title-1/xml' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: multipart/form-data; boundary=boundary'
```

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

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Получение XML титула продавца

Позволяет получить XML-файл титула продавца УПД, для которого нужно будет сформировать подпись для последующей его отправки.
После подписания полученного XML-файла его нельзя изменять (если изменение произошло, то нужно будет снова подписать обновленный XML-файл)

<a id="get-gw-upd-v4-docflows-{docflow_id}-documents-title-1-xml"></a>

Получение XML титула продавца

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/documents/title-1/xml' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

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

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

```json
{}
```

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Отправка титула продавца УПД

Позволяет отправить титул продавца УПД контрагенту внутри АТИ-Доков или в роуминг.
При отправке данные в теле титула продавца УПД версии 5.03 валидируются согласно приказу ФНС РФ от 19.12.2023 N ЕД-7-26/970@
- <a href="https://www.nalog.gov.ru/rn77/related_activities/el_doc/el_bus_entities/14414412/" target="_blank">nalog.gov.ru</a>, 
- <a href="https://normativ.kontur.ru/document?moduleId=1&documentId=486791#h6112" target="_blank">normativ.kontur.ru</a>

При отправке необходимо указать строку подписи прикладываемого XML-файла первого титула в формате base64, а также номер МЧД (если подписание при помощи сертификата физического лица).

После успешной отправки статус документооборота изменится с «draft» (черновик) на:
- «waiting_for_roaming_response» («Ожидается ответ контрагента»), если отправлен в роуминг
- «waiting_for_read_confirmation» («Ожидается подпись извещения»), если отправлен внутри АТИ-Доков

<a id="post-gw-edo_orchestrator-v4-docflow-types-upd-docflows-{docflow_id}-documents-title-1-send"></a>

Отправка титула продавца УПД

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

```bash
curl 'https://api.ati.su/gw/edo_orchestrator/v4/docflow-types/upd/docflows/string/documents/title-1/send' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: multipart/form-data; boundary=boundary'
```

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

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


## Работа с извещением о получении (ИОП) УПД

### Создание извещения о получении документа

Извещение о получении - служебный документ, регламентированный - <a href="https://normativ.kontur.ru/document?moduleId=1&documentId=451786" target="_blank">приказом 14Н</a>.
ИОП формируется при получении УПД и гарантирует, что документ доставлен до получателя без ошибок.

В ответе метода формируется XML-файл, для которого нужно будет сформировать подпись для последующей его отправки.
После подписания полученного XML-файла его нельзя изменять (если изменение произошло, то нужно будет снова подписать обновленный XML-файл)

<a id="post-gw-upd-v4-docflows-{docflow_id}-documents-title-1-read-confirmation-xml"></a>

Создание извещения о получении документа

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/documents/title-1-read-confirmation/xml' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "signer_info": {
    "first_name": "string",
    "last_name": "string",
    "patronymic": "string",
    "position": "string"
  },
  "mchd_info": {
    "mchd_id": "string",
    "mchd_issued_at": "1970-01-01T00:00:00.000Z"
  }
}'
```

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

**Описание полей запроса**
- `signer_info` — Данные подписанта
- `signer_info.first_name` — Имя подписанта
- `signer_info.last_name` — Фамилия подписанта
- `mchd_info.mchd_id` — ID машиночитаемой доверенности
- `mchd_info.mchd_issued_at` — Дата выдачи доверенности

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

```json
{}
```

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Отправка извещения о получении титула продавца УПД

При отправке необходимо указать строку подписи прикладываемого XML-файла ИОП в формате base64, а также номер МЧД (если подписание при помощи сертификата физического лица).

Данные в теле ИОП валидируются согласно <a href="https://normativ.kontur.ru/document?moduleId=1&documentId=451786" target="_blank">Приказу ФНС РФ от 30.01.2012 N ММВ-7-6/36@</a>.

После успешной отправки статус документооборота изменится:
- с «waiting_for_roaming_response» («Ожидается ответ контрагента») на «waiting_for_title_2» («Ожидается ответный документ»), если контрагент находится в роуминге
- с «waiting_for_read_confirmation» («Ожидается подпись извещения») на «waiting_for_title_2» («Ожидается ответный документ»), если контрагент находится внутри АТИ-Доков

<a id="post-gw-edo_orchestrator-v4-docflow-types-upd-docflows-{docflow_id}-documents-title-1-read-confirmation-send"></a>

Отправка извещения о получении титула продавца УПД

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

```bash
curl 'https://api.ati.su/gw/edo_orchestrator/v4/docflow-types/upd/docflows/string/documents/title-1-read-confirmation/send' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: multipart/form-data; boundary=boundary'
```

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

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


## Работа с титулом покупателя (вторым титулом) УПД

### Создание титула покупателя УПД

Титул покупателя требуется только для СЧФДОП и ДОП.
Если получатель УПД согласен с данными, которые указаны в титуле продавца УПД, то он должен подписать титул покупателя для завершения документооборота.

<a id="put-gw-upd-v4-docflows-{docflow_id}-documents-title-2"></a>

Создание титула покупателя

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/documents/title-2' \
  -X 'PUT' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "верс_форм": "string",
  "инф_пок": {
    "наим_экон_суб_сост": "string",
    "сод_фхж4": {
      "св_прин": {
        "сод_опер": "string",
        "дата_прин": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))",
        "код_сод_опер": {
          "код_итога": "1",
          "наим_док_расх": "string",
          "вид_док_расх": "2",
          "ном_док_расх": "string",
          "дата_док_расх": "((((0[1-9]{1}|1[0-9]{1}|2[0-8]{1})\\.(0[1-9]{1}|1[0-2]{1}))|((29|30)\\.(01|0[3-9]{1}|1[0-2]{1}))|(31\\.(01|03|05|07|08|10|12)))\\.((19|20)[0-9]{2}))|(29\\.02\\.((19|20)(((0|2|4|6|8)(0|4|8))|((1|3|5|7|9)(2|6)))))"
        },
        "св_лиц_прин": {
          "раб_орг_пок": {
            "должность": "string",
            "иные_свед": "string",
            "осн_полн": "string",
            "фио": {
              "фамилия": "string",
              "имя": "string",
              "отчество": "string"
            }
          },
          "ин_лицо": {
            "пред_орг_прин": {
              "должность": "string",
              "иные_свед": "string",
              "наим_орг_прин": "string",
              "осн_довер_орг_прин": "string",
              "осн_полн_пред_прин": "string",
              "фио": {
                "фамилия": "string",
                "имя": "string",
                "отчество": "string"
              }
            },
            "фл_прин": {
              "осн_довер_фл": "string",
              "иные_свед": "string",
              "фио": {
                "фамилия": "string",
                "имя": "string",
                "отчество": "string"
              }
            }
          }
        }
      },
      "инф_пол_фхж4": {
        "ид_файл_инф_пол": "string",
        "текст_инф": [
          {
            "идентиф": "string",
            "значен": "string"
          }
        ]
      }
    },
    "подписант": [
      {
        "обл_полн": "1",
        "статус": "3",
        "осн_полн": "string",
        "осн_полн_орг": "string",
        "фл": {
          "иннфл": "([0-9]{1}[1-9]{1}|[1-9]{1}[0-9]{1})[0-9]{10}",
          "иные_свед": "string",
          "фио": {
            "фамилия": "string",
            "имя": "string",
            "отчество": "string"
          }
        },
        "ип": {
          "св_гос_рег_ип": "string",
          "иные_свед": "string",
          "фио": {
            "фамилия": "string",
            "имя": "string",
            "отчество": "string"
          }
        },
        "юл": {
          "наим_орг": "string",
          "должн": "string",
          "иные_свед": "string",
          "фио": {
            "фамилия": "string",
            "имя": "string",
            "отчество": "string"
          }
        }
      }
    ]
  }
}'
```

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

**Описание полей запроса**
- `инф_пок.сод_фхж4.св_прин.св_лиц_прин.раб_орг_пок.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `инф_пок.сод_фхж4.св_прин.св_лиц_прин.ин_лицо.пред_орг_прин.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `инф_пок.сод_фхж4.св_прин.св_лиц_прин.ин_лицо.фл_прин.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `инф_пок.подписант[].фл` — Сведения о физическом лице • `иннфл`: ИНН • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `инф_пок.подписант[].фл.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `инф_пок.подписант[].ип` — Сведения о индивидуальном предпринимателе • `иннфл`: ИНН • `св_гос_рег_ип`: Реквизиты свидетельства о государственной регистрации индивидуального предпринимателя • `иные_свед`: Иные сведения, идентифицирующие физическое лицо • `фио`: Фамилия, имя, отчество
- `инф_пок.подписант[].ип.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество
- `инф_пок.подписант[].юл.фио` — Фамилия, имя, отчество физического лица • `фамилия`: Фамилия • `имя`: Имя • `отчество`: Отчество

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Получение XML титула покупателя УПД

Позволяет получить XML-файл титула покупателя УПД, для которого нужно будет сформировать подпись для последующей его отправки.
После подписания полученного XML-файла его нельзя изменять (если изменение произошло, то нужно будет снова подписать обновленный XML-файл)

<a id="get-gw-upd-v4-docflows-{docflow_id}-documents-title-2-xml"></a>

Получение XML титула покупателя

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/documents/title-2/xml' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

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

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

```json
{}
```

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Отправка титула покупателя УПД

Позволяет отправить титул покупателя УПД.

При отправке необходимо указать строку подписи прикладываемого XML-файла титула покупателя УПД в формате base64, а также номер МЧД (если подписание при помощи сертификата физического лица).

При отправке данные в теле титула покупателя для УПД версии 5.03 валидируются согласно приказу ФНС РФ от 19.12.2023 N ЕД-7-26/970@
- <a href="https://www.nalog.gov.ru/rn77/related_activities/el_doc/el_bus_entities/14414412/" target="_blank"> nalog.gov.ru</a>, 
- <a href="https://normativ.kontur.ru/document?moduleId=1&documentId=486791#h6112" target="_blank">normativ.kontur.ru</a>

После успешной отправки статус документооборота изменится с «waiting_for_title_2» («Ожидается ответный документ») на «done» («Документооборот завершен»).

<a id="post-gw-edo_orchestrator-v4-docflow-types-upd-docflows-{docflow_id}-documents-title-2-send"></a>

Отправка титула покупателя УПД

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

```bash
curl 'https://api.ati.su/gw/edo_orchestrator/v4/docflow-types/upd/docflows/string/documents/title-2/send' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: multipart/form-data; boundary=boundary'
```

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

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


## Работа с уведомлением об уточнении (УОУ) УПД

### Создание уведомления об уточнении титула продавца УПД

Если покупатель обнаружил в полученном УПД ошибку, он может направить уведомление об уточнении титула продавца УПД.
При формировании УОУ следует указать причину запроса УОУ.

УОУ может запросить только получатель УПД

УОУ можно запросить:
  - после титула продавца
  - после подписания ИОП
  - после подписания титула покупателя

В ответе метода формируется XML-файл, для которого нужно будет сформировать подпись для последующей его отправки.
После подписания полученного XML-файла его нельзя изменять (если изменение произошло, то нужно будет снова подписать обновленный XML-файл)

<a id="post-gw-upd-v4-docflows-{docflow_id}-documents-title-1-clarification-notification-xml"></a>

Создание Уведомления об уточнении документа

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/documents/title-1-clarification-notification/xml' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "signer_info": {
    "first_name": "string",
    "last_name": "string",
    "patronymic": "string",
    "position": "string"
  },
  "mchd_info": {
    "mchd_id": "string",
    "mchd_issued_at": "1970-01-01T00:00:00.000Z"
  }
}'
```

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

**Описание полей запроса**
- `signer_info` — Данные подписанта
- `signer_info.first_name` — Имя подписанта
- `signer_info.last_name` — Фамилия подписанта
- `mchd_info.mchd_id` — ID машиночитаемой доверенности
- `mchd_info.mchd_issued_at` — Дата выдачи доверенности

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

```json
{}
```

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Отправка уведомления об уточнении документа

При отправке необходимо указать строку подписи прикладываемого XML-файла УОУ в формате base64, а также номер МЧД (если подписание при помощи сертификата физического лица).

Данные в теле УОУ валидируются согласно <a href="https://normativ.kontur.ru/document?moduleId=1&documentId=451786" target="_blank">Приказу ФНС РФ от 30.01.2012 N ММВ-7-6/36@</a>.

После успешной отправки статус документооборота изменится с того, который был до запроса УОУ, на «clarification_notification_requested» («На уточнении»)

<a id="post-gw-edo_orchestrator-v4-docflow-types-upd-docflows-{docflow_id}-documents-title-1-clarification-notification-send"></a>

Отправка уведомления об уточнении титула продавца УПД

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

```bash
curl 'https://api.ati.su/gw/edo_orchestrator/v4/docflow-types/upd/docflows/string/documents/title-1-clarification-notification/send' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: multipart/form-data; boundary=boundary'
```

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

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


## Получение информации по УПД

### Получение истории УПД

<a id="get-gw-upd-v4-docflows-{docflow_id}-history"></a>

Получение истории документооборота

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/history' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

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

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

```json
[
  {
    "document_type": "title-1",
    "action_type": "start_sending",
    "actor_type": "sender_user",
    "created_at": "1970-01-01T00:00:00.000Z"
  }
]
```

**Описание полей ответа**
- `[].document_type` — Какой документ изменялся
- `[].action_type` — Какое действие было совершено
- `[].actor_type` — Кто совершил действие
- `[].created_at` — Временная отметка события

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Получение тела титула продавца УПД

<a id="get-gw-upd-v4-docflows-{docflow_id}-documents-title-1-body"></a>

Получение тела титула продавца

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/documents/title-1/body' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

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

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

```json
{}
```

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Получение тела титула покупателя УПД

<a id="get-gw-upd-v4-docflows-{docflow_id}-documents-title-2-body"></a>

Получение тела титула покупателя

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/documents/title-2/body' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

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

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

```json
{}
```

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


## Действия с УПД

### Получение XML-оригинала документа

<a id="get-gw-upd-v4-docflows-{docflow_id}-original"></a>

Получение XML-оригинала документа

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/original' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

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

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

```json
{}
```

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Скачивание PDF-файла документа

<a id="get-gw-upd-v4-docflows-{docflow_id}-pdf"></a>

Скачивание PDF-файла документа

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/pdf' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

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

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

```json
{}
```

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Скачивание PDF-файла протокола документооборота

Протокол передачи фиксирует каждый этап прохождения документа через «АТИ-Доки».
В нём указывается, кем был отправлен документ, кем подписан, когда отправлен, когда получен и так далее.

<a id="post-gw-upd-v4-docflows-{docflow_id}-protocol-pdf"></a>

Скачивание PDF-файла протокола документооборота

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

```bash
curl 'https://api.ati.su/gw/upd/v4/docflows/string/protocol/pdf' \
  -X 'POST' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json' \
  --data-raw '[
  {
    "date": "1970-01-01",
    "doc_recipient_contact": "string",
    "doc_request": false,
    "doc_sender_contact": "string",
    "doctype": "акт",
    "id": "string",
    "number": "string",
    "xmlBody": "string"
  }
]'
```

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

**Описание полей запроса**
- `[].date` — Дата документа
- `[].doc_recipient_contact` — Код пользователя в ATI.SU в формате .
- `[].doc_request` — Флаг запроса решения для документа. Если это поле не передается, то для новых документов запрос решения остается без изменений. Если это передается, то в документе для флага будет использовано переданное значение.
- `[].doc_sender_contact` — Код пользователя в ATI.SU в формате .
- `[].doctype` — Тип документа
- `[].id` — Идентификатор документа
- `[].number` — Номер документа
- `[].xmlBody` — Тело документа в формате xml, в виде строки

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

```json
{}
```

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```


### Получение ZIP-архива УПД по документообороту

В ZIP-архиве документооборота находятся:
- XML-файлы документов, которые уже есть в документообороте (титул продавца, ИОП, титул покупателя, служебные документы оператора и т.д.)
- SGN-файлы подписи для каждого XML-файла
- document.pdf -- pdf-файл УПД
- protocol.pdf -- pdf-файл протокола документооборота

<a id="get-gw-edo_orchestrator-v4-docflow-types-upd-docflows-{docflow_id}-documents-zip"></a>

Получение ZIP-архива УПД по документообороту

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

```bash
curl 'https://api.ati.su/gw/edo_orchestrator/v4/docflow-types/upd/docflows/string/documents/zip' \
  -X 'GET' \
  -H 'Authorization: Bearer {authorizationToken}' \
  -H 'Content-Type: application/json'
```

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

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

```json
{}
```

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

```json
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```

