Change Log

n11’de hayata geçirilecek e-ihracat süreçleri kapsamında entegrasyon servislerimizde bazı geliştirmeler yapılmıştır. Bu geliştirmeler ile e-ihracat siparişlerinde ihtiyaç duyulan bilgilerin servisler aracılığıyla paylaşılması hedeflenmektedir.

Bu kapsamda GetShipmentPackages (Sipariş Listeleme) ve SendInvoiceLink (Fatura Link Yükleme) servislerine yeni alanlar eklenmiştir. Yapılan geliştirmeler mevcut servis yapısında herhangi bir değişikliğe neden olmamakta olup, mevcut entegrasyonlarınızın çalışmasını etkilemeyecektir.

1. Sipariş Listeleme Servisi (GetShipmentPackages)

E-ihracat siparişlerinde ihtiyaç duyulan bilgilerin paylaşılabilmesi amacıyla servis response yapısına yeni alanlar eklenmiştir.

• Billing Address altında yer alan countryCode alanı, alıcının ülke bilgisini içermektedir.
• Lines altında yer alan productOrigin alanı, ürünün menşei bilgisini içermektedir.
• Content altında yer alan micro alanının true olması, siparişin e-ihracat kapsamında olduğunu göstermektedir.

Ayrıca e-ihracat süreçlerinde ihtiyaç duyulan hsCode, invoiceLink, invoiceDate, etgbNo ve etgbDate alanları da sipariş içeriğine eklenmiştir.

E-ihracat kapsamındaki siparişlerde micro alanı true olarak iletilecektir. Bu siparişler için faturaların ihracat faturası olarak düzenlenmesi ve ilgili fatura bilgilerinin servisler aracılığıyla n11’e iletilmesi gerekmektedir.

2. Fatura Link Gönderme Servisi (SendInvoiceLink)

E-ihracat siparişlerine ait fatura bilgilerinin iletilebilmesi amacıyla SendInvoiceLink servisine yeni alanlar eklenmiştir.

Bu alanlar yalnızca e-ihracat kapsamındaki siparişlerde, micro alanının true olarak iletilmesi durumunda kullanılacaktır.

Bu siparişler için servis isteğinde mevcut alanlara ek olarak invoiceDateTime (fatura tarihi) ve invoiceNumber (fatura numarası) alanlarının da gönderilmesi gerekmektedir.

Konuya ilişkin sorularınızı sellerintegration@n11.com adresine iletebilirsiniz.

Entegrasyon sürecinde kullandığınız paket bölme servis cevabına yeni parametreler eklenmiştir.

Mağazanızda Paket Bölme Servisi kullanılmakta ise, kullandığınız entegratör firma veya ilgili teknik ekiplerin konu hakkında bilgilendirilmesini rica ederiz.

Mevcut servis yapısında herhangi bir değişiklik yapılmamıştır. Yalnızca servis cevabına splitPackageOrderItems alanı eklenmiştir.

Eklenen alan içerisinde aşağıdaki parametreler yer almaktadır:

• orderNumber
• packageId
• stockCode
• quantity

Güncel Response örneği aşağıda paylaşılmıştır.

{
    "code": 200,
    "message": "success",
    "splitPackageOrderItems": [
        {
            "orderNumber": "207291931337",
            "packageId": "112152753274970",
            "orderLineId": 466969524,
            "stockCode": "SplitQTY-5",
            "quantity": 2
        },{
        "orderNumber": "207291931337",
        "packageId": "112617253822254",
        "orderLineId": 466969525,
        "stockCode": "SplitQTY-6",
        "quantity": 2
        }
    ]
}

Herhangi bir sorun yaşamanız halinde sellerintegration@n11.com adresi üzerinden bizimle iletişime geçebilirsiniz.

15 Ekim itibariyle, müşterilerden TCKN bilgisinin talep edilmesi zorunluluğu kaldırılacaktır.

Bu değişiklikle birlikte, entegrasyon sipariş servisinde yer alan “tcId”: “11111111111” alanı, TCKN bilgisi bulunmayan müşteriler için boş olarak dönecektir.

Entegrasyon ve Muhasebe sistemlerinizde herhangi bir uyumsuzluk yaşanmaması için, ilgili ekiplerinizi ve entegrasyon firmanızı bu değişiklik hakkında bilgilendirmenizi rica ederiz. Sorularınız için: sellerintegration@n11.com mail adresine mail atabilirsiniz.

