BillInfo

Bu nesne, adisyon üst bilgilerini barındıran nesnedir. Nesne ile ilgili detaylar aşağıda anlatılmıştır.

public class BillInfoDto
{
    public Guid UUID { get; set; }
    public Guid TemplateUUID { get; set; }
    public string TemplateBase64String { get; set; }
    public string BillSerieOrNumber { get; set; }
    public DateTime IssueDate { get; set; } 
    public string CurrencyCode { get; set; }
    public decimal? ExchangeRate { get; set; }
    public RelatedDocument RelatedDocument { get; set; }
    public ValidityPeriod ValidityPeriod { get; set; }
}

UUID

Guid Seçimli

Guid veri tipinde adisyonun takibi için kullanılacak unique numaradır.

Bill.BillInfo.UUID = 'b8787efb-639d-4efc-85b5-953bf1dbaac0';

Alanın boş gönderilmesi durumunda sistem tarafından yeni bir UUID adisyona eklenecektir.

TemplateUUID

Guid Seçimli

Bu alan adisyona eklenecek olan XSLT’nin UUID'si için kullanılır. UUID'ye ait XSLT adisyona eklenir.

Bill.BillInfo.TemplateUUID = '94e8b735-1361-4d6f-a4a6-3745b62239c8';

• TemplateUUID alanının dolu ve TemplateBase64String alanının boş olması durumunda girilen TemplateUUID bilgisine ait tasarım adiyona eklenecektir.

• TemplateBase64String alanının dolu olması durumunda TemplateUUID alanına bakılmaksızın TemplateBase64String bilgisi adisyon tasarımı olarak eklenecektir.

• TemplateUUID ve TemplateBase64String alanları boş geçilirse adisyona varsayılan tasarım eklenecektir.

TemplateBase64String

string Seçimli

Adisyona eklenecek tasarımın Base64'ü buraya eklenir.

• TemplateUUID alanının dolu ve TemplateBase64String alanının boş olması durumunda girilen TemplateUUID bilgisine ait tasarım adisyona eklenecektir.

• TemplateBase64String alanının dolu olması durumunda TemplateUUID alanına bakılmaksızın TemplateBase64String bilgisi adisyon tasarımı olarak eklenecektir.

• TemplateUUID ve TemplateBase64String alanları boş geçilirse adisyona varsayılan tasarım eklenecektir.

BillSerieOrNumber

string Zorunlu

Bu alana 16 haneli e-Adisyon numarasını, 3 haneli seri bilgisini girebilirsiniz. 16 haneli adisyon numarası girmeniz durumunda herhangi bir işlem yapılmaz adisyon numarası olarak girdiğiniz değer belirlenir. Eğer 3 haneli seri girerseniz portal üzerinde tanımlı olan bu seri üzerinden numara üretilir.

//Manuel Adisyon Numarası
Bill.BillInfo.BillSerieOrNumber = "EAD2023000000001";

//Seri Bilgisi
Bill.BillInfo.BillSerieOrNumber= "EAD";

Portal da kayıtlı EAD serisine otomatik olarak sıradaki numara verilir.

IssueDate

DateTime Zorunlu

Bu alana adisyon tarihi ve saati girilir.

Bill.BillInfo.IssueDate = "2023-03-22T10:20:39.846Z";

CurrencyCode

string Zorunlu

Bu alan makbuzun para biriminin girileceği alandır. Alabileceği değerler kod listeleri bölümünde Para Birim Kodları altında belirtilmiştir.

Bill.BillInfo.CurrencyCode = "TRY";

ExchangeRate

string Seçimli

Bu alan adisyonun Türk lirasından farklı bir para biriminde kesildiğinde döviz kurunun girileceği alandır. Adisyon üzerinde kur bilgisi görünecektir.

RelatedDocument

string Zorunlu

Hizmetin tamamlanması ile birlikte düzenlenecek e-Fatura veya e-Arşiv Fatura’nın evrensel tekil tanımlama numarası (ETTN) veya perakende satış fişinin düzenlendiği ÖKC’nin cihaz sicil numarası Code alanına girilecektir.

public class RelatedDocument
    {
        public RelatedDocumentType Type { get; set; }
        public string Code { get; set; }
    }

RelatedDocumentType Enum veri tipinde bir nesnedir. Code alanına ÖKC'nın cihaz sicil numara girilirse SATIS_FISI girilecektir. Code alanına ETTN girildiğinde ilgili kesilen faturanın türünün belirtileceği alandır. EFATURA , EARSIV_FATURA değerlerini alabilir.

public enum RelatedDocumentType
{ 
     EFATURA = 1,
     EARSIV_FATURA = 2,
     SATIS_FISI = 3
}

Bill.BillInfo.RelatedDocument.Code= "b8787efb-639d-4efc-85b5-953bf1dbaac0";

Bill.BillInfo.RelatedDocument.Type = "EFATURA";

ValidityPeriod

string Zorunlu

e-Adisyon belgesinin hizmet süresinin bulunduğu nesnedir. Masa kullanılmaya başlandığındaki tarih ve saat, bitiş zamanındaki tarih ve saat gönderilir.

public class ValidityPeriod
    {
        public DateTime StartDate { get; set; }
        public DateTime EndDate { get; set; }
    }

Bill.BillInfo.ValidityPeriod.StartDate = "2023-03-22T10:20:39.846Z";

Bill.BillInfo.ValidityPeriod.EndDate = "2023-03-22T12:00:00.200Z";