Акт это документ, который формируется по факту выполненных работ. Акт подписывается компанией и исполнителем. На основании акта можно отправить деньги исполнителю и сформировать чек для самозанятого в ФНС.
Структура объекта
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 | autopayerror string | null
Текст ошибки если оплата не прошлаdate string | null
Дата списания со счётаcommission string
Сумма комиссии сервиса, в том числе с учетом копеек. Значение возвращается с точностью до двух знаков, например: 103.68.
contractor object
Исполнитель, выполнивший работы Исполнители
receipt null | hash
Чек, формируется при оплате реестра
Свойства чека
url string
Ссылка на сайте nalog.rucanceled 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
}
]
}