HX Muhasebe Entegrasyonu Önemli Bilgiler

Kayıt Bazlı Muhasebe Servisi

Bu methoda entegre olan satıcılarımız,mega merchant(ana satıcı) üzerinden mağaza/bayi bazlı ödeme ve faturaları kontrol edebilir.

❗️

Not

Finansal kayıtlarınız sipariş Teslim Edildi statüsünden sonra oluşmaktadır.

Mega Merchant üzerinden API’den veri alabilirsiniz.Response’da submerchant bilgileri iletilecektir.

  • API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.

Parametreler(Parameters)

MerchantidZorunludur, Her satıcının unique bir tanımlayıcısıdır.
transactionTypesOpsiyoneldir, kayıt tiplerini belirtir. Bu parametre verilmediğinde tüm kayıt tipleri listelenecektir. Spesifik tipler bakılmak istenirse sorgulanacak tipler virgülle ayrılarak yazılabilir. Örnek; transactiontypes=Commission, Payment
recordDateStart – recordDateEnd
dueDateStart – dueDateEnd
orderDateStart – orderDateEnd
paymentDateStart – paymentDateEnd		4 tarih aralığı parametresinden biri girilmek zorundadır. Bir tanesi girildikten sonra kalanlar opsiyonel eklenebilir. orderNumber, packageNumber, sku, invoiceNumber arametrelerinden en az biri verilirse tarih parametreleri zorunlu olmayacaktır.
offset/limitGirişi zorunludur. Offset, kaçıncı kayıttan itibaren gösterileceğini verir. Limit, servisten kaç tane kayıt döneceğini belirler. Limit en fazla 100 olabilir.
Örnek; Kayıtlar yüzer yüzer çekildiğinde yani limiti 100 belirlendiğinde, 3. sayfayı göstermek için offset=200&limit=100 girilecektir.
statusOpsiyoneldir. İlgili kaydın ödeme statüsünü belirtir.
Örnek; status=Paid
Paid : Ödenenler
WillBePaid : Henüz ödenmeyenleri belirtir.
orderNumberOpsiyoneldir. Sipariş numarası olarak geçer.
Örnek; orderNumber=0019531668
packageNumberOpsiyoneldir. Paket numarası
Örnek; packageNumber=0019531668
skuOpsiyoneldir. Ürün Hepsiburada numarasıdır.
Örnek; sku=HBV0000058C3H
invoiceNumberOpsiyoneldir. Kayıt ya da Fatura numarasına karşılık gelir.
Örnek; invoiceNumber=HD12018000104453

📘

Bilgi

transactionTypes parametresi “InvoiceTransactions“ olarak beslendiğinde yalnızca faturalar için listeleme yapılacaktır.

Döviz Cinsi Kodları; currencyCode alanında dönen bilgidir.

currencyCode 949

Açıklama TRY

IsInvoice : Bu alan ilgili kaydın fatura mı değil mi bilgisini döner. True döndüğü durumda kaydın fatura olduğu anlaşılır. False döndüğü durumda kaydın fatura tipinde olmadığı anlaşılır.

IsIncome : Bu alan ilgili kaydın gelir mi gider mi bilgisini döner. True döndüğü durumda geliri ifade eder, false döndüğü durumda gideri ifade eder.

Kayıt Tipi Bilgileri

