DIA ERP Integration

Connect your DIA cloud ERP to Talos for stock, manufacturing, e-invoice, banking, accounting, and personnel operations.

Overview

DIA is a cloud-based ERP system with a REST/JSON API. It organizes functionality into 21+ modules (SCF, URE, MUH, EFA, BCS, PER, and more), each containing dozens of methods for specific operations.

Talos connects to your DIA instance via web services, providing AI-powered access to over 470 methods across all licensed modules.

What You Need

  • DIA server code (assigned by DIA, used in your URL pattern)
  • Username and password for web service access
  • API key from DIA admin panel
  • firma_kodu (company code) and donem_kodu (period code)
  • List of licensed DIA modules (SCF, URE, EFA, etc.)

Step 1 — Get Your Server Code

  1. Your DIA instance URL follows the pattern https://{server_code}.ws.dia.com.tr. The server code is assigned by DIA when your account is created.
  2. If you don't know your server code, check your DIA login URL or contact DIA support.
  3. Example: if your URL is https://acme.ws.dia.com.tr, your server code is "acme".

Tip: The server code is case-sensitive. Make sure to enter it exactly as shown in your DIA URL.

Step 2 — Get API Credentials

  1. Log in to the DIA admin panel and navigate to Web Service Settings.
  2. Generate or copy your API key from the settings page.
  3. The default web service user is often "ws" with password "ws". Your administrator may have changed these — check with them.

Step 3 — Company & Period

After login, Talos auto-detects your available companies and periods using the sis_yetkili_firma_donem_sube_depo method:

FieldDescription
firma_koduCompany code — identifies which company database to work with.
donem_koduPeriod code — the active fiscal period (year). Must match the current operating period in DIA.

Tip: If you have multiple companies in DIA, you can switch between them in Talos settings without re-entering credentials.

Step 4 — Configure in Talos

  1. Go to Settings > ERP in the Talos dashboard.
  2. Select "DIA" as your ERP type.
  3. Enter your server code, username, password, and API key. Talos will auto-detect firma_kodu and donem_kodu.
  4. Click "Test Connection" to verify. If successful, click "Save".

Available Modules

DIA organizes its API into modules. Talos integrates with the following key modules (availability depends on your DIA license):

CodeModuleDescription
SCFStock / Commercial / FinanceMaterials, inventory, accounts, invoices, orders, delivery notes. The core ERP module.
UREManufacturingProduction orders, BOMs, work orders, production tracking, quality control.
EFAE-Invoice (E-Fatura)Send and receive e-fatura and e-irsaliye through GIB. Check taxpayer registration.
BCSBankingBank accounts, transfers, reconciliation, check/bill management.
MUHAccountingGeneral ledger, journal entries, trial balance, financial reports.
PERPersonnelEmployee records, payroll, leave management, organizational structure.

DIA offers over 470 methods across all modules. Talos exposes the most commonly used ones through AI and provides raw access to the rest via the query tool.

E-Invoice (E-Fatura)

DIA handles e-invoice operations through the EFA module, with invoice creation in the SCF module:

  1. Create the invoice in the SCF module using standard invoice methods.
  2. Send the invoice as e-fatura via the EFA module. DIA handles GIB submission automatically.
  3. Accept or reject incoming e-invoices through the EFA module's inbox methods.
  4. Check taxpayer registration status to determine if a customer requires e-fatura or e-arsiv.

Security

  • Session-based authentication — DIA uses session tokens that expire on disconnect. Talos manages session lifecycle automatically.
  • Auto-logout on disconnect — If the connection drops, the session is invalidated. Talos reconnects and re-authenticates transparently.
  • Read-only by default — Talos connects in read-only mode unless you explicitly enable write operations in the ERP settings.

Troubleshooting

ProblemSolution
Invalid session / session expiredDIA sessions expire after inactivity. Talos auto-reconnects, but if issues persist, go to Settings > ERP and click "Test Connection" to force a new session.
Wrong firma_kodu / no data returnedVerify your firma_kodu matches the company you want to access. Use the auto-detect feature in Talos to list all available companies and periods.
Module not licensed / method not foundSome DIA modules (URE, EFA, PER) require separate licenses. Contact your DIA dealer to verify which modules are active on your subscription.

Useful Links