Uyumsoft Tablo Yapısı: girus SQL Raporlama Rehberi
Uyumsoft girus veritabanında cari, stok, fatura, sipariş, irsaliye ve cari bakiye hangi tabloda? Firma süzgeçli 7 örnek PostgreSQL sorgusuyla rehber.
ERP Asistanı
Editör ekibi
18 dk okuma
İçindekiler
Uyumsoft girus veritabanını ilk kez açan bir raporcu, alışık olduğu SQL Server yerine PostgreSQL ile ve binlerce tabloyla karşılaşır. Cari kart hangi tabloda, alış ve satış faturası neden aynı yerde, stok miktarı hangi kolonda, cari bakiye nasıl hesaplanır? Bu rehber Uyumsoft girus tablo adlarının mantığını, firma ve işyeri süzgecini ve raporlarda en çok kullanılan tabloları anlatır; sonunda doğrudan kullanabileceğiniz yedi örnek sorgu bulunur.
Bütün sorgular salt okunur SELECT sorgularıdır. Uyumsoft'a SQL ile kayıt yazılmaz; kayıt Uyumsoft'un kendi ekranlarından ya da API'nin kayıt uçlarından açılır.
Sorgular nerede denendi? Uyumsoft girus şemasından kurduğumuz, veri içermeyen bir doğrulama veritabanında derlendi. Değer anlamları (alış/satış ayrımı, borç/alacak yönü) bir pilot kurulumda ölçüldü. Kurulumunuzdaki hareket kodları, fiş türleri ve parametreler farklı olabilir; ilk çalıştırmada sonucu Uyumsoft ekranlarıyla karşılaştırın.
Uyumsoft girus veritabanı: PostgreSQL ve uyumsoft şeması
Uyumsoft girus veritabanı PostgreSQL'dir ve iş tabloları uyumsoft şemasındadır. Üç temel kural:
- Tablo adını şema önekiyle yazın:
uyumsoft.psmt_invoice_m. Önek yazılmazsa tablo bulunamayabilir. - Tablo ve kolon adları küçük harf ve tırnaksızdır:
doc_date."DOC_DATE"gibi tırnaklı büyük harf PostgreSQL'de başka bir ad sayılır ve sorgu derlenmez. - T-SQL söz dizimi çalışmaz. SQL Server alışkanlıklarının PostgreSQL karşılıkları:
| SQL Server | PostgreSQL (Uyumsoft) |
|---|---|
SELECT TOP 100 … |
… LIMIT 100 |
ISNULL(x, 0) |
COALESCE(x, 0) |
GETDATE() |
CURRENT_DATE ya da now() |
DATEADD(DAY, -30, x) |
x - INTERVAL '30 days' |
N'metin', [kolon], dbo. |
'metin', tırnaksız ad, uyumsoft. |
LIKE (harf duyarsız sanılır) |
ILIKE |
Bayrak kolonları boolean değil, tamsayıdır: ispassive = 0 yazılır, ispassive = false yazılmaz. Tarih kolonları saat taşıyabilir; gün aralığını doc_date >= '2026-01-01' AND doc_date < '2026-02-01' biçiminde kurun.
Tablo adları nasıl okunur?
Uyumsoft girus tablo adı modül, tür ve rol bilgisini taşır:
- İlk üç harf modüldür:
gnlgenel tanımlar,finfinans ve muhasebe,invstok,psmsatış ve satınalma. - Dördüncü harf türü gösterir:
dtanım (kart) tablosu,thareket tablosu.invd_itemstok kartı,invt_item_mstok hareketidir. _mve_dekleri başlık ve satırdır:psmt_invoice_mfatura başlığı,psmt_invoice_dfatura satırı.
Veritabanında yabancı anahtar kısıtı yoktur. İlişki ad kuralından çıkar: bir tablodaki X_id kolonu, birincil anahtarı X_id olan tabloya bağlanır. psmt_invoice_m.entity_id cari kartına (find_entity.entity_id), psmt_invoice_d.invoice_m_id fatura başlığına (psmt_invoice_m.invoice_m_id) gider. Numaralı kolonlar numarasız adın tablosuna bağlanır: transferdeki karşı depo whouse2_id, invd_whouse.whouse_id kolonunu gösterir.
Firma ve işyeri süzgeci: co_id ve branch_id
Bir Uyumsoft veritabanında birden çok firma (gnld_company, anahtar co_id) ve her firmanın işyerleri (gnld_branch, anahtar branch_id) aynı tablolarda tutulur. Belge ve hareket tablolarında co_id, çoğunda branch_id kolonu vardır. Süzgeç unutulursa sorgu hata vermez, sonuç yanlış çıkar: toplam bütün firmaların hareketini toplar.
Firma ve işyeri kimlikleri kuruluma özeldir. Önce listeyi alın, sorgularda :co_id ve :branch_id yerine kendi değerlerinizi yazın:
-- Firma ve işyeri listesi (pasif kolonunun adı iki tabloda farklıdır)
SELECT c.co_id, c.co_code, c.co_desc,
b.branch_id, b.branch_code, b.branch_desc,
COALESCE(c.is_passive, 0) AS firma_pasif,
COALESCE(b.ispassive, 0) AS isyeri_pasif
FROM uyumsoft.gnld_company c
LEFT JOIN uyumsoft.gnld_branch b ON b.co_id = c.co_id
ORDER BY c.co_code, b.branch_code;
Bu raporu SQL yazmadan, Türkçe sorarak alın: Uyumsoft raporlama
İşyeri seçilmezse firmanın bütün işyerleri birlikte raporlanır; işyeri bazında rapor için AND m.branch_id = :branch_id ekleyin.
Ana kartların bir kısmı firmalar arasında ortaktır ve co_id taşımaz. Firmaya özel ayar ayrı tablodadır:
Genel kart (co_id yok) |
Firmaya özel tablo (co_id var) |
|---|---|
find_entity (cari) |
find_co_entity |
invd_item (stok) |
invd_branch_item (co_id + branch_id) |
invd_whouse (depo) |
invd_branch_whouse (co_id + branch_id) |
Genel karta co_id yazarsanız sorgu derlenmez. Bir firmanın carilerini ya da stoklarını istiyorsanız firmaya özel tabloyla birleştirin.
En çok kullanılan Uyumsoft girus tabloları
| Tablo | Ne tutar | Öne çıkan kolonlar |
|---|---|---|
find_entity / find_co_entity |
Cari kart (genel) / firma cari kartı | entity_id, entity_code, entity_name, tax_no, ispassive |
invd_item / invd_branch_item |
Stok kartı (genel) / işyeri stok kartı | item_id, item_code, item_name, unit_id, ispassive |
invd_whouse / invd_bwh_item |
Depo / işyeri-depo stok kaydı | whouse_id, whouse_code, description, qty_prm |
psmt_invoice_m / psmt_invoice_d |
Fatura başlık / satır (alış ve satış) | invoice_m_id, doc_no, doc_date, entity_id, purchase_sales, amt_receipt |
psmt_order_m / psmt_order_d |
Sipariş başlık / satır (alış ve satış) | order_m_id, order_status, qty, qty_shipping, delivery_date |
invt_item_m / invt_item_d |
Stok hareketi: irsaliye ve ambar fişi | item_m_id, doc_tra_id, whouse_id, qty_prm, plus_minus |
fint_fin_m / fint_fin_d |
Finans fişi: tahsilat, tediye, cari hareket | fin_m_id, receipt_type_id, card_type, amt, plus_minus |
gnld_doc_tra |
Hareket kodu (belge türü) | doc_tra_code, description, purchase_sales, inventory_status |
Alış mı satış mı: purchase_sales
Alış ve satış belgeleri aynı tablolardadır: fatura psmt_invoice_m, sipariş psmt_order_m, stok hareketi invt_item_m. Ayrım purchase_sales kolonundadır:
purchase_sales |
Anlam |
|---|---|
| 1 | Alış |
| 2 | Satış |
| 3 | Satış iadesi |
| 4 | Alış iadesi |
| 0 | Stok transferi, sayım ve iç hareket |
Satışı hareket kodunun açıklamasıyla (description ILIKE '%satış%') süzmeyin: "Satış İade Faturası" gibi açıklamalar iadeleri de toplama katar. Belirli bir belge türü gerekiyorsa kodu gnld_doc_tra listesinden seçin ve purchase_sales ile birlikte okuyun.
Faturanın iptal işareti psmt_invoice_m.is_cancel_invoice kolonundadır; 0 normal faturadır. Aşağıdaki satış sorguları COALESCE(m.is_cancel_invoice, 0) = 0 ile sıfır dışındaki bütün değerleri dışarıda bırakır. Kurulumunuzda hangi değerlerin geçtiğini GROUP BY is_cancel_invoice ile bir kez görmenizi öneririz.
1. Firmanın aktif carileri
Cari kartın adı ve kodu genel kartta (find_entity), firmaya bağlılığı ve pasiflik ayarı firma cari kartındadır (find_co_entity).
SELECT e.entity_code, e.entity_name, e.tax_no,
v.description AS vergi_dairesi
FROM uyumsoft.find_co_entity ce
JOIN uyumsoft.find_entity e ON e.entity_id = ce.entity_id
LEFT JOIN uyumsoft.find_tax_office v ON v.tax_office_id = e.tax_office_id
WHERE ce.co_id = :co_id
AND COALESCE(ce.ispassive, 0) = 0
AND COALESCE(e.ispassive, 0) = 0
ORDER BY e.entity_code
LIMIT 200;
entity_type kolonu cari tipini (müşteri, tedarikçi) taşır, ancak tamsayı değerlerin karşılığı kuruluma göre doğrulanmalıdır. Müşteri ile tedarikçiyi ayırmak için önce değer dağılımına bakın.
2. Depo bazında stok miktarı
Stok yönü hareket satırındadır: invt_item_d.plus_minus girişte +1, çıkışta -1 değerini alır. Miktarı ana birimle (qty_prm) toplamak, farklı birimli satırların karışmasını önler.
SELECT w.whouse_code, w.description AS depo,
i.item_code, i.item_name, u.unit_code,
SUM(d.qty_prm * d.plus_minus) AS miktar
FROM uyumsoft.invt_item_d d
JOIN uyumsoft.invt_item_m m ON m.item_m_id = d.item_m_id
JOIN uyumsoft.invd_item i ON i.item_id = d.item_id
LEFT JOIN uyumsoft.invd_unit u ON u.unit_id = i.unit_id
LEFT JOIN uyumsoft.invd_whouse w ON w.whouse_id = d.whouse_id
WHERE m.co_id = :co_id
AND d.plus_minus IN (1, -1)
GROUP BY w.whouse_code, w.description, i.item_code, i.item_name, u.unit_code
HAVING SUM(d.qty_prm * d.plus_minus) <> 0
ORDER BY w.whouse_code, i.item_code;
Uyumsoft işyeri-depo-stok kaydını ayrıca invd_bwh_item tablosunda tutar (co_id, branch_id, whouse_id, item_id, qty_prm). İki yoldan aynı miktara ulaşmanız beklenir; raporu devreye almadan önce birkaç stokta karşılaştırın.
3. Cari bazında net satış (satış eksi satış iadesi)
Net satış, satış faturalarından (purchase_sales = 2) satış iadesi faturalarının (purchase_sales = 3) çıkarılmasıyla bulunur. Başlıkta amt yerel para mal tutarı, amt_disc_total iskonto toplamı, amt_vat KDV, amt_receipt genel toplamdır; amt - amt_disc_total KDV hariç, iskonto sonrası tutarı verir.
SELECT e.entity_code, e.entity_name,
SUM(CASE WHEN m.purchase_sales = 2 THEN m.amt - COALESCE(m.amt_disc_total, 0) ELSE 0 END) AS satis,
SUM(CASE WHEN m.purchase_sales = 3 THEN m.amt - COALESCE(m.amt_disc_total, 0) ELSE 0 END) AS iade,
SUM(CASE WHEN m.purchase_sales = 2 THEN m.amt - COALESCE(m.amt_disc_total, 0)
ELSE -(m.amt - COALESCE(m.amt_disc_total, 0)) END) AS net_satis
FROM uyumsoft.psmt_invoice_m m
JOIN uyumsoft.find_entity e ON e.entity_id = m.entity_id
WHERE m.co_id = :co_id
AND m.purchase_sales IN (2, 3)
AND COALESCE(m.is_cancel_invoice, 0) = 0
AND m.doc_date >= date_trunc('year', CURRENT_DATE)
GROUP BY e.entity_code, e.entity_name
ORDER BY net_satis DESC
LIMIT 20;
Alış raporu için aynı sorguda 2 yerine 1 (alış), 3 yerine 4 (alış iadesi) yazmanız yeterlidir. Eksiz kolonlar firmanın yerel para birimindedir; _tra ekli kolonlar (amt_receipt_tra gibi) belgenin kendi döviz cinsindendir ve firmalar ya da dövizler arasında toplanmaz.
4. Fatura satırları: stok ve hizmet
Fatura satırı bir stok kartını ya da bir hizmet kartını gösterebilir. Satırın türü line_type kolonundadır: 1 stok satırı (item_id → invd_item), 3 hizmet satırı (expense_id → invd_expense). dcard_id kolonu iki türü birden taşıdığı için onu tek bir tabloya bağlamayın.
SELECT m.doc_no, m.doc_date, d.line_no, d.line_type,
COALESCE(i.item_code, x.expense_code) AS kart_kodu,
COALESCE(i.item_name, x.description) AS kart_adi,
d.qty, u.unit_code, d.unit_price,
d.amt_with_disc AS iskontolu_tutar, d.vat_rate, d.amt_vat
FROM uyumsoft.psmt_invoice_d d
JOIN uyumsoft.psmt_invoice_m m ON m.invoice_m_id = d.invoice_m_id
LEFT JOIN uyumsoft.invd_item i ON i.item_id = d.item_id AND d.line_type = 1
LEFT JOIN uyumsoft.invd_expense x ON x.expense_id = d.expense_id AND d.line_type = 3
LEFT JOIN uyumsoft.invd_unit u ON u.unit_id = d.unit_id
WHERE m.co_id = :co_id
AND m.purchase_sales = 2
AND COALESCE(m.is_cancel_invoice, 0) = 0
AND m.doc_date >= date_trunc('month', CURRENT_DATE)
ORDER BY m.doc_date DESC, m.doc_no, d.line_no
LIMIT 200;
Hizmet satırında item_id boş değil 0 olabilir; satır türünü item_id IS NOT NULL ile değil, line_type ile ayırın.
5. Açık sipariş satırları ve kalan miktar
Sipariş satırında sipariş miktarı qty, sevk edilen miktar qty_shipping, satır durumu order_status kolonundadır. Pilot kurulumda order_status = 1 açık, 2 kapalı satır olarak görüldü; kendi verinizde dağılımı bir kez kontrol edin.
SELECT o.doc_no, o.doc_date, e.entity_code, e.entity_name,
i.item_code, i.item_name,
d.qty, COALESCE(d.qty_shipping, 0) AS sevk_edilen,
d.qty - COALESCE(d.qty_shipping, 0) AS kalan,
CASE WHEN d.delivery_date >= DATE '1901-01-01' THEN d.delivery_date END AS teslim_tarihi
FROM uyumsoft.psmt_order_d d
JOIN uyumsoft.psmt_order_m o ON o.order_m_id = d.order_m_id
JOIN uyumsoft.find_entity e ON e.entity_id = o.entity_id
LEFT JOIN uyumsoft.invd_item i ON i.item_id = d.item_id
WHERE o.co_id = :co_id
AND o.purchase_sales = 2
AND d.order_status = 1
ORDER BY teslim_tarihi NULLS LAST, o.doc_no;
Boş tarih Uyumsoft'ta 0001-01-01 olarak saklanabilir; sorgu bu yüzden 1901 öncesi teslim tarihini boş gösterir. Siparişin hangi faturaya dönüştüğünü görmek için fatura satırındaki psmt_invoice_d.source_order_m_id (sipariş başlığı) ve source_order_d_id (sipariş satırı) kolonlarını kullanın.
6. Satış irsaliyeleri
İrsaliyeler ve ambar fişleri aynı tablo çiftindedir: başlık invt_item_m, satır invt_item_d. Belgenin türü hareket kodundan (gnld_doc_tra), alış/satış yönü yine purchase_sales kolonundan okunur.
SELECT m.doc_no, m.doc_date,
t.doc_tra_code, t.description AS hareket_kodu,
e.entity_code, e.entity_name,
w.whouse_code, i.item_code, i.item_name,
d.qty_prm AS miktar, m.invoice_status
FROM uyumsoft.invt_item_d d
JOIN uyumsoft.invt_item_m m ON m.item_m_id = d.item_m_id
LEFT JOIN uyumsoft.gnld_doc_tra t ON t.doc_tra_id = m.doc_tra_id
LEFT JOIN uyumsoft.find_entity e ON e.entity_id = m.entity_id
LEFT JOIN uyumsoft.invd_whouse w ON w.whouse_id = d.whouse_id
LEFT JOIN uyumsoft.invd_item i ON i.item_id = d.item_id
WHERE m.co_id = :co_id
AND m.purchase_sales = 2
AND m.doc_date >= CURRENT_DATE - INTERVAL '30 days'
ORDER BY m.doc_date DESC, m.doc_no
LIMIT 200;
invoice_status kolonu irsaliyenin fatura durumunu (irsaliye, kısmi fatura, fatura) taşır; tamsayı değerlerin karşılığını kendi kurulumunuzda doğrulamadan "faturalanmamış irsaliye" süzgeci kurmayın. Transfer hareketlerinde karşı depo whouse2_id kolonundadır.
7. Cari bakiye ve yürüyen bakiyeli ekstre
Cari kartında hazır bir bakiye kolonu yoktur. Cari hareketleri finans fişi satırlarındadır (fint_fin_d): fatura, tahsilat ve tediye cari tarafını buraya yazar. Cari satırı card_type = 2 ile seçilir (3 banka, 4 kasa satırıdır); yön plus_minus kolonundadır: +1 cariyi borçlandırır, -1 alacaklandırır. Tutar amt, yerel paradır.
-- Pozitif bakiye: cari borçlu
SELECT e.entity_code, e.entity_name,
SUM(CASE WHEN d.plus_minus = 1 THEN COALESCE(d.amt, 0) ELSE 0 END) AS borc,
SUM(CASE WHEN d.plus_minus = -1 THEN COALESCE(d.amt, 0) ELSE 0 END) AS alacak,
SUM(COALESCE(d.amt, 0) * d.plus_minus) AS bakiye
FROM uyumsoft.fint_fin_d d
JOIN uyumsoft.fint_fin_m m ON m.fin_m_id = d.fin_m_id AND m.co_id = d.co_id
JOIN uyumsoft.find_entity e ON e.entity_id = d.entity_id
WHERE m.co_id = :co_id
AND d.card_type = 2
AND d.plus_minus IN (1, -1)
GROUP BY e.entity_code, e.entity_name
HAVING SUM(COALESCE(d.amt, 0) * d.plus_minus) <> 0
ORDER BY bakiye DESC
LIMIT 100;
Banka fişinde her cari satırına ters yönlü bir banka satırı eşlik eder. Yalnız card_type = 2 satırlarını toplamak, karşı bacağın çift sayılmasını önler.
Mutabakat görüşmesi için tek carinin hareketleri ve her satırdan sonra oluşan bakiye:
SELECT m.doc_date AS tarih,
COALESCE(NULLIF(m.doc_no, ''), m.receipt_no) AS belge_no,
CASE WHEN m.receipt_type_id = 0 THEN 'Fatura / muhasebe kaydı' ELSE r.description END AS fis_turu,
COALESCE(d.note1, m.note1) AS aciklama,
CASE WHEN d.plus_minus = 1 THEN COALESCE(d.amt, 0) ELSE 0 END AS borc,
CASE WHEN d.plus_minus = -1 THEN COALESCE(d.amt, 0) ELSE 0 END AS alacak,
SUM(COALESCE(d.amt, 0) * d.plus_minus)
OVER (ORDER BY m.doc_date, d.fin_d_id ROWS UNBOUNDED PRECEDING) AS yuruyen_bakiye
FROM uyumsoft.fint_fin_d d
JOIN uyumsoft.fint_fin_m m ON m.fin_m_id = d.fin_m_id AND m.co_id = d.co_id
JOIN uyumsoft.find_entity e ON e.entity_id = d.entity_id
LEFT JOIN uyumsoft.find_receipt_type r ON r.receipt_type_id = m.receipt_type_id
WHERE m.co_id = :co_id
AND d.card_type = 2
AND d.plus_minus IN (1, -1)
AND e.entity_code = :cari_kod
ORDER BY m.doc_date, d.fin_d_id;
receipt_type_id = 0 olan fişler faturanın ve muhasebenin oluşturduğu finans kayıtlarıdır; tahsilat ve tediye fişlerinin türü find_receipt_type tablosundadır ve kodları kuruluma özeldir. Sonucu ilk kullanımda Uyumsoft'taki cari ekstreyle karşılaştırın.
Sık yapılan hatalar
- Firma süzgecini unutmak.
co_idsüzgeci olmayan sorgu bütün firmaların hareketini toplar; hata vermediği için fark edilmez. - Genel karta
co_idyazmak.find_entity,invd_itemveinvd_whousefirmasızdır; firmanın kartları firmaya özel tablodan gelir. - Satışı açıklamayla süzmek. Hareket kodu açıklaması iadeleri de kapsayabilir; satış
purchase_sales = 2ile süzülür. - T-SQL yazmak.
TOP,ISNULL,GETDATE()veN'...'PostgreSQL'de çalışmaz. - Pasif kolon adını tahmin etmek.
gnld_companytablosundais_passive,find_entityveinvd_itemtablolarındaispassiveyazılır; yanlış ad sorguyu durdurur. - Hareket raporunu pasif karta göre süzmek. Pasif cari ya da stok geçmiş belgelerde durur; süzgeç yalnız kart listesinde uygulanır.
Sık sorulanlar
Uyumsoft girus hangi veritabanını kullanır? Uyumsoft girus veritabanı PostgreSQL'dir. İş tabloları uyumsoft şemasındadır, tablo ve kolon adları küçük harfle ve tırnaksız yazılır. Sorgularda TOP yerine LIMIT, ISNULL yerine COALESCE kullanılır.
Uyumsoft'ta fatura hangi tabloda? Fatura başlığı psmt_invoice_m, fatura satırları psmt_invoice_d tablosundadır ve invoice_m_id kolonuyla bağlanır. Alış ve satış faturası aynı tablodadır; purchase_sales kolonu 1 alış, 2 satış, 3 satış iadesi, 4 alış iadesi değerini taşır.
Uyumsoft'ta cari kart hangi tabloda? Genel cari kartı find_entity tablosundadır (entity_code, entity_name, tax_no) ve firma bilgisi taşımaz. Carinin firmaya bağlılığı ve firmaya özel ayarları find_co_entity tablosunda, entity_id ve co_id ile tutulur.
Uyumsoft'ta cari bakiye nasıl hesaplanır? Cari kartında bakiye kolonu yoktur. Bakiye, finans fişi satırlarından (fint_fin_d) card_type = 2 olan cari satırlarının amt × plus_minus toplamıyla bulunur; +1 borç, -1 alacaktır. Sorgu mutlaka firma süzgeci (co_id) taşımalıdır.
İrsaliye hangi tabloda tutulur? İrsaliye ve ambar fişleri invt_item_m (başlık) ve invt_item_d (satır) tablolarındadır. Belgenin türü doc_tra_id ile bağlanan hareket kodundan (gnld_doc_tra), stok yönü satırdaki plus_minus kolonundan okunur.
Uyumsoft'a SQL ile kayıt yazılabilir mi? Rapor sorguları yalnız okur; Uyumsoft'a SQL ile kayıt yazılmaz. ERP Asistanı da veritabanına SQL ile yazmaz: Uyumsoft'a yazma, varsayılan olarak kapalıdır ve açıldığında yalnız Uyumsoft API'nin resmî kayıt uçlarıyla, sizin onayınızla yapılır.
Bu tabloları her raporda yeniden kurmak yerine ERP Asistanı'na "bu yıl en çok satış yapılan 10 müşteriyi getir" yazabilirsiniz. ERP Asistanı Uyumsoft girus'a Uyumsoft API üzerinden bağlanır; sunucunuza Köprü kurmanız gerekmez, Uyumsoft API'nin internetten HTTPS ile erişilebilir olması gerekir. Seçtiğiniz firma için PostgreSQL'e uygun salt okunur SQL'i üretir ve firma süzgecini sorgu çalışmadan denetler. Ayrıntılar için Uyumsoft raporlama sayfasına göz atın.
Bu raporu SQL yazmadan, Türkçe sorarak alın
Türkçe sorunuzu yazın, şemanıza uygun çalışan SQL'i ya da hazır uygulamanızı saniyeler içinde alın.