Etkilenen Servisler:

• RestAPI: GetShipmentPackages
• SOAP: DetailedOrderList, OrderDetail , OrderList

Mevcut süreçte n11 Kategori Servisleri’ne erişim için API Key & Secret zorunlu değildi; ancak 15 Ağustos 2025 itibarıyla bu bilgiler olmadan servislerimiz çalışmayacaktır. Servislerinizin kesintisiz devam etmesi için gerekli güncellemeleri yapmanızı rica ederiz.

Kategori entegrasyonu kullanıyorsanız, mağduriyet yaşamamanız adına entegratör firmanıza bu bilgilendirmeyi iletmenizi önemle rica ederiz.

Sorularınız için: sellerintegration@n11.com

Mevcut süreçte n11 Kategori Servisleri’ne erişim için API Key & Secret zorunlu değildi; ancak 15 Ağustos 2025 itibarıyla bu bilgiler olmadan servislerimiz çalışmayacaktır. Servislerinizin kesintisiz devam etmesi için gerekli güncellemeleri yapmanızı rica ederiz.

Kategori entegrasyonu kullanıyorsanız, mağduriyet yaşamamanız adına entegratör firmanıza bu bilgilendirmeyi iletmenizi önemle rica ederiz.

Sorularınız için: sellerintegration@n11.com

Entegratör kullanıyorsanız ve işçilik bedeli eklenecek kategorilerde satış yapıyorsanız ( altın, pırlanta vb. ) aşağıdaki bilgilendirmeyi Entegratör firmanız ile paylaşmanızı rica ederiz.

LaborCost Rest API servisimiz yayına alınmıştır.

Bu servis üzerinden orderLineId bazında işçilik bedeli ve işçilik bedeli KDV oranı gönderebilirsiniz.

Soru ve talepleriniz için sellerintegration@n11.com

Yapılan bu güncelleme ile birlikte siparişiniz kargoya verilene kadar alıcı tarafından direkt iptal edilebilecektir. İptal sonrası kargo kampanya numaraları geçersiz olacaktır.

Parçalı iptallerde ise, (Örneğin: Tek siparişteki 2 üründen birinin iptal edilmesi) kargo kampanya kodu güncellenecektir ve yeni kampanya kodu üzerinden kalan ürünün gönderimini sağlayabileceksiniz.

Daha öncesinde Aralık sonu itibarı ile kapatılacağı hakkında bilgilendirmesini yaptığımız, aşağıdaki tabloda yer alan SOAP servislerimiz kapatılmıştır.

Mağazanızda ürün entegrasyonu kullanıyorsanız, mağduriyet yaşamamanız adına entegratör firmanıza bu bilgilendirmeyi iletmenizi önemle rica ederiz.

Sipariş Listeleme, Sipariş Onaylama ve Sipariş Bölme servislerinin RestApiye geçişi tamamlanmıştır.

RestApi Sipariş Listeleme servislerinden değişiklikler

• • Siparişlerin paket mantığına geçişi
  • Kısmi iptalden sonra kargo kodunun değişimi
  • Sipariş teslim edilene kadar yaşanacak tüm statüleri tek istekle alabilme
  • Sipariş için oluşan paketlerin onaylanması

Bilgi ve görüşleriniz için sellerintegration@n11.com mail adresine ulaşabilirsiniz.

API üzerinden gönderim sağlayan entegratörlerinizi ve/veya yazılım geliştiricilerinizi bilgilendirmenizi önemle rica ederiz.

REST servis geçiş sürecinde öncelikli olarak Stok-Fiyat Güncelleme (UpdateProductPriceStock) ve Ürün Güncelleme (UpdateProduct) servislerimizi aktif ediyoruz. Ürün açma servisimiz ilerleyen süreçlerde aktif edilecektir.

Bu geçiş ile birlikte stok ve fiyat güncellemelerinizi tek seferde 1000 SKU’ya kadar gönderebileceksiniz. Batch yapısına geçiş yapılması sebebiyle Stok-Fiyat Güncelleme (UpdateProductPriceStock) ve Ürün Güncelleme (UpdateProduct) servislerinden işleminize ait bir ProcessId değeri dönecektir. Yapılan işlemin durumu ve detayını sorgulayabileceğiniz İşlem Durumu Sorgulama (GetTaskStatus) ve İşlem Durum Detay Sorgulama (GetTaskDetails) servislerimiz de canlıya alınmıştır.