Акты

Акт это документ, который формируется по факту выполненных работ. Акт подписывается компанией и исполнителем. На основании акта можно отправить деньги исполнителю и сформировать чек для самозанятого в ФНС.

Структура объекта

id integer
Уникальный идентификатор объекта на платформе

number integer
Номер документа на платформе, уникален в рамках компании

title string
Описание работ

date string
Дата акта

date_from string
Дата с которой нужно загрузить акты. Может использоваться без date_to

date_to string
Дата по которую нужно загрузить акты.

start_date string
Дата начала периода оказания услуг

end_date string
Дата окончания периода оказания услуг

created timestamp
Дата и время создания

jobs_count integer
Количество услуг в акте

jobs_type string
Тип услуг

amount decimal
Сумма акта

payment_amount decimal
Сумма выплаты исполнителю по договору ГПХ после вычета НДФЛ. Так же используется для создания акта взаимозачета, равняется сумме выплаты без учета взаимозачета.

outer_id string
Внешний идентификатор – уникальный идентификатор акта на стороне клиента. Повторное создание акта с одним идентификатором вернет ошибку.

status string
Текущий статус акта, таблица значений:

СтатусОписание
createdсоздан
accepted_by_companyподписан компанией
accepted_by_contractorподписан исполнителем
acceptedподписан обеими сторонами
annulledаннулирован
paid_without_contractor_acceptоплачен без подписи исполнителя
paidоплачен

payment object
Процесс оплаты акта

Свойства оплаты

status enum
Статус оплаты, возможные значения: not_paid | in_progress | paid | error | autopay

error string | null
Текст ошибки если оплата не прошла

date string | null
Дата списания со счёта

commission string
Сумма комиссии сервиса, в том числе с учетом копеек. Значение возвращается с точностью до двух знаков, например: 103.68.

contractor object
Исполнитель, выполнивший работы Исполнители

receipt null | hash
Чек, формируется при оплате реестра

Свойства чека

url string
Ссылка на сайте nalog.ru

canceled boolean
TRUE если чек был аннулирован
FALSE если чек не аннулирован

jobs_count int
Количество работ/услуг в акте

jobs_type string
Вид работ/услуг в акте (штук, часов, услуг и т.д.)

bundle null | hash
Пачка, в которой находится акт

Свойства пачки

id integer
Номер пачки

url string
Ссылка на печатную форму акта
Например: https://api.konsol.pro/v2/acts/{id}/url

settlement_act_url string
Ссылка на печатную форму акта взаимозачета
Например: https://api.konsol.pro/company/documents/file_url?token=

subtasks array
Значения в табличной части шаблона акта

Свойства табличной части шаблона акта

quantity string
Количество услуг

unit_cost string
Стоимость одной услуги

amount string
Сумма за оказанные услуги/работы

description string
Описание услуги/работы (будет отражено в чеке для самозанятого)

unit_kind string
Тип услуги

contract object
Договор, по - которому был создан акт.

id integer
Идентификатор договора

number string
Номер договора

date string
Дата договора

template string
Идентификатор сценария приглашения

data string
Значения дополнительных (кастомных) переменных добавленных в шаблон акта.
К примеру: "podrazdelenie": "Название подразделения", "service_count": "3"

contractor_sign_date string
Дата подписания акта исполнителем в формате YYYY-MM-DD

company_sign_date string
Дата подписания акта компанией в формате YYYY-MM-DD

Пример

{ "id": 860958, "title": "Заготовка травяных сборов", "amount": "26000.0", "prepaid_amount": null, "contractor_id": 122377, "start_date": "2022-09-01", "end_date": "2022-09-08", "outer_id": null, "number": "134", "created": 1662967915, "contractor": { "id": 122377, "kind": "self_employed", "inn": "000000000000", "ogrnip": null, "nalog_registration_time": null, "snils": null, "phone": "+70000000000", "email": null, "first_name": "Анатолий", "last_name": "Александрович", "patronymic": "Вассерман" }, "status": "paid", "date": "2022-09-10", "jobs_count": null, "jobs_type": null, "receipt": { "url": "https://lknpd.nalog.ru/api/v1/receipt/504010840708/200km3p99f/print", "canceled": false }, "bundle": null, "payment_amount": "26000.0", "contract": { "id": 181783, "number": 50, "date": "2022-08-17", "template": "secretroom" }, "payment": { "status": "paid", "error": null, "commission": "520.0", "date": null }, "url": "https://api.konsol.pro/v2/acts/860958/url", "data": {}, "contractor_sign_date": null, "company_sign_date": null, "subtasks": [ { "data": {}, "quantity": null, "unit_cost": null, "amount": "26000.0", "description": "Заготовка травяных сборов", "unit_kind": null } ] }