---
title: "Получить настройку артикула в документах покупателя"
method: GET
path: "/api/v1/docflow/contacts/{id}/paper-settings"
tags: ["Docflow flow"]
---

# Получить настройку артикула в документах покупателя

`GET /api/v1/docflow/contacts/{id}/paper-settings`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/docflow/contacts/{id}/paper-settings`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Какой артикул и код товара уходят этому контрагенту в его документах — УПД и УКД по ЭДО и печатных формах счёта, акта, ТОРГ-12 и УПД. article_source: sku — основной артикул номенклатуры, manufacturer — артикул производителя, channel — артикул канала article_channel (пространство source_ref внешних артикулов номенклатуры), none — не передавать. code_source — то же для КодТов, по умолчанию none. Не настроенный контрагент отвечает умолчанием: sku и none, как до настройки. channels — существующие пространства артикулов каналов кабинета с числом позиций: из них выбирают article_channel и code_channel. Контрагент не найден — 404.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Response `200`

Настройка контрагента и каналы для выбора

- DocflowContactPaperSettings: Настройка контрагента вместе с каналами, из которых её выбирают.
  - `contact_id` string, uuid, required
  - `article_source` 'sku' | 'manufacturer' | 'channel' | 'none', required: Источник артикула или кода: sku — основной артикул номенклатуры, manufacturer — артикул производителя, channel — артикул канала, none — не передавать
  - `article_channel` string: Пространство source_ref артикула канала; только при article_source=channel
  - `code_source` 'sku' | 'manufacturer' | 'channel' | 'none', required: Источник артикула или кода: sku — основной артикул номенклатуры, manufacturer — артикул производителя, channel — артикул канала, none — не передавать
  - `code_channel` string: Пространство source_ref кода; только при code_source=channel
  - `updated_at` string, date-time: Когда настройку меняли; отсутствует у ненастроенного контрагента
  - `channels` DocflowArticleChannel[], required: Существующие пространства артикулов каналов кабинета с числом позиций с активным артикулом.
    - `kind` string, required: Вид внешнего идентификатора: channel_article
    - `source_ref` string, required: Ключ пространства
    - `products` integer, required: Сколько позиций номенклатуры имеют в нём активный артикул
  - `channel_default` DocflowPaperChannelSetting: Настройка «Артикул и код в УПД» канала продаж (ERP-2507); source channel — артикул этого канала.
    - `channel_id` string, uuid, required
    - `channel_code` string, required
    - `channel_label` string, required
    - `article_source` 'sku' | 'manufacturer' | 'channel' | 'none': Источник артикула или кода: sku — основной артикул номенклатуры, manufacturer — артикул производителя, channel — артикул канала, none — не передавать
    - `article_channel` string
    - `code_source` 'sku' | 'manufacturer' | 'channel' | 'none': Источник артикула или кода: sku — основной артикул номенклатуры, manufacturer — артикул производителя, channel — артикул канала, none — не передавать
    - `code_channel` string

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `503`: Внешний банк, справочник или контур подключений временно недоступен

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)