NESDespatch Nedir?

NESDespatch, DespatchAdvice xml formatında çıktı üreten, dökümantasyonu bakımından sadelestirilmis ve basitlestirilmiş bir JSON nesnesidir.


Bu dökümantasyonda NESDespatch içerisindeki alanların kullanım örnekleri ve alanların zorunlulukları hakkında detaylı bilgiyi bulabilirsiniz.

  1. DespatchInfo
  2. DespatchSupplierInfo
  3. DeliveryCustomerInfo
  4. BuyerCustomerInfo
  5. SellerSupplierInfo
  6. OriginatorCustomerInfo
  7. ShipmentDetail
  8. DespatchLines
  9. Notes

DespatchInfo

Bu nesne, irsaliye üst bilgilerini barındıran nesnedir. Asagıda bu nesnenin detayları anlatılmıstır.

UUID

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

nesDespatch.DespatchInfo.UUID = Guid.NewGuid().ToString(); //Örnek : caeffd50-21e6-436d-95e7-b8869a77ab1e
         

DespatchType

Enum veri tipinde bir nesnedir.

  • SEVK
  • MATBUDAN
değerini alabilir.

nesDespatch.DespatchInfo.DespatchType = DespatchType.SEVK;
         

DespatchSerieOrNumber

Bu alana 16 haneli e-İrsaliye numarasını yada 3 haneli seri bilgisini girebilirsiniz. 16 haneli irsaliye numarası girmeniz durumunda herhangi bir işlem yapılmaz irsaliye numarası olarak girdiğiniz değer belirlenir. Eğer 3 haneli seri girerseniz portal üzerinde tanımlı olan bu seri üzerinden numara üretilir. Boş geçmeniz durumunda ise sistem üzerinde tanımlı varsayılan seri üzerinden numaralandırma yapılır. Boş geçerseniz ve sistem üzerinde tanımlı varsayılan seri yok ise irsaliye şematron hatası alır.


//Manuel numara verilmis
nesDespatch.DespatchInfo.DespatchSerieOrNumber = "ABC2017000000001";

//Portalde kayıtlı ABC serisinden otomatik olarak sıradaki numara verilir
nesDespatch.DespatchInfo.DespatchSerieOrNumber = "ABC";
         

IssueDate

Bu alana irsaliye tarihi girilir.


IssueTime

Bu alana irsaliye düzenleme saati girilir.


OrderReference

Bu alan irsaliyeye ait sipariş bilgilerinin girilebileceği alandır. (Bkz. KeyValue)


OrderReferenceDocument

Bu alan irsaliyeye ait sipariş bilgilerinin girilebileceği alandır. (Bkz. AdditioanlDocumentReference)


XSLTTitle

Bu alan faturaya eklenecek olan XSLT’yi seçmeniz için kullanılır. Burada girilen değer portalde tanımlı XSLT’nizi otomatik olarak faturaya ekler.


XSLTPath

Bu alan irsaliyeye eklenecek olan XSLT’nin dosya sistemindeki yolunu belirtmek için kullanılır. Burada girilen değer üzerinden dosya sistemindeki XSLT irsaliyeye eklenir.


DespatchProfile

Bu alan e-irsaliyenin senaryosunun belirtileceği alandır.

DespatchSupplierInfo

İrsaliyeyi düzenleyen bilgilerinin girileceği alandır.

NOT : DespatchSupplierInfo nesnesi PartyInfo nesnesinden türetilmektedir. (Bkz. PartyInfo)
DespatchContact
DespatchContact alanına, teslim edenin adı ve soyadı girilir.
public class DespatchSupplierInfo : PartyInfo
{
  public string DespatchContact { get; set; }
}
                        

DeliveryCustomerInfo

DeliveryCustomerInfo, nesnesine "Sevk İrsaliyesindeki Malların, Sevkiyatını Teslim Alan Taraf Bilgileri" (DeliveryCustomerParty) girilir.

Yeni düzenleme ile birlikte alcının e-İrsaliye mükellefi olup olmamasının bir önemli bulunmamaktadır.

Bütün sevk irsaliyeleri e-İrsaliye olarak düzenlenmek zorundadır.
NOT : DeliveryCustomerInfo nesnesi PartyInfo nesnesinden türetilmektedir. (Bkz. PartyInfo)

BuyerCustomerInfo

BuyerCustomerInfo, nesnesine "Sevk İrsaliyesinin Alıcısının Haricinde, Sevk İrsaliyesindeki Malları Satın Alan Taraf Bilgileri" (BuyerCustomerParty) girilir.

