REST API для 1С:Бухгалтерия предприятия 3.0:
интеграция ваших систем с 1С:Бухгалтерия предприятия 3.0 через современный HTTP-интерфейс

Расширение конфигурации | 1С:Предприятие 8 | 1С:Бухгалтерия 3.0

Подробнее Получить консультацию

Возможности API

Работа со счетами

  • • Создание, редактирование, удаление счетов
  • • Получение печатной формы в PDF
  • • Просмотр статусов оплаты
POST /invoices
{
  "seller_inn": "7799434926",
  "payer_inn": "770987654321",
  "items": [{
    "name": "Услуга",
    "price": 100000,
    "quantity": 2
  }]
}

Управление актами

  • • Создание актов по счетам
  • • Связь с исходными документами
  • • Генерация печатных форм
GET /acts/АКТ-2024-001_20240520

Управление контрагентами

  • • Добавление новых контрагентов
  • • Полная банковская информация
  • • Интеграция с договорами
POST /counterparties
{
  "inn": "771234567890",
  "name": "ООО Ромашка",
  "kpp": "771301001"
}

 

 
Frame 1321315639.png

Технические характеристики

Формат данных

JSON

Аутентификация

Basic Auth

Методы

GET, POST, PUT, DELETE

Версия 1С

Бухгалтерия предприятия 3.0 (3.0.190.22+, в т.ч. КОРП)

 

check Быстрая интеграция

check Подключение за 1 день с помощью REST API и JSON

check Полная документация

check Подробные схемы данных и примеры запросов

Документация веб-сервиса для 1С:Бухгалтерия предприятия 3.0

1. Общие положения

REST API для интеграции 1С:Бухгалтерия предприятие 3.0 (3.0.190.22, в т.ч. КОРП) с внешними системами через 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": "7799434926",
  "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": "7799434926",
  "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": "7799434926",
  "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..."
}

 

История версий

  • Добавили поиск счёта по комментарию: /invoices/4ed9?comment=1 , здесь в адресной строке, после "invoices/" задаем что ищем в комментарии счета (пример, 4ed9), и указываем параметр включающий поиск по комменту ?comment=1

Техническая поддержка

В случае возникновения ошибок рекомендуем ознакомиться с описанием и документацией программы. Если не нашли решения своей проблемы в документации или решение не помогает - тогда создайте обращение по инструкции ниже:

1

Создать обращение (тикет)

Создать тикет

2

Заполнить данные

Контакты, номер заказа, подробное описание вопроса
Напишите порядок ваших действий с программой, приложите видео/скриншоты/отчеты об ошибке
Точную конфигурацию 1С, версии платформы, инструмента, СУБД

3

Дождаться ответа

Время ответа до 24 часов в рабочее время

Внимание! 

Техническая поддержка предоставляется исключительно в рамках переписки по обращению. В некоторых случаях для диагностики ошибок и/или вопросов, связанных с особенностями использования продукта в информационных базах покупателя, может потребоваться дополнительная платная диагностика с организацией удаленного доступа к информационной базе. Стоимость уточняется индивидуально.

Остались вопросы?

Для получения дополнительной информации и помощи в настройке модуля под нужды вашего бизнеса — оставьте заявку

Демоверсия Feedback Pro