In FirstBIT software, it is possible to configure an API that allows external systems to request the required data — for example, customer balances, order information, documents, or items.

When an API request is sent, the system automatically returns up-to-date data from the database in a convenient format (typically JSON). This enables integration with websites, CRM systems, customer portals, and other external services.

Please note that 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.

Overview

API integration allows external systems to:

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

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

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.

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
• Payments received
• Payments issued

Registers and Balances

External integrations can request:

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

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 initiate an API integration request, please contact the Hotline support team or your Account Manager.

Thank you for being FirstBIT customer!