Контрагент
Контрагент — ящик, с которым можно обмениваться документами.
Для работы с контрагентами через API не требуется приглашение — документы можно сразу отправить в любой ящик. У этого правила есть два исключения:
- организации, которые принимают документы только если у них партнерские отношения с контрагентами;
- организации, которые работают в других сервисах ЭДО. Это техническое ограничение: разным операторам сперва нужно установить связь между ящиками.
Список контрагентов
Список нужен для поиска контрагентов в разных состояниях партнерства. В веб-интерфейсе Диадока этот раздел называется «Контрагенты». В список попадают те, с кем:
- установлены партнерские отношения,
- устанавливается связь,
- прекратили сотрудничество,
- отказались сотрудничать и отклонили приглашение.
Партнерские отношения возникают:
- когда один участник отправил приглашение на обмен документами, а второй его принял. Отправить приглашение можно не только организациям в Диадоке, но и тем, кто подключен к другим операторам ЭДО;
- автоматически, если у ящика получателя приглашения есть настройка
Sociability = AllOrganizations, а приглашение отправлено без запроса подписи, независимо от наличия вложения; - при начале документооборота;
- через настройку роуминга.
Инструкция по работе со списком контрагентов приведена на странице Список контрагентов.
Группы контрагентов
Группы помогают объединить контрагентов, с которыми установлены партнерские отношения, и ограничить их права на отправку документов в конкретные подразделения.
По умолчанию все контрагенты в группе могут отправлять документы в любое подразделение организации. Но при необходимости для каждой группы контрагентов можно настроить подразделения, в которые они смогут отправлять документы. Это может быть полезно в случае, если разные подразделения организации работают с документами от разных контрагентов.
Инструкция по работе с группами контрагентов приведена на странице Группы контрагентов.
См. также
Представление в API:
- Counteragent — данные контрагента
- CounteragentGroup — данные группы контрагентов
- CounteragentList — список контрагентов
Инструкции:
Методы для работы с контрагентами:
- GetBox — по идентификатору ящика возвращает информацию об организации, которой он принадлежит
- GetCounteragent (V3) — возвращает данные контрагента по указанному идентификатору
- GetCounteragentCertificates (V2) — возвращает список сертификатов контрагента
- GetOrganization — по идентификатору организации возвращает принадлежащий ей ящик и ее данные: например, ИНН, КПП, название и т.п.
- GetOrganizationsByInnKpp — возвращает организации с указанными ИНН и КПП
- GetOrganizationsByInnList (V2) — возвращает организации и их статусы по указанному списку ИНН
Методы для работы со списком контрагентов:
- AcquireCounteragent (V3) — отправляет контрагенту приглашение к партнерским отношениям
- AcquireCounteragentResult (V3) — возвращает результат приглашения контрагента к партнерским отношениям
- BreakWithCounteragent (V2) — разрывает партнерские отношения с контрагентом
- GetCounteragents (V3) — выполняет поиск контрагентов по указанным параметрам
Методы для работы с группами контрагентов:
- AddCounteragentToGroup — добавляет контрагента в группу
- CreateCounteragentGroup — создает группу контрагентов
- DeleteCounteragentGroup — удаляет группу контрагентов
- GetCounteragentGroup — возвращает данные группы контрагентов по указанному идентификатору
- GetCounteragentGroups — возвращает список групп контрагентов
- GetCounteragentsFromGroup — возвращает список контрагентов, состоящих в указанной группе
- UpdateCounteragentGroup — изменяет данные группы контрагентов
Методы для работы с событиями по контрагентам:
- GetCounteragentEvents (V1) — возвращает список событий по изменению отношений с контрагентами