Запрос R6: Создание новой декларации на товары
Адрес: https://www.tws.by/tws/api/r6
Создаётся новая декларация на товары и возвращается её внутренний ID в Системе TWS. Этот ID в дальнейшем может использоваться в других запросах, поэтому имеет смысл его сохранить в системе, которая использует API TWS.
Перед выполнением этого запроса необходимо установить текущего пользователя (от имени которого будут производиться все действия с декларацией) - запрос R10. Этот пользователь будет первоначальным владельцем декларации. Обычно для этих целей в Виртуальном офисе заводят отдельного пользователя, а затем вручную перебрасывают декларацию на непосредственных исполнителей. Однако ничто не мешает и сразу создавать декларацию, назначенную реальным сотрудникам.
Многие из перечисленных ниже полей декларации могут быть в дальнейшем изменены при загрузке в декларацию сведений о товарах запросом R7.
Входные параметры
- SessionKey – сессионный ключ, полученный из запроса R1. Обязательный параметр.
- OwnerID – ID пользователя в Системе TWS, который будет являться владельцем декларации. Параметр может быть опущен, тогда будет автоматически подставлен текущий пользователь (см. запрос R10).
- Date – дата декларации. Обязательный параметр. Формат: YYYY-MM-DD.
- Number – исходящий номер декларации, если необходимо его задавать явно. Если параметр не добавлен, номер декларации будет сгенерирован автоматически.
- Kind – вид декларации (возможные значения). Обязательный параметр.
- ProcedureNumber – для деклараций на товары: код таможенной процедуры в соответствии с Классификатором видов таможенных процедур. Для статистических деклараций: код таможенной процедуры “ИМ” либо “ЭК”. Обязательный параметр.
- SellerPartner – краткое наименование продавца/контрактодержателя в соответствии со справочником контрагентов в Виртуальном офисе. Обязательно к заполнению, если не заполнено поле SellerPartnerID.
- SellerPartnerID – ID контрагента продавца/контрактодержателя в соответствии со справочником контрагентов в Виртуальном офисе. Обязательно к заполнению, если не заполнено поле SellerPartner.
- DeclarantPartner – Краткое наименование декларанта (для СД это графа 2а “Резидент”) в соответствии со справочником контрагентов в Виртуальном офисе. Обязательно к заполнению, если не заполнено поле DeclarantPartnerID.
- DeclarantPartnerID – ID контрагента декларанта (для СД это графа 2a “Резидент”) в соответствии со справочником контрагентов в Виртуальном офисе. Обязательно к заполнению, если не заполнено поле DeclarantPartner.
- CurrencyCode – трёхбуквенный код валюты декларации в соответствии с Классификатором валют. Обязательный параметр.
- SaleCountry – двухбуквенный код торгующей страны в соответствии с Классификатором стран мира. Необязательный параметр.
- SaleCountryRegion – код региона торгующей страны в соответствии с Классификатором административно-территориального деления стран мира. Необязательный параметр.
Обычно используется только в статистических декларациях.
Значение поля игнорируется, если не заполнено поле SaleCountry.
Код “000” соответствует записи справочника “000 - Иные”. Для заполнения графы значением “000 - Отсутствие административно-территориального деления” просто оставьте поле пустым.
- DealCharacter – код характера сделки в соответствии с Классификатором характера сделки. Необязательный параметр.
- DealDetails – код особенности внешнеэкономической сделки в соответствии с Классификатором особенности внешнеэкономической сделки. Необязательный параметр.
- Note – примечание к декларации, доступное для редактирования декларантами. Максимальная длина 8000 символов.
- ApiNote – произвольная строка, которая будет храниться вместе с декларацией, и отдаваться назад запросом R5. Поле недоступно для редактирования декларантами. Максимальная длина 8000 символов.
Для статистических деклараций также дополнительно могут использоваться следующие поля:
- SdCustomsCode – код таможенного органа, в регионе деятельности которого зарегистрирован экспортёр (импортёр) в соответствии со Справочником таможен и пунктов таможенного оформления (ПТО). Необязательный параметр.
Указывается полный код таможенного органа (например “02000”).
- SdCommonLiabilityDate – общая для всех товаров дата отгрузки/поступления. Значение этого поля может быть переопределено на уровне товарной позиции. Необязательный параметр. Формат: YYYY-MM-DD.