BaseResponsePagination
resultsnumberExample: 233pagesnumberExample: 100pagenumberExample: 4per_pagenumberExample: 2
CustomerListRequest
limitnumber · int64The limit of the results return - can be between 0 and 100
Example: 15Default: 10pagenumber · int64The page/index of the results related to the result number
Example: 2Default: 0searchstringSearch the customers by name or email - case sensitive
Example: Jhondirectionstring · enumThe direction of return results by the customer creation date
Enum values:descasc
CustomerListResponse
customer_idnumber · int64Customer unique id - use to delete/get/edit customer
Example: 123customer_group_idnumber · int64Customer group id
Example: 23namestringFull customer name
Example: Jhon DoetelephonestringCustomer`s phone
Example: 0544884654date_addedstring · dateDate customer added or registered
addressesobject[]
CustomerSingleResponse
customer_idnumber · int64Customer unique id - use to delete/get/edit customer
Example: 123customer_group_idnumber · int64Customer group id
Example: 23namestringFull customer name
Example: Jhon DoetelephonestringCustomer`s phone
Example: 0544884654date_addedstring · dateDate customer added or registered
addressesobject[]
CustomerCreate
firstnamestringCustomer first name
Example: JhonlastnamestringCustomer last name
Example: DoetelephonestringCustomers telephone
Example: 0544884547passwordstringPassword that will be related to this customer to login to the store
Example: 12345678confirmstringPassword confirmation
Example: 12345678responder_listnumber · int64Responder list id for subscription to newsletter
Example: 3221addressobjectObject of the main address will be related to the new customer
CustomerEdit
firstnamestringCustomer first name
Example: JhonlastnamestringCustomer last name
Example: DoetelephonestringCustomers telephone
Example: 0544884547passwordstringPassword that will be related to this customer to login to the store (If you dont want to change password dont pass this and confirm field)
Example: 12345678confirmstringPassword confirmation
Example: 12345678addressobjectObject of the main address will be related to the new customer
PaymentData
unique_idstringlangstringauth_numberintegerthe auth number of the order
responce_macstringresponses code that get back from CG after transaction
terminal_numintegerthe terminal num (updated once a day)
mutav_nointegerThe dealer num
card_tokenintegerthe card token can be use for delayed order transacrions
card_expintegerFirst two numbers are month , 2nd two numbers are year
card_maskintegerThe card number with mask at the middle (not full number)
tx_idstringsuccessfully transactions give back special transaction id that can be used for refunding and more
number_of_paymentintegerfirst_paymentintegerRelevant only if there is payment_lastname
periodical_paymentintegerRelevant only if there is payment_lastname
mpiValidationstring · enumDescribe the type of the transaction
Enum values:AutoCommVerify
StockStatusList
successbooleanExample: truestatusesobject[]request_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
customFieldResponse
custom_field_idintegerRepresents order custom field id
custom_field_value_idintegerRepresents custom field value id
namestringThe name of the custom field
Example: Shoes sizevaluestringThe value of the field
Example: XLtypestringThe type of the field entered
Example: textlocationstringThe location of the field in the checkout page
Example: addressslugstringPermament slug for api usage
Example: house-number
LanguageList
successbooleanExample: truelanguagesobject[]Array of language objects
request_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
CurrencyList
successbooleanExample: truecurrenciesobject[]request_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
DimensionList
successbooleanExample: trueweightsobject[]Array of valid weight classes inc their description
lengthsobject[]Array of valid length dimension classes
request_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
CouponListRequest
pageinteger · min: 1 · max: 9999The start page for list pagination
Example: 1Default: 1limitinteger · min: 1 · max: 100The results count limit between 1 - 100
Example: 50Default: 50date_startstring · dateSet the min date the coupon is valid from for usage
Example: 2021-04-03date_endstring · dateSet the max date the coupon is valid from for usage
Example: 2021-04-03order_used_startstring · dateThe mininmum date for the order related to current coupon
Example: 2021-04-03order_used_endstring · dateThe maximum date for the order related to current coupon
Example: 2021-04-03date_added_startstring · dateThe mininmum date from the coupon added to system
Example: 2021-04-03date_added_endstring · dateThe maximum date from the coupon added to system
Example: 2021-04-03namestringThe name of the coupon or part of it
Example: summer salecodestringThe code of the coupon or part of it
Example: SUMMER1012typestring · enumThe type of the coupon for filter
Enum values:percentPfixedFgiftDorder_idinteger · int32The order id related to the coupon
Example: 54222
CouponResponseStructure
coupon_idintegerThe id represent the coupon for CRUD and etc
Example: 23namestringThe coupon name
Example: Gift for novembercodestringThe Coupon code
Example: JHG34Gtypestring · enumThe type of the coupon (The letters at the example are the same as the string before)
Enum values:percentPfixedFgiftDdiscountnumber · int64The discount value of the coupon (the behaviour depends on the coupon type)
Example: 44loggedinteger · enum · int321 - The coupon only for logged customers | 2 - coupon available for everyone
Enum values:01shippinginteger · enum · int320 - Exclude shipping | 1 - Free shipping | 2 - Include the shipping at the math action for this coupon
Enum values:012totalinteger · int32The minimum total sum the customer have to reach in his cart to apply the coupon
Example: 100date_startstring · dateThe date the coupon is available from
Example: 2021-04-03date_endstring · dateThe maximum date the coupon is available
Example: 2021-04-03date_addedstring · dateThe date the coupon added
Example: 2021-04-03uses_totalstringThe maximum total uses for this coupon
Example: 3uses_customerstringThe maximum uses available for each registered customer (if the coupon only for registered customers)
Example: 10statusinteger · enum · int321 - The coupon is active | 0 - The coupon not active
Enum values:01multiple_dealsinteger · int321 - The coupon enables more discounts | 0 - If coupon active other discounts will not work
Example: 1total_usedinteger · int32The total times the current coupon used at the system
Example: 45
ShippingSingleResponse
display_namestringThe display name of the shipping
Example: My brand shippingcodestringUnique code for shipping for other systems usage
Example: xyz_shippingsort_orderintegerThe sort order of the shipping compared to other shipping methods
Example: 1from_sumnumber · int64If there is from sum requirement for current shipping
Example: 450limit_sumnumber · int64If there is limit sum requirement for current shipping
Example: 850statusintegerThe status of the shipping (1 - active and used, 0 - disabled)
Example: 1typeintegerThe shipping type (0 - regular cart shipping, 1 - product related shipping type)
Example: 1costnumber · int64The shipping cost in system's currency
Example: 265tax_class_idintegerThe id of the tax class
Example: 0shipping_feed_statusboolean · int320 - not showing in feeds, 1 - showing in feeds
Example: 1settingsobjectobject with different shipping extra settings
descriptionsobjectObject with current shipping descriptions
Example: {"1":"Shipping description language id 1","3":"Shipping description language id 3"}titlesobjectObject with current shipping titles
Example: {"1":"Shipping title language id 1","3":"Shipping title language id 3"}additional_notesobjectObject with current shipping additional_notes
Example: {"1":"Shipping title additional_note id 1","3":"Shipping title additional_note id 3"}
ShippingMethodListResponse
shipping_idintegerThe shipping ID (used for /shipping/{shipping_id} request)
Example: 33display_namestringThe display name of the shipping
Example: My brand shippingcodestringUnique code for shipping for other systems usage
Example: xyz_shippingsort_orderintegerThe sort order of the shipping compared to other shipping methods
Example: 1from_sumnumber · int64If there is from sum requirement for current shipping
Example: 450limit_sumnumber · int64If there is limit sum requirement for current shipping
Example: 850statusintegerThe status of the shipping (1 - active and used, 0 - disabled)
Example: 1typeintegerThe shipping type (0 - regular cart shipping, 1 - product related shipping type)
Example: 1costnumber · int64The shipping cost in system's currency
Example: 265tax_class_idintegerThe id of the tax class
Example: 0shipping_feed_statusboolean · int320 - not showing in feeds, 1 - showing in feeds
Example: 1settingsobjectobject with different shipping extra settings
CustomFieldCrudStructure
nameobjectObject of names by lagnuage id
Example: {"3":"House num"}typestringFill the type of the custom field (there is api request for valid list of types)
Example: radiolocationstringThe location of the custom field (now only 'address available')
Example: addressvalidationstringA valid regex pattern for the custom field (leave empty to allow all chars)
Example:sort_orderintegerThe order of the custom field in the relation to another fields
slugstringA valid slug without sapcing for inner proccesses and API (you can leave it empty, the system will create it automaticly)
statusinteger · booleanThe status of the custom field ('1' means its active)
requiredinteger · booleanIf field is required pass '1'
custom_field_valueobject[]Array of objects with data of the custom field values (only if its multi value field like radio or checkbox)
webhookSingle
webhook_idintegerThe ID of the webhook used for single webhook actions
Example: 4namestringWebhook name to recognize
Example: Webhook namedescriptionstringWebhook description
Example: Webhook descriptioneventsinteger[]actionstringRequest action (post/get/put/delete)
Example: posturlstringValid url for webhook
Example: https://webhook.site/7b152643-b570-46dd-976c-bee83497af41headersobject[]content_typestringThe body content type (system/custom)
Example: system
webhookListRequest
offsetintegerThe offset of the results (start from offset and get the limit)
Example: 0limitinteger · max: 50The limit of results for pagination
Example: 20searchstringSearch webhooks by name or description
Example: my webhook 2
webhookCreateUpdateRequest
namestringThe name of the webhook
Example: webhook1descriptionstringThe description of the webhook
Example: description1eventsinteger[]Array of evnt ids (check webhook event request)
Example: [1,2]actionstringThe action of the webhook request (post/put/delete/get)
Example: posturlstringThe url of the webhook request
Example: https://webhook.site/7b152643-b570-46dd-976c-bee83497af41headersobject[]content_typestringThe body sent type can be "json" / "system"
Example: system
webhookEventListResponse
event_idintegerThe event id used to create/update webhooks
Example: 1event_slugstringThe event short description formated to slug
Example: new_orderevent_groupstringThe event group current slug related to (not used)
Example: orders
ProductSingleResponse
successbooleanExample: trueproductobjectrequest_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
ProductBulkEditResponse
successbooleanExample: trueresponsestringExample: Product bulk edit completeupdated_productsinteger[]List of items that updated
Example: [64222,53331]nothing_to_update_productsinteger[]List of items that were nothing to update
Example: [54222,23331]request_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
ProductBulkEditRequest
product_idintegerProduct ID that we update
Example: 23331quantityintegerUpdated product's quantity
Example: 3pricenumber · floatProduct's price
Example: 56.76
ProductListResponse
successbooleanExample: trueProductsobject[]resultsnumberExample: 233pagesnumberExample: 100pagenumberExample: 4per_pagenumberExample: 2request_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
ProductAddRequest
product_descriptionobject · requiredExample: {"3":{"name":"Green socks","description":"My brand socks"}}
skustringThe SKU od the product
Example: dkasj234modelstringminimumintegerminimum items to add to cart
Example: 10upcstringUPC code for current product
weightinteger · floatNumeric value of the weight of the product, if not passed it is zero
Example: 40weight_class_idinteger · int32The id of the weight class you are using for current product (There is separate API request that return all the weight classes, check "misc/dimension_lst")
Example: 3lengthinteger · floatNumeric value of the length of the product, if not passed it is zero
Example: 15widthinteger · floatNumeric value of the width of the product, if not passed it is zero
Example: 15heightinteger · floatNumeric value of the height of the product, if not passed it is zero
Example: 15length_class_idinteger · int32The id of the length class you are using for current product (There is separate API request that return all the weight classes, check "misc/dimension_lst")
Example: 3stock_statusintegerValid stock status id (you can find them in separate API call the returns stock status ids)
Example: 7subtractinteger · booleanPass '1' if you want to activate subtruct feature, if not pass '0'
sort_orderintegerThe order of the product related to another products
Example: 9statusinteger · booleanIf you want disactivate the product pass '0' else pass '1'
keywordstringKeyword related to SEO
Example: foodquantityintegerThe quantity of your product
Example: 10hiddeninteger · booleanHide your product from the customers by passing '1' else pass '0'
Example: 0imagestringValid URL for valid image format (jpg,jpeg,png)
imagesobject[]pricenumber · floatExample: 56.76product_pricingobjectproduct_relatedinteger[]Example: [12,15,33]product_categoryinteger[]Example: [555,444,123]product_attributesobject[]product_specialobject[]product_optionobject[]Array of options objects
shipping_productinteger[]Array of numeric shipping ids that valid for product (type 1 and above)
Example: [12,45,77]sticker_statusinteger · booleanDefines if the sticker enabled / enabled/disabled
sticker_typestring · enumDefines wich type of sticker
Enum values:percentsumcustomsticker_textobjectThe custom option text (for each language)
sticker_settingsobjectAll the sticker text styling options
ProductEditRequest
skustringThe SKU od the product
Example: dkasj234modelstringminimumintegerminimum items to add to cart
Example: 10upcstringUPC code for current product
weightinteger · floatNumeric value of the weight of the product, if not passed it is zero
Example: 40weight_class_idinteger · int32The id of the weight class you are using for current product (There is separate API request that return all the weight classes, check "misc/dimension_lst")
Example: 3lengthinteger · floatNumeric value of the length of the product, if not passed it is zero
Example: 15widthinteger · floatNumeric value of the width of the product, if not passed it is zero
Example: 15heightinteger · floatNumeric value of the height of the product, if not passed it is zero
Example: 15length_class_idinteger · int32The id of the length class you are using for current product (There is separate API request that return all the weight classes, check "misc/dimension_lst")
Example: 3stock_statusintegerValid stock status id (you can find them in separate API call the returns stock status ids)
Example: 7subtractinteger · booleanPass '1' if you want to activate subtruct feature, if not pass '0'
sort_orderintegerThe order of the product related to another products
Example: 9statusinteger · booleanIf you want disactivate the product pass '0' else pass '1'
keywordstringKeyword related to SEO
Example: foodquantityintegerThe quantity of your product
Example: 10hiddeninteger · booleanHide your product from the customers by passing '1' else pass '0'
Example: 0imagestringValid URL for valid image format (jpg,jpeg,png)
imagesobject[]Array of additional images sent for each product (optional)
pricenumber · floatExample: 56.76product_pricingobjectproduct_relatedinteger[]Example: [12,15,33]product_categoryinteger[]Example: [555,444,123]product_descriptionobjectExample: {"3":{"name":"Green socks","description":"My brand socks"}}sticker_statusinteger · booleanDefines if the the sticker enabled/disabled
sticker_typestring · enumDefines the type of the sticker
Enum values:percentsumcustomsticker_textobjectThe text appears on sticker (referenced by language id) in case of custom text chosen
sticker_settingsobjectThe sticker text styling
product_optionobject[]Array of options objects (If you want to empty the option pass empty array !)
shipping_productinteger[]Array of numeric shipping ids that valid for product (type 1 and above)
Example: [12,45,77]product_specialobject[]
ProductSpecials
priceinteger · floatThe price of the discount for current product must be float type more then zero
Example: 0date_startstring · dateStart date for current discount is required, format {Y-m-d} see example below
Example: 2018-12-02date_endstring · dateEnd date for current discount is required, format {Y-m-d} see example below
Example: 2018-12-02
ProductOptionsValues
option_value_idintegerThe id of the current option value related to the father option (shown from list)
Example: 44quantityintegerThe quantity of the current value (not required)
subtractinteger · booleanSet '1' if this value is subtractable or '0' if not
Example: 1priceinteger · floatIf there is additional price for current value or maybe discount add it here
Example: 12.99price_prefixstring · enumSet "+" (plus) if the price is additional or "-" (minus) if the price will be less for current value
Enum values:+-imagestringValid url if an image will be related to current value (available only for "select" type of option for now)
Example: https://www.exampleweb.com/example_img.jpggroupsobject[]Array of related options and option values to current value that will be subtracted together. Requires the "Advanced Inventory Management" app to be activated
ProductCrudOptionObject
product_option_idnumberProduct option id (if exist)
Example: 23namestringThe name of the option (chosen from option list may include multiple languages)
Example: sizeoption_idstringThe option id (return from option list GET request) have to be numeric string
Example: 123typestringThe option type (Also return from option GET list each option has type)
Example: checkboxrequiredinteger · booleanSet '1' if this option is required to proceed the product purchase
product_option_valueobject[]Array of option values that will be shown related to product
CategorySingleSingle
successbooleanExample: truecategory_idintegerExample: 45sort_orderintegerExample: 10topintegerExample: 0parent_idintegerExample: 2statusintegerExample: 1imagestringExample: https://example.com/images/sample-image.pngkeywordstringExample: new-keyword-123homefeaturedintegerExample: 1hiddenintegerExample: 1urlstringExample: https://example.com/new-category-urldescriptionobjectThe key of the object represent the language id
Example: {"3":{"name":"Canned Goods","description":"Assorted canned goods.","meta_title":"Canned Goods","meta_description":"Variety of canned goods.","meta_keyword":"Canned,Goods,Food"}}category_filtersobjectExample: {"30":{"filter_id":30,"filter_name":"Added Value","filter_group_id":16,"filter_group_name":"Value Group"}}request_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
CategoryCreateEdit
descriptionsobjectObject with language ids as index
Example: {"3":{"name":"T-shirts","description":"My T-shirts description","meta_title":"T-shirts","meta_description":"My T-shirts description","meta_keyword":"My,T-shirts,clothes"}}parent_idstringSet parent category (from your own categories ids), set 0 to ignore this option
Example: 2Default: 0keywordstringSet url keyword
Example: my-categoryimagestringInser valid image url (best to use cloudinary service to upload there first)
topinteger · booleanShow/Hide this category at the top bar (0/1)
sort_orderintegerSet category order number (affect the visual part in the store)
Example: 12homefeaturedinteger · booleanShow/Hide this category at the main page (1/0)
statusinteger · booleanEnable/Disable this category (1/0)
hiddeninteger · booleanShow/Hide the category from the store area (will be available by direct link to)
CategoryListResponse
successbooleanExample: trueresponseobject[]request_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
CategoryMutualResponse
category_idintegerExample: 45sort_orderintegerExample: 10topintegerExample: 0parent_idintegerExample: 2statusintegerExample: 1imagestringExample: https://example.com/images/sample-image.pngkeywordstringExample: new-keyword-123homefeaturedintegerExample: 1hiddenintegerExample: 1urlstringExample: https://example.com/new-category-url
OrderListResponse
successbooleanExample: trueresponseobject[]array with all orders
resultsnumberExample: 233pagesnumberExample: 100pagenumberExample: 4per_pagenumberExample: 2request_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
OrderSingleResponse
successbooleanExample: trueresponseobjectrequest_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
OrderProductsHistories
notifystringIf notifed the customer about the status change it will be "yes" in local language
Example: truestatusstringThe status that set in current change
Example: paiddate_addedstring · dateThe date when the status changed for current object
Example: 14/06/2020
OrderTotalsData
titlestringDescription of the total
Example: Discount for couponvalueintegerThe value is the sum that current total paid/discounted
Example: 245codestringThe code of current total item
Example: shipping
OrderProductsData
order_product_idintegerproduct_idintegerThe product id
namestringThe product name
modelstringskustringquantityintegerThe quantity of this product at the current order
priceintegerThe price of this current product
specialintegerRepresents special price if was enabled
original_priceintegerAssiciated with the special (show the original price)
weightinteger · floatNumeric value of the weight of the product, if not passed it is zero
Example: 40weight_class_idinteger · int32The id of the weight class you are using for current product (There is separate API request that return all the weight classes, check "misc/dimension_lst")
Example: 3lengthinteger · floatNumeric value of the length of the product, if not passed it is zero
Example: 15widthinteger · floatNumeric value of the width of the product, if not passed it is zero
Example: 15heightinteger · floatNumeric value of the height of the product, if not passed it is zero
Example: 15length_class_idinteger · int32The id of the length class you are using for current product (There is separate API request that return all the weight classes, check "misc/dimension_lst")
Example: 3optionobject[]
OrderCreateDocRequest
doc_typestring · enumThe document type must be one of (invrec,invoice,receipt,refund)
Enum values:invrecinvoicereceiptrefundExample: invoicecompany_personal_namestringNot required field that allows you to override the exist name with new personal/company name for invoice
Example: My Company LTDcompany_personal_idstringNot required field that allows you to override the esit persona; id with new personal/company Bn Number
Example: 23455234234telephonestringNot required field that allows you to override order's phone for the document
Example: 0548654366emailstringNot required field that allows you to override order's email for the document receiver
Example: [email protected]refund_sum
OrderCreateShippingRequest
providerstring · enumRequired field what shipping provider to create
Enum values:chitaExample: chitapackages_numberintegerThe package number you will send and will be charged for (and get sticker for each package)
Example: 3shipping_typestring · enumThe shipping type for current provider not required
Enum values:door_to_doorlockersExample: door_to_door
OrderProviderShippingRequest
providerstring · enumRequired field what shipping provider to create
Enum values:chitaExample: chita
OrderCreateDocResponse
successbooleanExample: trueresponseobjectrequest_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
OrderCreateShippingResponse
successbooleanExample: trueresponseobjectrequest_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
OrderStatusShippingResponse
successbooleanExample: trueresponseobjectrequest_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
OrderStatusList
successbooleanExample: trueresponseobjectExample: {"1":[{"order_status_id":2,"name":"Processing"},{"order_status_id":3,"name":"Shipped"}]}request_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
OrderStatusUpdateRequest
order_status_idinteger · requiredNumber that represent valid order status id (you can find API call for this statuses)
Example: 2
commentstringComment that will appear in the order status history related to the status you update
Example: Sent to customer Xnotifyinteger · enumPass 1 if you want to notifiy the customer abouth the status change
Enum values:01Default: 0sms_notifyinteger · enumPass 1 if you want to notify client by sms
Enum values:01Default: 0sms_contentstring · max: 150Message that will be sent to the customer associated with current order
Example: Thank you, your order complete!Default: null
OrderHistoryUpdateRequest
commentstring · requiredComment that will appear in the order status history related to the status you update
Example: Sent to customer X
CustomOrderListRequest
date_fromstringValid date (year-month-day) wich we start the filter from
Example: 2020-01-20date_tostringValid date (year-month-day) wich we end the filter
Example: 2020-01-25limitinteger · min: 1 · max: 100Limit orders per page (minimum 1)
Example: 10pageinteger · min: 1Limit orders per page (minimum 1)
Example: 1
CustomOrderListResponse
successbooleanExample: trueresponseobject[]array with all orders
resultsnumberExample: 233pagesnumberExample: 100pagenumberExample: 4per_pagenumberExample: 2request_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
CustomOrderSingleResponse
successbooleanExample: trueresponseobjectrequest_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
OptionListResponse
successbooleanExample: trueresponseobject[]request_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
OptionSingleResponse
successbooleanExample: trueresponseobjectrequest_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
OptionCreateRequest
typestring · enum · requiredEnum values:selectradiocheckboxtextfiledatetimedatetimeoption_descriptionobject[] · required
option_valueobject[]
OptionCreateResponse
successbooleanExample: trueresponseintegerCreated option id
request_idstringExample: 1ef2da0b-6f98-6fec-b13f-06c63b84be49
OptionUpdateRequest
typestring · enum · requiredEnum values:selectradiocheckboxtextfiledatetimedatetimeoption_descriptionobject[] · required
option_valueobject[]