Şube Kartı (Mersis No)

Şube bilgisi iki aşamalı çalışır:

1. Şirket detayı (/v1/search/vkn/detail) ile data.Subeler listesini alın
2. İstediğiniz şubenin MersisNo'su ile bu endpoint'i çağırın → şubenin tam kartı döner

POST /v1/search/mersis

Maliyet: Bakiye panelinizden görüntüleyebilirsiniz

İstek

{ "mersis_no": "0900050039400002" }

Yanıt

{
  "success": true,
  "dusulen_bakiye": 2,
  "response_time_ms": 245,
  "data": {
    "Sube": {
      "Unvani": "UYUMSOFT - İSTANBUL ŞUBESİ",
      "FirmaNeviGrup": "ANONİM ŞİRKET",
      "TSM": "İSTANBUL TİCARET SİCİLİ MÜDÜRLÜĞÜ",
      "SicilNo": "123456",
      "VergiNo": "9000500394",
      "VergiDairesi": "...",
      "TescilTarihi": "20.05.2010",
      "IseBaslamaTarihi": "20.05.2010",
      "KapanisTarihi": "",
      "Durumu": "Aktif",
      "SubeMerkeziMersisNo": "0900050039462851",
      "Adres": "Levent Mah. Beşiktaş/İSTANBUL"
    },
    "AktifTemsilciler": [
      {
        "Adi": "AHMET",
        "Soyadi": "******",
        "Gorevi": "ŞUBE MÜDÜRÜ",
        "TemsilTuru": "MÜNFERİT",
        "BaslangicTarihi": "20.05.2010"
      }
    ]
  }
}

Şube bilgisi data.Sube altında gelir. Merkez şirkete ait Mersis No için data.Sube.SubeMerkeziMersisNo kullanılabilir.

Erişim Örneği

const result = await searchByMersis('0900050039400002')
const sube = result.data.Sube

console.log(sube.Unvani)              // "UYUMSOFT - İSTANBUL ŞUBESİ"
console.log(sube.Durumu)              // "Aktif"
console.log(sube.SubeMerkeziMersisNo) // Merkez şirketin Mersis No

---

Şube Araması Akışı

1. VKN ile detaylı sorgu
   POST /v1/search/vkn/detail → { "vkn": "9000500394" }
   
2. Yanıttaki Subeler listesine bak
   result.data.Subeler[0].MersisNo → "0900050039400002"
   
3. Şube kartını al
   POST /v1/search/mersis → { "mersis_no": "0900050039400002" }

Kod Örneği (JavaScript)

const BASE = 'https://api.bilvio.com'
const headers = {
  'Authorization': 'Bearer bil_...',
  'Content-Type': 'application/json',
}

// Adım 1: Şirket detayı al
const company = await fetch(`${BASE}/v1/search/vkn/detail`, {
  method: 'POST',
  headers,
  body: JSON.stringify({ vkn: '9000500394' }),
}).then(r => r.json())

// Adım 2: Şubeleri listele
const branches = company.data.Subeler
console.log(`${branches.length} şube bulundu`)

// Adım 3: İlk şubenin tam kartını al
if (branches.length > 0) {
  const branch = await fetch(`${BASE}/v1/search/mersis`, {
    method: 'POST',
    headers,
    body: JSON.stringify({ mersis_no: branches[0].MersisNo }),
  }).then(r => r.json())

  console.log(branch.data.Sube.Unvani)
  console.log(branch.data.Sube.Durumu)
}

---

Önemli Not

Bu endpoint yalnızca bilinen bir Mersis numarası ile çalışır. Doğrudan şube adıyla arama desteklenmez — önce ana şirketi sorgulamanız gerekir.