Организации, доступные по ключу, и их банковские счета.

Шаблоны документов (счета, акты, договоры) — id для template_id в elba_create_bill и elba_create_act.

Найти контрагента в Эльбе по ИНН (надёжнее) и/или названию.

Карточка контрагента с контактами.

Создать контрагента. Перед созданием проверьте elba_find_contractor по ИНН, чтобы не завести дубль.

Выставить счёт клиенту.

items — список {"name": "Название услуги", "price": 10000, "quantity": 1, "unit": "усл."}; quantity и unit необязательны (1 и «усл.»), при with_nds можно задать "nds_rate" (nds22 по умолчанию). bill_date — ГГГГ-ММ-ДД, по умолчанию сегодня; number — по умолчанию следующий номер Эльбы. template_id — шаблон из elba_templates; сверьте его текст: шаблон-оферта может описывать не тот договор. bank_account_id — по умолчанию единственный открытый счёт организации; при нескольких открытых обязателен. project — метка для журнала (например сайт клиента), по ней видно, за что счёт. Счёт записывается в журнал. Если тому же клиенту на ту же сумму счёт выставлен в пределах недели, создание останавливается; allow_duplicate=true — выставить всё равно. Возвращает счёт с номером, суммой и статусом.

Счёт по id: номер, позиции, сумма и статус оплаты (notPaid, paid, partiallyPaid, rejected, overdue). total — null, если Эльба не вернула сумму хотя бы одной позиции. Счёт из журнала обновляется в журнале.

Добавить в журнал счёт, выставленный не через этот сервер (в Эльбе вручную или до появления журнала).

Неоплаченные счета из журнала со статусом из Эльбы и оплаченной частью из ленты оплат. Оплаченные и отменённые перечитываются, если лента расходится с журналом; recheck_all=true — все. Возвращает счета (номер, клиент, проект, сумма, оплачено, дней с даты счёта, ссылка) и общий долг; debt — null, если хоть одна сумма неизвестна или счёт не перечитался.

Сводка по журналу счетов: сколько выставлено, оплачено и не оплачено, сколько счетов закрыто актом или УПД — всего и по проектам, плюс список счетов (по нему же счёт находят по номеру). Фильтры: project, contractor_id, date_from и date_to (ГГГГ-ММ-ДД, по дате счёта). Отменённые не считаются. Статусы — из журнала; счета, у которых лента оплат с журналом расходится, перечитываются из Эльбы. Оплаченная часть — из ленты. Суммы null, если какую-то узнать не удалось; errors — счета, что не перечитались. byProject — список, project null — счета без проекта.

Оплаты по счетам с прошлой проверки (лента новостей Эльбы): счёт, статус, сумма счёта и сколько пришло. Обновляет статусы в журнале. Первый вызов только ставит отметку в конец ленты — история не выводится.

Создать акт выполненных работ. items — как в elba_create_bill. Основание (например «Счёт», номер и дата счёта) — reason_name, reason_number, reason_date. bank_account_id — как в elba_create_bill. template_id — шаблон акта из elba_templates. Акт по выставленному счёту проще сделать elba_act_from_bill.

Акт по выставленному счёту: позиции, клиент и банковский счёт берутся из счёта, основание — «Счёт № от». act_date — ГГГГ-ММ-ДД, по умолчанию сегодня. Второй акт по тому же счёту — только с allow_duplicate=true.

Создать УПД. items — как в elba_create_bill, плюс "type": "service" (по умолчанию) или "product". with_nds — УПД со счётом-фактурой (статус 1), без — только передаточный документ (статус 2). nds_rate — ставка при with_nds, обязательна: withoutNds, nds0, nds5, nds10, nds20, nds22 (у позиции можно переопределить "nds_rate"). УПД по выставленному счёту — elba_upd_from_bill.

УПД по выставленному счёту: позиции, клиент, банковский счёт и НДС берутся из счёта, основание — «Счёт № от». Счёт с НДС даёт УПД со счётом-фактурой (статус 1), без НДС — статус 2. product_type — service (по умолчанию) или product для всех позиций. Второй УПД по счёту — allow_duplicate=true.

Публичная ссылка на счёт или акт — её отправляют клиенту, по ней документ открывается и скачивается в PDF. with_signatures — с печатью и подписью; qr_payment — оплата по QR (только для счетов). Ссылка на счёт из журнала сохраняется в журнале.

Снять публичную ссылку с публикации (published=false, по умолчанию) или вернуть её (published=true). Снимать, когда счёт отменён: иначе клиент откроет и оплатит его по старой ссылке. link_id — из elba_document_link; для счёта из журнала достаточно document_id. API не отдаёт текущие настройки ссылки, поэтому with_signatures и qr_payment задаются заново.

Новый счёт по образцу прошлого: тот же клиент, позиции, НДС, банковский счёт, шаблон и проект. items — заменить позиции (формат elba_create_bill). Без items позиции копируются — проверьте названия: в них может остаться прошлый месяц. bill_date — по умолчанию сегодня. Дубли ловятся как в elba_create_bill.

Реквизиты организации или ИП по ИНН из ЕГРЮЛ/ЕГРИП ФНС (egrul.nalog.ru, без ключа): полное и краткое название, КПП, ОГРН, руководитель, дата регистрации, дата прекращения деятельности. Адреса поиск ФНС не отдаёт. Для elba_create_contractor: name — полное название, short_name — краткое. Сверьте с реквизитами от клиента; terminated — деятельность прекращена, счёт такому лицу выставлять нельзя.