NOT : BuyerCustomerInfo nesnesi PartyInfo nesnesinden türetilmektedir. (Bkz. PartyInfo)

SellerSupplierInfo

SellerSupplierInfo, nesnesine "Sevk İrsaliyesini Düzenleyen Haricinde, Sevk İrsaliyesindeki Malları Sağlayan Taraf Bilgileri" (SellerSupplierParty) girilir.

NOT : SellerSupplierInfo nesnesi PartyInfo nesnesinden türetilmektedir. (Bkz. PartyInfo)

OriginatorCustomerInfo

OriginatorCustomerInfo, nesnesine "Sevk İrsaliyesinin Alıcısının Haricinde, Sevk İrsaliyesindeki Malları Alınmasını Başlatan Taraf" (OriginatorCustomerParty) girilir.

NOT : OriginatorCustomerInfo nesnesi PartyInfo nesnesinden türetilmektedir. (Bkz. PartyInfo)

ShipmentDetail

İrsaliyenin gönderimiyle alakalı bilgilerin girileceği alandır.

Aşağıda bu nesnenin tüm detaylarını bulabilirsiniz.
ShipmentDetail Nesne Detayları
  • ShipmentInfos

    Malları taşıyan şoförlerin ve aracın bilgilerinin girileceği alandır. (Bkz. ShipmentInfos)

  • Delivery

    Malları taşıyan firmanın ve taşıma zamanının girileceği alandır. (Bkz. Delivery)

  • TransportEquipment

    Bu alana malları taşıyan aracın dorse plakaları girilir.

  • public class ShipmentDetail
    {
        public List<ShipmentInfo> ShipmentInfos { get; set; }
        public Delivery Delivery { get; set; }
        public List<string> TransportEquipment { get; set; }
    }
    

DespatchLines

İrsaliye kalemlerinin tüm detaylarının girileceği alandır.

NOT : DespatchLines nesnesi liste şeklinde DespatchLine sınıfı içermektedir.
Aşağıda bu nesnenin tüm detaylarını bulabilirsiniz.
DespatchLine Nesne Detayları
  • Index

    Fatura kaleminin sıra numarasının belirtileceği alandır.

  • DeliveredQuantity

    Gönderimi gerçekleştirilen mal adedi bu alana girilir.

  • DeliveredUnitType

    Bu alana gönderimi gerçekleştirilen malların birim tipi girilmelidir. Alabileceği değerler kod listeleri bölümünde Birim Kodları altında belirtilmiştir.

  • OutstandingQuantity

    İleriki bir tarihte gönderilecek mal adedi bilgisi bu alana girilir.

  • OutstandingUnitType

    Bu alana ileriki bir tarihte gönderilecek malların birim tipi girilmelidir. Alabileceği değerler kod listeleri bölümünde Birim Kodları altında belirtilmiştir.

    NOT : Eğer sonradan gönderilecek bir mal var ise yani OutstandingQuantity alanına 0'dan büyük bir değer girilmiş ise bu alan zorunludur.
  • OutstandingReason

    İleriki tarihte gönderilecek malın sebebi (neden ileri tarihte gönderileceği) girilir.

    NOT : Eğer sonradan gönderilecek bir mal var ise yani OutstandingQuantity alanına 0'dan büyük bir değer girilmiş ise bu alan zorunludur.
  • SellerCode

    Bu alana ürünün satıcı kodu girilir.

  • Name

    Bu alana ürünün adı girilir.

  • Description

    Bu alana ürünün açıklaması girilir.

  • DocumentReferences

    Satır içerisine Word,excel,pdf vs. gibi dosyalar eklemek yada farklı bilgileri eklemek için kullanabileceğiniz alandır. (Bkz. AdditioanlDocumentReference)

  • AdditionalItemIdentifications

    Bu alana satır ile alakalı kimlik bilgileri girilebilir. (Bkz. PartyIdentification)

public class DespatchLine
{
  public string Index { get; set; }
  public decimal DeliveredQuantity { get; set; }
  public string DeliveredUnitType { get; set; }
  public decimal OutstandingQuantity { get; set; }
  public string OutstandingUnitType { get; set; }
  public string OutstandingReason { get; set; }
  public string SellerCode { get; set; }
  public string Name { get; set; }
  public string Description { get; set; }
  public List<AdditioanlDocumentReference> DocumentReferences { get; set; }
  public List<PartyIdentification> AdditionalItemIdentifications { get; set; }
}

