VK ORD API News

Добавлена группа методов для работы с внешними CID, а также, возможность использовать добавленные CID в креативах и актах.

Если расчетная Сумма НДС < 0.1 руб., тоСумма НДС указывается с точностью от 2 до 5 знаков (i) после запятой. Если расчётная сумма НДС меньше 0,10 руб., допускается погрешность. Но итоговая сумма НДС должна находиться в диапазоне:От: значения, округлённого вниз до i-го знака (включительно)До: значения, округлённого математически до i-го знака, плюс 5 * 10⁻ⁱ руб. Указанная погрешность не может превышать 50% от суммы без НДС.5) Если "Ставка НДС" = "without_vat" или "Ставка НДС" = "0", то "Сумма НДС для стоимости оказанных услуг" должна быть равна 0.

В рамках поддержки нововведений и требований со стороны ЕРИР а нашем API проведены доработки:ПЕРСОНЫКонтрагент не может быть изменен, если после обновления в одном из договоров противоположной стороной является контрагент с таким же ИНН/foreign_registration_number/foreign_inn.ПЛОЩАДКИДобавлены новые типы площадок: smarttv и hbbtv. Для этих новых типов поле "url" не обязательно.ДОГОВОРЫПризнак is_charge_paid_by_agent не может быть передан, если в договоре НЕ указан признак agent_acting_for_publisher и исполнитель в договоре иностранное лицо.АКТЫ1) В новой версии API актов v4/invoice поле amount.services.vat_rate (Ставка НДС) может принимать значения:• "without_vat" (Без НДС),• "0",• "5",• "7",• "10",• "20"В версии v3/invoice можно по-прежнему передавать другие значения, в том числе дробные, но в скором времени эта возможность будет закрыта.2) Поле amount.services.vat_rate (Ставка НДС) обязательно к заполнению, если:- акт создан к договору оказания услуг (либо дополнительное соглашение к такому договору)- акт создан к посредническому договору с признаком agent_acting_for_publisher (либо дополнительному соглашению к такому договору)3) Если поле amount.services.vat_rate (Ставка НДС) НЕ передано, то amount.services.vat (Сумма НДС) должна быть больше 0 и не должна быть больше произведения максимальной ставки НДС в РФ (20%) на amount.services.excluding_vat (Сумму акта/отчета по услугам без НДС) с учетом предусмотренной погрешности.Описание расчета:Если расчетная Сумма НДС >= 0.50 руб., тоПереданная Сумма НДС <= m, гдеm - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.5 руб.Если расчетная Сумма НДС < 0.50 руб., то0 < Переданная Сумма НДС <= m, гдеm - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.05 руб., но не больше 50% от Суммы без НДС.Если расчетная Сумма НДС < 0,10 руб., то0 <= Переданная Сумма НДС <= m, гдеm - 50% от Суммы без НДС, с учетом математического округления до 2-го знака.

9) В новой версии API актов v4/invoice поле items.amount.vat_rate может принимать значения:• "without_vat" (Без НДС),• "0",• "5",• "7",• "10",• "20". 10) Если акт создан к договору оказания услуг (либо дополнительное соглашение к такому договору), то поле items.amount.vat_rate должно быть обязательно заполненно11) Если договор, к которому создан акт, имеет тип Посреднический договор (либо дополнительное соглашение к такому договору), договор в детализации является посредническим с признаком agent_acting_for_publisher (либо дополнительным соглашением к такому договору), то поле items.amount.vat_rate должно быть обязательно заполненно* Для поля items.amount.vat (Сумма НДС в детализации):12) добавлен форматный контроль: Если поле items.amount.vat_rate (Ставка НДС в детализации) НЕ передана, то поле items.amount.vat (Сумма НДС в детализации) должно быть больше 0 и не должно быть больше произведения максимальной ставки НДС в РФ (20%) items.amount.excluding_vat (Сумма детализации без учета НДС) с учетом предусмотренной погрешности.Описание расчета:0 < Если расчетная Сумма НДС >= 0.5 руб., тоПереданная Сумма НДС <= m, гдеm - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.5 руб.Если расчетная Сумма НДС < 0.5 руб., то0 < Переданная Сумма НДС <= m, гдеm - Округленная расчетная Сумма НДС по математическим правилам до 2-го знака после запятой + 0.05 руб., но не больше 50% от Суммы без НДС.Если расчетная Сумма НДС < 0,10 руб., то0 <= Переданная Сумма НДС <= m, гдеm - 50% от Суммы без НДС, с учетом математического округления до 2-го знака."13) Если "Ставка НДС в детализации" передана, то "Сумма НДС в детализации" должна быть равна произведению "Суммы детализации без учета НДС" на "Ставку НДС в детализации" с учетом предусмотренной погрешности.Описание расчета:Если расчетная Сумма НДС >= 0.5 руб., тоn <= Переданная Сумма НДС <= m, гдеn - Округленная вниз расчетная Сумма НДС до 2-го знака после запятой,m - Округленная расчетная Сумма НДС

