Shoppinglists
A service which allows to manage user shoppinglists. All Shoppinglists endpoints have path prefix /shoppinglists-service.
Get shoppinglist
Get user shoppinglist list.
GET /shoppinglists-service/user/shoppinglist
After first request from user creates shoppinglist with required type.
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| excluder_product | string | Optional: excluder product gtin |
Example Response
{
"shoppinglists": {
"required": [
{
"_id": "53e49d0e-b0b1-4cc2-b385-71ee3bb09547",
"name": "This Week",
"is_required": true,
"owner": {
"_id": "urn:authenticateit:user:email:maria.arshava+223@gmail.com",
"name": "Милана Перевощикова",
"image": "https://dev-cdn.shping.com/2019/9/29/94ba1ae0-6f90-40f7-9b96-1a6ec09d0793"
},
"shared_with": [],
"type": "shoppinglist",
"created_at": "2020-08-10T08:54:41.723Z",
"products_amount": 23,
"role": "owner"
}
],
"custom": [
{
"_id": "537e7e9c-793c-4a47-9b84-c1d9bb1bf7b8",
"name": "Milana1",
"owner": {
"_id": "urn:authenticateit:user:email:maria.arshava+223@gmail.com",
"name": "Милана Перевощикова",
"image": "https://dev-cdn.shping.com/2019/9/29/94ba1ae0-6f90-40f7-9b96-1a6ec09d0793"
},
"shared_with": [
{
"_id": "urn:authenticateit:user:email:maria.arshava+222@gmail.com",
"_rev": "403-7cc723b337313606dc8dd08bd9489261",
"name": "Алёшенька Ерёменко",
"image": "https://dev-cdn.shping.com/2019/9/26/fdc48e2c-971a-42fe-a4a3-253c7ba68171",
"role": "guest"
}
],
"type": "shoppinglist",
"created_at": "2020-08-10T10:03:47.051Z",
"products_amount": 5,
"role": "owner"
},
{
"_id": "f28a89ff-04b8-43f6-873c-67f96dc6d749",
"name": "Milana2",
"owner": {
"_id": "urn:authenticateit:user:email:maria.arshava+223@gmail.com",
"name": "Милана Перевощикова",
"image": "https://dev-cdn.shping.com/2019/9/29/94ba1ae0-6f90-40f7-9b96-1a6ec09d0793"
},
"shared_with": [
{
"_id": "urn:authenticateit:user:email:maria.arshava+222@gmail.com",
"_rev": "403-7cc723b337313606dc8dd08bd9489261",
"name": "Алёшенька Ерёменко",
"image": "https://dev-cdn.shping.com/2019/9/26/fdc48e2c-971a-42fe-a4a3-253c7ba68171",
"role": "default"
}
],
"type": "shoppinglist",
"created_at": "2020-08-10T10:04:02.035Z",
"products_amount": 0,
"role": "owner"
},
{
"_id": "a3987567-f202-47ed-b0ed-030d794d2c82",
"name": "Milana3",
"owner": {
"_id": "urn:authenticateit:user:email:maria.arshava+223@gmail.com",
"name": "Милана Перевощикова",
"image": "https://dev-cdn.shping.com/2019/9/29/94ba1ae0-6f90-40f7-9b96-1a6ec09d0793"
},
"shared_with": [
{
"_id": "urn:authenticateit:user:email:maria.arshava+222@gmail.com",
"_rev": "403-7cc723b337313606dc8dd08bd9489261",
"name": "Алёшенька Ерёменко",
"image": "https://dev-cdn.shping.com/2019/9/26/fdc48e2c-971a-42fe-a4a3-253c7ba68171",
"role": "default"
},
{
"_id": "urn:authenticateit:user:email:maria.arshava+336@gmail.com",
"_rev": "23-1d22248f2fe1ef0a3961dada967ed24e",
"name": "Via A",
"image": "https://dev-cdn.shping.com/2019/10/31/c5d10ad6-2ab6-407b-ae86-c629bbad7516",
"role": "default"
}
],
"type": "shoppinglist",
"created_at": "2020-08-10T10:04:12.659Z",
"products_amount": 0,
"role": "owner"
},
{
"_id": "2cd032db-ee72-43bc-addf-369ce1cf6c8c",
"name": "Milana sent tru skype",
"owner": {
"_id": "urn:authenticateit:user:email:maria.arshava+223@gmail.com",
"name": "Милана Перевощикова",
"image": "https://dev-cdn.shping.com/2019/9/29/94ba1ae0-6f90-40f7-9b96-1a6ec09d0793"
},
"shared_with": [
{
"_id": "urn:authenticateit:user:email:maria.arshava+336@gmail.com",
"_rev": "23-1d22248f2fe1ef0a3961dada967ed24e",
"name": "Via A",
"image": "https://dev-cdn.shping.com/2019/10/31/c5d10ad6-2ab6-407b-ae86-c629bbad7516",
"role": "default"
}
],
"type": "shoppinglist",
"created_at": "2020-08-13T13:09:00.355Z",
"products_amount": 0,
"role": "owner"
},
{
"_id": "1775f249-d1e0-4c88-a116-49704b73c6ef",
"name": "Milana5",
"owner": {
"_id": "urn:authenticateit:user:email:maria.arshava+223@gmail.com",
"name": "Милана Перевощикова",
"image": "https://dev-cdn.shping.com/2019/9/29/94ba1ae0-6f90-40f7-9b96-1a6ec09d0793"
},
"shared_with": [],
"type": "shoppinglist",
"created_at": "2020-08-13T13:09:19.387Z",
"products_amount": 0,
"role": "owner"
}
],
"shared": [
{
"_id": "33f3f774-f90c-4afe-9544-40ef92d98e3d",
"name": "AE1",
"owner": {
"_id": "urn:authenticateit:user:email:maria.arshava+222@gmail.com",
"name": "Алёшенька Ерёменко",
"image": "https://dev-cdn.shping.com/2019/9/26/fdc48e2c-971a-42fe-a4a3-253c7ba68171"
},
"shared_with": [
{
"_id": "urn:authenticateit:user:email:maria.arshava+94@gmail.com",
"_rev": "585-8e0147a49fdd6ce80718e8e1e24bcbf5",
"name": "94Maria Gmail",
"image": "https://dev-cdn.shping.com/2019/5/7/b625a6a1-c37f-4211-9805-dfe9108f7034",
"role": "default"
},
{
"_id": "urn:authenticateit:user:email:maria.arshava+1229@gmail.com",
"_rev": "76-fdb9e44009a562ce56a13d879ad85ed0",
"name": "Клава Кокина",
"image": "https://dev-cdn.shping.com/2020/7/22/95e664ff-01c4-4891-8182-0c841be1c0a0",
"role": "default"
},
{
"_id": "urn:authenticateit:user:email:maria.arshava+223@gmail.com",
"_rev": "381-8bd07089a67658596a0dc1a3f51f23a2",
"name": "Милана Перевощикова",
"image": "https://dev-cdn.shping.com/2019/9/29/94ba1ae0-6f90-40f7-9b96-1a6ec09d0793",
"role": "default"
},
{
"_id": "urn:authenticateit:user:email:maria.arshava+336@gmail.com",
"_rev": "23-1d22248f2fe1ef0a3961dada967ed24e",
"name": "Via A",
"image": "https://dev-cdn.shping.com/2019/10/31/c5d10ad6-2ab6-407b-ae86-c629bbad7516",
"role": "default"
},
{
"_id": "urn:authenticateit:user:email:maria.arshava+227@gmail.com",
"_rev": "68-57d70928354e2ae2db1176682c934ec5",
"name": "Софья Петрова",
"image": "https://dev-cdn.shping.com/2019/10/15/4c20bdc5-6f43-4ea5-a589-e8c6fe86d3e2",
"role": "default"
}
],
"type": "shoppinglist",
"created_at": "2020-08-13T11:46:45.543Z",
"products_amount": 0,
"role": "default"
},
{
"_id": "114b5641-2a2a-4269-88f9-f1deef4b6bc6",
"name": "AE2",
"owner": {
"_id": "urn:authenticateit:user:email:maria.arshava+222@gmail.com",
"name": "Алёшенька Ерёменко",
"image": "https://dev-cdn.shping.com/2019/9/26/fdc48e2c-971a-42fe-a4a3-253c7ba68171"
},
"shared_with": [
{
"_id": "urn:authenticateit:user:email:maria.arshava+223@gmail.com",
"_rev": "381-8bd07089a67658596a0dc1a3f51f23a2",
"name": "Милана Перевощикова",
"image": "https://dev-cdn.shping.com/2019/9/29/94ba1ae0-6f90-40f7-9b96-1a6ec09d0793",
"role": "default"
}
],
"type": "shoppinglist",
"created_at": "2020-08-13T11:47:11.215Z",
"products_amount": 0,
"role": "default"
},
{
"_id": "2f15200f-cbc6-4a2f-80b3-513555dac73e",
"name": "This Week",
"is_required": true,
"owner": {
"_id": "urn:authenticateit:user:email:maria.arshava+335@gmail.com",
"name": "Hugo F",
"image": "https://dev-cdn.shping.com/2019/10/31/51ef1b00-4dfa-4cc3-9298-26e469eb5fb9"
},
"shared_with": [
{
"_id": "urn:authenticateit:user:email:maria.arshava+336@gmail.com",
"_rev": "23-1d22248f2fe1ef0a3961dada967ed24e",
"name": "Via A",
"image": "https://dev-cdn.shping.com/2019/10/31/c5d10ad6-2ab6-407b-ae86-c629bbad7516",
"role": "default"
},
{
"_id": "urn:authenticateit:user:email:maria.arshava+223@gmail.com",
"_rev": "381-8bd07089a67658596a0dc1a3f51f23a2",
"name": "Милана Перевощикова",
"image": "https://dev-cdn.shping.com/2019/9/29/94ba1ae0-6f90-40f7-9b96-1a6ec09d0793",
"role": "default"
}
],
"type": "shoppinglist",
"created_at": "2020-08-16T15:46:34.765Z",
"products_amount": 0,
"role": "default"
},
{
"_id": "3a135cd3-e18e-470c-b543-4aa83fbb090e",
"name": "Via4",
"owner": {
"_id": "urn:authenticateit:user:email:maria.arshava+336@gmail.com",
"name": "Via A",
"image": "https://dev-cdn.shping.com/2019/10/31/c5d10ad6-2ab6-407b-ae86-c629bbad7516"
},
"shared_with": [
{
"_id": "urn:authenticateit:user:email:maria.arshava+223@gmail.com",
"_rev": "381-8bd07089a67658596a0dc1a3f51f23a2",
"name": "Милана Перевощикова",
"image": "https://dev-cdn.shping.com/2019/9/29/94ba1ae0-6f90-40f7-9b96-1a6ec09d0793",
"role": "default"
}
],
"type": "shoppinglist",
"created_at": "2020-08-17T11:32:04.068Z",
"products_amount": 0,
"role": "default"
}
]
}
}
Add new shoppinglist
Add new user shoppinglist.
POST /shoppinglists-service/user/shoppinglist
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| name | string | Required: shoppinglist name |
Example body
{
"name": "test name"
}
Example Response
{
"result": "Shopping list has been created"
}
Delete shoppinglist
Delete user shoppinglist.
DELETE /shoppinglists-service/user/shoppinglist
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| id | string | Required: user shoppinglist id (uuid) |
Example body
{
"id": "e2af5961-e74d-41ca-a998-a782a7a90807"
}
Example Response
{
"result": "Shoppinglist with id dff5f8ce-d238-4b8b-97c0-fd5c9c9b6301 has been deleted."
}
Required shoppinglists can't be deleted. If shoppinglist with id in request body has field is_required it return error.
{
"error": "Shoppinglist with id a51a9c37-0222-4e1d-904d-94ba6bbb3089 is required and can't be deleted",
"error_data": null,
"error_id": "receipts-del_receipt",
"error_object": null
}
Copy shoppinglist
We can copy a shopping list to a new one (Custom lists), all products are copied, all permissions are copied
POST /shoppinglists-service/user/shoppinglist/copy
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| id | string | Required: user shoppinglist id (uuid) |
| name | string | Optional: New shoppinglist name |
Example body
{
"id": "e2af5961-e74d-41ca-a998-a782a7a90807",
"name": "New shoppinglist name"
}
Example Response
{
"id": "dff5f8ce-d238-4b8b-97c0-fd5c9c9b6301"
}
Rename shoppinglist
Rename user shoppinglist.
Shoppinglists with required type can't be renamed.
PUT /shoppinglists-service/user/shoppinglist
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| id | string | Required: user shoppinglist id (uuid) |
| name | string | Required: shoppinglist name |
Example body
{
"name": "test name",
"id": "e2af5961-e74d-41ca-a998-a782a7a90807"
}
Example Response
{
"result": "Shoppinglist with id dff5f8ce-d238-4b8b-97c0-fd5c9c9b6301 has been renamed."
}
Required shoppinglists can't be renamed. If shoppinglist with id in request body has field is_required it return error.
{
"error": "Shoppinglist with id a51a9c37-0222-4e1d-904d-94ba6bbb3089 is required and can't be renamed",
"error_data": null,
"error_id": "shoppinglists-rename_shoppinglist",
"error_object": null
}
Only owner or user with admin role can rename shoppinglist. If user has no permission to rename shoppinglist it returns error.
{
"error": "You dont't have permission to rename this shoppinglist",
"error_data": null,
"error_id": "shoppinglists-rename_shoppinglist",
"error_object": null
}
Share shoppinglist with buddy
Share user's shoppinglist with buddy.
POST /shoppinglists-service/user/shoppinglist/sharing
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| list_id | string | Required: user shoppinglist id (uuid) |
| buddies_id | Array of strings | Required: buddies ids list id |
Example body
{
"buddies_id": ["ikleeen@gmail.com"],
"list_id": "e2af5961-e74d-41ca-a998-a782a7a90807"
}
Example Response
{
"result": "Shopping list with id 28e341a0-4d58-4b8c-8a4e-4dc716a12ddf has been shared."
}
If shoppinglist has been already shared to buddy it returns error.
{
"error": "Shopping list with id 7041e11b-3de7-41e8-8377-cd62ad0cc300 has already been shared to this user.",
"error_data": null,
"error_id": "shoppinglists-shareShoppinglistWithBuddy",
"error_object": null
}
Delete shoppinglist sharing with buddy
Delete buddy from list of users with whom shoppunglist is shared.
DELETE /shoppinglists-service/user/shoppinglist/sharing
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| list_id | string | Required: user shoppinglist id (uuid) |
| buddy_id | string | Required: buddy id |
Example body
{
"buddy_id": "ikleeen@gmail.com",
"list_id": "e2af5961-e74d-41ca-a998-a782a7a90807"
}
Example Response
{
"result": "Shopping list with id 7041e11b-3de7-41e8-8377-cd62ad0cc300 is no more shared to this user."
}
If shoppinglist has not been shared to buddy it returns error.
{
"error": "Shoppinglist with id 7041e11b-3de7-41e8-8377-cd62ad0cc300 has not been shared to this user.",
"error_data": null,
"error_id": "shoppinglists-deleteSharing",
"error_object": null
}
Create sharing url
Create sharing url for shoppinglist.
POST /shoppinglists-service/user/shoppinglist/sharing/link
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| id | string | Required: user shoppinglist id (uuid) |
{
"id": "e2af5961-e74d-41ca-a998-a782a7a90807"
}
Example Response
{
"url": "https://test-shping.app.link/7XUJjaLaV7"
}
Share shoppinglist by invitation code
Add to user's shared shoppinglists another one by invitation code
POST /shoppinglists-service/user/shoppinglist/invitation
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| invitation_code | string | Required: invitation code from url params |
Example body
{
"invitation_code": "575374152462501"
}
Example Response
{
"result": "Shopping list with id 4c9a2e46-dd74-4b83-9e66-da2602d73134 has been shared with you."
}
If user is owner of the shoppinglist it returns an error.
{
"error": "Shopping list can be shared with owner",
"error_data": null,
"error_id": "shoppinglists-self-sharing",
"error_object": null
}
If the shoppinglist has already been shared with user it returns an error.
{
"error": "This shopping list has already been shared with you",
"error_data": null,
"error_id": "shoppinglists-re-sharing",
"error_object": null
}
Set user role for shoppinglist
Set user's role for shared shoppinglist.
PUT /shoppinglists-service/user/shoppinglist/role
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| list_id | string | Required: shoppinglist id (uuid) |
| user_id | string | Required: id of user to whom list is shared |
| role | string | Required: user's role (one of: guest, default, admin) |
Example body
{
"user_id": "ikleeen@gmail.com",
"list_id": "e2af5961-e74d-41ca-a998-a782a7a90807",
"role": "admin"
}
Example Response
{
"result": "Role has been changed."
}
If shoppinglist has not been shared to user it returns error.
{
"error": "Shopping list with id 7041e11b-3de7-41e8-8377-cd62ad0cc300 is not shared to this user.",
"error_data": null,
"error_id": "shoppinglists-changeRole",
"error_object": null
}
Only owner of shoppinglist can manage user roles for it. If other user try to change role it returns error.
{
"error": "You dont't have permission to manage this shopping list's roles",
"error_data": null,
"error_id": "shoppinglists-changeRole",
"error_object": null
}
Add product
Add product to shoppinglist.
POST /shoppinglists-service/user/shoppinglist/product
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| lists_ids | array of strings | Optional: array of shoppinglists ids(uuid) |
| list_id | string | Optional: shoppinglists id(uuid) |
| product_id | string | Required: product id (uuid) |
| name | string | Optional: custom product name |
| params | object | Optional: product parameters (position, amount, purchase_frequency, added_by,unit) |
One of "lists_ids" or "list_id" is required. If both are passed "lists_ids" is priority.
Example body
{
"lists_ids": [
"168659c6-a110-4b73-bfc5-209619b7dd78",
"a0927558-9fda-4b82-ab1c-84192d4233fd",
"ab3d38ee-d8ea-4178-9d02-a0cb17b4e7e4"
],
"product_id": "00000772091930",
"params": {
"position": 3,
"added_by": "urn:authenticateit:user:email:system@authenticateit.com",
"amount": 2,
"purchase_frequency": "weekly",
"unit":"ml"
}
}
Users can add custom product using param "name".
Example Response
{
"result": "Product has been added to shopping lists"
}
Users with role "guest" can't add products to shoppinglist. If guest try to add product to shoppinglist it returns error.
{
"error": "You dont't have permission to add products to this shopping list",
"error_data": null,
"error_id": "shoppinglists-addProducts",
"error_object": null
}
Delete product
Delete product from shoppinglist.
DELETE /shoppinglists-service/user/shoppinglist/product
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| list_id | string | Required: shoppinglist id (uuid) |
| product_id | string | Required: product id (uuid) |
Example body
{
"list_id": "8a674d4a-d1fc-4728-90de-f904eb96f6c7",
"product_id": "00000772091930"
}
Example Response
{
"result": "Product has been deleted from shopping list"
}
Users with role "guest" can't delete products to shoppinglist. Users with role "defailt" can delete only products that were added by themselves. If user who has no rights try to delete product it returns error.
{
"error": "You dont't have permission to delete this product from this shopping list",
"error_data": null,
"error_id": "shoppinglists-delProducts",
"error_object": null
}
If there are no product_id in shoppinglist with list_id it returns error.
{
"error": "There are no this product in this shopping list",
"error_data": null,
"error_id": "shoppinglists-delProducts",
"error_object": null
}
Global search
Search products in entire database.
POST /shoppinglists-service/user/shoppinglist/search
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| search_string | string | Required: string for matching product names |
| list_id | string | Required: id of shoppinglist |
Example body
{
"search_string": "bitsy",
"list_id": "8a674d4a-d1fc-4728-90de-f904eb96f6c7"
}
Returns list of products. Special Sorting Rules are used to find the first 3 records (highlited_products), while the rest are sorted in alphabetical order. If products array is empty it means that selected products have no prices docs in dev couchDB.
Example Response
{
"retailers": [
{
"id": "urn:authenticateit:participant:111111111111133",
"name": "Import participant MyDeal"
},
{
"id": "urn:authenticateit:participant:111111111111115",
"name": "Import participant Coles",
"logo": "https://dev-cdn.shping.com/2020/9/18/bb4f9033-ca16-4c95-a820-276373660680.png"
},
{
"id": "urn:authenticateit:participant:111111111111132",
"name": "Import participant FairPrice"
},
{
"id": "urn:authenticateit:participant:111111111111131",
"name": "Import participant Chemist Warehouse"
}
],
"products": [
{
"product_id": "00888731089583",
"product_name": "Mel Dreamed by Melissa Women's Mel Open Boot US",
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 65.99,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/11/27/0c0b8537-2347-4df3-ab00-13fe808f8c28"
},
{
"url": "https://dev-cdn.shping.com/2019/11/27/1d688040-f049-464c-a823-c87a97c972c1"
},
{
"url": "https://dev-cdn.shping.com/2019/11/27/c439fda2-8ba7-4d96-9e63-856769174042"
},
{
"url": "https://dev-cdn.shping.com/2019/11/27/0837d734-4538-4bb8-9d44-32367e533f7e"
},
{
"url": "https://dev-cdn.shping.com/2019/11/27/1402db7b-2550-4c58-a9e0-1833deecafb9"
},
{
"url": "https://dev-cdn.shping.com/2019/11/27/f2bf17ad-6919-445d-b64c-d44ea382da00"
}
],
"retailer_id": "urn:authenticateit:participant:111111111111133"
}
],
"attributes": [],
"highlited": true
},
{
"product_id": "00889698134606",
"product_name": "Despicable Me 3 I Heart Gru Mel US Exclusive Pop!",
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 33.95,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/11/27/61cd97bf-c053-46c4-a733-9df3256d8a1c"
},
{
"url": "https://dev-cdn.shping.com/2019/11/27/c587653d-be44-41e3-9bae-2ef3e3dce1da"
},
{
"url": "https://dev-cdn.shping.com/2019/11/27/f9035e94-a3a0-4117-bbf4-5b1b6d936647"
}
],
"retailer_id": "urn:authenticateit:participant:111111111111133"
}
],
"attributes": [],
"highlited": true
},
{
"product_id": "04060507267982",
"product_name": "Adidas Heather Colour Block Polo - Navy Mel./White",
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 69.99,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/11/27/26a4b059-b8b2-42d0-9927-e085de29f9e0"
},
{
"url": "https://dev-cdn.shping.com/2019/11/27/59acf1b2-e3b7-4e79-86ad-ddad3e010d15"
},
{
"url": "https://dev-cdn.shping.com/2019/11/27/dc4b7cb2-a82a-4deb-8252-71acbb6692ab"
}
],
"discount_value": 39.99,
"retailer_id": "urn:authenticateit:participant:111111111111133"
}
],
"attributes": [],
"highlited": true
},
{
"product_id": "09780062560995",
"product_name": "Funny Man : Mel Brooks",
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 69.99,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/11/27/94ee0cbd-0e10-491a-86bc-484f83ecb200"
}
],
"discount_value": 51.95,
"retailer_id": "urn:authenticateit:participant:111111111111133"
}
],
"attributes": []
},
{
"product_id": "09312628040100",
"product_name": "Mel Nat Almond Spread",
"price_per_unit": {
"price": 3.58,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "mg"
},
{
"value": "g",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 8.95,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/5/15/87a6cdee-54e0-48fd-a804-7ef3d7555c89"
}
],
"price_per_unit": {
"price": 3.58,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111115"
}
],
"attributes": []
},
{
"product_id": "09312628040117",
"product_name": "Mel Nat Cashew Spread",
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 8.95,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/5/15/4b6e925d-9626-4a55-855b-64c934aada0a"
}
],
"retailer_id": "urn:authenticateit:participant:111111111111115"
}
],
"attributes": []
},
{
"product_id": "09312628260867",
"product_name": "Mel Unrefined Coconut Oil",
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "SGD",
"currency_label": "$",
"value": 17.6,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/10/24/834b65f7-1cfc-486f-8256-c8acc8ecc9ed"
},
{
"url": "https://dev-cdn.shping.com/2019/10/24/a1cf590f-458c-40dd-b34c-7998d178773c"
},
{
"url": "https://dev-cdn.shping.com/2019/10/24/30026738-f051-4492-805f-a147bf228bfc"
},
{
"url": "https://dev-cdn.shping.com/2019/10/24/a7da7161-59f6-47b1-8a7f-06f1f0764dd0"
}
],
"retailer_id": "urn:authenticateit:participant:111111111111132"
},
{
"currency": "AUD",
"currency_label": "$",
"value": 7.95,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/8/22/901f3034-c69e-4bb2-9954-95312ce214e3"
}
],
"discount_value": 6.99,
"retailer_id": "urn:authenticateit:participant:111111111111131"
}
],
"attributes": []
}
]
}
Change units type
Сhanges the product measurement units.
PUT /shoppinglists-service/user/shoppinglist/product/unit
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| list_id | string | Required: shoppinglist id (uuid) |
| product_id | string | Required: product id |
| unit | string | Required: type of unit of product |
Example body
{
"list_id": "168659c6-a110-4b73-bfc5-209619b7dd78",
"product_id": "09329982016849",
"unit": "l"
}
Example Response
{
"result": "Product unit has been changed"
}
If there are no product_id in shoppinglist with list_id it returns error.
{
"error": "There are no this product in this shoppinglist",
"error_data": null,
"error_id": "shoppinglists-ChangeProductAmount",
"error_object": null
}
Adjust number of units of product
Adjust number of units of product in shoppinglist.
PUT /shoppinglists-service/user/shoppinglist/product/amount
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| list_id | string | Required: shoppinglist id (uuid) |
| product_id | string | Required: product id |
| amount | string | Required: number of units of product |
Example body
{
"product_id": "00817579012811",
"list_id": "e2af5961-e74d-41ca-a998-a782a7a90807",
"amount": "5"
}
Example Response
{
"result": "Product amount has been changed"
}
If there are no product_id in shoppinglist with list_id it returns error.
{
"error": "There are no this product in this shoppinglist",
"error_data": null,
"error_id": "shoppinglists-ChangeProductAmount",
"error_object": null
}
Change product bought in
Allows to specify where the product was purchased
POST /shoppinglists-service/user/shoppinglist/product/bought-in
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| list_id | string | Required: shoppinglist id (uuid) |
| product_id | string | Required: product id |
| retailer_id | string | Optional: retailer id |
| is_bought | boolean | Required: is_bought |
Example body
{
"list_id": "168659c6-a110-4b73-bfc5-209619b7dd78",
"retailer_id": "urn:authenticateit:participant:735879621218609",
"product_id": "09329982016849",
"is_bought": true
}
Example Response
If 'is_bought' property is true, 'bought_in' property will be created or changed. If 'is_bought' property is true, 'bought_in' property required
{
"result": "'Bought in' property changed to urn:authenticateit:participant:735879621218609"
}
If 'is_bought' property is false, 'bought_in' property will be deleted.
{
"result": "'Bought in' property deleted"
}
Reset products bought in
Allows you to reset bought_in property of each product in the shopping list
PUT /shoppinglists-service/user/shoppinglist/reset
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| list_id | string(param) | Required: shoppinglist id (uuid) |
Example Response
{
"result": "shopping list reseted"
}
If list_id parameter missed it returns error.
{
"error": "Missed required param 'list_id'",
"error_data": null,
"error_id": "shoppinglists-missed params",
"error_object": null
}
Change purchase frequency of product
A user can change purchase frequency from default (for this task Weekly is default value)
PUT /shoppinglists-service/user/shoppinglist/product/purchase-frequency
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| list_id | string | Required: shoppinglist id (uuid) |
| product_id | string | Required: product id |
| purchase_frequency | string | Required: purchase frequency of product (one of: "weekly", "occasional_buys", "scheduled") |
| dates | array of strings | Optional: dates |
Example body
{
"user_id": "ikleeen@gmail.com",
"list_id": "e2af5961-e74d-41ca-a998-a782a7a90807",
"purchase_frequency": "weekly",
"dates": [
{
"year": "2020",
"month": "10",
"week": "4"
}
]
}
Example Response
{
"result": "Purchase frequency has been changed"
}
if the frequency of purchases is scheduled, but the dates parameter is missing it returns error.
{
"error": "Param 'dates' required for 'scheduled purchase frequency'",
"error_data": null,
"error_id": "shoppinglists-missed params",
"error_object": null
}
If there are no product_id in shoppinglist with list_id it returns error.
{
"error": "There are no this product in this shopping list",
"error_data": null,
"error_id": "shoppinglists-changePurchaseFrequency",
"error_object": null
}
Get product's scheduled dates
A user can get product's scheduled dates
GET /shoppinglists-service/user/shoppinglist/product/dates
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| list_id | string (get param) | Required: shoppinglist id (uuid) |
| product_id | string (get param) | Required: product id |
Example body
{
"product_id": "09310885115708",
"list_id": "168659c6-a110-4b73-bfc5-209619b7dd78"
}
Example Response
{
"result": [
{
"year": "2022",
"month": "3",
"week": "2"
}
]
}
If there are no product_id or list_id in request it returns error.
{
"error": "Missed required param 'product_id' or 'list_id",
"error_data": null,
"error_id": "shoppinglists-missed params",
"error_object": null
}
Get attributes
Get list of attributes of products.
GET /shoppinglists-service/attributes
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
Example Response
{
"result": [
{
"name": "Organic",
"id": "aac11b66-807c-49e7-a27e-939969855751"
},
{
"name": "Low Fat",
"id": "44781039-af2d-4986-be2d-afac2c363bf3"
},
{
"name": "Lactose free",
"id": "be7194dc-06e3-4bd1-91db-5eb04be9a8b5"
},
{
"name": "Australian made",
"id": "86e9e12f-aed1-476c-a62e-2fd19bbce713"
},
{
"name": "Free range",
"id": "8f42ece8-8853-4052-a85b-92df163c7004"
},
{
"name": "Halal",
"id": "f15fc677-faa9-41d6-85b9-0a7d8d133dfb"
}
]
}
Get categories
Get list of categories of products.
GET /shoppinglists-service/categories
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| category_id | string(get param) | Optional: category id |
Example body
{
"category_id": "80584457-5e7e-4021-adfa-9f7ef071d373"
}
If "category_id" field was not passed to the request, a list of first level categories is returned
Example Response
{
"result": [
{
"name": "Bread & Bakery",
"id": "80584457-5e7e-4021-adfa-9f7ef071d373"
},
{
"name": "Meat, Seafood & Deli",
"id": "e3058cbb-ec46-4dea-acef-4dc658576947"
},
{
"name": "Fruit & Veg",
"id": "9c6358b1-5719-487a-88bc-b823b36b02fa"
},
{
"name": "Dairy & Eggs",
"id": "d50dc365-b34c-4d8d-a38a-483551f0054c"
},
{
"name": "Drinks",
"id": "21d94b4f-d76e-46a2-befd-503e6b08ab39"
}
]
}
If "category_id" field was passed to the request, an object of category with list of it's sub categories is returned
Example Response
{
"result": [
{
"id": "dafb471a-9793-4c9b-9fc7-adbc31791213",
"name": "Instore bakery"
},
{
"id": "46eb270e-5107-4564-bca1-7d080303a71f",
"name": "Packaged"
}
]
}
Add categories
Assign categories to product.
POST /shoppinglists-service/categories/product
Category can be assigned by id or by name.
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| gtin | string | Required: gtin |
| category_id | string | Optional: category id |
| category_name | string | Optional: category name |
Example body
{
"gtin": "06713910111127",
"category_name": "Free range"
}
One of "category_id" or "category_name" fields has to be passed to the request.
Example Response
{
"result": "Category has been added"
}
Delete categories
Delete categories from product.
DELETE /shoppinglists-service/categories/product
Category can be deleted by id or by name.
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| gtin | string | Required: gtin |
| category_id | string | Optional: category id |
| category_name | string | Optional: category name |
Example body
{
"gtin": "06713910111127",
"category_name": "Free range"
}
One of "category_id" or "category_name" fields has to be passed to the request.
Example Response
{
"result": "Category has been deleted"
}
Get products by category
Get list of products by category
GET /shoppinglists-service/categories/product
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| category_id | string (get param) | Required: category id |
Example Response
{
"retailers": [
{
"id": "urn:authenticateit:participant:111111111111111",
"name": "Import participant Woolworts",
"logo": "https://dev-cdn.shping.com/2020/9/18/8479df1a-b943-4045-883f-c63ef4432979.jpg"
},
{
"id": "urn:authenticateit:participant:111111111111115",
"name": "Import participant Coles",
"logo": "https://dev-cdn.shping.com/2020/9/18/bb4f9033-ca16-4c95-a820-276373660680.png"
}
],
"products": [
{
"product_id": "09340078000009",
"product_name": "Sonoma Country White Sourdough",
"price_per_unit": {
"price": 1.17,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 7.5,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/921a4fa1-40c1-4b2d-83cb-5d248a3d2d79"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/dfb6d7ac-3ccb-4891-a727-6885bf2dd65c"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/c1db7712-5423-4dde-98e7-02adbf7d3488"
}
],
"price_per_unit": {
"price": 1.17,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": 640,
"serving_size": 128,
"package_unit": "g",
"attributes": [],
"category": {
"id": "6518f435-5fff-45b0-94f2-4c2b2f8d1fab",
"name": "Bread"
}
},
{
"product_id": "09310023144676",
"product_name": "Sourdough Bread",
"price_per_unit": {
"price": 0.6,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 3.9,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/24acd66b-83db-4ec6-9230-d3141c8af09b"
}
],
"price_per_unit": {
"price": 0.6,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
},
{
"currency": "AUD",
"currency_label": "$",
"value": 3.9,
"image": [],
"price_per_unit": {
"price": 0.6,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111115"
}
],
"package_size": 650,
"serving_size": 72,
"package_unit": "g",
"attributes": []
},
{
"product_id": "09316595683728",
"product_name": "The Famous Homemade Almond Biscotti",
"price_per_unit": {
"price": 4.67,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "g",
"selected": true
},
{
"value": "kg"
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 7,
"image": [
{
"url": "https://dev-cdn.shping.com/2020/7/23/750f20c5-f0b0-42ec-b359-73a09f901332"
}
],
"price_per_unit": {
"price": 4.67,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": null,
"serving_size": null,
"package_unit": null,
"attributes": []
},
{
"product_id": "09324499000114",
"product_name": "WW ISB White Mud Cake",
"price_per_unit": {
"price": 0.8,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 4.8,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/5/25/1b73768b-5b9f-40c2-9ce1-858540e457a7"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/11ddfefc-0d7c-4f77-821c-78aee655d3c5"
}
],
"price_per_unit": {
"price": 0.8,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": 600,
"serving_size": 100,
"package_unit": "g",
"attributes": []
},
{
"product_id": "00283273000001",
"product_name": "Woolworths Bread White Extra Soft Loaf",
"price_per_unit": {
"price": 0.29,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "g",
"selected": true
},
{
"value": "kg"
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 2,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/83d82c95-2e62-465b-887a-721e4872c7d9"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/68eef776-21b1-4bf5-90b8-24e9a5bccd10"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/af1aac53-a557-401a-864b-aabbc4c5d0be"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/35f5e2a3-15a2-4c1c-8f40-15cd4ef52464"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/bdf4434e-88ad-4c76-ba8d-4651a84ae856"
}
],
"price_per_unit": {
"price": 0.29,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": null,
"serving_size": null,
"package_unit": null,
"attributes": [],
"category": {
"id": "fdb66a4a-19a9-4ad6-a767-f7e487afd18a",
"name": "Bread & Bakery"
}
},
{
"product_id": "09340078000009",
"product_name": "Sonoma Country White Sourdough",
"price_per_unit": {
"price": 1.17,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 7.5,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/921a4fa1-40c1-4b2d-83cb-5d248a3d2d79"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/dfb6d7ac-3ccb-4891-a727-6885bf2dd65c"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/c1db7712-5423-4dde-98e7-02adbf7d3488"
}
],
"price_per_unit": {
"price": 1.17,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": 640,
"serving_size": 128,
"package_unit": "g",
"attributes": [],
"category": {
"id": "6518f435-5fff-45b0-94f2-4c2b2f8d1fab",
"name": "Bread"
}
},
{
"product_id": "09316595683728",
"product_name": "The Famous Homemade Almond Biscotti",
"price_per_unit": {
"price": 4.67,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "g",
"selected": true
},
{
"value": "kg"
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 7,
"image": [
{
"url": "https://dev-cdn.shping.com/2020/7/23/750f20c5-f0b0-42ec-b359-73a09f901332"
}
],
"price_per_unit": {
"price": 4.67,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": null,
"serving_size": null,
"package_unit": null,
"attributes": []
},
{
"product_id": "00289239000009",
"product_name": "Woolworths Mini Donut Chocolate Hazelnut",
"price_per_unit": {
"price": 0.67,
"quantity": 1,
"unit": "each"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 2,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/5/25/2332d2af-a81c-45e7-ae20-9677ded20aaa"
}
],
"price_per_unit": {
"price": 0.67,
"quantity": 1,
"unit": "each"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": null,
"serving_size": null,
"package_unit": null,
"attributes": []
},
{
"product_id": "09310023144676",
"product_name": "Sourdough Bread",
"price_per_unit": {
"price": 0.6,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 3.9,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/24acd66b-83db-4ec6-9230-d3141c8af09b"
}
],
"price_per_unit": {
"price": 0.6,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
},
{
"currency": "AUD",
"currency_label": "$",
"value": 3.9,
"image": [],
"price_per_unit": {
"price": 0.6,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111115"
}
],
"package_size": 650,
"serving_size": 72,
"package_unit": "g",
"attributes": []
},
{
"product_id": "09324499000114",
"product_name": "WW ISB White Mud Cake",
"price_per_unit": {
"price": 0.8,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 4.8,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/5/25/1b73768b-5b9f-40c2-9ce1-858540e457a7"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/11ddfefc-0d7c-4f77-821c-78aee655d3c5"
}
],
"price_per_unit": {
"price": 0.8,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": 600,
"serving_size": 100,
"package_unit": "g",
"attributes": []
},
{
"product_id": "00283273000001",
"product_name": "Woolworths Bread White Extra Soft Loaf",
"price_per_unit": {
"price": 0.29,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "g",
"selected": true
},
{
"value": "kg"
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 2,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/83d82c95-2e62-465b-887a-721e4872c7d9"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/68eef776-21b1-4bf5-90b8-24e9a5bccd10"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/af1aac53-a557-401a-864b-aabbc4c5d0be"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/35f5e2a3-15a2-4c1c-8f40-15cd4ef52464"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/bdf4434e-88ad-4c76-ba8d-4651a84ae856"
}
],
"price_per_unit": {
"price": 0.29,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": null,
"serving_size": null,
"package_unit": null,
"attributes": [],
"category": {
"id": "fdb66a4a-19a9-4ad6-a767-f7e487afd18a",
"name": "Bread & Bakery"
}
},
{
"product_id": "00289239000009",
"product_name": "Woolworths Mini Donut Chocolate Hazelnut",
"price_per_unit": {
"price": 0.67,
"quantity": 1,
"unit": "each"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 2,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/5/25/2332d2af-a81c-45e7-ae20-9677ded20aaa"
}
],
"price_per_unit": {
"price": 0.67,
"quantity": 1,
"unit": "each"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": null,
"serving_size": null,
"package_unit": null,
"attributes": []
},
{
"product_id": "09300633065577",
"product_name": "Woolworths Butter Cake",
"price_per_unit": {
"price": 1,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 4.5,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/f3bbb9cc-f9e4-485b-98ae-1f1e3db9788b"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/6fc44a92-3990-4e2f-8d6b-18c3d56b8316"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/a5d06c49-a7d9-4990-ba96-1e1cbbee96df"
}
],
"price_per_unit": {
"price": 1,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": 450,
"serving_size": 56,
"package_unit": "g",
"attributes": [],
"category": {
"id": "ef6d9651-ff89-44e0-8430-f9d2d2b6e8c1",
"name": "Bakery Cakes"
}
},
{
"product_id": "09340078000009",
"product_name": "Sonoma Country White Sourdough",
"price_per_unit": {
"price": 1.17,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 7.5,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/921a4fa1-40c1-4b2d-83cb-5d248a3d2d79"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/dfb6d7ac-3ccb-4891-a727-6885bf2dd65c"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/c1db7712-5423-4dde-98e7-02adbf7d3488"
}
],
"price_per_unit": {
"price": 1.17,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": 640,
"serving_size": 128,
"package_unit": "g",
"attributes": [],
"category": {
"id": "6518f435-5fff-45b0-94f2-4c2b2f8d1fab",
"name": "Bread"
}
},
{
"product_id": "09300633065577",
"product_name": "Woolworths Butter Cake",
"price_per_unit": {
"price": 1,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 4.5,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/f3bbb9cc-f9e4-485b-98ae-1f1e3db9788b"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/6fc44a92-3990-4e2f-8d6b-18c3d56b8316"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/a5d06c49-a7d9-4990-ba96-1e1cbbee96df"
}
],
"price_per_unit": {
"price": 1,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": 450,
"serving_size": 56,
"package_unit": "g",
"attributes": [],
"category": {
"id": "ef6d9651-ff89-44e0-8430-f9d2d2b6e8c1",
"name": "Bakery Cakes"
}
},
{
"product_id": "00283273000001",
"product_name": "Woolworths Bread White Extra Soft Loaf",
"price_per_unit": {
"price": 0.29,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "g",
"selected": true
},
{
"value": "kg"
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 2,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/83d82c95-2e62-465b-887a-721e4872c7d9"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/68eef776-21b1-4bf5-90b8-24e9a5bccd10"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/af1aac53-a557-401a-864b-aabbc4c5d0be"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/35f5e2a3-15a2-4c1c-8f40-15cd4ef52464"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/bdf4434e-88ad-4c76-ba8d-4651a84ae856"
}
],
"price_per_unit": {
"price": 0.29,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": null,
"serving_size": null,
"package_unit": null,
"attributes": [],
"category": {
"id": "fdb66a4a-19a9-4ad6-a767-f7e487afd18a",
"name": "Bread & Bakery"
}
},
{
"product_id": "00289239000009",
"product_name": "Woolworths Mini Donut Chocolate Hazelnut",
"price_per_unit": {
"price": 0.67,
"quantity": 1,
"unit": "each"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 2,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/5/25/2332d2af-a81c-45e7-ae20-9677ded20aaa"
}
],
"price_per_unit": {
"price": 0.67,
"quantity": 1,
"unit": "each"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": null,
"serving_size": null,
"package_unit": null,
"attributes": []
},
{
"product_id": "09300633065577",
"product_name": "Woolworths Butter Cake",
"price_per_unit": {
"price": 1,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 4.5,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/f3bbb9cc-f9e4-485b-98ae-1f1e3db9788b"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/6fc44a92-3990-4e2f-8d6b-18c3d56b8316"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/a5d06c49-a7d9-4990-ba96-1e1cbbee96df"
}
],
"price_per_unit": {
"price": 1,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": 450,
"serving_size": 56,
"package_unit": "g",
"attributes": [],
"category": {
"id": "ef6d9651-ff89-44e0-8430-f9d2d2b6e8c1",
"name": "Bakery Cakes"
}
},
{
"product_id": "09310023144676",
"product_name": "Sourdough Bread",
"price_per_unit": {
"price": 0.6,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 3.9,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/24acd66b-83db-4ec6-9230-d3141c8af09b"
}
],
"price_per_unit": {
"price": 0.6,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
},
{
"currency": "AUD",
"currency_label": "$",
"value": 3.9,
"image": [],
"price_per_unit": {
"price": 0.6,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111115"
}
],
"package_size": 650,
"serving_size": 72,
"package_unit": "g",
"attributes": []
},
{
"product_id": "09316595683728",
"product_name": "The Famous Homemade Almond Biscotti",
"price_per_unit": {
"price": 4.67,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "g",
"selected": true
},
{
"value": "kg"
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 7,
"image": [
{
"url": "https://dev-cdn.shping.com/2020/7/23/750f20c5-f0b0-42ec-b359-73a09f901332"
}
],
"price_per_unit": {
"price": 4.67,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": null,
"serving_size": null,
"package_unit": null,
"attributes": []
},
{
"product_id": "09324499000114",
"product_name": "WW ISB White Mud Cake",
"price_per_unit": {
"price": 0.8,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 4.8,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/5/25/1b73768b-5b9f-40c2-9ce1-858540e457a7"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/11ddfefc-0d7c-4f77-821c-78aee655d3c5"
}
],
"price_per_unit": {
"price": 0.8,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": 600,
"serving_size": 100,
"package_unit": "g",
"attributes": []
},
{
"product_id": "09340078000009",
"product_name": "Sonoma Country White Sourdough",
"price_per_unit": {
"price": 1.17,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "each",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 7.5,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/921a4fa1-40c1-4b2d-83cb-5d248a3d2d79"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/dfb6d7ac-3ccb-4891-a727-6885bf2dd65c"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/c1db7712-5423-4dde-98e7-02adbf7d3488"
}
],
"price_per_unit": {
"price": 1.17,
"quantity": 100,
"unit": "g"
},
"retailer_id": "urn:authenticateit:participant:111111111111111"
}
],
"package_size": 640,
"serving_size": 128,
"package_unit": "g",
"attributes": [],
"category": {
"id": "6518f435-5fff-45b0-94f2-4c2b2f8d1fab",
"name": "Bread"
}
}
]
}
Get products by purchase frequency
Get list of products by purchase frequency
GET /shoppinglists-service/user/shoppinglist/products
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| list_id | string (get param) | Required: shopping list id |
| type | string (get param) | Required: purchase frequency type (scheduled or occasional_buys) |
Example Response
{
"retailers": [
{
"id": "urn:authenticateit:participant:111111111111111",
"name": "Import participant Woolworts",
"logo": "https://dev-cdn.shping.com/2020/9/18/8479df1a-b943-4045-883f-c63ef4432979.jpg"
},
{
"id": "urn:authenticateit:participant:111111111111132",
"name": "Import participant FairPrice"
},
{
"id": "urn:authenticateit:participant:111111111111115",
"name": "Import participant Coles",
"logo": "https://dev-cdn.shping.com/2020/9/18/bb4f9033-ca16-4c95-a820-276373660680.png"
}
],
"products": [
{
"product_id": "09310885115708",
"product_name": "Mayvers Super Spread Original 280g",
"price_per_unit": {
"price": 1.16,
"quantity": 100,
"unit": "g"
},
"units": [
"g",
"kg",
"units"
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 6.5,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/c8120e53-54f2-467a-918b-f9ff6437a158"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/cbba049b-288e-4e7e-9ee1-7855e4696184"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/c43567f1-3933-4114-a91f-d03125cff95c"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/03bae239-1f54-4985-96d5-d9b9d66e44df"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/94773a3f-7121-4a24-a97c-dfca0731f797"
}
],
"discount_value": 3.25,
"retailer_id": "urn:authenticateit:participant:111111111111111"
},
{
"currency": "SGD",
"currency_label": "$",
"value": 10.5,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/10/24/b2867938-9a16-4cf4-b814-f37dc407b9e1"
},
{
"url": "https://dev-cdn.shping.com/2019/10/24/2eb6fc6f-0bd1-4f18-bb7f-416032d02cab"
},
{
"url": "https://dev-cdn.shping.com/2019/10/24/831be811-f927-4777-bbc7-417abf911f69"
}
],
"discount_value": 4.5,
"retailer_id": "urn:authenticateit:participant:111111111111132"
},
{
"currency": "AUD",
"currency_label": "$",
"value": 6.5,
"image": [],
"retailer_id": "urn:authenticateit:participant:111111111111115"
}
],
"attributes": []
},
{
"product_id": "64563256879324658237845123",
"name": "scissors",
"amount": 5,
"added_by": "urn:authenticateit:user:email:system@authenticateit.com",
"is_custom": true
}
],
"attributes": [
{
"name": "Organic",
"id": "aac11b66-807c-49e7-a27e-939969855751"
},
{
"name": "Low Fat",
"id": "44781039-af2d-4986-be2d-afac2c363bf3"
},
{
"name": "Lactose free",
"id": "be7194dc-06e3-4bd1-91db-5eb04be9a8b5"
},
{
"name": "Australian made",
"id": "86e9e12f-aed1-476c-a62e-2fd19bbce713"
},
{
"name": "Free range",
"id": "8f42ece8-8853-4052-a85b-92df163c7004"
},
{
"name": "Halal",
"id": "f15fc677-faa9-41d6-85b9-0a7d8d133dfb"
}
]
}
Get products in shopping list
Get list of products in shopping list
GET /shoppinglists-service/user/shoppinglist/product-list
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| list_id | string (get param) | Required: shopping list id |
Example Response
{
"retailers": [
{
"id": "urn:authenticateit:participant:111111111111111",
"name": "Import participant Woolworts",
"logo": "https://dev-cdn.shping.com/2020/9/18/8479df1a-b943-4045-883f-c63ef4432979.jpg"
},
{
"id": "urn:authenticateit:participant:111111111111132",
"name": "Import participant FairPrice"
},
{
"id": "urn:authenticateit:participant:111111111111115",
"name": "Import participant Coles",
"logo": "https://dev-cdn.shping.com/2020/9/18/bb4f9033-ca16-4c95-a820-276373660680.png"
},
{
"id": "urn:authenticateit:participant:735879621218609",
"name": "Иван Васильев",
"logo": "https://dev-cdn.shping.com/2019/3/28/5e1eb1a7-7d38-4d09-bace-a586cb0fc326.png"
}
],
"users": [
{
"id": "urn:authenticateit:user:email:system@authenticateit.com",
"name": "Женя Козин",
"image": "https://dev-cdn.shping.com/2019/10/18/5b6a79d1-f1bb-446e-8216-edb22726c4be"
}
],
"products": [
{
"product_id": "09310885115708",
"product_name": "Mayvers Super Spread Original 280g",
"price_per_unit": {
"price": 1.16,
"quantity": 100,
"unit": "g"
},
"units": [
{
"value": "g",
"selected": true
},
{
"value": "kg"
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 6.5,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/6/19/c8120e53-54f2-467a-918b-f9ff6437a158"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/cbba049b-288e-4e7e-9ee1-7855e4696184"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/c43567f1-3933-4114-a91f-d03125cff95c"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/03bae239-1f54-4985-96d5-d9b9d66e44df"
},
{
"url": "https://dev-cdn.shping.com/2019/6/19/94773a3f-7121-4a24-a97c-dfca0731f797"
}
],
"discount_value": 3.25,
"retailer_id": "urn:authenticateit:participant:111111111111111"
},
{
"currency": "SGD",
"currency_label": "$",
"value": 10.5,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/10/24/b2867938-9a16-4cf4-b814-f37dc407b9e1"
},
{
"url": "https://dev-cdn.shping.com/2019/10/24/2eb6fc6f-0bd1-4f18-bb7f-416032d02cab"
},
{
"url": "https://dev-cdn.shping.com/2019/10/24/831be811-f927-4777-bbc7-417abf911f69"
}
],
"discount_value": 4.5,
"retailer_id": "urn:authenticateit:participant:111111111111132"
},
{
"currency": "AUD",
"currency_label": "$",
"value": 6.5,
"image": [],
"retailer_id": "urn:authenticateit:participant:111111111111115"
}
],
"package_size": 490,
"serving_size": 122,
"package_unit": "g",
"attributes": [],
"amount": 1,
"purchase_frequency": "scheduled",
"added_by": "urn:authenticateit:user:email:system@authenticateit.com",
"sheduled_dates": [
{
"year": "2022",
"month": "10",
"week": "1"
},
{
"year": "2020",
"month": "10",
"week": "5"
},
{
"year": "2020",
"month": "11",
"week": "4"
}
]
},
{
"product_id": "09329982016849",
"product_name": "Somersby Apple Cider Premium European Cider 4.5% 6 X 330ml",
"price_per_unit": {
"price": 1.01,
"quantity": 100,
"unit": "ml"
},
"units": [
{
"value": "ml"
},
{
"value": "l",
"selected": true
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 21.5,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/5/25/f5c806af-502c-468b-bd4f-bbf2369d9478"
}
],
"discount_value": 16,
"retailer_id": "urn:authenticateit:participant:735879621218609"
},
{
"currency": "AUD",
"currency_label": "$",
"value": 20,
"image": [],
"price_per_unit": {
"price": 1.01,
"quantity": 100,
"unit": "ml"
},
"retailer_id": "urn:authenticateit:participant:111111111111115"
}
],
"package_size": null,
"serving_size": null,
"package_unit": null,
"attributes": [],
"amount": 4,
"purchase_frequency": "weekly",
"added_by": "urn:authenticateit:user:email:system@authenticateit.com",
"bought_in": "urn:authenticateit:participant:111111111111115"
},
{
"product_id": "09300601031184",
"product_name": "Chicken Flavour Noodle Snacks 12 pack",
"units": [
{
"value": "each"
}
],
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 2.85,
"image": [
{
"url": "https://dev-cdn.shping.com/2019/5/15/60bb6769-34b8-4d92-b3cf-cf097b2ecb65"
}
],
"retailer_id": "urn:authenticateit:participant:111111111111115"
}
],
"package_size": null,
"serving_size": null,
"package_unit": null,
"attributes": [],
"amount": 4,
"purchase_frequency": "weekly",
"added_by": "urn:authenticateit:user:email:system@authenticateit.com",
"bought_in": "urn:authenticateit:participant:111111111111115"
},
{
"name": "Something tasty",
"amount": 1,
"purchase_frequency": "weekly",
"added_by": "urn:authenticateit:user:email:system@authenticateit.com",
"is_custom": true
},
{
"name": "scissors",
"amount": 5,
"purchase_frequency": "scheduled",
"added_by": "urn:authenticateit:user:email:system@authenticateit.com",
"is_custom": true
}
],
"categories": [
{
"name": "Bread & Bakery",
"id": "fdb66a4a-19a9-4ad6-a767-f7e487afd18a"
},
{
"name": "Meat, Seafood & Deli",
"id": "0ca7636a-5ced-4eea-a807-37eab2a341dd"
},
{
"name": "Fruit & Veg",
"id": "b90c0f02-b264-4ce0-b952-f1068f298493"
},
{
"name": "Dairy & Eggs",
"id": "8d264c76-4b11-4f76-9e4d-d6576fa64da1"
},
{
"name": "Drinks",
"id": "1e7fb3d0-cd18-4898-ae57-fe11ab7c04f5"
}
],
"attributes": [
{
"name": "Organic",
"id": "aac11b66-807c-49e7-a27e-939969855751"
},
{
"name": "Low Fat",
"id": "44781039-af2d-4986-be2d-afac2c363bf3"
},
{
"name": "Lactose free",
"id": "be7194dc-06e3-4bd1-91db-5eb04be9a8b5"
},
{
"name": "Australian made",
"id": "86e9e12f-aed1-476c-a62e-2fd19bbce713"
},
{
"name": "Free range",
"id": "8f42ece8-8853-4052-a85b-92df163c7004"
},
{
"name": "Halal",
"id": "f15fc677-faa9-41d6-85b9-0a7d8d133dfb"
}
]
}
Add attribute
Assign attribute to product.
POST /shoppinglists-service/attributes/product
Attribute can be assigned by id or by name.
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| gtin | string | Required: gtin |
| attribute_id | string | Optional: attribute id |
| attribute_name | string | Optional: attribute name |
Example body
{
"gtin": "06713910111127",
"attribute_id": "21d94b4f-d76e-46a2-befd-503e6b08ab39"
}
One of "attribute_id" or "attribute_name" fields has to be passed to the request.
Example Response
{
"result": "Attribute has been added"
}
Delete attribute
Delete attribute from product.
DELETE /shoppinglists-service/attributes/product
Attribute can be deleted by id or by name.
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
| gtin | string | Required: gtin |
| attribute_id | string | Optional: attribute id |
| attribute_name | string | Optional: attribute name |
Example body
{
"gtin": "06713910111127",
"attribute_id": "21d94b4f-d76e-46a2-befd-503e6b08ab39"
}
One of "attribute_id" or "attribute_name" fields has to be passed to the request.
Example Response
{
"result": "Attribute has been deleted"
}
Get recently used products
Get recently used products.
GET /shoppinglists-service/user/shoppinglist/products/recently-used
Parameters
| Name | Type | Description |
|---|---|---|
| authenticateit_identity_ticket | header | Required: Session's ticket |
Example Response
{
"result": [
{
"product_id": "09329982016849",
"product_name": "Somersby Apple Cider Premium European Cider 4.5% 6 X 330ml",
"price_per_unit": {
"price": 1.01,
"quantity": 100,
"unit": "ml"
},
"prices": [
{
"currency": "AUD",
"currency_label": "$",
"value": 21.5,
"retailer": {
"id": "urn:authenticateit:participant:735879621218609",
"name": "Иван Васильев",
"logo": "https://dev-cdn.shping.com/2019/3/28/5e1eb1a7-7d38-4d09-bace-a586cb0fc326.png"
},
"image": [
{
"url": "https://dev-cdn.shping.com/2019/5/25/f5c806af-502c-468b-bd4f-bbf2369d9478"
}
],
"type": "price"
},
{
"currency": "AUD",
"currency_label": "$",
"value": 16,
"retailer": {
"id": "urn:authenticateit:participant:735879621218609",
"name": "Иван Васильев",
"logo": "https://dev-cdn.shping.com/2019/3/28/5e1eb1a7-7d38-4d09-bace-a586cb0fc326.png"
},
"image": [
{
"url": "https://dev-cdn.shping.com/2019/5/25/f5c806af-502c-468b-bd4f-bbf2369d9478"
}
],
"type": "discount_price"
}
]
}
]
}