Notes

Bu alana sınırsız not eklenebilir.

Ortak Nesneler

KeyValue

public class KeyValue
{
  //kullanıldığı yerle alakalı tarih verisi girilir. (Örn: İrsaliye Tarihi)
  public DateTime IssueDate { get; set; }

  //kullanıldığı yerle alakalı değer girilir. (Örn: İrsaliye Numarası)
  public string Value { get; set; }
}

Delivery

Malları taşıyan firmanın ve taşıma zamanının girileceği alandır.


CarrierInfo

Bu alana taşıyıcı taraf bilgileri girilir.

NOT : CarrierInfo nesnesi PartyInfo nesnesinden türetilmektedir. (Bkz. PartyInfo)

ActualDespatchDateTime

Malların teslim tarihi ve saati bu alana girilir.

public class Delivery
{
  public PartyInfo CarrierInfo { get; set; }
  public DateTime ActualDespatchDateTime { get; set; }
}

ShipmentInfo

Malları taşıyan firmanın ve taşıma zamanının girileceği alandır.


LicensePlateID

Bu alana malları taşıyan aracın plakası girilir.


DriverPerson

Bu alana malları taşıyan aracın şoför bilgileri girilir.

NOT : DriverPerson nesnesi PersonInfo nesnesinden türetilmektedir. (Bkz. PersonInfo)
public class ShipmentInfo
{
  public string LicensePlateID { get; set; }
  public List<PersonInfo> DriverPerson { get; set; }
}

PersonInfo

Bu alana şoför bilgileri girilir.


FirstName

Bu alana şoförün adı girilir.


LastName

Bu alana şoförün soyadı girilir.


RegisterNumber

Bu alana şoförün tc kimlik numarası girilir.

public class PersonInfo
{
  public string FirstName { get; set; }
  public string LastName { get; set; }
  public string RegisterNumber { get; set; }
}

AdditioanlDocumentReference

AdditioanlDocumentReference Nesnesi

  • ID

    Eklenen dosyanın yada diğer bilginin değeri buraya girilebilir.

  • IssueDate

    Eklenen belgenin tarihi. Not: Bir belge değil sadece değer girişi olarak kullanılacaksa da fatura tarihi olarak girilebilir.

  • DocumentType

    Eklenen belgenin tipi veya sabit değer serbest metin şeklinde yazılabilir.

  • DocumentTypeCode

    Eklenen belgenin tipi veya sabit değer serbest metin şeklinde yazılabilir.

  • Attachment

    Eğer bir dosya eklenecekse, dosya bu alanda girilebilir.

    • Base64Data

      Eklenen dosyanın Base64 encode edilmiş hali buraya girilir.

    • MimeCode

      Eklenen dosyanın mimeCode değeri buraya girilir.

    • FileName

      Eklenen dosyanın adı buraya girilebilir. (Örn : application/pdf)

public class AdditioanlDocumentReference
{
  public string ID { get; set; }
  public DateTime? IssueDate { get; set; }
  public string DocumentType { get; set; }
  public string DocumentTypeCode { get; set; }
  public Attachment Attachment { get; set; }
}

public class Attachment
{
    public string Base64Data { get; set; }
    public string MimeCode { get; set; }
    public string FileName { get; set; }
}

PartyInfo

PartyInfo Nesnesi AddressInfo nesnesinden kalıtım almaktadır.

  • RegisterNumber

    Bu alana alıcı/göndericinin vergi/t.c. kimlik numarası girilir.

    NOT : e-Arşiv için alıcının vergi/t.c. kimlik numarasını bilmediğiniz durumda; T.C. vatandaşları için "11111111111" T.C. vatandaşı olmayanlar için "22222222222" girilir.
  • Name

    Bu alana alıcı/göndericinin ünvanı/adı soyadı girilir.

  • TaxOffice

    Bu alana alıcı/göndericinin vergi dairesi girilir.

    NOT : Company info içerisinde zorunludur. Ayrıca alıcısının e-fatura mükelefi olması durumunda zorunludur.
    NOT : Alıcısının e-Arşiv olup vergi mükellef olmaması durumunda boş geçilebilir.
  • PartyIdentifications

    Bu alana alıcı/göndericinin diğer resmi bilgileri girilebilir. (Bkz. PartyIdentification)

  • AgentPartyIdentifications

    Bu alana aracı kurum'a ait bilgiler girilir. (Bkz. PartyIdentification)

  • ReceiverAlias

    Alıcının e-Fatura mükellefi olması durumunda faturanın hangi etikete gönderileceği bu alanda belirtilir.

    NOT : Herhangi bir değer girilmez ve alıcının birden fazla etiketi varsa fatura Portal üzerinden etiket seçip gönderilebilir. Aksi durumda alıcıya iletilmez!
