Bayi ve Müşteri Bilgilerini Sorgulama
Açıklama
ERP'nizdeki bayi, alt bayi, alt müşteri ve müşteri kayıtlarını sorgulamak için.
Tek Bir Kaydı Sorgulama
URL:/erp/agent/codeOrErpCode
Method: GET
- codeOrErpCode yerine üyenin üye kodunu veya ERP kodunu yazıyorsunuz.
Header: AccessToken'ı unutmayın! (Bkz: 2.1 AccessToken Oluşturma)
- Örnek Response Bayi & Alt bayi (tekil)
- Örnek Reponse Müşteri & Alt müşteri (tekil)
- Örnek CURL
{
"id": "d76272b4-7526-416b-afa7-98c5743fbb88",
"isActive": true,
"name": "Ana bayi",
"code": "NT44276512",
"erpCode": "",
"taxNumber": "00000000000",
"taxOffice": null,
"email": null,
"phone": "5000000000",
"cityName": null,
"districtName": null,
"address": null,
"parentTenantId": "2e64d939-d56f-4c78-a76f-84d0d445067b",
"parentTenantCode": "Test",
"parentTenantName": "Test",
"isIndividual": true,
"paymentExCurrencyType": null,
"users": [
{
"id": "0dfc31f9-8614-40ef-b055-e72da84f002a",
"name": "Kullanıcı 2",
"surname": ".",
"email": "[email protected]",
"gsm": "5000000000",
"canUseMobile": true,
"description": "",
"roles": [
"Bayi Admin"
],
"paymentExCurrencyType": "8e6cc739-83e0-4af5-accf-a55476e758c6",
"code": ""
},
{
"id": "db0b3d24-a678-474c-9134-e73542265a9f",
"name": "Ana bayi kullanıcı Test",
"surname": ".",
"email": "[email protected]",
"gsm": "5000000000",
"canUseMobile": true,
"description": ".",
"roles": [
"Anasayfa Rolü"
],
"paymentExCurrencyType": "8e6cc739-83e0-4af5-accf-a55476e758c6",
"code": "AYS123456Test"
}
]
}
{
"id": "e8362a52-013a-44f9-8479-704eea249095",
"isActive": true,
"name": "John Doe",
"code": "741147",
"erpCode": "erpCode",
"taxNumber": 00000000000,
"taxOffice": "test",
"email": "[email protected]",
"phone": "5000000000",
"cityName": "Adıyaman",
"districtName": "Merkez",
"address": "test test test",
"parentTenantId": "00000000-0000-0000-0000-000000000000",
"parentTenantCode": null,
"parentTenantName": "Test",
"isIndividual": true,
"paymentExCurrencyType": "8e6cc739-83e0-4af5-accf-a55476e758c6",
"users": null
}
curl --location 'https://prodtest_gw.finrota.com/erp/agent/741147' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzY29wZSI6WyJjYXR2MS5hcGkiLCJ2ZW5kb3J2MS5hcGkiLCJlcnB2MS5hcGkiXSwiYWN0b3J0Ijoic2VydmljZSIsInJvbGUiOiJzZXJ2aWNlIiwiVW5pcXVlIjoiODI3MGVkYjAtYmMzOC00MmNlLTgzMGUtMWM4YTBkOGM4YmZmIiwiVGVuYW50SWQiOiIyZTY0ZDkzOS1kNTZmLTRjNzgtYTc2Zi04NGQwZDQ0NTA2N2IiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL2V4cGlyYXRpb24iOiI2Mzg5Mzk1NTYyNTc1MTM0NzkiLCJuYmYiOjE3NTgxODYwMjUsImV4cCI6MTc1ODM1ODgyNSwiaWF0IjoxNzU4MTg2MDI1LCJpc3MiOiJzc28uYXBpIiwiYXVkIjoiZWNvenVtLnNzbyJ9.U6DsAzdcA5YPRBqcP16FVDaw2cSN6SShFpiitJcCsyQ'
Birden Fazla Kaydı Sorgulama (Listeleme)
URL
- Bayi/Alt Bayi için:
/erp/agent?type=dealer\&page=1\&pageSize=10\&name=John+Doe - Müşteri/Alt Müşteri:
erp/agent?type=customer\&page=1\&pageSize=10\&name=John+Doe
Method: GET
Header: AccessToken'ı unutmayın! (Bkz: 2.1 AccessToken Oluşturma)
Filters: İsim, kod, erp kod, e-posta, telefon, tckn, vkn, kullanıcı adı ve kullanıcı kodu gibi kriterlere göre filtreleme yapabilirsiniz. Eğer filtre girmezseniz, sayfalandırmaya göre sonuç alırısnız.
| Parametre | Açıklama |
|---|---|
| name | Firma adı |
| code | Üye kodu |
| erpCode | Üye ERP kodu |
| E‑posta | |
| phone | Telefon |
| tckn | T.C. Kimlik No |
| vkn | Vergi Kimlik No |
Sayfalama
page (hangi sayfa) ve pageSize (sayfa başına kaç kayıt) ile sonuçları düzenleyebilirsiniz.
| Parametre | Tip | Varsayılan | Açıklama |
|---|---|---|---|
| page | int | 1 | Getirilecek sayfa |
| pageSize | int | 10 | Sayfa başına kayıt |
Not:
- Bayi, Alt bayi, Müşteri veya Alt Müşteri bireysel ise taxNumber alanında TCKN değerini göreceksiniz.
- Bayi, Alt bayi, Müşteri veya Alt Müşteri üyelerin Adres bilgileri eksiksiz olmalı. Eksik değer olması durumunda hata alırsınız.
Örnek Yanıt (liste)
- Örnek Yanıt(liste)
- Örnek CURL
{
"data": [
{
"id": "e8362a52-013a-44f9-8479-704eea249095",
"isActive": true,
"name": "John Doe",
"code": "741147",
"erpCode": "erpCode",
"taxNumber": "00000000000",
"taxOffice": "test",
"phone": null,
"email": "[email protected]",
"countryCode": null,
"cityName": "Adıyaman",
"districtName": "Merkez",
"address": "test test test",
"parentTenantId": "2e64d939-d56f-4c78-a76f-84d0d445067b",
"parentTenantName": "Test",
"parentTenantCode": "Test",
"isIndividual": true,
"paymentExCurrencyType": "8e6cc739-83e0-4af5-accf-a55476e758c6"
}
],
"currentPage": 1,
"rowCount": 1,
"pageCount": 1
}
curl --location 'https://prodtest_gw.finrota.com/erp/agent?type=customer&page=1&pageSize=10&name=John+Doe' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzY29wZSI6WyJlcnB2MS5hcGkiLCJjYXR2MS5hcGkiLCJ2ZW5kb3J2MS5hcGkiXSwiYWN0b3J0Ijoic2VydmljZSIsInJvbGUiOiJzZXJ2aWNlIiwiVW5pcXVlIjoiMmNjMWFkZDUtYTZmZi00ZjMxLWE0YzYtYzdlMzYwNzdhODNlIiwiVGVuYW50SWQiOiIyZTY0ZDkzOS1kNTZmLTRjNzgtYTc2Zi04NGQwZDQ0NTA2N2IiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL2V4cGlyYXRpb24iOiI2Mzg5NDI5OTk0Mjg2MDU3ODkiLCJuYmYiOjE3NTg1MzAzNDIsImV4cCI6MTc1ODcwMzE0MiwiaWF0IjoxNzU4NTMwMzQyLCJpc3MiOiJzc28uYXBpIiwiYXVkIjoiZWNvenVtLnNzbyJ9.9oo4RgktUmuN6MZ3W4h9jOdZXHlEHC_e0KPOCFy2Jag' \
--data ''