Акты

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

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

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
    }
  ]
}