Gelen İrsaliye
Gelen İrsaliye Entegratör API
Gelen irsaliye listeleme, detay, çıktı, ERP işleme ve irsaliye yanıtı endpointleri.
Gelen Belge Endpointleri
Entegratör yüzeyi /api/VbtApi altındadır. Aşağıdaki tablo JSON sözleşmesini gösterir; ByXml varyantları aynı işlevin XML biçimidir.
| Amaç | Method ve endpoint | Request | Ana çıktı |
|---|---|---|---|
| Listeleme | POST /api/VbtApi/GetIncomingDespatchAdviceList | SearchRequestModel<IncomingDespatchAdviceGetRequestModel> | Sayfalı gelen irsaliye listesi |
| Detay | GET /api/VbtApi/GetIncomingDespatchAdvice?id={id} | Query: id | Gelen irsaliye modeli |
| Görsel | POST /api/VbtApi/GetIncomingDespatchAdviceView | Ettn, IsRead | HTML/görsel çıktı |
POST /api/VbtApi/GetIncomingDespatchAdvicePdf | DespatchAdviceEttns[] | PDF içerikleri | |
| UBL XML | POST /api/VbtApi/GetIncomingDespatchAdviceXmlList | DespatchAdviceEttns[] | UBL XML içerikleri |
| İndirme bağlantısı | POST /api/VbtApi/GetIncomingDespatchAdviceDownloadUrl | Belge seçim modeli | İndirme URL'si |
| ERP işleme | POST /api/VbtApi/UpdateIncomingDespatchAdviceErpProcessStatus | Ettn, ErpProcessBranch, IsErpProcessed | Güncelleme sonucu |
İrsaliye Yanıtı Endpointleri
| Amaç | Endpoint | Request / çıktı |
|---|---|---|
| JSON ile yanıt oluşturma | POST /api/VbtApi/AddOutgoingReceiptAdvice | ReceiptAdviceRequestModel; ETTN, yanıt numarası ve hata listesi |
| Hazır UBL ile yanıt oluşturma | POST /api/VbtApi/AddOutgoingReceiptAdviceByUbl | ReceiptAdviceUblRequestModel |
| Yanıt görseli | POST GetOutgoingReceiptAdviceView | ReceiptAdviceViewRequestModel |
| Yanıt PDF'si | POST GetOutgoingReceiptAdvicePdf | ReceiptAdvicePdfRequestModel |
| Yanıt UBL'si | POST GetOutgoingReceiptAdviceXml | ReceiptAdviceXmlRequestModel |
| İndirme bağlantısı | POST GetOutgoingReceiptAdviceDownloadUrl | Yanıt seçimi |
Gelen Liste Filtreleri
Query içinde düzenleme ve zarf tarihi aralıkları, zarf kimliği, ETTN, belge numarası, taraf adı, VKN/TCKN, kullanıcı durumu ve IsErpProcessed bulunur. Dış sarmalda Skip ve en fazla 100 olacak şekilde Take kullanılır.
Yanıt Üretme Kuralı
DespatchDocumentReference.Id yanıt verilecek gelen irsaliyeyi seçer. Platform profil ve belge tipini TEMELIRSALIYE/SEVK olarak uygular, eksik gönderici/alıcı tarafını mevcut irsaliye ve firma verisinden tamamlayabilir. Entegratör teslim miktarlarını, satır referanslarını ve red gerekçelerini gerçek iş sonucundan üretmelidir.
Kritik İşlem Sözleşmeleri
| İşlem | Önkoşul | Başarılı sonuç | Sonraki kontrol |
|---|---|---|---|
GetIncomingDespatchAdviceList | Tarih/durum filtresi ve en fazla 100 kayıtlık sayfalama hazırlanır. | ETTN bazlı gelen belge listesi döner. | Sayfaları kayıpsız ilerletin; ETTN'yi tekilleştirin. |
UpdateIncomingDespatchAdviceErpProcessStatus | ETTN mevcut olmalı; yerel ERP işlemi kalıcı biçimde tamamlanmış olmalıdır. | IsErpProcessed ve işlem dalı güncellenir. | Bu sonuç kabul/red değildir; yanıt durumunu ayrıca yönetin. |
AddOutgoingReceiptAdvice | Gelen belge yanıt bekleyen veya aynı kararın yeniden denenebilir hata durumunda olmalı; fiili sevkten başlayan yedi günlük süre dolmamış olmalıdır. | Yanıt ETTN'si, belge numarası ve hata listesi döner. | Yeni yanıt üretmeden mevcut kararın durum ve çıktısını izleyin. |
| Görsel/PDF/UBL çıktıları | Belge veya yanıt ETTN'si doğru yöndeki endpointte gönderilir. | İstenen sunum ya da resmi UBL içeriği döner. | ERP ve arşiv eşleşmesini ETTN + belge numarasıyla kurun. |
Yedi günlük süre: Tam teslimde yanıt zorunlu değildir ve süre sonunda tam kabul varsayımı oluşur. Eksik teslim veya red varsa irsaliye yanıtını süre dolmadan gönderin; süresi geçen yeni yanıt kabul edilmez.
Tam Endpoint Envanteri
| İşlem ailesi | JSON / UBL endpointleri | XML varyantları |
|---|---|---|
| Gelen liste | GetIncomingDespatchAdviceList | GetIncomingDespatchAdviceListByXml |
| Gelen detay | GetIncomingDespatchAdvice | GetIncomingDespatchAdviceByXml |
| Gelen görsel | GetIncomingDespatchAdviceView | GetIncomingDespatchAdviceViewByXml |
| Gelen PDF | GetIncomingDespatchAdvicePdf | GetIncomingDespatchAdvicePdfByXml |
| Gelen UBL | GetIncomingDespatchAdviceXmlList | GetIncomingDespatchAdviceXmlListByXml |
| İndirme | GetIncomingDespatchAdviceDownloadUrl | — |
| ERP işleme | UpdateIncomingDespatchAdviceErpProcessStatus | UpdateIncomingDespatchAdviceErpProcessStatusByXml |
| Yanıt oluşturma | AddOutgoingReceiptAdvice, AddOutgoingReceiptAdviceByUbl | AddOutgoingReceiptAdviceByXml |
| Yanıt görseli | GetOutgoingReceiptAdviceView | GetOutgoingReceiptAdviceViewByXml |
| Yanıt PDF | GetOutgoingReceiptAdvicePdf | GetOutgoingReceiptAdvicePdfByXml |
| Yanıt UBL | GetOutgoingReceiptAdviceXml | GetOutgoingReceiptAdviceXmlByXml |
| Yanıt indirme | GetOutgoingReceiptAdviceDownloadUrl | — |