Всвязи с отключением в ЕРИР возможности передавать старые акты и статистики без детализаций в amount полях, в скором времени будут отключены следующие эндпоинты в нашем API:PUT /v1/invoice/{external_id}GET /v1/invoice/{external_id}PUT /v2/invoice/{external_id}/headerPATCH /v2/invoice/{external_id}/itemsPOST /v1/statisticsGET /v1/statistics/listЕсли вы используете какие-то из них, следует перейти на аналоги из более высоких версий.

Добавили словарь статусов ЕРИР.Ручка /v1/erir_statuses возвращает в структуре поле messages с каким-то программистским описанием ошибки. Теперь сообщение из этого поля можно взять и передать в ручку /v1/dict/erir_message, чтобы получить человекочитаемое описание на выбранном языке, годное для отображения пользователю в интерфейсе. Есть также ручка POST, куда можно передать сразу несколько сообщений, для которых требуется перевод.

Планируем ужесточить проверки подаваемых данных актов: в статистике в акте можно будет подать только такую пару «договор, креатив», где указанный креатив зарегистрирован на указанный договор. В веб-интерфейсе уберем галочку «показать все креативы» возле договора в статистике. Если кто-то считает, что это ему может помешать - расскажите, пожалуйста, чем.

Перевели метод словаря ОКВЭДов /v1/dict/okved в разряд устаревших и выключим на следующей неделе.

Устаревшие методы GET и PUT /v1/creative/{external_id} перестанут работать с 29-го апреля.

Добрый день.В API GET /v3/invoice/{external_id} добавили в ответ поле status, которое для черновиков актов принимает значение 'draft' (а для не черновиков может вообще не отдаваться).Что такое черновик акта: это то, во что превращается акт при использовании следующих методов:- /v2/invoice/{external_id}/header- /v2/invoice/{external_id}/delete- /v2/invoice/{external_id}/items- /v3/invoice/{external_id}/header- /v3/invoice/{external_id}/itemsПосле использования одного или серии таких запросов требуется вызвать метод /v2/invoice/{external_id}/ready, чтобы акт пометился как готовый к отправке и ушел в ЕРИР.В интерфейсе данное изменение никак не отражено, т.к. интерфейс не пользуется этими методами.

- с конца марта через веб-интерфейс и миниапп ВКонтакте подать любые новые акты и отредактировать старые можно будет только с вводом всех новых полей - ставки НДС, размера налога и суммы без НДС.Выкатили интерфейс с новыми полями.

- после этого примерно с 24-го числа аналогичное изменение будет применено к API креативов: флаг native начнет игнорироваться. Т.е. при создании нового креатива этот флаг проставить не получится, а при редактировании старого нативного креатива он снимется. При этом в GET-методе по-прежнему будет отдаваться.Включили удаление флага native при редактировании старых креативов.

- с конца марта через веб-интерфейс и миниапп ВКонтакте подать любые новые акты и отредактировать старые можно будет только с вводом всех новых полей - ставки НДС, размера налога и суммы без НДС.API статистик с новыми полями тоже с нами.

Также опубликовали документацию к API удаления актов.Как это работает: после вызова удаления акта акт остается в листинге и доступен к получению по GET (где у него будет отображаться поле "status": "deleted"), но более недоступен к редактированию (запросы на редактирование вернут "403 Forbidden"). При этом все равно надо проверить статус акта из ЕРИР, потому что если акт уже участвует в расчете начислений сбора в 3%, то ЕРИР не позволит ни редактировать его, ни удалить. Если ЕРИР вернет ошибку, акт у нас останется в статусе "удален" и со статусом ЕРИРа "bad".

- с конца марта через веб-интерфейс и миниапп ВКонтакте подать любые новые акты и отредактировать старые можно будет только с вводом всех новых полей - ставки НДС, размера налога и суммы без НДС.По этому поводу опубликовали API v3 актов.