Transaction Type Açıklama Detay Bilgi
Payment Sipariş tutarı Siparişe ait ürünün satış tutarını ifade etmektedir.
Return İade tutarı İade edilen sipariş tutarlarını ifade etmektedir.
Commission Komisyon tutarı Siparişe ait komisyon faturalarını ifade etmektedir.
CommissionInvoiceRefund Komisyon iadesi Hepsiburada’ya düzenlediğiniz komisyon iade faturaları ile iadesi onaylanan siparişlerinizde, mağazanıza geri ödenen komisyon tutarlarını gösterir.
CommissionRefund Komisyon iade tutarı Siparişe ait iade edilen komisyon faturalarını ifade etmektedir.
ShipmentCostSharingExpense Kargo katkı payı gideri Hepsiburada anlaşmalı kargo desi/fiyat tablosuna ve kampanya süreçlerine göre düzenlenen kargo faturalarıdır.
ShipmentCostSharingIncome Kargo katkı payı iadesi Siparişe ait paketler üzerinden uygulanan kargo giderleri için düzenlenen iade faturalarıdır.
ProcessingFeeExpense Hizmet bedeli Siparişe ait ürünler üzerinden uygulanan hizmet bedeli tutarıdır.
ProcessingFeeExpenseRefund Hizmet bedeli iadesi Hizmet bedeli iade faturalarıdır.
CustomerSatisfaction Müşteri memnuniyeti yansıtma Tedarik gecikmesi ve sipariş iptallerinden doğan işlemler için düzenlenen faturalardır.
CustomerSatisfactionRefund Müşteri memnuniyeti yansıtma iadesi Sipariş gecikme ve iptal ücretlendirmeleri karşılığında düzenlenen iade faturalarıdır.
LineItemTransferExpense Sipariş transfer gideri Tedarik edilemeyen ve iptali sağlanan siparişler için kesilen “sipariş kaydırma” tutarlarını ifade etmektedir.
LineItemTransferIncome Sipariş transfer geliri Sipariş transfer gideri faturaları karşılığında düzenlenen iade faturalarıdır.
CampaignDiscount Kampanya indirimleri Hepsiburada\’ya düzenlediğiniz kampanya faturaları ile Hepsiburada\’nın siparişlerinizde karşıladığı, komisyonunuzdan düşen indirim tutarlarını gösterir.
CampaignDiscountRefund Kampanya indirimleri iadesi Siparişe ait iade edilen kampanya indirimleri faturalarını ifade etmektedir.
RevenueExpense Ciro gideri Anlaşmalı ciro gideri faturalarını ifade etmektedir.
RevenueIncome Ciro geliri Anlaşmalı ciro geliri faturalarını ifade etmektedir.
CargoMargin Kargo marj Siparişe ait paketler üzerinden uygulanan kargo giderleri için düzenlenen iade faturalarıdır.
CargoCompensationIncomeRefund Kargo tazmin geliri iadesi Sipariş tazminleri için kestiğiniz faturaları ifade eder.
MpScrapIncome Hurda geliri Müşteri memnuniyeti adına iadesi onaylanan siparişleriniz için Hepsiburada\’ya düzenlediğiniz faturalardır.
RefusedInvoiceExpenseRefund Reddedilen faturalar Hepsiburada\’ya düzenlenen ancak onaylanmayan faturalardır.
RefusedInvoiceExpense Reddedilen fatura bedeli Hepsiburada\’ya düzenlenen ancak onaylanmayan faturaları ifade etmektedir.
Deposit Depozito tutarı Depozito faturalarını ifade etmektedir.
AdSharingExpense Reklam katılım gideri Reklam katılım bedeli faturalarıdır.
AdSharingExpenseRefund Reklam katılım gideri iadesi Reklam katılım bedeli iade faturalarıdır.
DropShipmentCostSharingExpense Drop kargo katkı payı gideri Hepsiburada anlaşmalı kargo desi/fiyat tablosuna ve kampanya süreçlerine göre düzenlenen kargo faturalarıdır.
DropShipmentCostSharingIncome Drop kargo katkı payı geliri Siparişe ait paketler üzerinden uygulanan kargo giderleri için düzenlenen iade faturalarıdır.
Chargeout Masraf yansıtma tutarı Masraf yansıtma faturalarını ifade etmektedir.
CargoCompensationSellerSatisfactionIncome Kargo tazmin satıcı memnuniyet geliri Satıcı memnuniyeti sebebiyle tarafınızdan alınan iade tazmin faturalarını ifade eder.
MarketingExpense Pazarlama bedeli Pazarlama/reklam faturalarını ifade etmektedir.
MarketingExpenseRefund Pazarlama bedeli iadesi İade edilen pazarlama faturalarını ifade etmektedir.
StudioExpense Stüdyo kullanım bedeli Stüdyo kullanım bedeli faturalarıdır.
PriceDifferenceExpense Fiyat farkı bedeli Maliyetlerde meydana gelen değişikliklerin yansıtıldığı faturaları ifade eder.
PriceDifferenceRefund Fiyat farkı iadesi Maliyetlerde meydana gelen değişikliklerin firma tarafından HB\’ye iletilmesini ifade etmektedir.
LateInterestExpense Vade farkı gideri Vade farkı sebebiyle kesilen faturaladır.
CargoCostRefund Kargo iade Kargo tutar iadesi sebebiyle düzenlediğiniz faturalardır.
RoadAssistanceExpenseRefund Yol yardım iadesi İade edilen yol yardım faturalarını ifade etmektedir.
RoadAssistanceExpense Yol yardım bedeli Yol yardım faturalarını ifade etmektedir.
SponsorshipFee Sponsorluk bedeli Sponsorluk faturalarını ifade etmektedir.
OverseasCommissionRefund Yurtdışı komisyon iadesi Yurtdışı siparişe ait iade edilen komisyon faturalarını ifade etmektedir.
MpScrapExpense Hurda gideri Sipariş özelinde HB\’nın düzenlemiş olduğu memnuniyet faturalarını ifade etmektedir.
MpCompensationIncome MP operasyon departmanı tazmin geliri Kampanya döneminde düzenlenen Hizmet Bedeli faturasının iadesidir.
CargoCompensationExpenseRefund Kargo tazmin gideri iadesi Sipariş tazminleri için düzenlediğiniz faturaların iadesidir.
VAT KDV Katma değer vergisi faturalarını ifade etmektedir.
BalanceCorrection Düzeltme kaydı Muhasebe/Finans tarafından ekstre üzerinde uygulanan ters kayıt işlemlerini ifade etmektedir.
SfsInterest TFS vade farkı TFS işlemi sonrası firmaya yansıtılan tfs gideri
ProductsReportedByService MP servis raporlu ürünler MP Servis Raporlu Ürünler
FacebookAdExpense MP Facebook reklam gideri Facebook reklam katılım bedeli faturalarıdır.
CargoLimitExcessCompensationIncome Kargo limit aşımı tazmin geliri Sipariş tazminleri için kestiğiniz faturaları ifade eder.
OrderBasedTransactions Sipariş bazlı kayıtlar Sipariş bazlı kayıtlarınızı listeler
ContractualOrSpecialCaseTransactions Sözleşmeye bağlı / Özel durum kayıtlar Sözleşmeye bağlı / Özel durum kayıtlarınızı listeler
CommissionSettlementTransactions Komisyon mahsuplaşma kayıtları Komisyon mahsup içerisinde yer alan tüm kayıtlarınızı listeler(Mahsup içerisindeki komisyon, kampanya indirimleri gibi.)
InvoiceTransactions Faturalar Fatura tipindeki kayıtlarınızı listeler
IncomeTransactions Tüm gelir kayıtları Gelir tipindeki tüm kayıtlarınızı listeler
ExpenseTransactions Tüm gider kayıtları Gider tipindeki tüm kayıtlarınızı listeler
AdBalanceTopUpFromAllowance Reklam Bakiye Yüklemesi Hak edişinizden reklam bakiyesi olarak yüklediğiniz tutarı ifade etmektedir. Kullanım detayları için Merchant paneldeki Reklam sayfasını ziyaret edebilirsiniz.
AdBalanceTopUpFromAllowanceRefund Reklam bakiye iadesi Reklam bakiyenizden hak edişinize iade edilen tutarı ifade etmektedir.
MarketingSupportParticipation Pazarlama Destek Katılım Fenomen reklamlarından gelen siparişleriniz için kesilen katılım tutarınızı ifade etmektedir.
MpOutletProductExpense Mp outlet gider kalemi Müşteri memnuniyeti için kestiğiniz fatura tutarının iadesi için kesilen tutarını ifade etmektedir.
BnplOrder BNPL Sipariş Tutarı BNPL Siparişe ait ürünün satış tutarını ifade etmektedir.
BnplRefund BNPL İade Tutarı İade edilen BNPL sipariş tutarlarını ifade etmektedir.