public class PartyInfo : AddressInfo
{
    public string RegisterNumber { get; set; }
    public string Name { get; set; }


    public string TaxOffice { get; set; }
    public List<PartyIdentification> PartyIdentifications { get; set; }
    public List<PartyIdentification> AgentPartyIdentifications { get; set; }
    public string ReceiverAlias { get; set; }
}

public class AddressInfo
{
    public string Address { get; set; }
    public string District { get; set; }
    public string City { get; set; }
    public string Country { get; set; }
    public string PostalCode { get; set; }
    public string Phone { get; set; }
    public string Fax { get; set; }
    public string Mail { get; set; }
    public string WebSite { get; set; }
}

public class PartyIdentification
{
    public string SchemeID { get; set; }
    public string Value { get; set; }
}

AddressInfo

AddressInfo Nesnesi

  • Address

    Bu alana alıcı/göndericinin adres bilgisi girilir.

  • District

    Bu alana alıcı/göndericinin ilçe bilgisi girilir.

  • City

    Bu alana alıcı/göndericinin şehir bilgisi girilir.

  • Country

    Bu alana alıcı/göndericinin ülke bilgisi girilir.

  • PostalCode

    Bu alana alıcı/göndericinin posta kodu girilir.

  • Phone

    Bu alana alıcı/göndericinin telefon bilgisi girilir.

    NOT : e-Arşiv için elektronik gönderim tipinde SMS gönderilmesi tercih edilirse SMS burada tanımlanan numaraya gidecektir.
  • Fax

    Bu alana alıcı/göndericinin Fax bilgisi girilir.

  • Mail

    Bu alana alıcı/göndericinin Mail bilgisi girilir.

    NOT : e-Arşiv için elektronik gönderim tipinde Mail gönderilmesi tercih edilirse MAIL burada tanımlanan mail adresine gidecektir.
  • WebSite

    Bu alana alıcı/göndericinin web site bilgisi girilir.

public class AddressInfo
{
    public string Address { get; set; }
    public string District { get; set; }
    public string City { get; set; }
    public string Country { get; set; }
    public string PostalCode { get; set; }
    public string Phone { get; set; }
    public string Fax { get; set; }
    public string Mail { get; set; }
    public string WebSite { get; set; }
}

PartyIdentification

PartyIdentification Nesnesi

  • SchemeID

    Bu alana aşağıdaki listeden birisi yazılmalıdır.

  • Value

    Bu alana seçilen tipin değeri girilmelidir.

public class PartyIdentification
{
    public string SchemeID { get; set; }
    public string Value { get; set; }
}

Kod Listeleri

