E-Fatura ve E-İrsaliye sistemine kayıtlı firmalara ait GB/PK etiketlerinin sıkıştırılmış olarak istenilen tipte dönüldüğü servistir.
Servisten dönen parametreler şu şekildedir:
| Parametre | Tip | Açıklama |
|---|---|---|
| CONTENT | Base64Encoded | Kriterlere uygun mükelleflere ait GB ve PK adresleri |
XML dosyasının içerisinde bulunan USER objesinin elamanları şu şekildedir :
| Eleman | Tip | Açıklama |
|---|---|---|
| USER.IDENTIFIER | String | Mükellefe ait VKNsı. |
| USER.ALIAS | String | Mükellefe ait GB veya PK etiketi. format: urn:mail:defaultgb@firma.com |
| USER.TITLE | String | Firmanın GİB e-fatura sisteminde tanımlı ünvanı. |
| USER.TYPE | String | Firmanın GİB e-fatura sisteminde tanımlı tipi. OZEL veya KAMU olabilir. |
| USER.UNIT | String | Etiketin tipi. GB veya PK |
| USER.DOCUMENT_TYPE | String | E-Fatura için INVOICE, E-İrsaliye için DESPATCHADVICE dönülmektedir. |
| USER.REGISTER_TIME | DateTime | Firmanın GİB e-fatura sistemine ilk kayıt olduğu tarih. formatı: 2013-07-01T15:22:11 |
| USER.ALIAS_CREATION_TIME | DateTime | Etiketin oluşturulduğu tarih. formatı: 2013-07-01T15:22:11 |
| USER.DELETED | String | Eleman sadece silinmiş etiketlerde bulunur. Değeri Y olur. Silinmemiş etiketlerde bu eleman bulunmaz. |
| USER.DELETION_TIME | DateTime | Eleman sadece silinmiş etiketlerde bulunur. Etiketin GİB sisteminde kapatıldığı tarih. formatı: 2013-07-01T15:22:11 |
Parametreler
| Ad | Tip | Zorunlu | Aciklama |
|---|---|---|---|
REQUEST_HEADER |
object |
Evet | |
└ SESSION_ID |
text |
Evet | Kimlik doğrulama servisi (AuthenticationWS) oturum açma metodundan (Login) alına oturum/token/session bilgisi. |
└ APPLICATION_NAME |
text |
Evet | Metodu çağıran uygulamanın adı. Örnek: AppName-v1.4.67 |
└ CLIENT_TXN_ID |
text |
Hayir | İstemci uygulama tarafından işlem için üretilen işlem bilgisi (transaction id) varsa istek esnasında gönderilip, sonuçta alabileceğiniz bir değerdir. request/response eşleşmesi yapmak için kullanılabilir. |
TYPE |
select |
Hayir | Listenin dönüleceği dosya tipi. XML ve CSV olabilir. Varsayılan XMLdir. |
DOCUMENT_TYPE |
select |
Hayir | Mükellef listesi çekilmek istenilen ürün tipi. E-Fatura için INVOICE, E-İrsaliye için DESPATCHADVICE gönderilmelidir. Her iki ürüne ait etiketleri çekmek için ALL değeri gönderilebilir. Parametre gönderilmez bütün ürünlere ait Aktif etiket listesi dönülecektir. |
REGISTER_TIME_START |
text |
Hayir | Mükellefiyet başlangıç tarihi. Belirli bir tarihten sonra e-fatura veya e-irsaliye mükellefi sisteme dahil olmuş mükellefleri çekmek için kullanılabilir. Eğer tarih içerisinde saat bilgisi gönderilirse sonuç dönülürken dikkate alınacaktır. format: YYYY-AA-GG veya YYYY-AA-GGTSS:DD:SS formatında 2013-01-01, 2013-01-01T01:01:01 |
ALIAS_TYPE |
select |
Hayir | Mükelleflerin etiketlerine göre çekmek için kullanılır. Sadece Gönderici Birim etiketini çekmek için GB, Posta Kutusu etiketini çekmek için PK gönderilmelidir. Bütün etiketleri çekmek için ALL değeri gönderilebilir. Varsayılan PKdir. Parametre gönderilmez ise sadece PK etiket listesi dönülecektir. Belge göndermek için sadece PK etiketlerine ihtiyaç bulunmaktadır. |
ALIAS_MODIFY_DATE |
text |
Hayir | Etiket durum değişiklik tarihi. Belirli bir tarihten sonra sisteme eklenen veya silinen etiketleri çekmek için kullanılabilir. Bu parametre gönderilirse gönderilen tarihten sonra sisteme eklenen veya silinen etiketler dönülecektir. Eğer tarih içerisinde saat bilgisi gönderilirse sonuç dönülürken dikkate alınacaktır. format: YYYY-AA-GG veya YYYY-AA-GGTSS:DD:SS formatında 2013-01-01, 2013-01-01T01:01:01 |
Ornek Yanit (XML)
<?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns3:GetGibUserListResponse xmlns:xmime="http://www.w3.org/2005/05/xmlmime" xmlns:ns3="http://schemas.i2i.com/ei/wsdl">
<CONTENT>UEsDBBQACAgIADea91wAAAAAAAA</CONTENT>
</ns3:GetGibUserListResponse>
</S:Body>
</S:Envelope>