Справочник формата документов API ЭДО

Справочник формата документов API ЭДО

При отправке или обработке документов нужно правильно передавать в Saby информацию о типе документа, этапе и действии над ним, вложении и событии. В статье собраны примеры оформления данных для передачи по API ЭДО.

Типы документов

Исходящие счета-фактуры («ФактураИсх»), накладные («ДокОтгрИсх») и акты выполненных работ («АктВР») должны отправляться как «Документ отгрузки».

Тип документа

Описание

Направление

АктВыпускаАкт ВыпускаВнутренний
АктИнвИнвентаризацияВнутренний
АктСверИсхАкт сверкиИсходящий
АктСверВхВходящий
АктСписанияСписаниеВнутренний
ВнутрПрмВнутреннее перемещениеВнутренний
ДоговорИсхДоговорИсходящий
ДоговорВхВходящий
ДоговорДокДоговорВходящий
Исходящий
ДокОтгрИсхРасход (Реализация)Исходящий
ДокОтгрВхПриход (Поступление), ОприходованиеВходящий
ЗаказИсхЗаказИсходящий
ЗаказВхВходящий
КассовыйДеньКассовая книгаВнутренний
КоррИсхПисьмоИсходящий
КоррВхВходящий
ПересортПересортицаВнутренний
ПриходныйОрдерПриходный кассовый ордерВнутренний
РасходныйОрдерРасходный кассовый ордерВнутренний
СчетИсхСчетИсходящий
СчетВхВходящий
ФактураИсхСчет-фактура от 02.02.2019Исходящий
ФактураВхВходящий
ConsignmentNoteТранспортная накладнаяИсходящий
Входящий
CorrInКорректировкаВходящий
CorrOutИсходящий
DeviationActInВходящий акт о расхожденияхВходящий
DeviationActOut Исходящий акт о расхожденияхИсходящий
PriceMatchingIn
(для поставщика)
Согласование ценВходящий/Исходящий
PriceMatchingOut
(для покупателя)
Запрос ценВходящий/Исходящий
ReturnInВозврат от покупателяВходящий
ReturnOutВозврат поставщикуИсходящий
WaybillЭлектронный путевой листИсходящий
Входящий

Этапы и действия (команды)

Тип документа

Этап

Действие (команда)

АктСверИсх
(Акты сверки)
ОтправкаОтправить
Извещение о получении подтверждения даты полученияОбработать служебное
Извещение о получении уведомления о приеме
Извещение о получении уведомления об уточнении
АктСверВх
(Акты сверки)
СверитьУтверждено
Отправить свой вариант
Переназначить
Извещение о полученииОбработать служебное
ДоговорИсх
(Договоры)
ОтправкаОтправить
Извещение о получении подтверждения даты полученияОбработать служебное
Извещение о получении уведомления о приеме
Извещение о получении уведомления об уточнении
ДоговорВх
(Договоры)
УтверждениеУтвердить
Отклонить
Переназначить
Извещение о полученииОбработать служебное
ДокОтгрИсх
(Фактуры, накладные, акты)
ОтправкаОтправить
ДокОтгрВх
(Фактуры, накладные, акты)
УтверждениеУтвердить
Отклонить
Переназначить
Извещение о полученииОбработать служебное
ЗаказИсх
(Заказы поставщикам)
ОтправкаОтправить
ЗаказВх
(Заказы поставщикам)
УтверждениеУтвердить
Отклонить
Переназначить
Отправить предложение
КоррИсх
(Корреспонденция)
ОтправкаОтправить
Извещение о получении подтверждения даты полученияОбработать служебное
КоррВх
(Корреспонденция)
Извещение о полученииОбработать служебное
СчетИсх
(Счета)
ОтправкаОтправить
Извещение о получении подтверждения даты полученияОбработать служебное
Извещение о получении уведомления о приеме
Извещение о получении уведомления об уточнении
СчетВх
(Счета)
УтверждениеУтвердить
Отклонить
Переназначить
Извещение о полученииОбработать служебное
Извещение о получении подтверждения даты отправки
Извещение о получении подтверждения даты получения извещения о получении документов
ФактураИсх
(Фактуры)
ОтправкаОтправить
ФактураВх
(Фактуры)
УтверждениеУтвердить
Отклонить
Извещение о полученииОбработать служебное
ConsignmentNote
(ЭТрН)
ОтправкаПогружен
Получение грузаПринят
Не принят*
Переназначить
Приемка грузаПринят
Не принят*
Переназначить
Выдача грузаВыдан
Переназначить
ИзменениеСогласовано
Не согласовано
CorrIn
(Корректировка)
УтверждениеУтвердить
Отклонить
Переназначить
Извещение о полученииОбработать служебное
CorrOut
(Корректировка)
ОтправкаОтправить
DeviationActIn
(Входящий акт о расхождениях)
УтверждениеУтверждено
Отклонено
Извещение о полученииОбработать служебное
DeviationActOut
(Исходящий акт о расхождениях)
ОтправкаОтправить
PriceMatchingIn
(Согласование цен)
Отправить заявкуОтправить
Отклонить
PriceMatchingOut
(Запрос цен)
ОтправкаОтправить
ReturnIn
(Возврат от покупателя)
УтверждениеУтверждено
Отклонено
ReturnOut
(Возврат поставщику)
ОтправкаОтправить
Waybill
(ЭПЛ)
На выполнениеОтправить
Внутренний ТОДопущен
Не допущен
Переназначить
Внутренний МОДопущен
Не допущен
Переназначить
Медосмотр (внешний)Допущен
Не допущен
Переназначить
Выпуск в рейсВыпущен
Завершить
Переназначить
ПриемкаПринят
Переназначить
На медосмотр (если предусмотрен медосмотр после рейса)
Переназначить
Послерейсовый медосмотрПроведен
Переназначить

