Устаревшие методы 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, чтобы акт пометился как готовый к отправке и ушел в ЕРИР.

В интерфейсе данное изменение никак не отражено, т.к. интерфейс не пользуется этими методами.

Выкатили интерфейс с новыми полями.

Включили удаление флага native при редактировании старых креативов.

API статистик с новыми полями тоже с нами.

Также опубликовали документацию к API удаления актов.

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

По этому поводу опубликовали API v3 актов.

Это изменение случилось.

Здравствуйте!

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

Хороших всем выходных!

В API загрузки медиафайлов больше не требуем и не принимаем поле описания файла (description). Передавать его не будет ошибкой, он просто проигнорируется. Метод выдачи информации по ранее загруженным файлам отдаст ранее загруженные описания, если они были.

Из интерфейса это поле также убрали, а файл теперь загружается автоматически сразу после его выбора.

К 1-му апреля в связи с введением сбора в 3% ЕРИР ожидает от нас реализацию ряда изменений, среди которых наиболее вероятны такие (финальный список еще утверждается, как и срок):
- роль "посредник" у контрагентов по акту: для посредников, не являющихся рекламными агентами.
- у акта появляется тип: "акт" (акт выполненных работ) и "отчет посредника"
- детализация суммы акта и суммы в разаллокациях по договорам и в статистиках: вместо просто поля "сумма" теперь требуется 4 поля - без НДС, ставка НДС, НДС, полная сумма с НДС, плюс включает отдельно блок, включающий вознаграждение посредника. Пример данных:

"amount": {
"services": {
"excludingVat": 22500.00, //Сумма отчета без учета НДС
"vatRate": "20", //Ставка НДС
"vat": 4500.00, //Сумма НДС
"includingVat": 27000.00 //Сумма отчета, включая НДС
},
"commission": { //Если вознаграждение посредника отражено
//только отчете, то сумма по вознаграждению
//посредника передается в отчете
"excludingVat": 1000.00, //Сумма посредника без учета НДС
"vatRate": "0", //Ставка НДС
"vat": 0.00, //Сумма НДС
"includingVat": 1000.00 //Сумма посредника, включая НДС
}
}


Когда и в каком порядке это будет вводиться у нас - посмотрим, но уже надо думать вам о том, чтобы доставать эти данные - они будут обязательными.
Как именно что надо будет передавать - разъяснения ожидаются позже.

‼️

С 30-го января перестанем принимать по API креативы, у которых не заполнены поля про тексты и медиафайлы, соответствующие типу креатива. Т.е. в API станет так, как уже сделано в интерфейсе.

И еще одна новость (скрестил пальцы, чтобы последняя на сегодня).

Поля с описанием креатива теперь можно не заполнять, если в списке ККТУ есть значения, отличные от "30.15.1" (Прочие товары и услуги).

Сегодня и в интерфейсе должно стать так же (не забудьте обновить страницу перед проверкой - чудо не произойдет само).

К менее важным, но тоже приятным новостям: открыли кобрендинг в API. Изменения реализованы в новом API v3 креативов, заключаются они в следующем:
* Строковое поле contract_external_id стало массивом строк с именем contract_external_ids (обратите внимание на 's' на конце).
* Поле kktus может принять более одного кода (до 16-ти) в случае, если contract_external_ids содержит более одного договора.
* Поле okveds исчезло полностью, не принимается и не отдается (передавать его в запрос не является ошибкой, но учитываться оно не будет).
* В ответе PUT-запроса нет более поля marker, осталось только поле erid.

Также есть нюанс в API актов: для кобрендинговых креативов в разаллокациях нельзя заполнить статистику: ее надо подавать отдельно через апи статистик.

Ссылка по теме: https://ord.vk.com/help/api/swagger/#/creative/v3-create-creative

Кто с чем, а мы с релизом года: теперь наша документация API поддерживает темную тему: https://ord.vk.com/help/api/
(страницу лучше обновить принудительно, иначе будет отображаться некорректно).