Appendix A – List of Error and Warning Messages
Non-zero error codes for the Inbound Interface are described in the following table, where error is a problem in the transaction that causes the command rejection, and warning is a problem in the transaction with which the command can be executed.
If the error message is not descriptive, additional description is provided in the following table. The errors are listed in the order of their codes.
In case you encounter any error codes that are not mentioned in the following table, contact support.
| Number | Error/Warning | Text | Description and solution |
|---|---|---|---|
|
60080 |
error |
You don't have permission for this action. |
Authentication failed. This could be because of one the following: – invalid credentials (user does not exist or password is incorrect) – user does not have permissions set up to access the Inbound API – the <now> date differs from the server time by more than 30 minutes – the <auth_string> is generated incorrectly |
|
69001 |
error |
Wrong version of SOAP request. Expected start node '%s', got '%s'. |
Check the input. |
|
69002 |
error |
Mandatory element is empty or absent: '%s/%s' |
Check the input for the element referred in the message. |
|
69003 |
error |
'head/upload_type' element is absent or invalid |
Check the input. |
|
69005 |
error |
'data/providers' element is absent or empty |
Check the input. |
|
69006 |
error |
'data/commands' must not be present for full upload |
Check the input. |
|
69007 |
error |
'data/commands' element is absent or empty |
Check the input. |
|
69008 |
error |
'data/providers' must not be present for incremental upload |
Check the input. |
|
69009 |
error |
'head/processing_mode' has invalid value '%s'. (valid values are '%s','%s') |
Check the input. |
|
69010 |
error |
'head/date' is not a YYYY-MM-DD date '%s' |
Check the input. |
|
69011 |
error |
'head/date' is in past |
Check the input. |
|
69012 |
error |
'head/date' parameter is mandatory for full upload type |
Check the input. |
|
69013 |
error |
'head/provider_group' parameter- property not found '%s' |
head/provider_group if specified, must contain a label of a valid provider property visible to inbound interface. Ensure provider group is a valid property label. See Company Settings → Properties page for the list of properties. |
|
69014 |
error |
'head/provider_group' parameter- is not a provider property '%s' |
head/provider_group if specified, must contain a label of a valid provider property visible to inbound interface. Ensure provider group is a valid property label. See Company Settings → Properties page for the list of properties. |
|
69015 |
error |
'head/appointment/action_if_completed' has invalid value: '%s' |
Check the input. |
|
69016 |
error |
'head/appointment/keys' parameter is absent or empty |
Valid keys are: appt_number, customer_number, name. |
|
69017 |
error |
'head/appointment/keys' invalid appointment key: '%s' |
Valid keys are: appt_number, customer_number, name. |
|
69018 |
error |
'head/inventory/upload_type' has invalid value '%s'. (valid values are '%s','%s') |
Set head/inventory/upload_type to either full or incremental. |
|
69019 |
error |
'head/inventory/keys' parameter is absent or empty |
Valid keys are: invsn, invtype, invtype_label. |
|
69020 |
error |
'head/inventory/keys' invalid inventory key: '%s' |
Valid keys are: invsn, invtype, invtype_label. |
|
69021 |
error |
'head/properties_mode' has invalid value: '%s'. (valid values are '%s','%s','%s') |
Valid keys are: update, replace. |
|
69022 |
error |
Invalid date format in field '%s': expected '%s' got '%s' |
Check the input. |
|
69023 |
error |
Invalid integer format in field '%s': got '%s' |
Check the input. |
|
69024 |
error |
Invalid floating point number format in field '%s': got '%s' |
Check the input. |
|
69025 |
error |
Internal error in '%s' - PHP interface not implemented |
Contact the support. |
|
69026 |
error |
Internal error in '%s' %d |
Contact the support. |
|
69027 |
error |
Unexpected end of document |
The xml request is invalid. Check the input. |
|
69028 |
error |
Error parsing XML |
The xml request is invalid. Check the input. |
|
69029 |
error |
NULL name of element node |
Internal error. Contact the support. |
|
69030 |
error |
Node not found: '%s' |
Check the input. |
|
69031 |
error |
Child node not found: '%s/%s' |
Check the input. |
|
69032 |
error |
Error decoding base64 |
A file property is not properly encoded in request. Ensure it's encoded in base64. |
|
69033 |
error |
Invalid appointment key name in link: '%s' |
Valid keys are: appt_number, customer_number, name |
|
69034 |
error |
Error creating xml-reader |
Internal error. Contact the support. |
|
69035 |
error |
Time slot not found: '%s' |
Appointment time_slot field must contain valid time slot label. Check the input. |
|
69037 |
error |
Will not set unordered- activity type does not support this |
Activity type specified in 'worktype' field does not allow appointment without service window. Change activity type. |
|
69038 |
error |
Key field is absent: '%s' |
Activity or inventory key is absent. Check the input. |
|
69039 |
error |
Key field is empty: '%s' |
Activity or inventory key is empty. Check the input. |
|
69040 |
error |
No key fields specified |
Activity or inventory key is absent. Check the input. |
|
69041 |
error |
Inventory key fields are not defined |
Internal error. Contact the support. |
|
69042 |
error |
Inventory properties are absent |
Inventory has no properties – nothing can be added. Check the input. |
|
69043 |
error |
Inventory key field is empty: '%s' |
Activity or inventory key is empty. Check the input. |
|
69044 |
error |
Inventory key field has numeric type but non-numeric value: label='%s' value='%s' |
'invtype' field must be a number. Check the input. |
|
69045 |
error |
Inventory key field is absent: '%s' |
Activity or inventory key is absent. Check the input. |
|
69046 |
error |
Inventory key is empty |
Inventory key is empty. Check the input. |
|
69049 |
warning |
Cannot add link. Appointment not found: '%s' |
Link refers to an activity that cannot be found (e.g. it may be in the past). Do not send this link. |
|
69050 |
error |
Provider not found: '%s' |
Check the input. |
|
69051 |
warning |
Property name is empty |
Check the input. |
|
69052 |
warning |
Invalid property name: '%s' |
Property not found in OFSC. Check the input or add this property. |
|
69053 |
warning |
Duplicate property: '%s' |
There are multiple properties in the same appointment/inventory with the same label. All but one of them (the last one) will be ignored. Remove duplicates from the input. |
|
69054 |
warning |
Invalid file encoding: '%s'. (valid values are '%s', '%s') |
'files/file/encoding' has invalid value. Check the input. |
|
69055 |
warning |
File too big: '%s' |
The file passed into a file property is bigger than allowed limit of 512000 bytes. File will not be added. Ensure that the files to be sent are not too large. |
|
69056 |
warning |
Could not insert file '%s' |
Internal error. Contact the support. |
|
69057 |
warning |
Property is not a file property but sent as file: '%s' |
Non-file property is sent in 'files' array. Check the property description. |
|
69058 |
warning |
Invalid MIME type for property: '%s' mime_type='%s' |
File property has MIME type that is not in the list of allowed types. Check the property description. |
|
69059 |
warning |
No filename for property: '%s' |
File property has no filename. Check the input. |
|
69060 |
warning |
File is empty: '%s' |
File property has no file data. Check the input. |
|
69061 |
warning |
Duplicate file property: '%s' |
There are multiple file properties in the same appointment/inventory with the same label. All but the last one will be ignored. Remove duplicates from the input. |
|
69062 |
warning |
Property is read-only: '%s' |
You have no permission to modify this property. Check permissions in the display profile. |
|
69063 |
warning |
Property is not visible: '%s' |
You have no permission to modify this property. Check permissions in the display profile. |
|
69064 |
warning |
Duplicate field %s |
Non-array field is encountered twice. Check the input. |
|
69065 |
error |
Mandatory field missing: worktype |
Check the input. |
|
69066 |
error |
Unknown worktype ID: '%s' |
Check the input. |
|
69067 |
error |
Unknown worktype label: '%s' |
Check the input. |
|
69068 |
error |
Activity type cannot be created from inbound interface: '%s' |
The activity type does not the support 'Allow to create from Incoming interface' option. Check the input / activity type. |
|
69069 |
error |
Invalid phone number format: '%s' |
Check the input. Contact the support if you think the phone format is correct. |
|
69070 |
error |
Invalid cell phone number format: '%s' |
Check the input. Contact the support if you think the cell format is correct. |
|
69071 |
error |
Unknown time zone id: %d |
Check the input. |
|
69072 |
error |
Unknown time zone name: '%s' |
Check the input. |
|
69073 |
error |
Unknown language id: %d |
Check the input. |
|
69074 |
error |
Unknown language name: '%s' |
Check the input. |
|
69075 |
error |
Either 'service_window_start' or 'service_window_end' is absent |
Either none or both of fields must be present. Check the input. |
|
69076 |
error |
Field contents is not a time 'service_window_start': '%s' |
Check the input. |
|
69077 |
error |
Field contents is not a time 'service_window_end': '%s' |
Check the input. |
|
69078 |
error |
Service window start > service window end: '%s' > '%s' |
Check the input. |
|
69079 |
error |
Field contents is not a date-time: SLA window' |
Check the input. |
|
69080 |
error |
SLA window start > SLA window end: '%s' > '%s' |
Check the input. |
|
69081 |
error |
Either 'coordX' or 'coordY' is absent |
Either none or both of fields must be present. Check the input. |
|
69082 |
error |
'coordX' is not a real number: '%s' |
Check the input. |
|
69083 |
error |
'coordY' is not a real number: '%s' |
Check the input. |
|
69084 |
error |
'coordX' is not in range [-180; 180]: '%g' |
Check the input. |
|
69085 |
error |
'coordY' is not in range [-90; 90]: '%g' |
Check the input. |
|
69086 |
error |
Invalid 'zip' format: '%s' |
Check the input. Contact the support if you think zip format is correct. |
|
69087 |
error |
Invalid 'state' format: '%s' |
Check the input. Contact the support if you think state format is correct. |
|
69088 |
error |
Invalid 'email' format: '%s' |
Check the input. Contact the support if you think email format is correct. |
|
69094 |
error |
Invalid 'reminder_time' format: '%s' |
The 'reminder_time' value must be numeric. Check the input. |
|
69095 |
error |
'reminder_time' out of range %d [%d; %d] |
The 'reminder_time' value must be a number in specified range. Check the input. |
|
69096 |
error |
Time slot is not supported by this activity type |
The activity type does not the support 'Support of time slots' option. Check the input / activity type. |
|
69097 |
error |
Time slot is required for this activity type |
The 'Support of time slots' option is enabled for the activity type, but no time slot is defined. Check the input / activity type. |
|
69098 |
error |
Will not add inventory- activity type does not support this |
The activity type does not the support 'Support of inventory' option. Check the input / activity type. |
|
69099 |
warning |
Will not add/remove links- activity type does not support this |
The activity type does not the support 'Support of links' option. Check the input / activity type. |
|
69101 |
error |
Duplicate inventory key: '%s' |
There are two or more inventories for this activity with the same key, OR There are two or more resource inventories in request with the same key. Remove duplicates from the request. |
|
69102 |
error |
Duplicate appointment in transaction: '%s' |
There are two or more activities with the same key. When the request contains several commands with the same key, the last command is accepted while others are rejected. Remove duplicates from the request. |
|
69103 |
warning |
Link keys not specified |
Check the input. |
|
69104 |
warning |
Duplicate link: '%s' |
There are two or more links for this activity with the same key. Remove duplicates from the request. |
|
69105 |
error |
'command/type' is invalid: '%s' |
Valid values: 'start_activity'; 'complete_activity'; 'notdone_activity'; 'suspend_activity'; 'update_activity'; 'cancel_activity'; 'delete_activity'; 'set_inventory'; 'update_inventory'; 'delete_inventory'; Check the input. |
|
69106 |
error |
'command/date' is not a 'YYYY-MM-DD' date: '%s' |
Check the input. |
|
69107 |
error |
'command/time' is not a 'YYYY-MM-DD HH:MM:SS' datetime: '%s' |
Check the input. |
|
69108 |
error |
'command/appointment' cannot be absent for command type: '%s' |
Check the input. |
|
69109 |
error |
'command/appointment' cannot be present for command type: '%s' |
Check the input. |
|
69110 |
error |
'command/external_id' cannot be absent for command type: '%s' |
Check the input. |
|
69111 |
error |
'external_id' is absent |
Check the input. |
|
69112 |
error |
Duplicate 'external_id': '%s' |
Check the input. |
|
69113 |
error |
Provider does not have any appointments: '%s' |
Check the input. |
|
69114 |
warning |
Cannot delete link: %s |
Internal error (not critical for the transaction success). Contact support. |
|
69115 |
warning |
Cannot add link: %s |
Internal error (not critical for the transaction success). Contact support. |
|
69116 |
warning |
Providers are in the same group- will not move |
Check if it was the intention. |
|
69117 |
warning |
Cannot update existing inventory: inserting new |
Internal error. Contact the support. |
|
69118 |
error |
Cannot delete - inventory does not exist |
The inventory does not exist (e.g. has already been deleted) – error can be ignored as there is no more need to delete the inventory. |
|
69119 |
error |
Cannot delete - error getting existing inventory |
Internal error. Contact the support. |
|
69120 |
error |
Cannot delete - inventory is assigned to another provider |
Specify the correct resource. |
|
69121 |
warning |
Provider is in the same group as original provider - will not move: external_id='%s' |
Cannot move inventory. Check if it was the intention. |
|
69122 |
warning |
Falling back to fallback_external_id: %s |
Resource specified in 'command/fallback_external_id' cannot be assigned the activity. |
|
69123 |
warning |
Falling back to default pool: %s |
Resource specified in 'head/default_appointment_pool' cannot be assigned the activity. |
|
69124 |
error/warning |
Queue is invalid: %s |
See description after the colon and check the input accordingly. When updating an activity and defining an ended route, activity will be updated but not rescheduled; else the command will fail. |
|
69125 |
warning |
Coordinates are out of bounds - [%g,%g] |
Coordinates do not fit into any of bounding rectangles defined for company at Company settings → Business rules → Company boundaries. Check the input / the boundaries. |
|
69126 |
error |
Appointment not found. cannot cancel |
The activity cannot be found (e.g. has already been canceled or deleted) – error can be ignored as there is no more need to cancel the activity. |
|
69127 |
error |
Appointment has been changed during upload |
Internal error. Contact the support. |
|
69128 |
error |
'date' is empty |
There is no date in command and there is no existing appointment (date does not have to be specified if the activity already exists). Add date field to the command. |
|
69129 |
error |
Appointment status is not 'pending'. cannot update |
Activities with status other than 'pending' cannot be updated. Check if it was the intention. Check head/action_if_completed flag value. |
|
69130 |
error |
Unexpected appointment status. cannot update |
Internal error. Contact the support. |
|
69131 |
error |
Unexpected value of action_if_completed setting |
Internal error. Contact the support. |
|
69132 |
error |
No properties to update |
Appointment is not pending and there are no properties to update. Can be ignored. |
|
69133 |
error |
Unable to update properties |
Internal error. Contact the support. |
|
69134 |
error |
Will not add unscheduled appointment- activity type does not support this |
The activity type does not the support the 'Support of not-scheduled activities' option. Check the input / activity type. |
|
69135 |
error |
Date is too far in future |
Dates until the end of the next year can be used (e.g. in 2011 the latest valid date is 2012-12-31). Check the input. |
|
69136 |
error |
Will not assign to bucket- activity type does not support this |
The activity type does not the support the 'Allow creation in buckets' option. Check the input / activity type. |
|
69137 |
error |
Appointment is not found |
Cannot process (cancel, start etc.) activity because it does not exist. |
|
69138 |
error |
Command type is unknown |
Type of the command is invalid. Check the input. |
|
69139 |
warning |
Will not move- activity type does not support this |
The activity type does not support the 'Allow creation in buckets' option. Check the input / activity type. |
|
69140 |
warning |
Will not reschedule- activity type does not support this |
The activity type does not support the 'Allow creation in buckets' option. Check the input / activity type. |
|
69141 |
error |
Appointment status is not 'pending'. cannot start |
Activities with status other than 'pending' cannot be started. Check the input. |
|
69142 |
error |
Appointment status is not 'started' |
Activities with status other than 'started' cannot be set complete/suspend/notdone. Start the activity or check the input. |
|
69143 |
error |
String property value does not match pattern: label='%s' value='%s' pattern='%s' |
Check the input. Check property description (Company Settings → Properties → Modify). |
|
69144 |
error |
Int property value is non-numeric: label='%s' value='%s' |
Check the input. Check property description (Company Settings → Properties → Modify). |
|
69145 |
error |
Enum property value is reserved: label='%s' value='%s' |
Reserved values '0' and '-1' cannot be set for 'enum' property. Check the input. Check property description. |
|
69146 |
error |
Enum property value is inactive: label='%s' value='%s' |
Check the input. Check property description (Company Settings → Properties → Modify). |
|
69147 |
error |
Enum property value is out of range: label='%s' value='%s' |
Check the input. Check property description (Company Settings → Properties → Modify). |
|
69148 |
error |
Property type not supported for property: '%s' |
Internal error. Contact support. |
|
69149 |
error |
Mandatory property is absent: '%s' |
Property defined as mandatory is missing. Check the input. Check the display profile. |
|
69150 |
error |
Mandatory property is empty: '%s' |
Property defined as mandatory is empty. Check the input. Check the display profile. |
|
69151 |
error |
Appointment key has no property description '%s' |
Internal error. Contact support. |
|
69152 |
error |
The appointment cannot be started at the specified time: min_time='%s' time='%s' |
Check the input. |
|
69153 |
error |
User is not active: '%s' |
Authentication failed. Check the user record. |
|
69154 |
error |
User is blocked: '%s' |
Authentication failed. Check the user record. |
|
69155 |
warning |
Invalid provider preference type: '%s' |
Valid values are 'preferred', 'required', 'forbidden'. Check the input. |
|
69156 |
warning |
Provider preference external_id not found: '%s' |
Check the input. |
|
69157 |
warning |
Cant have required and preferred providers |
The 'required' preference type always prevails over 'preferred', so it is impossible to have both defined for one activity. Check the input. |
|
69158 |
warning |
Cannot delete provider preferences: '%s' |
Internal error. Contact support. |
|
69159 |
warning |
Cannot add provider preferences: '%s' |
Internal error. Contact support. |
|
69160 |
error |
Error executing commands: '%s' |
Internal error. Contact support. |
|
69161 |
error,warning |
Error executing command: '%s' |
Internal error (may be not critical for the transaction success). Contact support. |
|
69162 |
error |
Error trying to validate properties: '%s' |
Internal error. Contact support. |
|
69163 |
warning |
Company has duplicate time zones with name: '%s' |
OFSC configuration problem. Contact support. Workaround: use time zone's numeric ID instead of literal name. |
|
69164 |
warning |
Activity has link alerts: flags=%u, desc='%s' |
Depends on alert flags value. |
|
69165 |
error |
Will not add teamwork - activity type does not support this |
Check activity type. |
|
69166 |
error |
'team_id' field is required for this activity type |
Check the input. |
|
69167 |
error |
Invalid provider in field team_id: '%s' |
Check the input. |
|
69168 |
error |
Will not change team_id: '%s' |
The 'team_id' can only be set when creating new activity and cannot be changed. Ensure 'team_id' in updates is the same as initially defined for the activity or do not send team_id in updates. |
|
69169 |
warning |
Will not move/reschedule teamwork |
Activities of a teamwork type cannot be moved or rescheduled. Check the input / activity type. |
|
69170 |
error |
Appointment status is not 'pending'. cannot delete |
Only activities of 'pending' status can be deleted. Check the input / activity type. |
|
69171 |
warning |
Will not add/remove provider_preferences- activity type does not support this |
The activity type does not the support the 'Support of preferred resources' option. Check the input / activity type. |
|
69172 |
warning |
Some fields could not be updated- changed by user: %s |
The fields were changed by OFSC user and thus cannot be updated by the Inbound Interface. |
|
69173 |
warning |
Activity is started out of order- moved to the beginning of the queue |
Can be ignored if that is the desired behavior. |
|
69174 |
error |
Appointment status is not 'pending'. cannot cancel |
Activities of status other that 'pending' cannot be canceled. |
|
69175 |
error |
Both worktype and worktype_label are present |
Only one of the two fields should be present in the request. |
|
69176 |
error |
Activity type does not support time slot: '%s' |
The activity type does not the support the 'Support of time slots' option. Check the input / activity type. |
|
69177 |
error |
Cannot change status of unscheduled activity |
Status of unscheduled activity cannot be changed if the 'date' of the command is not defined. |
|
69178 |
error |
Cannot start unscheduled activity on date='%s' reason='%s' |
Trying to start unscheduled activity but cannot move it to a specified date because of resource non-working day or calendar error. Check resource calendar. |
|
69179 |
error |
Will not move/reschedule to invalid queue: %s |
Activity cannot be moved to the route, e.g. because of the resource preferences set for the activity. |
|
69180 |
error |
No inventories to add or delete |
The set_inventory command is empty and performs no actions. |
|
69181 |
warning |
time_slot overrides service_window_start/ service_window_end |
If both service window and time slot have been sent for an activity, the Inbound Interface will ignore the service window values. |
|
69182 |
error |
N/A |
This function is temporarily unavailable, please try again in a minute. |
|
69184 |
warning |
Cannot add required inventories |
Required inventories cannot be added. The warning message will contain the reason which is one of the following:
|
|
69185 |
error |
Invalid inventory type label |
Internal error |
|
69186 |
error |
Invalid inventory type ID |
Internal error |
|
69187 |
error |
Both invtype and invtype_label are present |
Internal error |
|
69188 |
error |
Invalid link type label |
Internal error |
|
69189 |
error |
'head/allow_change_date' has invalid value |
Internal error |
|
69190 |
error |
Cannot update file property |
Internal error occurs at an attempt to update the file property, due to service unavailability or misconfiguration. Contact support. |
|
69191 |
error |
Property value too long – truncated. Property label='%s', received length=%zu, max allowed length=%zu |
The property value has too many characters. Check the input |
|
69192 |
error |
Multiday activity cannot be started via Inbound API |
Segmentable activities can only be started by starting their individual segments. The Inbound API does not recognize segmentable activity segments, therefore, segmentable activities cannot be started via the Inbound API. Use a different API to start the activity |
|
69193 |
error |
Cannot complete multiday activity: %s |
A segmentable activity can be completed if it contains no started segments. Complete any started segments using a different API, then complete the activity |
|
69194 |
warning |
Activity type cannot be changed |
The type of an existing activity cannot be changed. Check the input (the 'worktype' and 'worktype_label' fields) |
| 69222 | error |
Unknown flow label in the field 'activity_flow': {activity_flow label} |
Internal error |