Performans Servisi

Bu methoda entegre olan satıcılarımız,mega merchant(ana satıcı) üzerinden sipariş ve ürün detayı bazında finansal performansı kontrol edebilir.

❗️

Not

Finansal kayıtlarınız sipariş Teslim Edildi statüsünden sonra oluşmaktadır.

Mega Merchant üzerinden API’den veri alabilirsiniz.Response’da submerchant bilgileri iletilecektir.

  • API, HTTP Basic Auth. ile korunmaktadır, dolayısıyla istemci, kullanıcı adı ve şifreyi HTTP Authorization Header bilgisinde göndermelidir.

Parametreler(Parameters)

MerchantidZorunludur, Her satıcının unique bir tanımlayıcısıdır.
orderDateStart – orderDateEnd
dueDateStart – dueDateEnd		2 tarih aralığı parametresinden biri girilmek zorundadır. Bir tanesi girildikten sonra kalanlar opsiyonel eklenebilir.
orderNumber, Sku parametrelerinden en az biri verilirse tarih parametreleri zorunlu olmayacaktır.
Örnek format;
orderDateStart=2021-08-01& orderDateEnd=2021-08-31
dueDateStart=2021-08-01& dueDateEnd=2021-08-31
offset/limitGirişi zorunludur. Offset, kaçıncı kayıttan itibaren gösterileceğini verir. Limit, servisten kaç tane kayıt döneceğini belirler. Limit en fazla 100 olabilir.
Örnek; Kayıtlar yüzer yüzer çekildiğinde yani limiti 100 belirlendiğinde, 3. sayfayı göstermek için offset=200&limit=100 girilecektir.
orderNumberOpsiyoneldir. Sipariş numarası olarak geçer.
Örnek; orderNumber=0019531668
skuOpsiyoneldir. Ürün Hepsiburada numarasıdır.
Örnek; sku=HBV0000058C3H