* — для выполнения команды заполните поле «Комментарий».

Этапы и действия по аннулированию доступны для всех типов документов внешнего документооборота, кроме электронной транспортной накладной.

Тип документа

Этап

Действие

Любой
(внешний документооборот)
Аннулировать (отправка, скрытый этап)Аннулировать
АннулированиеДокумент аннулирован
Аннулирование отклонено

Типы вложений документа

Возможные значения поля «Документ.Вложение.Тип» описаны в таблице.

Тип вложенияОписание
Первичные вложения
АктВРАкт выполненных работ
АктЗаказАкт (титул заказчика)
АктППАкт приема-передачи неисключительных прав
АктПриемкиАкт о приемке товаров
АктСверАкт сверки взаиморасчетов
ДоговорДоговор
ЗаказЗаказ
ЗапросЦенДокумент согласования цен
КСЧФСчет-фактура корректировочный
НаклПокупТоварная накладная (титул покупателя)
ПисьмоЭДОКорреспонденция ЭДО
ПодтверждениеЗаказаПодтверждение заказа
ПриходныйОрдерПриходный кассовый ордер
РасходныйОрдерРасходный кассовый ордер
СлужЗапТип документа для «Задача»
счФактКорСчет-фактура корректировочный
СчФктрСчет-фактура от 02.02.2019
УведомлОтгрУведомление об отгрузке
УкдДисКорректировочный документ
УкдДисПокупКорректировочный документ (титул покупателя)
УкдКсчфДисКорректировочный счет-фактура и корректировочный документ
УкдКсчфДисПокупКорректировочный счет-фактура и корректировочный документ (с 2020 г.) (титул покупателя)
УпдДопПередаточный документ от 02.02.2019
УпдДопПокупПередаточный документ (титул покупателя)
УпдСчфДопСчет-фактура и передаточный документ от 02.02.2019
УпдСчфДопПокупСчет-фактура и передаточный документ (титул покупателя)
ЭДОНаклТоварная накладная
ЭДОСчСчет
АктВыпускаАкт выпуска
АктСписанияАкт списания
Служебные вложения
ИзвПолучИзвещение о получении
ПодтвДатОтпрПодтверждение даты отправки оператором
ПодтвДатПолПодтверждение даты получения оператором
УведПриемУведомление о приеме
УведУточУведомление о требовании уточнений
Корреспонденция
ПисьмоПисьмо ЭДО
ТОРГ-2Акт о расхождении при приемке ТМЦ (ТОРГ-2)

Все значения поля для вложений регистрозависимы — для СБИС «СчФктр» и «СЧФКТР» будут разными типами вложений.

Список допустимых событий

ЭДО

  • «Отправка»
  • «Подтверждение даты отправки»
  • «Извещение о получении Подтверждения даты отправки»
  • «Подтверждение даты получения»
  • «Извещение о получении Подтверждения даты получения»
  • «Получение»
  • «Извещение о получении»
  • «Подтверждение даты получения извещения о получении документов»
  • «Извещение о получении подтверждения даты получения извещения о получении документов»
  • «Уведомление о приеме»
  • «Извещение о получении Уведомления о приеме»
  • «Уведомление об уточнении»
  • «Извещение о получении Уведомления об уточнении»
  • «Ошибка». Может появиться при загрузке или отправке документа. В событии есть описание проблемы и вложения, которые были загружены в момент появления ошибки. Это событие можно игнорировать
  • «Аннулирование»
  • «Отправка соглашения об аннулировании»
  • «Получение соглашения об аннулировании»
  • «Отправка подтверждения соглашения об аннулировании»
  • «Получение подтверждения соглашения об аннулировании»
  • «Отправка отклонения соглашения об аннулировании»
  • «Получение отклонения соглашения об аннулировании»
  • «Загрузка»
  • «Уведомление об удалении на стороне получателя»
  • «Уведомление об удалении на стороне отправителя»
  • «Подтверждение отправителю на отправку»
  • «Подтверждение получателю на отправку»
  • «Подтверждение отправителю на извещение»
  • «Подтверждение получателю на извещение»
  • «Подтверждение отправителю на отклонение»
  • «Подтверждение получателю на отклонение»

Обмен с госсистемами

Порядок формирования основных событий показан на схеме обмена счетами-фактурами в API и SDK.

События, которые не указаны в списке, мы рекомендуем игнорировать.

Допустимые направления пакетов с документами

НазваниеОписание
ВходящийВходящие пакеты
ИсходящийИсходящие пакеты
ВнутреннийВнутренние пакеты

Допустимые направления вложений (документов)

Направление вложения не связано с направлением пакета, к которому оно относится.

Название

Описание

ВходящийВходящие вложения (направление документа может быть любым). Получены от контрагента
ИсходящийИсходящие вложения (направление документа может быть любым). Отправлены контрагенту
Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.