Müşavir

goc

8 uç · /api/musavir/v1/goc

İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 8 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.

GET/api/musavir/v1/goc

Bakiye + defter.

Oturum
İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/goc" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/goc/{id}

GET /karsit/{id}/zincir/rapor?format=json|txt|pdf — KDVİRA tarzı zincir raporu.

OturumYol parametresi: id
İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/goc/<id>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/goc/belge

Belge goc

Oturum
İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/goc/belge" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/goc/cari

Cari goc

Oturum
İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/goc/cari" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/goc/cari-kart

Cari **kartı** göçü — açılış bakiyesi YAZMAZ (/goc/carinin tersi).

Oturum

## 🔴 İki uç neden ayrı (ve MÜF24 sınırı) /goc/cari bir DEVİR işlemidir: kartı açar ve tur='acilis' hareketini dönem başı tarihiyle yazar. Bu uç ise yalnız KARTI açar — çünkü bakiyesi başka bir yoldan gelecektir (yevmiye göçü ya da MÜF24'ün sürekli senkronu). İkisini tek uçta birleştirip "bakiye sütunu varsa yaz" demek, kaynak dosyada bakiye sütunu bulunan her sürekli-sync göçüne **ikinci kez** açılış bakiyesi yazdırırdı — yani bakiyeyi İKİYE KATLARDI. Karar kullanıcının UCU SEÇMESİYLE verilir, dosyanın şekliyle değil. ⚠ **MÜF24 sınırı:** bu uç TEK SEFERLİKtir. Sürekli senkron (aynı kaynaktan periyodik çekim) MÜF24'ün konusudur ve devir noktası goc_eslemeleri üzerinden kurulur (BLE22-7106): buradaki eşleme satırları, sürekli-sync'in "bu kaydı zaten biliyorum" cevabıdır. Eşlemeyi atlayan bir sürekli-sync, göç edilmiş her cariyi yeniden açardı.

İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/goc/cari-kart" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
GET/api/musavir/v1/goc/kaynaklar

Tanınan göç kaynaklarının kataloğu — sihirbazın kaynak seçicisi bunu okur.

Oturum

🔴 Liste SUNUCUDAN gelir. Panelde ikinci bir dizi tutulsaydı yeni bir kaynak eklendiğinde backend kabul eder, ekran göstermezdi — ve hata yalnız o kaynaktan göç etmeye çalışan müşterinin ekranında görünürdü (çekirdek panelin 2026-08-27 vakası).

İstek
curl -X GET "https://{slug}.musavir.blesyum.app/api/musavir/v1/goc/kaynaklar" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/goc/mukellef

🔴 Bu göç, HENÜZ VAR OLMAYAN mükellefleri açar — bu yüzden mukellef_ref NULL'dır ve

Oturum

raporu yalnız büro-geneli görünürlüğe verilir (rapor'un fail-closed kararı). İzin musavir.mukellef.manage: yeni mükellef açmak, listeleme izninden farklı bir yetkidir.

İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/goc/mukellef" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
POST/api/musavir/v1/goc/yevmiye

🔴 Yevmiye göçünün İKİ ayırt edici kararı:

Oturum

1. **Satırlar FİŞE gruplanır, satır satır yazılmaz.** Muhasebede kayıt birimi satır değil FİŞTİR; satır satır yazan bir göç, yarım fiş üretir ve mizanı bozar. 2. **Dengesiz fiş KARANTİNAYA alınır** ([yevmiye_dengeli_mi]): fişin TÜM satırları hata olur ve HİÇBİRİ yazılmaz. "Sonra düzeltiriz" diye yazılan dengesiz bir fiş, üzerine kurulan her raporu ve her beyannameyi bozar.

İstek
curl -X POST "https://{slug}.musavir.blesyum.app/api/musavir/v1/goc/yevmiye" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"
Yanıt
{
  "data": "…",
  "trace_id": "01JC…"
}
Bu sayfa işine yaradı mı?
Hâlâ takıldın mı? Destek al