PARA BİRİM KODLARI
Kod Değer Kod Değer Kod Değer
TRY Türk Lirası EGP Mısır Lirası/ Gineih LVL Letonya Latsı
USD Amerikan Doları ERN Nafka LYD Libya Dinarı
EUR Avro ETB Etiyopya Birri MAD Fas Dirhemı
AED Dirhams FJD Fiji Doları MDL Moldovya Leusu
AFN Afgan FKP Falkland Adaları Lirası MGA Madagaskar Ariarisi
ALL Lek GBP İngiliz Sterlini/İngiliz Lirası MKD Makedon Dinarı
AMD Dram GEL Gürcistan Lirası/ Lari MMK Kyat
ANG Antiller Guldeni GHC Cedi MNT Tugrik
AOA Kwanza GIP Cebelitarık Lirası MOP Macau Patakası
ARS Arjantin Pesosu GMD Dalasi MRO Ouguiya
BHD Bahreyn Dinarı GNF Gine Frangı MTL Malta Lirası
BIF Burundi Frankı GTQ Guatemala Kuetzalı MUR Mauritius Rupisi
BMD Bermuda Doları GYD Guyana Doları MVR Maldiv Rupisi Rufiyaa
BND Brunei Doları HKD Hong Kong Doları MWK Kwacha
BOB Bolivya Bolivyanosu HNL Honduras Lempirası MXN Meksika Pesosu
BOV Bolivya Mvdolu HRK Hırvatistan Kunası MYR Malezya Ringgiti
BRL Brazilya Reali HTG Haiti Gourde MZN Mozambik Metikali
BSD Bahama Doları HUF Macar Forinti NAD Namibya Doları
BTN Ngultrum IDR Rupiah NGN Naira
BWP Botsvana Pulası ILS İsrail Yeni Şekeli NIO Kordoba
BYR Belarus Rublesi INR Hindistan Rupisi NOK Norveç Kronu
BZD Belize Doları IQD Irak Dinarı NPR Nepal Rupisi
CAD Kanada Doları IRR İran Riyali NZD Yeni Zelanda Doları
CDF Kongo Frankı ISK İzlanda Kronası OMR Umman Riyali
CHE WIR Euro JMD Jamaika Doları PAB Balboa
CHF İsviçre Frankı JOD Ürdün Dinarı PEN Nuevo Sol
CHW WIR Franc JPY Japon Yeni PGK Kina
CLF Unidades de formento KES Kenya Şilini PHP Filipinler Pesosu
CLP Şili Pesosu KGS Kırgızistan Somu PKR Pakistan Rupisi
CNY Yuan Renminbisi KHR Riel PLN Leh Zlotisi
COP Kolombiya Pesosu KMF Komoro Frankı PYG Guarani
COU Unidad de Valor Real KPW Kuzey Kore Wonu QAR Katar Riyali
CRC Kosta Rika Colonu KRW Güney Kore Wonu ROL Eski Romanya Leyi
CUP Küba Pesosu KWD Kuveyt Dinarı RON Yeni Ley
CVE Cape Verde Escudosu KYD Cayman Adaları Doları RSD Sırbistan Dinarı
CYP Kıbrıs Lirası KZT Kazak Tengesi RUB Rus Rublesi
CZK Çek Korunası LAK Kip RWF Rıanda Frankı
DJF Cibuti Frankı LBP Lübnan Lirası SAR Suudi Riyali
DKK Danimarka Kronu LKR Sri Lanka Rupisi SBD Solomon Adaları Doları
DOP Dominik Pesosu LRD Liberya Doları SCR Seyşeller Rupisi
DZD Cezayir Dinarı LSL Loti SDD Sudan Dinar'ı
EEK Estonya Kronu LTL Litvanya Litası SEK İsveç Kronu
SGD Singapur Doları TJS Somoni VEB Venezuela Bolivarı
SHP Saint Helena Lira TMM Turkmenistan Manatı VND Dong
SIT Tolar TND Tunus Dinarı VUV Vatu
SKK Slovak Korunası TOP Pa'anga WST Samoa Talası
SLL Leone TTD Trinidad ve Tobago Doları XAF CFA Franc BEAC
SOS Somali Şilini TWD Yeni Tayvan Doları SRD Surinam Doları
TZS Tanzanya Şilini XCD Doğu Karayip doları STD Dobra
UAH Ukrayna Grivnası YER Yemen Riyali SYP Suriye Lirası
UGX Uganda Şilini ZAR Güney Afrika Randı SZL Lilangeni
UYU Uruguay Pesosu ZMK Kwacha THB Baht
UZS Özbekistan Somu ZWD Zimbabve Doları
RESMİ BİLGİ KODLARI
  • HIZMETNO
  • MUSTERINO
  • TESISATNO
  • TELEFONNO
  • DISTRIBUTORNO
  • TICARETSICILNO
  • TAPDKNO
  • BAYINO
  • ABONENO
  • SAYACNO
  • EPDKNO
  • SUBENO
  • PASAPORTNO
  • ARACIKURUMETIKET
  • ARACIKURUMVKN
  • CIFTCINO
  • IMALATCINO
  • DOSYANO
  • HASTANO
  • MERSISNO
  • URETICINO
  • KUNYENO
BİRİM KODLARI
Kod Karşılık Değer
C62 Adet
DAY Gün
MON Ay
ANN Yıl
HUR Saat
D61 Dakika
D62 Saniye
PA Paket
BX Kutu
MGM mg
GRM g
KGM Kg
LTR lt
26 ton
NT Net ton
GT Gross ton
MMT mm
CMT cm
MTR m
KTM km
MLT ml
MMQ mm3
CMK cm2
CMQ cm3
MTK m2
MTQ m3
KJO kj
CLT cl
KWH KWH
CCT Ton baş.taşıma kap.
D30 Brüt kalori
D40 1000 lt
LPA Saf alkol lt
B32 kg.m2
NCL Hücre adet
PR Çift
R9 1000 m3
SET Set
Set 1000 adet