Fatura ile Garanti Gönderme

Bu servis, fatura bilgileri ile garanti gönderimi yapabilir.

uyarı

externalOrderId değeri entegrasyonu yapan firma tarafında benzersiz bir değer olması önerilir. Bu değer daha sonra garanti silmek için kullanılacaktır.

uyarı

email ve phone değerleri zorunlu değildir ancak en az birinin gönderilmesi önerilir. Hangi alan gönderilirse müşteri bilgisi o alan ile önce veritabanında aranır. Eğer müşteri bilgisi o alan ile bulunamadıysa veya her iki alan da gönderilmez ise email ve phone değerleri benzersiz bir şekilde türetilerek müşteri bilgisi oluşturulur ve veritabanına kaydedilir.

uyarı

serialNumber değeri zorunlu değildir ancak gönderilmesi halinde merchantCode, productCode ve serialNumber değerleri bir grup şeklinde unique olarak search edilmektedir. Bu sayede hem serialNumber değerlerinin bayi bazında unique olması hem de aynı productCode ve serialNumber sahip ürünler için garanti bildirimleri teke indirgenmektedir.
Eğer mevcutta var olan productCode ve serialNumber değerleri ile birlikte tekrar istek atılırsa bu istek hata alacaktır. Bu durumda productCode veya serialNumber değerlerinin kontrol edilmesi gerekmektedir.

uyarı

Ürün bilgisi gönderilirken baz alınan 3 temel alan vardır. Bunlar; name, productCode ve brand alanlarıdır.
Bu alanlar ile ilgili dikkat edilmesi gereken husular aşağıdaki gibidir:

1. productCode alanı mevcut ise bu bilgi veritabanında aranır:
   • Eğer bulunursa garanti aktarımı gerçekleşir.
   • Eğer bulunamazsa ürün ismi gönderilen name alanından ve ürün kodu gönderilen productCode alanından alınarak varsayılan özelliklerde yeni bir ürün oluşturulur ve garanti aktarımı gerçekleşir.
2. productCode mevcut değil ancak brand ve name alanları mevcut ise:
   • Ürün ismi gönderilen name alanından ve marka gönderilen brand alanından alınarak varsayılan özelliklerde yeni bir ürün oluşturulur ve garanti aktarımı gerçekleşir.
3. productCode ve name-brand alanlarının hepsi gönderilirse productCode baz alınarak 1. akış gerçekleşir.
4. productCode ve name-brand alanları gönderilmez ise garanti aktarımı hata alır.

Request

curl --location --request POST '<BASE_URL>/individual-customers/warranty/invoice/with-product-code?merchantCode=<string>'
     --header 'Content-Type: application/json'
     --header 'Authorization: Basic ZGVtbzpwQDU1dzByZA=='
     --data '{
                "externalOrderId": "<string>",
                "sellerCode": "<string>",
                "customer": {
                    "firstName": "<string>",
                    "lastName": "<string>",
                    "email": "<string>",
                    "phone": "<string>",
                    "countryCode": "<enum>"
                },
                "products": [
                    {
                       "name": "<string>",
                       "brand": "<string>",
                       "productCode": "<string>",
                       "serialNumber": "<string>",
                       "externalLineId": "<string>",
                       "purchaseDate": "<string>",
                       "warrantyExpireDate": "<string>"
                    }
                ]
            }'

bilgi

Telefon numarası formatı için aşağıdaki örnekler kullanılabilir:

• 544 333 22 11
• 5443332211
• +905443332211
• 905443332211
• 05443332211

bilgi

purchaseDate ve warrantyExpireDate parametrelerinin formatı 01-01-2023 00:00 şeklinde olmalıdır. purchaseDate parametre gönderilmezse ürünün satın alındığı tarih olarak bugünün tarihi alınır. warrantyExpireDate parametre gönderilmezse ürünün garanti bitiş tarihi ürün bilgisi içerisindeki garanti süresi kadar ileri tarihe alınır.

Request Body

Parametre	Tip	Zorunlu	Açıklama
name	string	Hayır	Garanti gönderilecek ürünün adı
brand	string	Hayır	Garanti gönderilecek ürünün markası
productCode	string	Hayır	Garanti gönderilecek ürünün kodu
serialNumber	string	Hayır	Garanti gönderilecek ürünün seri numarası
sellerCode	string	Evet	Ürünün satışına sahip bayii kodu
firstName	string	Evet	Garanti sahibinin adı
lastName	string	Evet	Garanti sahibinin soyadı
email	string	Hayır	Garanti sahibinin e-posta adresi
phone	string	Hayır	Garanti sahibinin telefon numarası
countryCode	enum	Evet	Ülke kodu
externalOrderId	string	Evet	Fatura kodu veya sipariş numarası
externalLineId	string	Hayır	Fatura içindeki ürünün bilgisi veya kodu
purchaseDate	string	Hayır	Ürünün satın alınma tarihi
warrantyExpireDate	string	Hayır	Ürünün garanti bitiş tarihi

Request Parameters

Parametre	Tip	Zorunlu	Açıklama
merchantCode	string	Evet	Üretici Firma kodu

Country Code Enum

TR
US
DE
GB
AE
NL
FR
UZ

Response

{
  "individualCustomerProductResponseList": [
    {
      "id": 1,
      "lineId": "123456"
    },
    {
      "id": 2,
      "lineId": "1122334455"
    },
    {
      "id": 3,
      "lineId": "987654321"
    }
  ]
}