Operations related to authentication tokens
- Get a Product By ID
Create a Product
Update a Product By Code
Delete a Product
List Products
Get Product By
Get a Product By Code
Get Product List With Inventory By List ID
Get Product List By ID
Get Product List Detail By ID
Get Product List With Outlet Price By List ID
Get Product List With Pricebook By List ID
Get a Product By ID
DealPOS API (3.1.0)
Download OpenAPI description
Overview
URL
Customer Support
Languages
Servers
Production Server
https://{subdomain}/api/v3/
Bodyapplication/json
One of:
The image URL of the product
Example: "https://images.unsplash.com/photo-1622793348115-4e85dc2ca4eb?ixid=MnwxMjA3fDB8MHxzZWFyY2h8Mnx8Y2FwdGFpbiUyMGFtZXJpY2F8ZW58MHx8MHx8&ixlib=rb-1.2.1&auto=format&fit=crop&w=600&q=60"
The extra image URL of the product
Example: ["//res.cloudinary.com/pos/image/upload/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/vgzleqpgujlspm9ltdiht.jpg","//res.cloudinary.com/pos/image/upload/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/q7dbzf9qnif8vbxuzxo0.jpg","//res.cloudinary.com/pos/image/upload/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/ur871mubz7ioecvja8ex.jpg"]
Example: [{"Model":"Small","Code":"1003S","UnitCost":100000,"UnitPrice":150000,"Discontinued":true,"Type":{"value":"Standard"},"VariantDescription":"Unavailable"},{"Model":"Medium","Code":"1003M","UnitCost":125000,"UnitPrice":175000,"Type":{"value":"Standard"},"Discontinued":false}]
- Production Serverhttps://subdomain.dealpos.net/api/v3/Product
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X POST \
https://subdomain.dealpos.net/api/v3/Product \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-H 'UploadImageAsync: string' \
-d '{
"Category": "Top/Men",
"Name": "Captain America T-Shirt",
"Brand": "Brand",
"Code": "1003",
"Discontinued": false,
"ImageURL": "https://images.unsplash.com/photo-1622793348115-4e85dc2ca4eb?ixid=MnwxMjA3fDB8MHxzZWFyY2h8Mnx8Y2FwdGFpbiUyMGFtZXJpY2F8ZW58MHx8MHx8&ixlib=rb-1.2.1&auto=format&fit=crop&w=600&q=60",
"ExtraImagesURL": [
"//res.cloudinary.com/pos/image/upload/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/vgzleqpgujlspm9ltdiht.jpg",
"//res.cloudinary.com/pos/image/upload/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/q7dbzf9qnif8vbxuzxo0.jpg",
"//res.cloudinary.com/pos/image/upload/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/ur871mubz7ioecvja8ex.jpg"
],
"Description": "New Arrival",
"Variants": [
{
"Model": "Small",
"Code": "1003S",
"UnitCost": 100000,
"UnitPrice": 150000,
"Discontinued": true,
"Type": {
"value": "Standard"
},
"VariantDescription": "Unavailable"
},
{
"Model": "Medium",
"Code": "1003M",
"UnitCost": 125000,
"UnitPrice": 175000,
"Type": {
"value": "Standard"
},
"Discontinued": false
}
]
}'Response
application/json
{ "ID": "9525a6b0-297f-4b4a-97c7-0ae876bb44cd", "Variants": [ { … }, { … } ], "ListVariantID": [ "9ad47be6-bf1c-4dd5-87a8-193fe56d1035", "b3d68610-22a5-445d-8c5c-c79487373aa2" ] }
Bodyapplication/json
The name of the category that will be use, you also can create new category.
If you want to nest a category use a "/" operator ex: "Food/Snack/Pastries" will create 3 level category
- Production Serverhttps://subdomain.dealpos.net/api/v3/Product
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PUT \
https://subdomain.dealpos.net/api/v3/Product \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"Category": "Top/Men",
"Name": "Captain America T-Shirt",
"Brand": "Brand",
"Code": "1003",
"Discontinued": false,
"ImageURL": "https://images.unsplash.com/photo-1622793348115-4e85dc2ca4eb?ixid=MnwxMjA3fDB8MHxzZWFyY2h8Mnx8Y2FwdGFpbiUyMGFtZXJpY2F8ZW58MHx8MHx8&ixlib=rb-1.2.1&auto=format&fit=crop&w=600&q=60",
"Description": "New Arrival",
"Variants": [
{
"Model": "Medium",
"Code": "1003M",
"UnitCost": 125000,
"UnitPrice": 200000,
"Discontinued": false
},
{
"Model": "Large",
"Code": "1003L",
"UnitCost": 150000,
"UnitPrice": 225000,
"Discontinued": false
}
]
}'Response
application/json
{ "ID": "9525a6b0-297f-4b4a-97c7-0ae876bb44cd", "Variants": [ { … }, { … } ], "ListVariantID": [ "9ad47be6-bf1c-4dd5-87a8-193fe56d1035", "b3d68610-22a5-445d-8c5c-c79487373aa2" ] }
- Production Serverhttps://subdomain.dealpos.net/api/v3/Product
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X DELETE \
https://subdomain.dealpos.net/api/v3/Product \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"Code": "J100"
}'Response
application/json
"Product with code J100 has been successfully deleted."
Request
Also available as HTTP POST (endpoint: /api/v3/Product/p)
Get List of Products sorted by Category Asc, Code Asc, Name Asc
Required Group Role: "Products" - "VIEW"
Security
OAuth2_clientCredentials
- Production Serverhttps://subdomain.dealpos.net/api/v3/Product
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://subdomain.dealpos.net/api/v3/Product?PageNumber=1&PageSize=20&QueryRowCount=true&Category=string&Name=string&Discontinued=No&QueryInventory=false&SearchMode=Product' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'Response
application/json
{ "DataArray": [ { … }, { … }, { … }, { … }, { … } ], "RecordsCount": 5 }
- Production Serverhttps://subdomain.dealpos.net/api/v3/Product/Detail
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://subdomain.dealpos.net/api/v3/Product/Detail?Code=1003&ID=f74bba14-99f0-4246-84bf-3064e3d516c3' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'Response
application/json
{ "ID": "f74bba14-99f0-4246-84bf-3064e3d516c3", "Category": "Top/Men", "Name": "Captain America T-Shirt", "SupplierName": "PT ABC", "Brand": "Nike", "Code": "1003", "Discontinued": false, "Description": "New Arrival", "Storage": [ { … } ], "Tags": [ "New Brand" ], "ThumbnailURL": "https://cdn.dealpos.app/cdn-cgi/image/width=80,quality=100/net/sandbox/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/sgbksabgzjc2qmm4uigp.png", "ImageURL": "https://cdn.dealpos.app/net/sandbox/Product/f74bba14-99f0-4246-84bf-3064e3d516c3/url", "ExtraImagesURL": [ "https://cdn.dealpos.app/net/sandbox/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/vgzleqpgujlspm9ltdiht.jpg", "https://cdn.dealpos.app/net/sandbox/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/q7dbzf9qnif8vbxuzxo0.jpg", "https://cdn.dealpos.app/net/sandbox/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/ur871mubz7ioecvja8ex.jpg" ], "Variants": [ { … }, { … } ] }
Request
Also available as HTTP POST with the same endpoints
Get Product Detail By Code
Required Group Role: "Products" - "VIEW"
Security
OAuth2_clientCredentials
- Production Serverhttps://subdomain.dealpos.net/api/v3/Product/Code
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://subdomain.dealpos.net/api/v3/Product/Code?Code=1003' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'Response
application/json
{ "ID": "f74bba14-99f0-4246-84bf-3064e3d516c3", "Category": "Top/Men", "Name": "Captain America T-Shirt", "SupplierName": "PT ABC", "Brand": "Nike", "Code": "1003", "Discontinued": false, "Description": "New Arrival", "Storage": [ { … } ], "Tags": [ "New Brand" ], "ThumbnailURL": "https://cdn.dealpos.app/cdn-cgi/image/width=80,quality=100/net/sandbox/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/sgbksabgzjc2qmm4uigp.png", "ImageURL": "https://cdn.dealpos.app/net/sandbox/Product/f74bba14-99f0-4246-84bf-3064e3d516c3/url", "ExtraImagesURL": [ "https://cdn.dealpos.app/net/sandbox/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/vgzleqpgujlspm9ltdiht.jpg", "https://cdn.dealpos.app/net/sandbox/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/q7dbzf9qnif8vbxuzxo0.jpg", "https://cdn.dealpos.app/net/sandbox/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/ur871mubz7ioecvja8ex.jpg" ], "Variants": [ { … }, { … } ] }
Request
Also available as HTTP POST with the same endpoints
Get Product Detail By ID
Required Group Role: "Products" - "VIEW"
Security
OAuth2_clientCredentials
- Production Serverhttps://subdomain.dealpos.net/api/v3/Product/ID
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://subdomain.dealpos.net/api/v3/Product/ID?ID=a731920a-b3ab-42d7-b42d-b93cd69ceb92' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'Response
application/json
{ "ID": "f74bba14-99f0-4246-84bf-3064e3d516c3", "Category": "Top/Men", "Name": "Captain America T-Shirt", "SupplierName": "PT ABC", "Brand": "Nike", "Code": "1003", "Discontinued": false, "Description": "New Arrival", "Storage": [ { … } ], "Tags": [ "New Brand" ], "ThumbnailURL": "https://dealpos.b-cdn.net/net/sandbox/Product/5be4a972-a242-4ded-8722-6baf4ec270d5/newproductimage.jpg?width=80", "ImageURL": "https://cdn.dealpos.app/net/sandbox/Product/5be4a972-a242-4ded-8722-6baf4ec270d5/newproductimage.jpg", "ExtraImagesURL": [ "https://cdn.dealpos.app/net/sandbox/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/vgzleqpgujlspm9ltdiht.jpg", "https://cdn.dealpos.app/net/sandbox/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/q7dbzf9qnif8vbxuzxo0.jpg", "https://cdn.dealpos.app/net/sandbox/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/ur871mubz7ioecvja8ex.jpg" ], "Variants": [ { … }, { … } ] }
Bodyapplication/json
One of:
Array list of Outlet that use to get Product ID
Example: ["Outlet1"]
Array list of multiple product ID from chosen outlet
Example: ["14cf5b6b-0fb9-42b9-a956-09339b3985fe","f0e2bf85-cb49-4244-9e73-6e0a7403e2ca"]
- Production Serverhttps://subdomain.dealpos.net/api/v3/Product/WithInventoryByListID
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://subdomain.dealpos.net/api/v3/Product/WithInventoryByListID \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"From": 0,
"To": 10,
"ListOutlet": [
"Outlet1"
],
"ListID": [
"14cf5b6b-0fb9-42b9-a956-09339b3985fe",
"f0e2bf85-cb49-4244-9e73-6e0a7403e2ca"
],
"Discontinued": "No"
}'Response
application/json
[ { "ID": "14cf5b6b-0fb9-42b9-a956-09339b3985fe", "Name": "Denim Shirt", "Code": "1342", "CategoryID": "6d3817dc-4589-42b4-9464-4d6599046f02", "Category": "Dress", "Description": "Product Description", "ThumbnailUrl": "//res.cloudinary.com/pos/image/upload/w_80/com/christopher/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/sgbksabgzjc2qmm4uigp.png", "ImageUrl": "//res.cloudinary.com/pos/image/upload/com/christopher/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/sgbksabgzjc2qmm4uigp.png", "Created": "2018-04-06T17:24:17.283", "Discontinued": false, "Variants": [ … ] }, { "ID": "f0e2bf85-cb49-4244-9e73-6e0a7403e2ca", "Name": "Shirt", "Code": "1002", "CategoryID": "6d3817dc-4589-42b4-9464-4d6599046f02", "Category": "Dress", "Description": "Product Description", "ThumbnailUrl": "//res.cloudinary.com/pos/image/upload/w_80/com/christopher/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/sgbksabgzjc2qmm4uigp.png", "ImageUrl": "//res.cloudinary.com/pos/image/upload/com/christopher/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/sgbksabgzjc2qmm4uigp.png", "Created": "2018-04-06T17:24:17.11", "Discontinued": false, "Variants": [ … ] } ]
- Production Serverhttps://subdomain.dealpos.net/api/v3/Product/ListID
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://subdomain.dealpos.net/api/v3/Product/ListID \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"ListID": [
"14cf5b6b-0fb9-42b9-a956-09339b3985fe",
"f0e2bf85-cb49-4244-9e73-6e0a7403e2ca"
]
}'Response
application/json
[ { "ID": "14cf5b6b-0fb9-42b9-a956-09339b3985fe", "Name": "Denim Shirt", "Code": "1342", "CategoryID": "6d3817dc-4589-42b4-9464-4d6599046f02", "Category": "Dress", "Description": "Product Description", "ThumbnailUrl": "//res.cloudinary.com/pos/image/upload/w_80/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/vgzleqpgujlpm9ltdiht.jpg", "ImageUrl": "//res.cloudinary.com/pos/image/upload/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/vgzleqpgujlpm9ltdiht.jpg", "ExtraImageURL": [ … ], "Created": "2018-04-06T17:24:17.283", "Variants": [ … ] }, { "ID": "f0e2bf85-cb49-4244-9e73-6e0a7403e2ca", "Name": "Shirt", "Code": "1002", "CategoryID": "6d3817dc-4589-42b4-9464-4d6599046f02", "Category": "Dress", "Description": "Product Description", "ImageUrl": "//res.cloudinary.com/pos/image/upload/w_80/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/vgzleqpgujlpm9ltdiht.jpg", "Created": "2018-04-06T17:24:17.11", "Variants": [ … ] } ]
- Production Serverhttps://subdomain.dealpos.net/api/v3/Product/DetailByListID
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://subdomain.dealpos.net/api/v3/Product/DetailByListID \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"ListID": [
"14cf5b6b-0fb9-42b9-a956-09339b3985fe",
"f0e2bf85-cb49-4244-9e73-6e0a7403e2ca"
]
}'Response
application/json
[ { "ID": "7c1a0b28-45f2-4b65-8fe5-d5043f19ed74", "Name": "Baju Bunga 2", "Code": "TOP", "Category": "TOP", "Brand": "Classic", "Description": "ukuran tersedia saat ini hanya S", "ThumbnailUrl": "//res.cloudinary.com/dealpos/image/upload/w_80/net/tokoferdi2/Product/7c1a0b28-45f2-4b65-8fe5-d5043f19ed74/A13usaonutL._CLa_7C2140_2C2000_7C71zRbNUKhML.png_7C0_2C0_2C2140_2C2000_2B0.0_2C0.0_2C2140.0_2C2000.0_AC_UX342_.jpg", "ImageUrl": "//res.cloudinary.com/dealpos/image/upload/net/tokoferdi2/Product/7c1a0b28-45f2-4b65-8fe5-d5043f19ed74/A13usaonutL._CLa_7C2140_2C2000_7C71zRbNUKhML.png_7C0_2C0_2C2140_2C2000_2B0.0_2C0.0_2C2140.0_2C2000.0_AC_UX342_.jpg", "Created": "2022-06-14T11:30:37.4", "Variants": [ … ], "ProductImages": [ … ] } ]
- Production Serverhttps://subdomain.dealpos.net/api/v3/Product/WithOutletPriceByListID
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://subdomain.dealpos.net/api/v3/Product/WithOutletPriceByListID \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"ListID": [
"14cf5b6b-0fb9-42b9-a956-09339b3985fe",
"f0e2bf85-cb49-4244-9e73-6e0a7403e2ca"
]
}'Response
application/json
[ { "ID": "14cf5b6b-0fb9-42b9-a956-09339b3985fe", "Name": "Denim Shirt", "Code": "1342", "CategoryID": "6d3817dc-4589-42b4-9464-4d6599046f02", "Category": "Dress", "Description": "Product Description", "ThumbnailUrl": "//res.cloudinary.com/pos/image/upload/w_80/com/christopher/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/sgbksabgzjc2qmm4uigp.png", "ImageUrl": "//res.cloudinary.com/pos/image/upload/w_80/com/christopher/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95///res.cloudinary.com/pos/image/upload/com/christopher/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/sgbksabgzjc2qmm4uigp.png", "Created": "2018-04-06T17:24:17.283", "Variants": [ … ] }, { "ID": "f0e2bf85-cb49-4244-9e73-6e0a7403e2ca", "Name": "Shirt", "Code": "1002", "CategoryID": "6d3817dc-4589-42b4-9464-4d6599046f02", "Category": "Dress", "Description": "Product Description", "ImageUrl": "//res.cloudinary.com/pos/image/upload/w_80/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/vgzleqpgujlpm9ltdiht.jpg", "Created": "2018-04-06T17:24:17.11", "Variants": [ … ] } ]
- Production Serverhttps://subdomain.dealpos.net/api/v3/Product/WithPricebookByListID
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://subdomain.dealpos.net/api/v3/Product/WithPricebookByListID \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"ListID": [
"14cf5b6b-0fb9-42b9-a956-09339b3985fe",
"f0e2bf85-cb49-4244-9e73-6e0a7403e2ca"
]
}'Response
application/json
[ { "ID": "14cf5b6b-0fb9-42b9-a956-09339b3985fe", "Name": "Denim Shirt", "Code": "1342", "CategoryID": "6d3817dc-4589-42b4-9464-4d6599046f02", "Category": "Dress", "Description": "Product Description", "ThumbnailUrl": "//res.cloudinary.com/pos/image/upload/w_80/com/christopher/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/sgbksabgzjc2qmm4uigp.png", "ImageUrl": "//res.cloudinary.com/pos/image/upload/w_80/com/christopher/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95///res.cloudinary.com/pos/image/upload/com/christopher/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/sgbksabgzjc2qmm4uigp.png", "Created": "2018-04-06T17:24:17.283", "Variants": [ … ] }, { "ID": "f0e2bf85-cb49-4244-9e73-6e0a7403e2ca", "Name": "Shirt", "Code": "1002", "CategoryID": "6d3817dc-4589-42b4-9464-4d6599046f02", "Category": "Dress", "Description": "Product Description", "ImageUrl": "//res.cloudinary.com/pos/image/upload/w_80/Product/afa67ca2-46f4-418a-a5fe-a3a79b1dbc95/vgzleqpgujlpm9ltdiht.jpg", "Created": "2018-04-06T17:24:17.11", "Variants": [ … ] } ]