SendDocument |
Metod Adı: |
SendDocument |
Açıklama: |
UBL xml formatında oluşturulan faturaların entegratöre gönderildiği metottur.Gibe gönderilmeden Xml Şematron kontrol yapılmaktadir. |
Parametre |
Tip |
Açıklama |
Örnek Veri |
Ek Açıklama |
AppType |
int |
Uygulama Türü |
1 |
1 : e-Fatura, 3 :e-Arşiv , 5 : e-İrsaliye , 6 : e-Serbest Meslek Makbuzu , 7 : e-Müstahsil Makbuzu , 11:e-Döviz Belgesi , 12:e-Adisyon Belgesi |
SourceUrn |
string |
Satıcı GB Adresi |
urn:mail:defaultgb@hizlibilisimteknolojileri.net |
|
DestinationIdentifier |
string |
Alıcı Vergi Kimlik No |
4620553774 |
|
DestinationUrn |
string |
Alıcı PK Adresi |
urn:mail:defaultpk@hizlibilisimteknolojileri.net |
|
XmlContent |
string |
Xml Dosya |
|
UBL formatında hazırlanmış xml dosya |
DocumentUUID |
string |
ETTN |
e697232d-b057-d539-ebf8-bc3f78d02d65 |
|
DocumentId |
string |
Döküman No |
GIB2019000000001 |
XmlContent içerisindeki cbc:ID alanı ile aynı değer olmalıdır. |
DocumentDate |
DateTime |
Döküman Tarihi |
2019-01-01 |
XmlContent içerisindeki cbc:IssueDate alanı ile aynı değer olmalıdır. |
LocalId |
string |
Erp Local Id |
1234 |
Kendi Erp Sisteminizin Id değerini veya DökümanNo vb. değerlerini gönderebilirsiniz. Aynı Id değeri gelmesi durumunda sistem yeniden göndermeye izin vermeyecektir! |
UpdateDocument |
bool |
Dokuman Güncelleme |
false |
Hatalı dokumanları yeniden gönderebilmek için "true" yapılarak kullanılabilir. |
IsDraft |
bool |
Taslak Mı |
false |
Taslağa Kaydedilecek ise "true" olmalıdır. |
IsDraftSend |
bool |
Taslaktan Gib'e Gönderildi |
false |
Taslaktan Gib'e Gönderildi ise "true" olmalıdır. |
Geri Dönüş Değerleri |
public class ResponseMessage
{
public bool IsSucceeded { get; set; }
public string Message { get; set; }
}
Rest Api Örneği : https://econnect.hizliteknoloji.com.tr/Gerekliler/SendDocument.txt
e-Arşiv xml Eklenmesi Gereken Alanlar : https://econnect.hizliteknoloji.com.tr/Gerekliler/eArsivXmlEkAlanlar.txt
|
SendApplicationResponse |
Metod Adı: |
SendApplicationResponse |
Açıklama: |
Uygulama yanıtlarının (kabul, red) entegratöre gönderildiği metottur. |
Parametre |
Tip |
Açıklama |
Örnek Veri |
Ek Açıklama |
AppType |
int |
Uygulama Türü |
1 |
1 : e-Fatura |
ResponseCode |
string |
Cevap Kodu |
RED |
KABUL,RED |
ResponseDescription |
string |
Açıklama |
Hatalı olduğu için reddettim. |
KABUL,RED Nedeni zorunlu değildir. |
Documents |
List<ApplicationReponseDocumentInfo> |
Cevap Verilecek Dökümanlar |
|
Rest Api Örnek :https://econnect.hizliteknoloji.com.tr/Gerekliler/SendApplicationResponse.txt |
Geri Dönüş Değerleri |
Giriş Parametre
public class SendApplicationResponse
{
public int AppType { get; set; }
public string ResponseCode { get; set; }
public string ResponseDescription { get; set; }
public List<ApplicationReponseDocumentInfo> Documents { get; set; }
}
public class ApplicationReponseDocumentInfo
{
public string DocumentUUID { get; set; }
public string DocumentId { get; set; }
public DateTime DocumentDate { get; set; }
}
Çıkış Parametre
public class ResponseMessage
{
public bool IsSucceeded { get; set; }
public string Message { get; set; }
}
Rest Api Örnek :https://econnect.hizliteknoloji.com.tr/Gerekliler/SendApplicationResponse.txt
|
GetDocumentList |
Metod Adı: |
GetDocumentList |
Açıklama: |
Gelen , Giden Dökümanların listesini almanızı sağlar. |
Parametre |
Tip |
Açıklama |
Örnek Veri |
Ek Açıklama |
AppType |
int |
Uygulama Türü |
1 |
1:Gelen e-Fatura,2:Giden e-Fatura,3:Giden e-Arşiv Fatura,4:Gelen e-İrsaliye,5:Giden e-İrsaliye,6:Giden e-Serbest Meslek Makbuzu,7:Giden e-Müstahsil Makbuzu , 11:Giden e-Döviz , 12:Giden e-Adisyon |
DateType |
string |
Tarih Tipi |
IssueDate |
IssueDate = Döküman Tarihi , CreatedDate=İşlem Tarihi |
StartDate |
DateTime |
Başlangıç Tarihi |
2019-01-01 |
|
EndDate |
DateTime |
Bitiş Tarihi |
2019-01-31 |
|
IsNew |
bool |
Yeni gelenler |
false |
false=Tümü , true = Arşivlenmeyenler |
IsExport |
bool |
Sadece İhracat Faturalarının Listesi |
false |
false=Tümü , true =Sadece İhracat |
TakenFromEntegrator |
string |
Entegratörden Alındı Bilgisi |
ALL |
Entegratörden sorgulanan dökümanın lokalde kaydedilip kaydedilmediğini tutar. {"YES","NO","ALL"} değerlerinden birini alır. |
IsDraft |
bool |
Taslak mı? |
false |
AppType=2 giden taslak , AppType=3 giden earşiv taslak |
Geri Dönüş Değerleri |
public class DocumentList : ResponseMessage
{
public List<Document> documents { get; set; }
}
public class Document
{
public string UUID { get; set; }
public string EnvelopeUUID { get; set; }
public int AppType { get; set; }
public bool IsArchive { get; set; }
public bool IsRead { get; set; }
public bool IsAccount { get; set; }
public bool IsTransferred { get; set; }
public bool IsPrinted { get; set; }
public string DocumentId { get; set; }
public string DocumentTypeCode { get; set; }
public string ProfileId { get; set; }
public string DocumentCurrencyCode { get; set; }
public string TargetTitle { get; set; }
public string TargetIdentifier { get; set; }
public string TargetAlias { get; set; }
public string SourceAlias { get; set; }
public Nullable<bool> IsInternetSale { get; set; }
public string SendType { get; set; }
public decimal TaxTotal { get; set; }
public decimal PayableAmount { get; set; }
public string LocalReferenceId { get; set; }
public int Status { get; set; }
public string StatusExp { get; set; }
public int EnvelopeStatus { get; set; }
public string EnvelopeExp { get; set; }
public string Messsage { get; set; }
public DateTime IssueDate { get; set; } // WcfDate
public DateTime CreatedDate { get; set; }
public Nullable<DateTime> CancelDate { get; set; }
}
|
GetDocumentListGUID |
Metod Adı: |
GetDocumentListGUID |
Açıklama: |
Gelen , Giden Dökümanların listesini GUID ile almanızı sağlar. |
Parametre |
Tip |
Açıklama |
Örnek Veri |
Ek Açıklama |
AppType |
int |
Uygulama Türü |
1 |
1:Gelen e-Fatura,2:Giden e-Fatura,3:Giden e-Arşiv Fatura,4:Gelen e-İrsaliye,5:Giden e-İrsaliye,6:Giden e-Serbest Meslek Makbuzu,7:Giden e-Müstahsil Makbuzu , 11:Giden e-Döviz , 12:Giden e-Adisyon |
GUIDList |
string[] |
ETTN Listesi |
e697232d-b057-d539-ebf8-bc3f78d02d65 |
|
Geri Dönüş Değerleri |
public class DocumentList : ResponseMessage
{
public List<Document> documents { get; set; }
}
public class Document
{
public string UUID { get; set; }
public string EnvelopeUUID { get; set; }
public int AppType { get; set; }
public bool IsArchive { get; set; }
public bool IsRead { get; set; }
public bool IsAccount { get; set; }
public bool IsTransferred { get; set; }
public bool IsPrinted { get; set; }
public string DocumentId { get; set; }
public string DocumentTypeCode { get; set; }
public string ProfileId { get; set; }
public string DocumentCurrencyCode { get; set; }
public string TargetTitle { get; set; }
public string TargetIdentifier { get; set; }
public string TargetAlias { get; set; }
public Nullable<bool> IsInternetSale { get; set; }
public string SendType { get; set; }
public decimal TaxTotal { get; set; }
public decimal PayableAmount { get; set; }
public string LocalReferenceId { get; set; }
public int Status { get; set; }
public string StatusExp { get; set; }
public int EnvelopeStatus { get; set; }
public string EnvelopeExp { get; set; }
public string Messsage { get; set; }
public DateTime IssueDate { get; set; } // WcfDate
public DateTime CreatedDate { get; set; }
public Nullable<DateTime> CancelDate { get; set; }
}
|
GetDocumentFile |
Metod Adı: |
GetDocumentFile |
Açıklama: |
Gelen , Giden Dökümanların dosyalarını almanızı sağlar. |
Parametre |
Tip |
Açıklama |
Örnek Veri |
Ek Açıklama |
AppType |
int |
Uygulama Türü |
1 |
1:Gelen e-Fatura,2:Giden e-Fatura,3:Giden e-Arşiv Fatura,4:Gelen e-İrsaliye,5:Giden e-İrsaliye,6:Giden e-Serbest Meslek Makbuzu,7:Giden e-Müstahsil Makbuzu,8:Giden İrsaliye Yanıtı,9:Gelen İrsaliye Yanıtı , 11:Giden e-Döviz , 12:Giden e-Adisyon |
Uuid |
string |
ETTN |
e697232d-b057-d539-ebf8-bc3f78d02d65 |
Tur =ZARFXML ise EnvelopeUUID gönderilmeli |
Tur |
string |
Dosya Türü |
PDF |
PDF,XML,HTML,JPG,ZARFXML olarak gönderilebilir. |
IsDraft |
bool |
Taslak mı? |
false |
AppType=2 giden taslak , AppType=3 giden earşiv taslak |
Geri Dönüş Değerleri |
public class DocumentContent: ResponseMessage
{
public byte[] DocumentFile { get; set; }
}
|
SetDocumentFlag |
Metod Adı: |
SetDocumentFlag |
Açıklama: |
Gelen , Giden Dökümanların (Arşivlendi,Okundu vb) olarak işaretlemenizi sağlar. |
Parametre |
Tip |
Açıklama |
Örnek Veri |
Ek Açıklama |
AppType |
int |
Uygulama Türü |
1 |
1:Gelen e-Fatura,2:Giden e-Fatura,3:Giden e-Arşiv Fatura,4:Gelen e-İrsaliye,5:Giden e-İrsaliye,6:Giden e-Serbest Meslek Makbuzu,7:Giden e-Müstahsil Makbuzu , 11:Giden e-Döviz , 12:Giden e-Adisyon |
Uuid |
string |
ETTN |
e697232d-b057-d539-ebf8-bc3f78d02d65 |
|
Flag_Name |
string |
İşaret Türü |
OKUNDU |
ARSIVLENDI,OKUNDU,MUHASEBELESTIRILDI,AKTARILDI,YAZDIRILDI,TASLAKIPTAL,GIB_IPTAL |
Flag_Value |
int |
İşaret Değeri |
0 |
0: Okunmadı,1 Okundu Diğerleride aynı şekilde gönderilebilir. |
Geri Dönüş Değerleri |
public class ResponseMessage
{
public bool IsSucceeded { get; set; }
public string Message { get; set; }
}
|
SendInvoiceModel |
Metod Adı: |
SendInvoiceModel |
Açıklama: |
(InvoiceModel) Türünde oluşturulan faturaların entegratöre gönderildiği metottur.
|
Parametre |
Tip |
Açıklama |
Örnek Veri |
Ek Açıklama |
AppType |
int |
Uygulama Türü |
1 |
1 : e-Fatura,3 :e-Arşiv |
SourceUrn |
string |
Satıcı GB Adresi |
urn:mail:defaultgb@hizlibilisimteknolojileri.net |
|
DestinationIdentifier |
string |
Alıcı Vergi Kimlik No |
4620553774 |
|
DestinationUrn |
string |
Alıcı PK Adresi |
urn:mail:defaultpk@hizlibilisimteknolojileri.net |
|
LocalId |
string |
Erp Local Id |
123456 |
Kendi Erp Sisteminizin Id değerini veya DökümanNo vb. değerlerini gönderebilirsiniz. Aynı Id değeri gelmesi durumunda sistem yeniden göndermeye izin vermeyecektir! |
UpdateDocument |
bool |
Dokuman Güncelleme |
false |
Hatalı dokumanları yeniden gönderebilmek için "true" yapılarak kullanılabilir. |
IsDraft |
bool |
Taslak Mı |
false |
Taslağa Kaydedilecek ise "true" olmalıdır. |
IsDraftSend |
bool |
Taslaktan Gib'e Gönderildi |
false |
Taslaktan Gib'e Gönderildi ise "true" olmalıdır. |
InvoiceModel |
InvoiceModel |
Fatura verileri doldurulmalı |
Örnek Kodları indirip inceleyebilirsiniz |
Rest Api için Örnek : https://econnect.hizliteknoloji.com.tr/Gerekliler/SendInvoiceModel.txt |
IsPreview |
bool |
Gibe göndermeden sadece html görüntüsü almak için |
false |
|
Geri Dönüş Değerleri |
public class OutputInvoiceModel : ResponseMessage
{
public string HtmlContent { get; set; }
}
|
SendDespatchAdviceModel |
Metod Adı: |
SendDespatchAdviceModel |
Açıklama: |
(Irsaliye) Türünde oluşturulan faturaların entegratöre gönderildiği metottur.
|
Parametre |
Tip |
Açıklama |
Örnek Veri |
Ek Açıklama |
AppType |
int |
Uygulama Türü |
5 |
5 : e-İrsaliye |
SourceUrn |
string |
Satıcı GB Adresi |
urn:mail:defaultgb@hizlibilisimteknolojileri.net |
|
DestinationIdentifier |
string |
Alıcı Vergi Kimlik No |
4620553774 |
|
DestinationUrn |
string |
Alıcı PK Adresi |
urn:mail:defaultpk@hizlibilisimteknolojileri.net |
|
LocalId |
string |
Erp Local Id |
123456 |
Kendi Erp Sisteminizin Id değerini veya DökümanNo vb. değerlerini gönderebilirsiniz. Aynı Id değeri gelmesi durumunda sistem yeniden göndermeye izin vermeyecektir! |
UpdateDocument |
bool |
Dokuman Güncelleme |
false |
Hatalı dokumanları yeniden gönderebilmek için "true" yapılarak kullanılabilir. |
IsDraft |
bool |
Taslak Mı |
false |
Taslağa Kaydedilecek ise "true" olmalıdır. |
IsDraftSend |
bool |
Taslaktan Gib'e Gönderildi |
false |
Taslaktan Gib'e Gönderildi ise "true" olmalıdır. |
Irsaliye |
Irsaliye |
İrsaliye verileri doldurulmalı |
Örnek Kodları indirip inceleyebilirsiniz |
Rest Api için örnek : https://econnect.hizliteknoloji.com.tr/Gerekliler/SendDespatchAdviceModel.txt |
IsPreview |
bool |
Gibe göndermeden sadece html görüntüsü almak için |
false |
|
Geri Dönüş Değerleri |
public class OutputDespatchAdviceModel : ResponseMessage
{
public string HtmlContent { get; set; }
}
|
KontorYukle |
Metod Adı: |
KontorYukle |
Açıklama: |
Kontor bakiyesi yüklemenizi sağlar |
Parametre |
Tip |
Açıklama |
Örnek Veri |
Ek Açıklama |
vkn_tckn |
string |
Kontor yükenecek vkn veya tckn |
4620553774 |
Rest Api için örnek : https://econnect.hizliteknoloji.com.tr/Gerekliler/KontorYukle.txt |
birimTuru |
enum BirimTuru |
|
|
|
krediTuru |
KrediTuru krediTuru |
|
|
|
islemTuru |
enum IslemTuru |
|
|
|
Geri Dönüş Değerleri |
Giriş Parametreleri
public class KontorYukleModel
{
public string vkn_tckn { get; set; }
public BirimTuru birimTuru { get; set; }
public KrediTuru krediTuru { get; set; }
public IslemTuru islemTuru { get; set; }
}
public enum BirimTuru
{
FaturaAdedi,
AlanBoyutu,
}
public class KrediTuru
{
public OdemeTuru odemeTuru { get; set; }
public int taksitSayisi { get; set; }
public int birimMiktari { get; set; }
public string baslangicTarihi { get; set; }
public string sonKullanimTarihi { get; set; }
public string faturaNo { get; set; }
}
public enum OdemeTuru
{
Pesin,
Taksit,
Ucretsiz,
}
public enum IslemTuru
{
Satinalma,
Hediye,
Transfer,
}
Çıkış Parametreleri
public class ResponseMessage
{
public bool IsSucceeded { get; set; }
public string Message { get; set; }
}
|
UploadDocumentTransfer |
Metod Adı: |
UploadDocumentTransfer |
Açıklama: |
Başka sistemlerden gönderilen xml dosyalarını tranfer etmenizi sağlar. |
Parametre |
Tip |
Açıklama |
Örnek Veri |
Ek Açıklama |
Tip |
enum |
|
2 |
ZarfZip = 1,BelgeZip = 2, |
ZipContent |
byte[] |
|
|
Zip içerisinde xml dosyaları olacak şekilde eklenmelidir. |
AppType |
int |
Uygulama Türü |
1 |
1:Gelen e-Fatura,2:Giden e-Fatura,3:Giden e-Arşiv Fatura,4:Gelen e-İrsaliye,5:Giden e-İrsaliye,6:Giden e-Serbest Meslek Makbuzu,7:Giden e-Müstahsil Makbuzu |
Geri Dönüş Değerleri |
Giriş Parametreleri
public class UploadDocumentTransferInput
{
public Models.InvoiceModels.TransferTip Tip { get; set; } ZarfZip = 1, BelgeZip = 2,
public byte[] ZipContent { get; set; }
public int AppType { get; set; }
public string FirmaVknTckn { get; set; }
}
|
GetDocumentListTransfer |
Metod Adı: |
GetDocumentListTransfer |
Açıklama: |
Başka sistemlerden gönderilen xml dosyalarını tranfer listesini almanızı sağlar. |
Parametre |
Tip |
Açıklama |
Örnek Veri |
Ek Açıklama |
AppType |
int |
Uygulama Türü |
1 |
1:Gelen e-Fatura,2:Giden e-Fatura,3:Giden e-Arşiv Fatura,4:Gelen e-İrsaliye,5:Giden e-İrsaliye,6:Giden e-Serbest Meslek Makbuzu,7:Giden e-Müstahsil Makbuzu |
DateType |
string |
|
IssueDate |
IssueDate = Döküman Tarihi , CreatedDate=İşlem Tarihi |
StartDate |
DateTime |
|
2021-01-01 |
|
EndDate |
DateTime |
|
2021-01-31 |
|
Geri Dönüş Değerleri |
Çıkış
public class DocumentList : ResponseMessage
{
public List<Document> documents { get; set; }
}
public class Document
{
public string UUID { get; set; }
public string EnvelopeUUID { get; set; }
public int AppType { get; set; }
public bool IsArchive { get; set; }
public bool IsRead { get; set; }
public bool IsAccount { get; set; }
public bool IsTransferred { get; set; }
public bool IsPrinted { get; set; }
public string DocumentId { get; set; }
public string DocumentTypeCode { get; set; }
public string ProfileId { get; set; }
public string DocumentCurrencyCode { get; set; }
public string TargetTitle { get; set; }
public string TargetIdentifier { get; set; }
public string TargetAlias { get; set; }
public Nullable<bool> IsInternetSale { get; set; }
public string SendType { get; set; }
public decimal TaxTotal { get; set; }
public decimal PayableAmount { get; set; }
public string LocalReferenceId { get; set; }
public int Status { get; set; }
public string StatusExp { get; set; }
public int EnvelopeStatus { get; set; }
public string EnvelopeExp { get; set; }
public string Messsage { get; set; }
public DateTime IssueDate { get; set; }
public DateTime CreatedDate { get; set; }
public Nullable<DateTime> CancelDate { get; set; }
}
|
GetDocumentFileTransfer |
Metod Adı: |
GetDocumentFileTransfer |
Açıklama: |
Başka sistemlerden gönderilen transfer xml dosyalarını almanızı sağlar. |
Parametre |
Tip |
Açıklama |
Örnek Veri |
Ek Açıklama |
AppType |
int |
Uygulama Türü |
1 |
1:Gelen e-Fatura,2:Giden e-Fatura,3:Giden e-Arşiv Fatura,4:Gelen e-İrsaliye,5:Giden e-İrsaliye,6:Giden e-Serbest Meslek Makbuzu,7:Giden e-Müstahsil Makbuzu |
Uuid |
string |
|
e697232d-b057-d539-ebf8-bc3f78d02d65 |
|
Tur |
string |
|
XML |
PDF,XML,HTML olarak gönderilebilir. |
Geri Dönüş Değerleri |
Çıkış
public class DocumentContent : ResponseMessage
{
public byte[] DocumentFile { get; set; }
}
|
ObjectDocument |
Metod Adı: |
ObjectDocument |
Açıklama: |
e-Arşiv Fatura ve e-Serbest Meslek Makbuz belgelerine itiraz etmenizi sağlar |
Parametre |
Tip |
Açıklama |
Örnek Veri |
Ek Açıklama |
AppType |
int |
*Uygulama Türü |
3 |
3:Giden e-Arşiv Fatura,6:Giden e-Serbest Meslek Makbuzu |
DocumentUuid |
string |
*ETTN |
e697232d-b057-d539-ebf8-bc3f78d02d65 |
İtiraz edilecek belgenin ettn bilgisi |
ObjectionReason |
string |
*İtiraz Nedeni |
Belge hatalı itiraz ediyorum |
|
ObjectionDate |
string |
*İtiraz Tarihi |
2021-09-27 |
6102 sayılı Kanunun 18 inci maddesinin üçüncü fıkrası
uyarınca noter aracılığıyla, taahhütlü mektupla, telgrafla veya
güvenli elektronik imza kullanılarak KEP sistemi ile yapılan
işlemler neticesinde oluşacak belgenin tarihi |
ObjectionType |
string |
*Tip |
KEP |
KEP,NOTER,TELGRAF,TAAHHUTLU_MEKTUP |
ObjectionDocumentNo |
string |
*İtiraz Belge No |
00001 |
6102 sayılı Kanunun 18 inci maddesinin üçüncü fıkrası
uyarınca noter aracılığıyla, taahhütlü mektupla, telgrafla veya
güvenli elektronik imza kullanılarak KEP sistemi ile yapılan
işlemler neticesinde oluşacak belgenin numarası |
Geri Dönüş Değerleri |
Giriş
public class ObjectDocumentInput
{
public int AppType { get; set; }
public string DocumentUuid { get; set; }
public string ObjectionReason { get; set; }
public string ObjectionDate { get; set; }
public string ObjectionType { get; set; }
public string ObjectionDocumentNo { get; set; }
}
Çıkış
public class ResponseMessage
{
public bool IsSucceeded { get; set; }
public string Message { get; set; }
}
|