Skip to content

1C OData: import without the Bizos processing ​

If the Bizos processing (HTTP service /hs/bizos/) is not installed in your 1C database, Bizos can read data through the standard OData interface. It ships with 1C:Enterprise 8.3 and a 1C administrator enables it without programming.

Right now it is read-only: Bizos takes data from 1C and writes nothing back.

HTTP or OData — which one ​

HTTP /hs/bizos/OData
What 1C needsInstall the Bizos processingEnable the standard OData interface
CounterpartiesOnly as invoice buyersYes, the whole catalog
NomenclatureNoYes
Customer invoicesYesYes
Payments, cash desks, bank accountsYesNo (not yet)
Employees, transactionsYesNo
Writing to 1CTransactionsNo
  • HTTP — when the Bizos processing is installed or you can install it: full exchange including payments.
  • OData — when you cannot install a processing (cloud 1C, unmodified standard base): catalogs and invoices.
  • You can enable both. An invoice with the same number is not duplicated: Bizos finds the one already loaded and links it.

CommerceML and EnterpriseData are not supported.

What is imported ​

From 1C (OData)Where in Bizos
“Counterparties” catalog (Catalog_Контрагенты)Clients. On first import a client is matched by BIN/IIN, otherwise created. Groups are skipped.
“Nomenclature” catalog (Catalog_Номенклатура)Products. The article becomes the SKU if no other product uses it yet.
“Customer invoice” document (Document_СчетНаОплатуПокупателю)Invoices. The client comes from the invoice counterparty.

Rules:

  • The invoice amount is converted to minor units (tiyn / fils) without rounding. The currency comes from the 1C document; if empty — the organization base currency.
  • Invoice status: posted — “issued”, not posted — “draft”, marked for deletion — “cancelled”. “Paid” and “partially paid” are computed by Bizos from payments.
  • A deletion mark on a counterparty or product in 1C deletes nothing in Bizos. The product becomes inactive.
  • Re-importing creates no duplicates: each 1C record is linked to one Bizos record by its key (Ref_Key).

How to connect ​

  1. In 1C: Administration → Standard OData interface settings. Tick the “Counterparties”, “Nomenclature”, “Currencies” catalogs and the “Customer invoice” document. Create a user allowed to use OData.
  2. Publish the base on a web server (usually already done for the browser thin client).
  3. In Bizos open Settings → Integrations → 1C → OData tab (or “Connectors” → “1C” card → OData).
  4. Enter the publication URL (for example https://1c.example.kz/buh), the user and password. Click Check and connect: Bizos immediately checks that 1C answers.
  5. Click Import from 1C. The first part loads right away, the rest continues in the background. After that the import runs every 30 minutes on its own.

The tab shows the status, the last import time, how many records were created and updated, and the last error if any.

If a record changed in both systems ​

Choose when connecting:

  • Take the 1C version — changes from 1C overwrite Bizos.
  • Keep the Bizos version — the edit in Bizos stays.

If a record changed only in 1C, it is updated either way. An invoice amount from 1C cannot drop below what is already paid in Bizos — such a row goes to errors.

Access and security ​

  • Only an owner or admin can connect, disconnect and start an import. The “1C connector” module is required. Other roles see the status only.
  • The 1C login and password are stored encrypted and are never shown after saving.
  • The server address is checked: cloud metadata addresses are blocked. For 1C on the office network the Bizos server administrator can allow private addresses.
  • Connect, disconnect and every import are written to the audit log — counts only, no passwords, BINs or amounts.

Common errors ​

MessageWhat to do
Wrong login/password or no OData rightsCheck the 1C user and its rights.
Object is not publishedTick the catalog or document in the standard OData interface settings.
1C is unreachableCheck the publication URL and that the 1C server is reachable (or the private network is allowed).
Currency is not resolvableTick the “Currencies” catalog in the OData settings.

See also: 1C: invoices and payments (HTTP), Finance integrations, Invoices and payments, Roles and access.

AIDIR client documentation · docs.aidir.kz