Versions Compared

Old Version 2

changes.mady.by.user Olga Kaya

Saved on

compared with

New Version 3

changes.mady.by.user Daria Tikhova

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Please note that API integrations are available only in the classic (cloud) hosting environment — FirstBIT ERP software (i.e., not in the 1C:Fresh cloud subsystem, such as FirstBIT Accounting software) — and are implemented as paid, custom solutions based on specific business requirements.

Overview

In FirstBIT Software (ERP cloud environment), integration with external systems such as:

  • itrix24
  • Make (Integromat)
  • corporate websites
  • customer portals
  • external CRM systems
  • automation platforms
  • BI tools

is possible through API access to the 1C database.

API integration allows external systems to:

  • request master data
  • retrieve document data
  • receive balances
  • synchronize transactions
  • create new records
  • update existing records

Availability of API in FirstBIT Software

API access is available only in: FirstBIT ERP cloud hosting environment (classic hosting).

API integrations are not available in: 1C:Fresh cloud subsystem (for example FirstBIT Accounting cloud version).

API access is configured as a custom integration solution based on business requirements.

Each integration request is reviewed individually by the FirstBIT implementation team or hosting provider.

Supported API Technologies in FirstBIT Software

FirstBIT Software supports several integration mechanisms.

1. OData Interface

OData is the standard integration interface available in 1C-based systems.

OData allows external systems to:

  • read reference data
  • read documents
  • read registers
  • retrieve balances
  • synchronize structured data

Examples of accessible objects:

  • Companies (Customers / Suppliers)
  • Items (Products / Services)
  • Price lists
  • Warehousing data
  • Sales documents
  • Purchase documents
  • Payments
  • accounting registers

Important:

OData access is not enabled by default and requires database publication on web server.

Activation is performed by: hosting provider or FirstBIT implementation team.

2. Custom REST API (HTTP Services)

Standard universal REST API is not delivered out-of-the-box in FirstBIT Software.

Instead, custom REST-style API endpoints can be implemented using:

1C HTTP services

These endpoints allow:

  • structured JSON exchange
  • controlled access to business objects
  • secure integration with external systems
  • automation workflows

Typical use cases:

  • Bitrix24 synchronization
  • website catalog synchronization
  • order import/export automation
  • payment exchange automation
  • stock synchronization
  • customer portal integration

Custom API endpoints are created individually according to integration requirements.

Authentication Methods Supported by API

Authentication method depends on hosting configuration and security policy.Most common authentication methods include:

Login / Password (1C authentication)

Standard authentication method supported in most integrations.

Typically used together with: Basic Auth

Basic Authentication

Supported by default for:

OData
HTTP services

Credentials:

username
password

IP Restriction

Optional security method configured by hosting provider.

Allows access only from approved IP addresses.

VPN Access

May be required if customer infrastructure security policy requires private network access.

Configured by hosting provider.

Token-Based Authentication

Available when custom HTTP services are implemented.

Typically used for:

external CRM integrations
automation platforms
secure service-to-service integrations

Available Data Entities for API Integration

Availability of entities depends on integration scope.

Most commonly exposed objects include:

Reference Data

External systems can retrieve:

  • Customers
  • Suppliers
  • Companies
  • Items
  • Services
  • Warehouses
  • Price lists

Documents

External systems can retrieve or exchange:

  • Customer Orders
  • Sales Invoices
  • Purchase Orders
  • Supplier Invoices
  • Payments received
  • Payments issued

Registers and Balances

External integrations can request:

  • customer balances
  • supplier balances
  • stock balances
  • settlement balances
  • accounting balances (optional configuration)

Supported API Operations

Depending on configuration, API supports:


OperationAvailability
Read dataSupported
Create recordsSupported (custom configuration required)
Update recordsSupported (custom configuration required)
Delete recordsUsually restricted


Write access requires:

additional configuration
access rights setup

API Documentation Availability

Standard public API documentation is not provided because: each API integration is implemented as a custom technical solution.

However documentation can be prepared during integration project:

including:

  • endpoint structure
  • object structure
  • field descriptions
  • authentication method
  • request examples
  • response examples


After configuration, external systems can securely exchange data with FirstBIT Software through structured API endpoints.



If such integration is required, each request is reviewed individually by the FirstBIT team.To  To initiate an API integration request, please contact the Hotline support team or your Account Manager.

...