📘

Bilgi

İstek içerisinde orderNumber, sku parametreleri verilerek çağrım yapılırsa sipariş numarası ve ürün numarasına ait net kazanç, gelir, gider performansı gözlemlenebilir.

Döviz Cinsi Kodları; currencyCode alanında dönen bilgidir.

currencyCode 949

Açıklama TRY

Kayıt Tipi Bilgileri

Transaction Type Açıklama Detay Bilgi
Payment Sipariş tutarı Siparişe ait ürünün satış tutarını ifade etmektedir.
Return İade tutarı İade edilen sipariş tutarlarını ifade etmektedir.
Commission Komisyon tutarı Siparişe ait komisyon faturalarını ifade etmektedir.
CommissionInvoiceRefund Komisyon iadesi Hepsiburada\’ya düzenlediğiniz komisyon iade faturaları ile iadesi onaylanan siparişlerinizde, mağazanıza geri ödenen komisyon tutarlarını gösterir.
CommissionRefund Komisyon iade tutarı Siparişe ait iade edilen komisyon faturalarını ifade etmektedir.
ShipmentCostSharingExpense Kargo katkı payı gideri Hepsiburada anlaşmalı kargo desi/fiyat tablosuna ve kampanya süreçlerine göre düzenlenen kargo faturalarıdır.
ShipmentCostSharingIncome Kargo katkı payı iadesi Siparişe ait paketler üzerinden uygulanan kargo giderleri için düzenlenen iade faturalarıdır.
ProcessingFeeExpense Hizmet bedeli Siparişe ait ürünler üzerinden uygulanan hizmet bedeli tutarıdır.
ProcessingFeeExpenseRefund Hizmet bedeli iadesi Hizmet bedeli iade faturalarıdır.
CustomerSatisfaction Müşteri memnuniyeti yansıtma Tedarik gecikmesi ve sipariş iptallerinden doğan işlemler için düzenlenen faturalardır.
CustomerSatisfactionRefund Müşteri memnuniyeti yansıtma iadesi Sipariş gecikme ve iptal ücretlendirmeleri karşılığında düzenlenen iade faturalarıdır.
LineItemTransferExpense Sipariş transfer gideri Tedarik edilemeyen ve iptali sağlanan siparişler için kesilen “sipariş kaydırma” tutarlarını ifade etmektedir.
LineItemTransferIncome Sipariş transfer geliri Sipariş transfer gideri faturaları karşılığında düzenlenen iade faturalarıdır.
CampaignDiscount Kampanya indirimleri Hepsiburada\’ya düzenlediğiniz kampanya faturaları ile Hepsiburada\’nın siparişlerinizde karşıladığı, komisyonunuzdan düşen indirim tutarlarını gösterir.
CampaignDiscountRefund Kampanya indirimleri iadesi Siparişe ait iade edilen kampanya indirimleri faturalarını ifade etmektedir.
RevenueExpense Ciro gideri Anlaşmalı ciro gideri faturalarını ifade etmektedir.
RevenueIncome Ciro geliri Anlaşmalı ciro geliri faturalarını ifade etmektedir.
CargoMargin Kargo marj Siparişe ait paketler üzerinden uygulanan kargo giderleri için düzenlenen iade faturalarıdır.
CargoCompensationIncomeRefund Kargo tazmin geliri iadesi Sipariş tazminleri için kestiğiniz faturaları ifade eder.
MpScrapIncome Hurda geliri Müşteri memnuniyeti adına iadesi onaylanan siparişleriniz için Hepsiburada\’ya düzenlediğiniz faturalardır.
RefusedInvoiceExpenseRefund Reddedilen faturalar Hepsiburada\’ya düzenlenen ancak onaylanmayan faturalardır.
RefusedInvoiceExpense Reddedilen fatura bedeli Hepsiburada\’ya düzenlenen ancak onaylanmayan faturaları ifade etmektedir.
Deposit Depozito tutarı Depozito faturalarını ifade etmektedir.
AdSharingExpense Reklam katılım gideri Reklam katılım bedeli faturalarıdır.
AdSharingExpenseRefund Reklam katılım gideri iadesi Reklam katılım bedeli iade faturalarıdır.
DropShipmentCostSharingExpense Drop kargo katkı payı gideri Hepsiburada anlaşmalı kargo desi/fiyat tablosuna ve kampanya süreçlerine göre düzenlenen kargo faturalarıdır.
DropShipmentCostSharingIncome Drop kargo katkı payı geliri Siparişe ait paketler üzerinden uygulanan kargo giderleri için düzenlenen iade faturalarıdır.
Chargeout Masraf yansıtma tutarı Masraf yansıtma faturalarını ifade etmektedir.
CargoCompensationSellerSatisfactionIncome Kargo tazmin satıcı memnuniyet geliri Satıcı memnuniyeti sebebiyle tarafınızdan alınan iade tazmin faturalarını ifade eder.
MarketingExpense Pazarlama bedeli Pazarlama/reklam faturalarını ifade etmektedir.
MarketingExpenseRefund Pazarlama bedeli iadesi İade edilen pazarlama faturalarını ifade etmektedir.
StudioExpense Stüdyo kullanım bedeli Stüdyo kullanım bedeli faturalarıdır.
PriceDifferenceExpense Fiyat farkı bedeli Maliyetlerde meydana gelen değişikliklerin yansıtıldığı faturaları ifade eder.
PriceDifferenceRefund Fiyat farkı iadesi Maliyetlerde meydana gelen değişikliklerin firma tarafından HB\’ye iletilmesini ifade etmektedir.
LateInterestExpense Vade farkı gideri Vade farkı sebebiyle kesilen faturaladır.
CargoCostRefund Kargo iade Kargo tutar iadesi sebebiyle düzenlediğiniz faturalardır.
RoadAssistanceExpenseRefund Yol yardım iadesi İade edilen yol yardım faturalarını ifade etmektedir.
RoadAssistanceExpense Yol yardım bedeli Yol yardım faturalarını ifade etmektedir.
SponsorshipFee Sponsorluk bedeli Sponsorluk faturalarını ifade etmektedir.
OverseasCommissionRefund Yurtdışı komisyon iadesi Yurtdışı siparişe ait iade edilen komisyon faturalarını ifade etmektedir.
MpScrapExpense Hurda gideri Sipariş özelinde HB\’nın düzenlemiş olduğu memnuniyet faturalarını ifade etmektedir.
MpCompensationIncome MP operasyon departmanı tazmin geliri Kampanya döneminde düzenlenen Hizmet Bedeli faturasının iadesidir.
CargoCompensationExpenseRefund Kargo tazmin gideri iadesi Sipariş tazminleri için düzenlediğiniz faturaların iadesidir.
VAT KDV Katma değer vergisi faturalarını ifade etmektedir.
BalanceCorrection Düzeltme kaydı Muhasebe/Finans tarafından ekstre üzerinde uygulanan ters kayıt işlemlerini ifade etmektedir.
SfsInterest TFS vade farkı TFS işlemi sonrası firmaya yansıtılan tfs gideri
ProductsReportedByService MP servis raporlu ürünler MP Servis Raporlu Ürünler
FacebookAdExpense MP Facebook reklam gideri Facebook reklam katılım bedeli faturalarıdır.
CargoLimitExcessCompensationIncome Kargo limit aşımı tazmin geliri Sipariş tazminleri için kestiğiniz faturaları ifade eder.
OrderBasedTransactions Sipariş bazlı kayıtlar Sipariş bazlı kayıtlarınızı listeler
ContractualOrSpecialCaseTransactions Sözleşmeye bağlı / Özel durum kayıtlar Sözleşmeye bağlı / Özel durum kayıtlarınızı listeler
CommissionSettlementTransactions Komisyon mahsuplaşma kayıtları Komisyon mahsup içerisinde yer alan tüm kayıtlarınızı listeler(Mahsup içerisindeki komisyon, kampanya indirimleri gibi.)
InvoiceTransactions Faturalar Fatura tipindeki kayıtlarınızı listeler
IncomeTransactions Tüm gelir kayıtları Gelir tipindeki tüm kayıtlarınızı listeler
ExpenseTransactions Tüm gider kayıtları Gider tipindeki tüm kayıtlarınızı listeler
AdBalanceTopUpFromAllowance Reklam Bakiye Yüklemesi Hak edişinizden reklam bakiyesi olarak yüklediğiniz tutarı ifade etmektedir. Kullanım detayları için Merchant paneldeki Reklam sayfasını ziyaret edebilirsiniz.
AdBalanceTopUpFromAllowanceRefund Reklam bakiye iadesi Reklam bakiyenizden hak edişinize iade edilen tutarı ifade etmektedir.
MarketingSupportParticipation Pazarlama Destek Katılım Fenomen reklamlarından gelen siparişleriniz için kesilen katılım tutarınızı ifade etmektedir.
MpOutletProductExpense Mp outlet gider kalemi Müşteri memnuniyeti için kestiğiniz fatura tutarının iadesi için kesilen tutarını ifade etmektedir.
BnplOrder BNPL Sipariş Tutarı BNPL Siparişe ait ürünün satış tutarını ifade etmektedir.
BnplRefund BNPL İade Tutarı İade edilen BNPL sipariş tutarlarını ifade etmektedir.