Возможности API
Работа со счетами
- • Создание, редактирование, удаление счетов
- • Получение печатной формы в PDF
- • Просмотр статусов оплаты
POST /invoices
{
"seller_inn": "771234567890",
"payer_inn": "770987654321",
"items": [{
"name": "Услуга",
"price": 100000,
"quantity": 2
}]
}
Управление актами
- • Создание актов по счетам
- • Связь с исходными документами
- • Генерация печатных форм
GET /acts/АКТ-2024-001_20240520
Управление контрагентами
- • Добавление новых контрагентов
- • Полная банковская информация
- • Интеграция с договорами
POST /counterparties
{
"inn": "771234567890",
"name": "ООО Ромашка",
"kpp": "771301001"
}
Работа со счетами
- • Создание, редактирование, удаление счетов
- • Получение печатной формы в PDF
- • Просмотр статусов оплаты
POST /invoices
{
"seller_inn": "771234567890",
"payer_inn": "770987654321",
"items": [{
"name": "Услуга",
"price": 100000,
"quantity": 2
}]
}
Управление актами
- • Создание актов по счетам
- • Связь с исходными документами
- • Генерация печатных форм
GET /acts/АКТ-2024-001_20240520
Управление контрагентами
- • Добавление новых контрагентов
- • Полная банковская информация
- • Интеграция с договорами
POST /counterparties
{
"inn": "771234567890",
"name": "ООО Ромашка",
"kpp": "771301001"
}
Технические характеристики
Формат данных
JSON
Аутентификация
Basic Auth
Методы
GET, POST, PUT, DELETE
Версия 1С
Бухгалтерия предприятия 3.0 (3.0.177.30+)
Быстрая интеграция
Подключение за 1 день с помощью REST API и JSON
Полная документация
Подробные схемы данных и примеры запросов
Документация веб-сервиса для 1С:Бухгалтерия предприятия 3.0
1. Общие положения
REST API для интеграции 1С:Бухгалтерия предприятие 3.0 (3.0.177.30) с внешними системами через HTTP-запросы.
Расширение должно устанавливаться штатными средствами 1С: Предприятие.
Для работы с расширением лучше создать отдельного пользователя со следующим набором прав: bitHttpApi_ОсновнаяРоль, Базовые права БСП, Добавление и изменение данных бухгалтерии, Удаленный доступ (OData). Для работы с печатной формой pfd необходимо отключить безопасный режим, так как требуется сохранение временного файла печатной формы на стороне сервера
Технологии:
- • Бэкенд: 1С:Предприятие 8.3
- • Формат данных: JSON
- • Аутентификация: Basic Auth
2. Требования к API
2.1. Общие параметры
- • Базовый URL:
/{ваша_публикация}/hs/bit_http_api/
- • Идентификаторы документов:
- Формат:
{номер}_{дата} (пример: СЧ-2024-001_20240515)
- • Заголовки:
Content-Type: application/json
Authorization: Basic {base64_credentials}
2.2. Методы API
2.2.1. Счета
Метод
Путь
Параметры
Описание
Ограничения
Возвращаемые данные
POST
/invoicesseller_inn, payer_inn, items[]Создание счёта
Проверка контрагентов
Созданный счет (полная схема)
GET
/invoices/{id}-
Получение счёта
-
Полная схема счета
PUT
/invoices/{id}Все поля счёта
Редактирование
Запрещено при наличии оплат
Обновленный счет
DELETE
/invoices/{id}-
Удаление
Запрещено при наличии оплат
HTTP 204 No Content
GET
/invoices/{id}/print-
Получение печатной формы счета в PDF
-
PDF в виде base64 строки
2.2.2. Акты
Метод
Путь
Параметры
Описание
Ограничения
Возвращаемые данные
POST
/actsseller_inn, payer_inn, invoice_id, items[]Создание акта
Проверка контрагентов
Созданный акт
GET
/acts/{id}-
Получение акта
-
Полная схема акта
PUT
/acts/{id}Все поля акта
Редактирование
Запрещено при наличии оплат
Обновленный акт
DELETE
/acts/{id}-
Удаление
Запрещено при наличии оплат
HTTP 204 No Content
GET
/acts/{id}/print-
Получение печатной формы акта в PDF
-
PDF в виде base64 строки
2.2.3. Контрагенты
Метод
Путь
Параметры
Обязательные
Возвращаемые данные
POST
/counterpartiesinn, name, kpp, address, email, phone, account_number, bank_bik, bank_name, bank_correspondent_account, director_nameinn, name, kpp - если это юрлицо, а не ИПСозданный контрагент
GET
/counterparties/{inn}-
-
Данные контрагента
PUT
/counterparties/{inn}Любые поля контрагента
-
Обновленные данные
3. Обработка ошибок
3.1. Формат ответов
- • Успешные ответы: JSON
- • Ошибки: Текстовые сообщения (ограничение 1С)
3.2. Основные ошибки
HTTP-код
Пример сообщения
Условия
400
"Не указаны обязательные поля: seller_inn"
Ошибка валидации
401
"Требуется авторизация"
Ошибка аутентификации
403
"Документ имеет оплаты, редактирование запрещено"
Бизнес-ограничение
404
"Контрагент с ИНН 771234567890 не найден"
Объект не существует
409
"Контрагент с ИНН 771234567890 уже существует"
Конфликт данных
4. Схемы данных
Суммы должны возвращаться в виде целых чисел, в копейках
4.1. Счет
{
"id": "СЧ-2024-001_20240515",
"number": "СЧ-2024-001",
"date": "2024-05-15",
"seller_inn": "771234567890",
"payer": {
"inn": "771234567890",
"kpp": "771301001",
"name": "ООО Ромашка",
"address": "г. Москва, ул. Ленина, 1",
"phone": "+79991234567",
"account_number": "40702810500000012345",
"bank_bik": "044525225",
"bank_name": "ПАО Банк Поставщика",
"bank_correspondent_account": "30101810100000000111",
"email": "sc-bit@mail.ru",
"director_name": "Иванов Иван Иванович"
},
"status": "paid",
"items": [
{
"name": "Услуга",
"description": "Услуга",
"price": 100000,
"quantity": 2,
"total": 200000
}
],
"payments": [
{
"date": "2024-05-16",
"amount": 200000,
"payment_method": "bank_transfer"
}
],
"deleted": false,
"total_amount": 200000,
"paid_amount": 200000
}
4.2. Акт
{
"id": "АКТ-2024-001_20240520",
"number": "АКТ-2024-001",
"date": "2024-05-20",
"seller_inn": "771234567890",
"payer": {
"inn": "771234567890",
"kpp": "771301001",
"name": "ООО Ромашка",
"address": "г. Москва, ул. Ленина, 1",
"phone": "+79991234567",
"account_number": "40702810500000012345",
"bank_bik": "044525225",
"bank_name": "ПАО Банк Поставщика",
"bank_correspondent_account": "30101810100000000111",
"email": "sc-bit@mail.ru",
"director_name": "Иванов Иван Иванович"
},
"invoice_id": "СЧ-2024-001_20240515",
"items": [
{
"name": "Услуга",
"description": "Услуга",
"price": 100000,
"quantity": 2,
"total": 200000
}
],
"deleted": false,
"paid_amount": 200000
}
4.3. Контрагент
{
"inn": "771234567890",
"kpp": "771301001",
"name": "ООО Ромашка",
"address": "г. Москва, ул. Ленина, 1",
"phone": "+79991234567",
"account_number": "40702810500000012345",
"bank_bik": "044525225",
"bank_name": "ПАО Банк Поставщика",
"bank_correspondent_account": "30101810100000000111",
"director_name": "Иванов Иван Иванович",
"email": "sc-bit@mail.ru"
}
5. Примеры запросов
5.1. Создание счёта
POST /{ваша_публикация}/hs/bit_http_api/invoices
Authorization: Basic dXNlcjpwYXNzd29yZA==
Content-Type: application/json
{
"seller_inn": "771234567890",
"payer_inn": "770987654321",
"items": [
{
"name": "Разработка API",
"description": "Разработка API (аванс)",
"price": 1000000,
"quantity": 1
}
]
}
5.2. Получение акта
GET /{ваша_публикация}/hs/bit_http_api/acts/АКТ-2024-001_20240520
Authorization: Basic dXNlcjpwYXNzd29yZA==
5.3. Получение печатной формы счёта
GET /{ваша_публикация}/hs/bit_http_api/invoices/СЧ-2024-001_20240515/print
Authorization: Basic dXNlcjpwYXNzd29yZA==
Пример успешного ответа:
{
"pdf_base64": "JVBERi0xLjQKJdPr6eEKMSAwIG9iago8PC9UeXBlL1hPYmplY3QvU3VidHlwZS9JbWFnZS9XaWR0aCA1OTUvSGVpZ2h0IDg0Mi9Db2xvclNwYWNlL0RldmljZVJHQi9CaXRzUGVyQ29tcG9uZW50IDgvRmlsdGVyL0ZsYXRlRGVjb2RlL0xlbmd0aCAxMjM0NTY+PgpzdHJlYW0KeJzt3X..."
}
1. Общие положения
REST API для интеграции 1С:Бухгалтерия предприятие 3.0 (3.0.177.30) с внешними системами через HTTP-запросы.
Расширение должно устанавливаться штатными средствами 1С: Предприятие.
Для работы с расширением лучше создать отдельного пользователя со следующим набором прав: bitHttpApi_ОсновнаяРоль, Базовые права БСП, Добавление и изменение данных бухгалтерии, Удаленный доступ (OData). Для работы с печатной формой pfd необходимо отключить безопасный режим, так как требуется сохранение временного файла печатной формы на стороне сервера
Технологии:
- • Бэкенд: 1С:Предприятие 8.3
- • Формат данных: JSON
- • Аутентификация: Basic Auth
2. Требования к API
2.1. Общие параметры
- • Базовый URL:
/{ваша_публикация}/hs/bit_http_api/ - • Идентификаторы документов:
- Формат:
{номер}_{дата}(пример:СЧ-2024-001_20240515)
- Формат:
- • Заголовки:
Content-Type: application/json Authorization: Basic {base64_credentials}
2.2. Методы API
2.2.1. Счета
| Метод | Путь | Параметры | Описание | Ограничения | Возвращаемые данные |
|---|---|---|---|---|---|
| POST | /invoices |
seller_inn, payer_inn, items[] |
Создание счёта | Проверка контрагентов | Созданный счет (полная схема) |
| GET | /invoices/{id} |
- | Получение счёта | - | Полная схема счета |
| PUT | /invoices/{id} |
Все поля счёта | Редактирование | Запрещено при наличии оплат | Обновленный счет |
| DELETE | /invoices/{id} |
- | Удаление | Запрещено при наличии оплат | HTTP 204 No Content |
| GET | /invoices/{id}/print |
- | Получение печатной формы счета в PDF | - | PDF в виде base64 строки |
2.2.2. Акты
| Метод | Путь | Параметры | Описание | Ограничения | Возвращаемые данные |
|---|---|---|---|---|---|
| POST | /acts |
seller_inn, payer_inn, invoice_id, items[] |
Создание акта | Проверка контрагентов | Созданный акт |
| GET | /acts/{id} |
- | Получение акта | - | Полная схема акта |
| PUT | /acts/{id} |
Все поля акта | Редактирование | Запрещено при наличии оплат | Обновленный акт |
| DELETE | /acts/{id} |
- | Удаление | Запрещено при наличии оплат | HTTP 204 No Content |
| GET | /acts/{id}/print |
- | Получение печатной формы акта в PDF | - | PDF в виде base64 строки |
2.2.3. Контрагенты
| Метод | Путь | Параметры | Обязательные | Возвращаемые данные |
|---|---|---|---|---|
| POST | /counterparties |
inn, name, kpp, address, email, phone, account_number, bank_bik, bank_name, bank_correspondent_account, director_name |
inn, name, kpp - если это юрлицо, а не ИП |
Созданный контрагент |
| GET | /counterparties/{inn} |
- | - | Данные контрагента |
| PUT | /counterparties/{inn} |
Любые поля контрагента | - | Обновленные данные |
3. Обработка ошибок
3.1. Формат ответов
- • Успешные ответы: JSON
- • Ошибки: Текстовые сообщения (ограничение 1С)
3.2. Основные ошибки
| HTTP-код | Пример сообщения | Условия |
|---|---|---|
| 400 | "Не указаны обязательные поля: seller_inn" | Ошибка валидации |
| 401 | "Требуется авторизация" | Ошибка аутентификации |
| 403 | "Документ имеет оплаты, редактирование запрещено" | Бизнес-ограничение |
| 404 | "Контрагент с ИНН 771234567890 не найден" | Объект не существует |
| 409 | "Контрагент с ИНН 771234567890 уже существует" | Конфликт данных |
4. Схемы данных
Суммы должны возвращаться в виде целых чисел, в копейках
4.1. Счет
{
"id": "СЧ-2024-001_20240515",
"number": "СЧ-2024-001",
"date": "2024-05-15",
"seller_inn": "771234567890",
"payer": {
"inn": "771234567890",
"kpp": "771301001",
"name": "ООО Ромашка",
"address": "г. Москва, ул. Ленина, 1",
"phone": "+79991234567",
"account_number": "40702810500000012345",
"bank_bik": "044525225",
"bank_name": "ПАО Банк Поставщика",
"bank_correspondent_account": "30101810100000000111",
"email": "sc-bit@mail.ru",
"director_name": "Иванов Иван Иванович"
},
"status": "paid",
"items": [
{
"name": "Услуга",
"description": "Услуга",
"price": 100000,
"quantity": 2,
"total": 200000
}
],
"payments": [
{
"date": "2024-05-16",
"amount": 200000,
"payment_method": "bank_transfer"
}
],
"deleted": false,
"total_amount": 200000,
"paid_amount": 200000
}
4.2. Акт
{
"id": "АКТ-2024-001_20240520",
"number": "АКТ-2024-001",
"date": "2024-05-20",
"seller_inn": "771234567890",
"payer": {
"inn": "771234567890",
"kpp": "771301001",
"name": "ООО Ромашка",
"address": "г. Москва, ул. Ленина, 1",
"phone": "+79991234567",
"account_number": "40702810500000012345",
"bank_bik": "044525225",
"bank_name": "ПАО Банк Поставщика",
"bank_correspondent_account": "30101810100000000111",
"email": "sc-bit@mail.ru",
"director_name": "Иванов Иван Иванович"
},
"invoice_id": "СЧ-2024-001_20240515",
"items": [
{
"name": "Услуга",
"description": "Услуга",
"price": 100000,
"quantity": 2,
"total": 200000
}
],
"deleted": false,
"paid_amount": 200000
}
4.3. Контрагент
{
"inn": "771234567890",
"kpp": "771301001",
"name": "ООО Ромашка",
"address": "г. Москва, ул. Ленина, 1",
"phone": "+79991234567",
"account_number": "40702810500000012345",
"bank_bik": "044525225",
"bank_name": "ПАО Банк Поставщика",
"bank_correspondent_account": "30101810100000000111",
"director_name": "Иванов Иван Иванович",
"email": "sc-bit@mail.ru"
}
5. Примеры запросов
5.1. Создание счёта
POST /{ваша_публикация}/hs/bit_http_api/invoices
Authorization: Basic dXNlcjpwYXNzd29yZA==
Content-Type: application/json
{
"seller_inn": "771234567890",
"payer_inn": "770987654321",
"items": [
{
"name": "Разработка API",
"description": "Разработка API (аванс)",
"price": 1000000,
"quantity": 1
}
]
}
5.2. Получение акта
GET /{ваша_публикация}/hs/bit_http_api/acts/АКТ-2024-001_20240520
Authorization: Basic dXNlcjpwYXNzd29yZA==
5.3. Получение печатной формы счёта
GET /{ваша_публикация}/hs/bit_http_api/invoices/СЧ-2024-001_20240515/print
Authorization: Basic dXNlcjpwYXNzd29yZA==
Пример успешного ответа:
{
"pdf_base64": "JVBERi0xLjQKJdPr6eEKMSAwIG9iago8PC9UeXBlL1hPYmplY3QvU3VidHlwZS9JbWFnZS9XaWR0aCA1OTUvSGVpZ2h0IDg0Mi9Db2xvclNwYWNlL0RldmljZVJHQi9CaXRzUGVyQ29tcG9uZW50IDgvRmlsdGVyL0ZsYXRlRGVjb2RlL0xlbmd0aCAxMjM0NTY+PgpzdHJlYW0KeJzt3X..."
}
Остались вопросы?
Для получения дополнительной информации и помощи в настройке модуля под нужды вашего бизнеса — оставьте заявку
Проверено на следующих конфигурациях и релизах:
- Бухгалтерия предприятия, редакция 3.0, релизы 3.0.177.30
