Fatura ile Garanti Gönderme
Bu servis, fatura bilgileri ile garanti gönderimi yapabilir.
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.
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.
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.
Ü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:
- 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.
- 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.
- productCode ve name-brand alanlarının hepsi gönderilirse productCode baz alınarak 1. akış gerçekleşir.
- 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>"
}
]
}'
Telefon numarası formatı için aşağıdaki örnekler kullanılabilir:
- 544 333 22 11
- 5443332211
- +905443332211
- 905443332211
- 05443332211
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ı |
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 |
TR
US
DE
GB
AE
NL
FR
UZ
Response
{
"individualCustomerProductResponseList": [
{
"id": 1,
"lineId": "123456"
},
{
"id": 2,
"lineId": "1122334455"
},
{
"id": 3,
"lineId": "987654321"
}
]
}