Download OpenAPI specification:Download
This is the API documentation for Myra - an internal project covering full account management (accounts, brands, users) and transaction tracking with some management/reporting functionality.
This call returns the general parameters to use as multiple select options like packages, regions, accountManagers etc.
{- "accountManagers": [
- {
- "name": "Vildan",
- "email": "vildan@faselis.com",
- "phone": "0533 555 55 55",
- "id": "jshieid-26363-dndjs-2123"
}, - {
- "name": "Seckin",
- "email": "seckin@faselis.com",
- "phone": "0533 555 55 95",
- "id": "ewdewd-26363-dndj9-2123"
}
], - "packages": [
- {
- "name": "Agency Starter",
- "code": "as"
}, - {
- "name": "Agency Pro",
- "code": "ap"
}, - {
- "name": "Corporate Gold",
- "code": "cl"
}
]
}
Initial login call to get accessToken
All requests to this call have to include a username and password property in the request body object.
username required | string |
password required | string |
{- "username": "aydin.sun@faselis.com",
- "password": "test12"
}
{- "statusCode": 200,
- "login": true,
- "Cookie": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEyMzQ1IiwibmFtZSI6IkVsdmlzIFByZXNsZXkiLCJpYXQiOjE1MTYyMzkwMjJ9.QtUKYTdPEkkD3azc5CzgeVGgdjjPkFO5obWSAQ0Laho"
}
Requests a new password when the user forgots.
Username is required for new password request.
This call returns 200 even if there is no such user.
username required | string |
{- "username": "ozer.subasi@faselis.com"
}
{- "statusCode": 200,
- "username": "ozer.subasi@faselis.com",
- "isSend": true
}
This call fetches the logged-in Myra user's profile details.
{- "statusCode": 200,
- "body": {
- "userInfo": {
- "email": "emek.tuzun@faselis.com",
- "fullname": "Emek Tüzün",
- "region": "tr",
- "title": "İş Geliştirme Yöneticisi",
- "finance": true
}
}
}
This call updates the password of current Myra user.
The current password, a new password (newPassword) and the new password duplication (newPasswordControl) are required in the request body.
If the given current password is invalid, a 403 forbidden response is returned.
email required | string |
password required | string |
newPassword required | string |
newPasswordControl required | string |
{- "email": "ozer.subasi@faselis.com",
- "password": "currentxxxxpassword",
- "newPassword": "strongxxxxpassword",
- "newPasswordControl": "strongxxxxxpassword"
}
{- "statusCode": 200,
- "body": {
- "userInfo": {
- "email": "emek.tuzun@faselis.com",
- "fullname": "Emek Tüzün",
- "region": "tr",
- "title": "İş Geliştirme Yöneticisi",
- "finance": true
}
}
}
Accounts can be listed by filtering according to their Account Name, Company Name, Brand Name, User Name, User E-mail, Account Manager, Type, Package, Status, Payment Type and Contract End Date.
In addition, if balance parameter is set to be true, then the return object includes the balance value.
The filtering parameters should be sent. None is required. Missing parameters will not be used in filtering algorithm. If an ampty request body is sent, all the accounts will be returned. Try to set some defaults to prevent overload on the servers.
page | integer |
numberOfItems | integer |
name | string |
companyName | string |
brandName | string |
userName | string |
string | |
object | |
type | string Default: "Corporate" Enum: "Agency" "Corporate" "Sponsored" |
packageCode | string |
onlyActive | boolean |
showBalance | boolean |
paymentTypes | Array of strings |
contractEndDate | string <date> |
{- "page": 1,
- "numberOfItems": 10,
- "name": "Bersay",
- "companyName": "Bersay İletişim Danışmanlığı",
- "brandName": "Gravital",
- "userName": "Demir",
- "email": "a.demir@bersay.com.tr",
- "accountManager": {
- "id": "jcdkje-2321-cw-123"
}, - "type": "Corporate",
- "packageCode": "as",
- "onlyActive": true,
- "showBalance": false,
- "paymentTypes": [
- "Monthly"
], - "contractEndDate": "2021-12-31"
}
{- "statusCode": 200,
- "body": {
- "accounts": [
- {
- "id": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "name": "Bersay",
- "type": "Agency",
- "package": "as",
- "payment": "Monthly",
- "accountManager": {
- "id": 2222,
- "name": "Vildan",
- "email": "vildan@faselis.com",
- "phone": "0533 555 55 55"
}, - "balance": {
- "TL": 3000,
- "EUR": 0,
- "USD": 1000
}
}, - {
- "id": "e5b9f136-7b0f-45e1-98e2-58325fa08c84",
- "name": "Goleon",
- "type": "Agency",
- "package": "cl",
- "payment": "Upfront",
- "accountManager": {
- "id": 1111,
- "name": "Seckin",
- "email": "seckin@faselis.com",
- "phone": "05325555555"
}, - "balance": {
- "TL": 200,
- "EUR": 0,
- "USD": 0
}
}
]
}
}
Creates account and returns an accountId
Account data including accountName, manager, accountType and contact
accountName | string |
accountManagerId | string |
status | boolean |
accountType | string |
userName | string |
title | string |
mobilePhone | string |
string | |
webSite | string |
address | string |
officePhone | string |
postalCode | string |
state | string |
country | string |
package | string |
paymentType | string |
sendOnlyTest | boolean |
currency | string |
invoicing | string |
agreementFileName | string |
agreementExpireDate | string |
companyFullName | string |
taxPerson | string |
taxPersonPosition | string |
taxPersonPhone | string |
taxPersonEmail | string |
taxOffice | string |
taxNo | string |
invoiceAddress | string |
accountingCode | string |
note | string |
{- "accountName": "Faselis Development",
- "accountManagerId": "245",
- "status": 1,
- "accountType": "1",
- "userName": "Ozer SUBASI",
- "title": "Software Engineer",
- "mobilePhone": null,
- "email": "development.test@faselis.com",
- "webSite": "",
- "address": "",
- "officePhone": "",
- "postalCode": "",
- "state": "",
- "country": "",
- "package": "ax",
- "paymentType": "",
- "sendOnlyTest": 0,
- "currency": "",
- "invoicing": "",
- "agreementFileName": "cdn/test",
- "agreementExpireDate": "2020-09-09",
- "companyFullName": "Faselis Development A.Ş.",
- "taxPerson": "Emek Tuzun",
- "taxPersonPosition": "CTO",
- "taxPersonPhone": "0000000000",
- "taxPersonEmail": "emek.tuzun@faselis.com",
- "taxOffice": "Beyoğlu V.D.",
- "taxNo": "32525235",
- "invoiceAddress": "Hacımimi",
- "accountingCode": "007",
- "note": "Bu bir test notudur."
}
{- "statusCode": 200,
- "body": {
- "account": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "name": "Goleon Veri Teknolojileri Ltd. Şti.",
- "type": "Agency",
- "package": "ax",
- "status": true,
- "isHold": false,
- "brandCounts": {
- "total": 2,
- "sub": 14
}, - "financeManagement": { },
- "credits": { },
- "contact": {
- "name": "ceylan.bol",
- "title": "Pazarlama Yöneticisi",
- "email": "c.bol@goleon.com",
- "officePhone": ""
}, - "agreement": [
- {
- "closeDate": "2021-01-01",
}, - {
- "closeDate": "2020-12-01",
}, - {
- "closeDate": "2020-11-01",
}
]
}
}
}
This call returns the details of a specified account with path parameter accoundId
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
{- "statusCode": 200,
- "body": {
- "account": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "name": "Goleon Veri Teknolojileri Ltd. Şti.",
- "type": "Agency",
- "package": "ax",
- "status": true,
- "isHold": false,
- "accountManager": {
- "name": "Vildan",
- "email": "vildan@faselis.com",
- "phone": "0533 555 55 55",
- "id": "jshieid-26363-dndjs-2123"
}, - "brandCounts": {
- "total": 2,
- "sub": 14
}, - "financeManagement": { },
- "credits": { },
- "contact": {
- "name": "ceylan.bol",
- "title": "Pazarlama Yöneticisi",
- "email": "c.bol@goleon.com",
- "officePhone": ""
}, - "agreement": [
- {
- "closeDate": "2021-01-01",
}, - {
- "closeDate": "2020-12-01",
}, - {
- "closeDate": "2020-11-01",
}
]
}
}
}
In Details page, updates account info
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
Account data including accountName, manager, accountType and contact
accountName | string |
accountId | string |
accountManagerId | string |
status | boolean |
accountType | string |
userName | string |
title | string |
mobilePhone | string |
string | |
webSite | string |
address | string |
officePhone | string |
postalCode | string |
state | string |
country | string |
package | string |
paymentType | string |
sendOnlyTest | boolean |
currency | string |
invoicing | string |
agreementFileName | string |
agreementExpireDate | string |
companyFullName | string |
taxPerson | string |
taxPersonPosition | string |
taxPersonPhone | string |
taxPersonEmail | string |
taxOffice | string |
taxNo | string |
invoiceAddress | string |
accountingCode | string |
note | string |
{- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "accountName": "Faselis Development",
- "accountManagerId": "245",
- "status": 1,
- "accountType": "1",
- "userName": "Ozer SUBASI",
- "title": "Software Engineer",
- "mobilePhone": null,
- "email": "development.test@faselis.com",
- "webSite": "",
- "address": "",
- "officePhone": "",
- "postalCode": "",
- "state": "",
- "country": "",
- "package": "ax",
- "paymentType": "",
- "sendOnlyTest": 0,
- "currency": "",
- "invoicing": "",
- "agreementFileName": "cdn/test",
- "agreementExpireDate": "2020-09-09",
- "companyFullName": "Faselis Development A.Ş.",
- "taxPerson": "Emek Tuzun",
- "taxPersonPosition": "CTO",
- "taxPersonPhone": "0000000000",
- "taxPersonEmail": "emek.tuzun@faselis.com",
- "taxOffice": "Beyoğlu V.D.",
- "taxNo": "32525235",
- "invoiceAddress": "Hacımimi",
- "accountingCode": "007",
- "note": "Bu bir test notudur."
}
{- "statusCode": 200,
- "body": {
- "account": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "name": "Goleon Veri Teknolojileri Ltd. Şti.",
- "type": "Agency",
- "package": "ax",
- "status": true,
- "isHold": false,
- "accountManager": {
- "name": "Vildan",
- "email": "vildan@faselis.com",
- "phone": "0533 555 55 55",
- "id": "jshieid-26363-dndjs-2123"
}, - "brandCounts": {
- "total": 2,
- "sub": 14
}, - "financeManagement": { },
- "credits": { },
- "contact": {
- "name": "ceylan.bol",
- "title": "Pazarlama Yöneticisi",
- "email": "c.bol@goleon.com",
- "officePhone": ""
}, - "agreement": [
- {
- "closeDate": "2021-01-01",
}, - {
- "closeDate": "2020-12-01",
}, - {
- "closeDate": "2020-11-01",
}
]
}
}
}
Returns activation history array
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
{- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "status": true,
- "isHold": false,
- "activationHistory": [
- {
- "action": "Activate",
- "holdAciton": "Hold",
- "owner": "Owner name",
- "person": "Person name",
- "reason": "Finance",
- "Note": "No active brand"
}, - {
- "action": "Activate",
- "holdAction": "Unhold",
- "owner": "Owner name",
- "person": "Person name",
- "reason": "Finance",
- "Note": "No active brand"
}, - {
- "action": "Disactivate",
- "holdAction": "Unhold",
- "owner": "Owner name",
- "person": "Person name",
- "reason": "Finance",
- "Note": "No active brand"
}
]
}
Adds new action and returns action history
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
action | string |
holdAction | string |
actionBy | string |
reason | string |
note | string |
{- "action": "Open",
- "holdAction": "Unhold",
- "actionBy": "Person name",
- "reason": "Finance",
- "Note": "No active brand"
}
{- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "status": true,
- "isHold": false,
- "activationHistory": [
- {
- "action": "Activate",
- "holdAciton": "Hold",
- "owner": "Owner name",
- "person": "Person name",
- "reason": "Finance",
- "Note": "No active brand"
}, - {
- "action": "Activate",
- "holdAction": "Unhold",
- "owner": "Owner name",
- "person": "Person name",
- "reason": "Finance",
- "Note": "No active brand"
}, - {
- "action": "Disactivate",
- "holdAction": "Unhold",
- "owner": "Owner name",
- "person": "Person name",
- "reason": "Finance",
- "Note": "No active brand"
}
]
}
Get list of users associated to account. Optionally, add onlyActive and/or onlyAdmin params to filter the list if you want only active and/or admin/owner users.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
numberOfItems required | string Example: numberOfItems=20 Number of items to be displayed on page. |
page required | string Example: page=1 Page number. |
onlyActive | string Example: onlyActive=true Set 'true' to get only active users. Any other input will get both active and inactive users. |
onlyAdmin | string Example: onlyAdmin=true Set 'true', to get only admin users. Any other input will get users of all type. |
{- "statusCode": 200,
- "body": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "users": [
- {
- "id": "32784324",
- "firstName": "Ahmet",
- "lastName": "Mehmetoğlu",
- "email": "ahmet@mehmetoglu.com",
- "role": "User",
- "status": "Active"
}, - {
- "id": "32784325",
- "firstName": "Mehmet",
- "lastName": "Ahmetoğlu",
- "email": "mehmet@ahmetoglu.com",
- "role": "Admin",
- "status": "Inactive"
}
]
}
}
Creates new account user. Returns full list of account users.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
numberOfItems required | string Example: numberOfItems=20 Number of items to be displayed on page. |
page required | string Example: page=1 Page number. |
firstName | string |
lastName | string |
string | |
role | string |
status | boolean |
{- "firstName": "Ahmet",
- "lastName": "Mehmetoğlu",
- "email": "ahmet@mehmetoglu.com",
- "role": "Owner",
- "status": true
}
{- "statusCode": 200,
- "body": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "users": [
- {
- "id": "32784324",
- "firstName": "Ahmet",
- "lastName": "Mehmetoğlu",
- "email": "ahmet@mehmetoglu.com",
- "role": "User",
- "status": "Active"
}, - {
- "id": "32784325",
- "firstName": "Mehmet",
- "lastName": "Ahmetoğlu",
- "email": "mehmet@ahmetoglu.com",
- "role": "Admin",
- "status": "Inactive"
}
]
}
}
User info is returned (Id, First Name, Last Name, E-mail, Role, Status).
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
userId required | string Example: 32784324 |
{- "statusCode": 200,
- "body": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "user": {
- "id": "32784324",
- "firstName": "Ahmet",
- "lastName": "Mehmetoğlu",
- "email": "ahmet@mehmetoglu.com",
- "role": "User",
- "status": "Active"
}
}
}
Updates user's first name, last name, email, role and status. Updated user's info is returned as response.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
userId required | string Example: 32784324 |
id | string |
firstName | string |
lastName | string |
string | |
role | string |
status | boolean |
{- "id": "32784324",
- "firstName": "Ahmet",
- "lastName": "Mehmetoğlu",
- "email": "ahmet@mehmetoglu.com",
- "role": "User",
- "status": true
}
{- "statusCode": 200,
- "body": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "users": [
- {
- "id": "32784324",
- "firstName": "Ahmet",
- "lastName": "Mehmetoğlu",
- "email": "ahmet@mehmetoglu.com",
- "role": "User",
- "status": "Active"
}, - {
- "id": "32784325",
- "firstName": "Mehmet",
- "lastName": "Ahmetoğlu",
- "email": "mehmet@ahmetoglu.com",
- "role": "Admin",
- "status": "Inactive"
}
]
}
}
Returns list of brands associated to user's account and user's permissions for those brands.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
userId required | string Example: 32784324 |
numberOfItems required | string Example: numberOfItems=10 Number of items to be displayed on page. |
page required | string Example: page=1 Page number. |
{- "statusCode": 200,
- "body": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "brandPermissions": [
- {
- "brandId": 13568456,
- "brandName": "Arvento",
- "permission": false
}, - {
- "brandId": 93634753,
- "brandName": "Demir Döküm",
- "permission": true
}, - {
- "brandId": 93634753,
- "brandName": "Eurofins",
- "permission": true
}
]
}
}
Updates user's specific brand permission. Returns updated list of user's brand permissions.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
userId required | string Example: 32784324 |
numberOfItems required | string Example: numberOfItems=20 Number of items to be displayed on page. |
page required | string Example: page=1 Page number. |
brandId | integer |
permission | string |
{- "brandId": 93634753,
- "permission": true
}
{- "statusCode": 200,
- "body": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "updatedBrandPermission": {
- "brandId": 93634753,
- "brandName": "Demir Döküm",
- "permission": true
}, - "brandPermissions": [
- {
- "brandId": 13568456,
- "brandName": "Arvento",
- "permission": false
}, - {
- "brandId": 93634753,
- "brandName": "Demir Döküm",
- "permission": true
}, - {
- "brandId": 93634753,
- "brandName": "Eurofins",
- "permission": true
}
]
}
}
Creates new brand permission for user. Returns updated list of user's brand permissions.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
userId required | string Example: 32784324 |
numberOfItems required | string Example: numberOfItems=20 Number of items to be displayed on page. |
page required | string Example: page=1 Page number. |
brandId | integer |
{- "brandId": 7366235
}
{- "statusCode": 200,
- "body": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "createdBrandPermission": {
- "brandId": 7366235,
- "brandName": "Vodafone",
- "permission": true
}, - "brandPermissions": [
- {
- "brandId": 13568456,
- "brandName": "Arvento",
- "permission": false
}, - {
- "brandId": 93634753,
- "brandName": "Demir Döküm",
- "permission": true
}, - {
- "brandId": 93634753,
- "brandName": "Eurofins",
- "permission": true
}
]
}
}
Queries the brands according to filter in Brands Query page.
numberOfItems required | string Example: numberOfItems=20 Number of items to be displayed on page. |
page required | string Example: page=1 Page number. |
Body of Brands Query
brandName | string |
closeDateStart | string <date> |
closeDateEnd | string <date> |
onlyActiveAccount | boolean |
onlyActiveBrands | boolean |
onlyPassiveBrands | boolean |
{- "brandName": "Blabla İletişim",
- "closeDateStart": "2018-12-01",
- "closeDateEnd": "2018-10-31",
- "onlyActiveAccount": true,
- "onlyActiveBrands": true,
- "onlyPassiveBrands": false
}
{- "statusCode": 200,
- "body": {
- "brands": [
- {
- "brandId": 93634757,
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "accountName": "Bersay",
- "accountType": "Agency",
- "package": "Ajans Pro",
- "accountStatus": "Active",
- "brandName": "Temsa Holding",
- "type": "Master",
- "status": "Active",
- "lastActivateDate": "2018-11-18",
- "closeDate": "2018-12-13",
- "sponsored": false,
- "agencyOwned": false
}, - {
- "brandId": 43634753,
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "accountName": "Dersay",
- "accountType": "Agency",
- "package": "Ajans Pro",
- "accountStatus": "Active",
- "brandName": "Demsa Holding",
- "type": "Sub-brand",
- "status": "Active",
- "lastActivateDate": "2018-11-18",
- "closeDate": "2018-12-13",
- "sponsored": false,
- "agencyOwned": false
}
]
}
}
Brands under specified account are retrieved. Optional status query param can be set to get only active or inactive brands. If status is not set, all account brands are retrieved.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
status | string Example: status=true Activity status of brands. Set to true to list active brands. Set to false to list inactive brands. |
numberOfItems required | string Example: numberOfItems=20 Number of items to be displayed on page. |
page required | string Example: page=1 Page number. |
{- "statusCode": 200,
- "body": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "brands": [
- {
- "brandId": 93634757,
- "brandName": "Temsa Holding",
- "expireDate": "2018-12-13",
- "autoRenewal": true,
- "type": "Sub-brand",
- "sponsored": false,
- "agencyOwned": false,
- "status": "Active",
- "masterBrand": {
- "id": 462341,
- "name": "Temsa Group"
}, - "distribution": {
- "sent": 1,
- "scheduled": 2,
- "draft": 0
}
}, - {
- "brandId": 13634757,
- "brandName": "Demsa Holding",
- "expireDate": "2019-12-13",
- "autoRenewal": true,
- "type": "Master",
- "sponsored": false,
- "agencyOwned": false,
- "status": "Active",
- "masterBrand": {
- "id": 0,
- "name": "null"
}, - "distribution": {
- "sent": 3,
- "scheduled": 0,
- "draft": 0
}
}
]
}
}
Gets Brand Details in updatable form and Brand Action History.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
brandId required | integer <int64> Example: 327433 |
{- "statusCode": 200,
- "body": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "brandDetails": {
- "brandId": 93634757,
- "brandName": "Vestel",
- "status": "Active",
- "type": "Sub-brand",
- "expireDate": "2021-12-31",
- "autoRenewal": true,
- "sponsored": false,
- "agencyOwned": false,
- "masterBrand": {
- "id": 12365234,
- "name": "Zorlu"
}
}, - "brandActions": [
- {
- "date": "2021-01-31",
- "action": "Open",
- "user": "İlknur Altın",
- "detail": "Reminder to change Action"
}, - {
- "date": "2021-01-31",
- "action": "Open",
- "user": "İlknur Altın",
- "detail": "Reminder to change Action"
}
]
}
}
Updates Brand Details (Brand Name, Status, Brand Type, Master Brand, Expire Date, Auto Renewal). None is required, however if type is set as 'Sub-brand', masterBrandId is required.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
brandId required | integer <int64> Example: 327433 |
Brand's Type, Master Brand, Expired Date, Renewal information
brandName required | string |
status required | boolean |
type required | string |
agencyOwned required | boolean |
masterBrandId | integer |
expireDate required | string <date> |
autoRenewal required | integer |
{- "brandName": "Vestel",
- "status": true,
- "type": "Sub-brand",
- "agencyOwned": false,
- "masterBrandId": 12365234,
- "expireDate": "2021-12-31",
- "autoRenewal": true
}
{- "statusCode": 200,
- "body": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "brandDetails": {
- "brandId": 93634757,
- "brandName": "Vestel",
- "status": "Active",
- "type": "Sub-brand",
- "expireDate": "2021-12-31",
- "autoRenewal": true,
- "sponsored": false,
- "agencyOwned": false,
- "masterBrand": {
- "id": 12365234,
- "name": "Zorlu"
}
}
}
}
New Brand is created under account. For Sub-brand set type as 'Sub-brand' and and make sure set masterBrandId, for Master brand set type as 'Master'.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
Brand's Type, Master Brand, Expired Date, Renewal information
brandName | string |
status | boolean |
masterBrandId | integer |
expireDate | string <date> |
autoRenewal | boolean |
{- "brandName": "Zorlu",
- "type": "Sub-brand",
- "status": true,
- "masterBrandId": 324628,
- "expireDate": "2021-12-31",
- "autoRenewal": true
}
{- "statusCode": 200,
- "body": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "brandDetails": {
- "brandId": 93634757,
- "brandName": "Vestel",
- "status": "Active",
- "type": "Sub-brand",
- "expireDate": "2021-12-31",
- "autoRenewal": true,
- "sponsored": false,
- "agencyOwned": false,
- "masterBrand": {
- "id": 12365234,
- "name": "Zorlu"
}
}
}
}
Gets list of account users and their permissions for specified brand.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
brandId required | integer <int64> Example: 327433 |
numberOfItems required | string Example: numberOfItems=20 Number of items to be displayed on page. |
page required | string Example: page=1 Page number. |
{- "statusCode": 200,
- "body": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "userPermissions": [
- {
- "userId": 34113245,
- "userName": "Ahmet",
- "userSurname": "Çelebi",
- "userEmail": "a.celebi@abc.com.tr",
- "permission": true
}, - {
- "userId": 94113234,
- "userName": "Ziya",
- "userSurname": "Çelebi",
- "userEmail": "z.celebi@abc.com.tr",
- "permission": false
}, - {
- "userId": 12451532,
- "userName": "Veysel",
- "userSurname": "Çelebi",
- "userEmail": "v.celebi@abc.com.tr",
- "permission": true
}
]
}
}
Gets Brand Name, Brand Type, Master Brand and List of distribution periods.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
brandId required | integer <int64> Example: 327433 |
{- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "brandDetails": {
- "brandId": 93634757,
- "brandName": "Vestel",
- "status": "Active",
- "type": "Sub-brand",
- "expireDate": "2021-12-31",
- "autoRenewal": true,
- "sponsored": false,
- "agencyOwned": false,
- "masterBrand": {
- "id": 12365234,
- "name": "Zorlu"
}
}, - "distributionPeriods": [
- {
- "distributionPeriod": {
- "year": 2021,
- "month": 1
}, - "releases": {
- "pressReleases": {
- "sent": 3,
- "draft": 1,
- "scheduled": 1
}, - "invitations": {
- "sent": 3,
- "draft": 1,
- "scheduled": 1
}
}
}, - {
- "distributionPeriod": {
- "year": 2020,
- "month": 12
}, - "releases": {
- "pressReleases": {
- "sent": 3,
- "draft": 1,
- "scheduled": 1
}, - "invitations": {
- "sent": 3,
- "draft": 1,
- "scheduled": 1
}
}
}
]
}
List of Distributions for selected period. Brand Name to be retrieved as well?
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
brandId required | integer <int64> Example: 327433 |
Period for Distributions
accountId | string |
year required | integer [ 2000 .. 2050 ] |
month required | integer [ 1 .. 12 ] |
{- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "year": 2021,
- "month": 1
}
{- "brandDetails": {
- "brandId": 93634757,
- "brandName": "Vestel",
- "status": "Active",
- "type": "Sub-brand",
- "expireDate": "2021-12-31",
- "autoRenewal": true,
- "sponsored": false,
- "agencyOwned": false,
- "masterBrand": {
- "id": 12365234,
- "name": "Zorlu"
}
}, - "pressReleases": [
- {
- "date": "2021-01-11",
- "type": "Open",
- "user": {
- "id": 123124,
- "name": "Ilknur Aydin"
}, - "status": "Draft",
- "sender": "Vestel Kurumsal",
- "title": "Marketing Dev",
- "releaseLink": "www.faselis.com/vestel/gjewırgegberkje"
}, - {
- "date": "2021-01-01",
- "type": "Open",
- "user": {
- "id": 3462462,
- "name": "Yasemin Gümüş"
}, - "status": "Sent",
- "sender": "Vestel Kurumsal",
- "title": "Marketing Dev",
- "releaseLink": "www.faselis.com/vestel/abdbdfgdsage"
}
]
}
Get the invoice list of account
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
{- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "invoices": [
- {
- "date": "2021-01-31",
- "type": "INV",
- "documentNo": "32136546",
- "amount": "300",
- "currency": "try",
- "status": "paid",
- "note": "will be paid by CC"
}, - {
- "date": "2020-01-13",
- "type": "INV",
- "documentNo": "32136546",
- "amount": "300",
- "currency": "try",
- "status": "paid",
- "note": "will be paid by CC"
}
]
}
Create new invoice document
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
date | string <date> |
type | string |
documentNo | string |
amount | string |
currency | string |
status | string |
note | string |
{- "date": "2021-01-31",
- "type": "INV",
- "documentNo": "32136546",
- "amount": "300",
- "currency": "try",
- "status": "paid",
- "note": "will be paid by CC"
}
{- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "invoices": [
- {
- "date": "2021-01-31",
- "type": "INV",
- "documentNo": "32136546",
- "amount": "300",
- "currency": "try",
- "status": "paid",
- "note": "will be paid by CC"
}, - {
- "date": "2020-01-13",
- "type": "INV",
- "documentNo": "32136546",
- "amount": "300",
- "currency": "try",
- "status": "paid",
- "note": "will be paid by CC"
}
]
}
Get incoming invoice details, look payment periods, amounts and payment status
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
{- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "invoiceNo": 1221312,
- "invoiceDate": "2021-12-12",
- "periods": [
- {
- "period": "2021-10-12",
- "brand": "Vestel",
- "type": "paid",
- "amount": 100,
- "currency": "try"
}, - {
- "period": "2021-09-12",
- "brand": "Vestel",
- "type": "paid",
- "amount": 100,
- "currency": "try"
}, - {
- "period": "2021-08-12",
- "brand": "Vestel",
- "type": "paid",
- "amount": 100,
- "currency": "try"
}
]
}
Get credits list of account, look definitions of documents
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
{- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "creditsList": [
- {
- "date": "2021-01-31",
- "type": "INV",
- "credits": {
- "standart": 2,
- "distribution": 1
}, - "amount": "300",
- "currency": "try",
- "user": "ozer"
}, - {
- "date": "2020-12-31",
- "type": "INV",
- "credits": {
- "standart": 2,
- "distribution": 1
}, - "amount": "300",
- "currency": "try",
- "user": "ozer"
}
]
}
Update credits of account
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
object |
{- "credits": {
- "standart": 5,
- "distribution": 28
}
}
{- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "credits": {
- "standart": 5,
- "distribution": 28
}
}
Transactions can be listed by default Region and Currency filter.
Also filter can be expanded by adding Company details, Region, Currency, Transaction type, Payment Zones, Payment Type, Refund, Date Range and Amount.
name | string |
accountManager | string Default: "Vildan" Enum: "Seçkin" "Oğuzhan" "Vildan" |
type | string Default: "Corporate" Enum: "Agency" "Corporate" "Sponsored" |
package | string Enum: "Standart" "Pro" "Trial" "Silver" "Gold" "Full" |
regions | Array of strings |
currencies | Array of strings |
transactions | Array of strings |
paymentZones | Array of strings |
paymentTypes | Array of strings |
refunds | Array of strings |
object | |
object |
{- "name": "Blabla",
- "type": "Agency",
- "package": "Pro",
- "accountManager": "Seçkin",
- "regions": [
- "TR",
- "NL"
], - "currencies": [
- "USD"
], - "transactions": [
- "Opening Balance-OB",
- "Invoice-INV"
], - "paymentZones": [
- "Local",
- "Global"
], - "paymentTypes": [
- "Credit Card-IPCC",
- "Check-IPCH"
], - "refunds": [
- "Wire Transfer-IPW",
- "Credit Card-IPCC"
], - "dateRange": {
- "startDate": "2018-12-31",
- "endDate": "2019-12-31"
}, - "amountRange": {
- "min": 200,
- "max": 500
}
}
[- {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "date": "2021-01-04",
- "accountName": "Bersay",
- "accountType": "Agency",
- "type": "OB",
- "paymentStatus": true,
- "documentNo": "12581gy1-123512-gewgrt32243t",
- "amount": 300,
- "region": "MENA",
- "accountManager": "Seçkin",
- "notes": "",
}, - {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "date": "2021-01-04",
- "accountName": "Varmilo",
- "accountType": "Agency",
- "type": "INV",
- "paymentStatus": true,
- "documentNo": "gewgrt32243t-123512-abcwgrt32243t",
- "amount": 500,
- "region": "US",
- "accountManager": "Oğuzhan",
- "notes": "",
}
]
RESERVED FOR FUTURE USE: New transaction is added. Note to add api call to search by accountName and when selected found account, fill other account related fields (accountId, accountType) with its data.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
required | object (payment) |
type required | string Enum: "OB" "INV" |
{- "payment": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "date": "2021-01-04",
- "accountName": "Bersay",
- "accountType": "Agency",
- "paymentStatus": true,
- "documentNo": "12581gy1-123512-gewgrt32243t",
- "amount": 300,
- "region": "MENA",
- "accountManager": "Seçkin",
- "notes": "",
}, - "type": "OB"
}
{- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "payment": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "date": "2021-01-04",
- "accountName": "Bersay",
- "accountType": "Agency",
- "paymentStatus": true,
- "documentNo": "12581gy1-123512-gewgrt32243t",
- "amount": 300,
- "region": "MENA",
- "accountManager": "Seçkin",
- "notes": "",
}, - "type": "OB"
}
Transaction file is uploaded, or previously uploaded one can be replaced by reuploading the file.
accountId required | string Example: 5b4ecea1-be90-4b7d-81e6-27d7cb579d4e |
transactionId required | string Example: 1AB23456C7890123D |
[- {
- "payment": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "date": "2021-01-08",
- "accountName": "Leopold",
- "accountType": "Agency",
- "paymentStatus": true,
- "documentNo": "12581gy1-123512-srthyeruj",
- "amount": 100,
- "region": "MENA",
- "accountManager": "Seçkin",
- "notes": "",
}, - "invoice": 50
}, - {
- "payment": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "date": "2021-01-07",
- "accountName": "Ducky",
- "accountType": "Agency",
- "paymentStatus": true,
- "documentNo": "gewgrt32243t-123512-qwefqwfe",
- "amount": 200,
- "region": "US",
- "accountManager": "Oğuzhan",
- "notes": "",
}, - "invoice": 100
}
]
Disbursements are filtered according to Company Name, Currency, Payment Zone, Transaction Date and Amount.
accountName | string |
currencies | Array of strings |
paymentZones | Array of strings |
object | |
object |
{- "accountName": "Ducky",
- "currencies": [
- "USD",
- "EURO"
], - "paymentZones": [
- "Local",
- "Global"
], - "dateRange": {
- "startDate": "2018-12-31",
- "endDate": "2019-12-31"
}, - "amountRange": {
- "min": 100,
- "max": 500
}
}
[- {
- "payment": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "date": "2021-01-08",
- "accountName": "Leopold",
- "accountType": "Agency",
- "paymentStatus": true,
- "documentNo": "12581gy1-123512-srthyeruj",
- "amount": 100,
- "region": "MENA",
- "accountManager": "Seçkin",
- "notes": "",
}, - "invoice": 50
}, - {
- "payment": {
- "accountId": "5b4ecea1-be90-4b7d-81e6-27d7cb579d4e",
- "date": "2021-01-07",
- "accountName": "Ducky",
- "accountType": "Agency",
- "paymentStatus": true,
- "documentNo": "gewgrt32243t-123512-qwefqwfe",
- "amount": 200,
- "region": "US",
- "accountManager": "Oğuzhan",
- "notes": "",
}, - "invoice": 100
}
]
Reports can be filtered by specifying Account Name, Region, Product, Invoicing Zone, Amount range, Currency and Date range.
accountName | string |
region | Array of strings |
product | Array of strings |
invoicing | Array of strings |
object | |
currencies | Array of strings |
object |
{- "accountName": "Bersay",
- "region": [
- "TR",
- "MENA"
], - "product": [
- "Faselis Gold",
- "Faselis Silver"
], - "invoicing": [
- "Local",
- "Global"
], - "amountRange": {
- "min": 0,
- "max": 5000
}, - "currencies": [
- "USD",
- "TL"
], - "dateRange": {
- "start": "2019.12.31",
- "end": "2020.12.31"
}
}
[- {
- "accountId": "8f007eca-50df-11eb-ae93-0242ac130002",
- "accountName": "HHKB",
- "region": "US",
- "pacakge": "Faselis PR",
- "invoiceNo": 1235235,
- "invoiceTotal": 200,
- "paymentTotal": 100,
- "invoicing": "Global",
- "balance": 0
}, - {
- "accountId": "d6475786-50df-11eb-ae93-0242ac130002",
- "accountName": "FMV",
- "region": "TR",
- "pacakge": "Faselis Pro",
- "invoiceNo": 1235235,
- "invoiceTotal": 500,
- "paymentTotal": 100,
- "invoicing": "Local",
- "balance": 200
}
]