Global References

This section covers the global references, objects, enumerator definitions used across the PIM API.

Response Wrapper Model

This is the response wrapper object which wraps all the data responses returned by the API. The endpoint specific data is populated in result property of the object.

Response Model

Response

{
    "statusCode": 200,
    "status": "OK",
    "error": null,
    "errorId": null,
    "message": null,
    "messageCode": "OK",
    "result": [
      { 
        //API endpoint specific object 
      }
    ]
}
 
NameTypeDescription
statusCodeintHolds the http status codes, typically 200 for success and 500 for error.
statusstringHolds the status name related to the status code.
errorstringError message in case of any error.
errorIdstringUnique Error Id generated for the specific error, used for reference while creating a support ticket.
messagestringMessage to display on front end if any in case of errors. Typically left blank in case of successful operation.
messageCodestringMessage code related to the response.
resultobjectContains the API endpoint specific data object.

Product Types

ProductTypevalue
Product1
Service2
GiftCard4
Bundle7
DynamicBundle8
Addon10
GiftWrap11
GiftBox189
GiftBoxLine202
RelationTypeDescription
GWPGifts with Purchase
UPGRADEUpgrade option
ALSOLIKEyou may also like
ALSONEEDyou may also need
BASKETGROUPdisplayed in basket when items are added
ADDONSAdd on for the product
ALTERNATIVEAlternative for the product
WORKSWITHworks with the product

System Status

StatusValue
None0
Draft1
Active2
Archived3
Discontinued4

Action

ActionsValue
Create1
Update2
Delete3

Task Status

TaskStatusValue
Open1
InProgress2
Completed3

SupplierTypes

SupplierTypesValue
Individual1
Company2

SupplierPOCreateTypes

SupplierPOCreateTypesValue
None0
OnePOAgainstEachSO1
ConsolidatePOForMultipleSO2

PurchasabilityTypes

PurchasabilityTypeValue
OnlineStore1
PreOrder2
ForwardOrder3

MessageCodes

MessageCodesValue
CreatedSuccessfully2000
AddedSuccessfully2001
SavedSuccessfully2002
UpdatedSuccessfully2003
DeletedSuccessfully2004
ErrorOccurred2005

SearchFor

SearchForvalue
Both0
Master1
Variant2

Media Types

MediaTypesValue
Image0
Video1
Pdf2

Field Update Types

FieldUpdateTypeValue
Both0
Master1
Variant2

Input Types

InputTypeValue
Text1
Select2
LongText3
Date4
Radio5
Multi-select6
Datetime12
Multi-level-select13
Number14