Hepsiburada API · Sipariş ve paket

Hepsiburada fatura linki gönderme

Hepsiburada'da fatura, paket numarasıyla bir bağlantı (URL) olarak iletilir. Faturası yüklenmemiş paketler OMS servisindeki missing-invoice listesinde görünür. Saystok'un kodunda bu işlem paket numarası ve invoiceUrl alanıyla kurgulanmıştır. Bağlantı herkese açık, kalıcı ve doğrudan faturaya giden bir https adresi olmalıdır. İletimden sonra paketin bu listeden çıktığını kontrol edin.

Akış

AdımİşlemKaynak
1Fatura bekleyen paketleri bulun/packages/merchantid/SATICI_ID/missing-invoice
2Siparişin faturasını kesinE-arşiv ya da e-fatura sistemi
3Faturanın kalıcı bağlantısını alınFatura sistemi
4Bağlantıyı paket numarasıyla iletinPaket fatura işlemi (invoiceUrl)
5Paketin listeden düştüğünü doğrulayınmissing-invoice listesi

Birinci ve beşinci adımlar canlıda doğrulanmış uçlarla yapılır. Dördüncü adımın yolu canlıda doğrulanmadı; güncel yol için resmî dokümandaki paket bölümüne bakın.

Bağlantı kuralları

  • https ile başlamalı: müşteri faturayı güvenli bir bağlantıyla açmalıdır.
  • Kalıcı olmalı: birkaç saat sonra süresi dolan imzalı bağlantılar, müşteri faturayı açmak istediğinde çalışmaz.
  • Doğrudan faturaya gitmeli: giriş sayfası ya da yönlendirme zinciri olmamalı.
  • Herkese açık olmalı: oturum ya da şifre istememeli.
  • Tek pakete ait olmalı: birden çok siparişin faturasını içeren bir dosya, müşterilerin birbirinin bilgisini görmesine yol açar.

Kişisel veri taşıyan bir belgeyi tahmin edilemeyen bir adreste tutun. Sıralı numaralarla erişilen bağlantılar, başkalarının faturalarına ulaşılmasını kolaylaştırır.

Fatura kesimi tarafı

Pazaryeri satışında fatura satıcı tarafından kesilir. E-arşiv faturada siparişin verildiği internet sitesi bilgisi de yer alır; Hepsiburada siparişinde bu adres Hepsiburada'nın sitesidir. Müşterinin adı ve adresi sipariş detayından alınır.

  • Fatura adresi ile teslimat adresi farklı olabilir; sipariş yanıtında ayrı fatura adresi varsa onu kullanın.
  • Tutarı kalemlerin toplamından hesaplayın.
  • Kesilen faturanın numarasını ve bağlantısını paket numarasıyla birlikte saklayın.

Temel kavramlar e-ticarette fatura, e-arşiv ve vergi yazısında anlatılıyor.

Neden önemli?

Fatura bekleyen paketler listesi, faturası iletilmemiş paketlerin listesidir. Bu listede uzun süre bekleyen paketler, operasyonda bir şeyin aksadığını gösterir. Listeyi her gün kontrol etmek, ay sonunda biriken faturasız siparişleri önler.

Muhasebe tarafında da tutarlılık kazanırsınız: her paketin bir faturası, her faturanın bir paketi olur. Kâr-zarar hesabında sipariş tutarı ile fatura tutarını karşılaştırmak hataları erken yakalar.

Bağlantıyı fatura sisteminden pazaryerine elle taşımak, yoğun günlerde atlanan paketler üretir. Kesilen her faturanın paket numarasını ve bağlantısını aynı kayıtta tutun; eksikleri missing-invoice listesiyle karşılaştırarak kolayca bulursunuz.

Sık hatalar ve çözümleri

BelirtiOlası nedenÇözüm
Müşteri faturayı açamıyorBağlantının süresi doldu ya da oturum istiyorKalıcı, herkese açık bağlantı kullanın
Paket fatura bekleyenlerde kaldıBağlantı yanlış pakete gönderildiPaket numarasını sipariş detayından doğrulayın
Bağlantı reddedildiEksik ya da geçersiz adresTam ve https ile başlayan adres gönderin
Bozulan paketin faturası kaybolduPaket yeniden kurulduYeni paket numarasıyla bağlantıyı yeniden iletin

Sık sorulanlar

Hepsiburada'ya fatura nasıl gönderilir?

Fatura, paket numarasıyla bir bağlantı (URL) olarak iletilir. Güncel yol için resmî dokümandaki paket bölümüne bakın.

Faturası gönderilmemiş paketleri nasıl bulurum?

OMS servisinde GET /packages/merchantid/SATICI_ID/missing-invoice ucuyla.

Fatura bağlantısı nasıl olmalı?

https ile başlayan, kalıcı, herkese açık ve doğrudan faturaya giden bir adres.

Paket bozulursa fatura bağlantısı ne olur?

Yeni paket numarası oluşur. Bağlantıyı yeni paket için yeniden iletin.

Faturayı ne zaman iletmeliyim?

Paket oluştuktan sonra, kargo firması paketi teslim almadan önce. Fatura bekleyen paketler listesini her gün kontrol etmek gecikmeleri ve ay sonunda biriken faturasız siparişleri önler.

Kaynaklar

İlgili Hepsiburada API konuları

Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı

Hepsiburada entegrasyonunu kod yazmadan kurun

Saystok bu API'lerle stok, sipariş ve fiyatı sizin yerinize eşitler. 30 gün ücretsiz.