Fwd: Efor Onayı : HGS Faturalarının (Satış ve Cihaz) Web Servis ile Sağlanması İçin SFS API Geliştirme Talebi
Merhaba Feyruz Hanım,
HGS Faturalarının web service ile verilmesi için yapılan talebi inceledik.
Ön ve teknik analizi yaptık. Talebi aşağıda detaylandırdık.
Bu talep için SFS API'ye yeni bir endpoint eklenecektir.
Proje Kapsamı:
SFS API’ye yeni bir endpoint eklenmesi ve bu endpoint’in HGS faturalarını belirli kriterlere göre sorgulayabilecek şekilde yapılandırılması gerekmektedir.
Bu çalışma, müşteri ve bayi kullanıcılarının HGS ve cihaz fatura bilgilerini kolayca erişebilmesini ve yönetebilmesini sağlamak amacıyla yapılacaktır.
Yeni Endpoint Tanımı
Endpoint URL: /api/v1/hgs/gethgsinvoicelist
Domain: SFS Api
Kullanıcı Erişimi: Kullanıcı adı, şifre ve müşteri kodu ile alınan token ile
Kullanıcı Yetkisi: WS_HGS_Invoice_List yetkisi ile
Filtreleme Kriterleri
Bu endpoint üzerinden yapılacak sorgulamalarda aşağıdaki kriterlere göre filtreleme yapılabilecektir:
- InvoiceNumber: Fatura numarası
- CustomerCode: Müşteri kodu
- StartDate: Başlangıç tarihi (YYYYMMDD formatında)
- EndDate: Bitiş tarihi (YYYYMMDD formatında)
- PlateCode: Plaka kodu
- PaginationFilter: Sayfalama filtreleri
- CurrentPage: Geçerli sayfa numarası
- PageSize: Sayfa başına gösterilecek kayıt sayısı
İş Kuralları
- Sorgulama Yetkisi:
Reseller kullanıcılar, kendileri ve alt kodları için sorgulama yapabilecektir.
Müşteri (Customer) kullanıcılar, sadece kendi plakaları için sorgulama yapabilecektir.
- Maksimum Veri Çekme Limiti:
Her bir sorguda en fazla 1000 kayıt çekilebilecek, ancak kullanıcı istediği kadar veri çekme hakkına sahip olacaktır.
- Veri Bilgilendirme:
Her sorgu sonucunda, ilgili sorguya ait toplam veri sayısı bilgisi de cevapta yer alacaktır.
- Zorunlu Müşteri Verisi:
Müşteri kodu girişi zorunlu olacaktır.
- Validasyon:
Customer-Customer ve Customer-Card yetki validasyonları yapılacaktır.
Response (Yanıt) İçeriği
API’nin dönüş değeri aşağıdaki verileri içerecektir:
- InvoiceNo (Fatura Numarası)
- CardTypeCode (Kart Tipi Kodu)
- SotrFileName (Dosya Adı)
- SotrFileDate (Dosya Tarihi)
- SotrFileSequence (Dosya Sıra Numarası)
- SotrCardNo (Kart Numarası)
- PlateCode (Plaka Kodu)
- ResellerCode (Bayi Kodu)
- ResellerName (Bayi Adı)
- CustomerCode (Müşteri Kodu)
- CustomerName (Müşteri Adı)
- SotrCustomerCode (Sotr Müşteri Kodu)
- ReferanceNo (Referans Numarası)
- TransactionDate (İşlem Tarihi)
- TransactionTypeCode (İşlem Tipi Kodu)
- TransitionStartDate (Geçiş Başlangıç Tarihi)
- TransitionEndDate (Geçiş Bitiş Tarihi)
- TransactionType (İşlem Tipi)
- TransactionBranch (İşlem Şubesi)
- TransactionTotalAmount (İşlem Toplam Tutarı)
- VatPercentage (KDV Yüzdesi)
- SalesVatAmount (Satış KDV Tutarı)
- TransactionNetAmount (İşlem Net Tutarı)
- EntryStation (Giriş İstasyonu)
- ExitStation (Çıkış İstasyonu)
- SystemDate (Sistem Tarihi)
- DepartmentName (Bölüm Adı)
- TerminalName (Terminal Adı)
- Province (İl)
- District (İlçe)
- TotalCount (Toplam Kayıt Sayısı)
Geliştirme Süreci ve Efor Tahmini
Bu çalışmanın tamamlanması için gerekli iş adımları ve efor tahminleri aşağıdaki gibidir:
Analiz: Gereksinimlerin ve iş kurallarının detaylı analizi ve dokümantasyonu (0.5 man/day)
Geliştirme: API endpoint'inin geliştirilmesi ve ilgili iş kurallarının kodlanması (2.5 man/day)
Test, UAT ve Test Case Dokumanı: Geliştirilen endpoint'in test edilmesi, kullanıcı kabul testlerinin yapılması ve test senaryolarının dokümantasyonu (0.5 man/day)
Web Service Dokumanı: Web servis dokümantasyonunun hazırlanması (0.5 man/day)
Deployment: Geliştirilen endpoint'in test, staging ve prod ortamına deploy edilmesi ve gerekli konfigürasyonların yapılması (1 man/day)
Toplam Efor: 5 man/day
Bu tanım ve iş planı doğrultusunda, onayınız halinde çalışma planına dahil.
Selamlar
HGS Faturalarının web service ile verilmesi için bir talep var. Eforlayıp excele eklermisiniz?
Portaldeki filtrelerle sorgulayıp gridde dönen değerleri vermemiz yeterli gibi görünüyor.
Merhaba Hürkan
Arneca tarafında bir geliştirme olacak mı? Eğer olacaksa efor iletebilir mi?
Database tarafında da geliştirme olacak o yüzden biz o konuya en erken Eylülde bakabiliriz
Arneca ile geliştirme olacaksa oradaki iş listemize ekleyebilir misiniz?
Merhaba Feyruz
Müşteriden HGS faturalarının web service ile alınabilmesi talebi geldi, Mevcut HGS WS’lerinde Invoiceları listeleyen bir servisimiz yok. TTS WS’lerindeki GetInvoiceDetail servicei de sadece yakıt faturalarını dönüyor.
Müşteriye nasıl dönüş yapalım.
HGS Faturalandırma işlemini bütün shell distribütörlerinde en kısa sürede aktive etmek istiyoruz.
Yardımcı olma şansınız var mı?
Selamlar,
HGS satışlarını müşterilere faturalandırmak istiyoruz, bununla alakalı bir kaç problemimiz var.
1-) Cihazların sisteme eklenme tarihi mevcut değil. Cihaz listeleme fonksiyonunda additionDate diye bir alan var ancak her zaman tanımsız bir tarihe işaret ediyor. Bir cihazın ne zaman tanımlandığını bilmeden doğru fatura dönemine de fatura edemeyiz. Bu konuda bir çözüm öneriniz var mı?
2-) TTS ve Adblue faturaları gibi, HGS faturalarına da erişebilir miyiz? Shell'in distribütöre kestiği HGS faturalarına erişemeden, kâr hesabı, fatura doğrulama gibi işlemleri yapamıyoruz.