Uploaded image for project: 'Shell OneHub'
  1. Shell OneHub
  2. SO-3020

HGS Faturalarının (Satış ve Cihaz) Web Servis ile Sağlanması İçin SFS API Geliştirme Talebi

    XMLWordPrintable

    Details

      Description

      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ı

      1. 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.

      1. 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.

      1. Veri Bilgilendirme:

          Her sorgu sonucunda, ilgili sorguya ait toplam veri sayısı bilgisi de cevapta yer alacaktır.

      1. Zorunlu Müşteri Verisi:

          Müşteri kodu girişi zorunlu olacaktır.

      1. 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.

        Attachments

          Activity

            People

            Assignee:
            mehmet Mehmet Gülenç
            Reporter:
            Şerife Şerife Şahin
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Dates

              Created:
              Updated: