jobs={
    "jobs" : [
        {
            "clientId" : "2",
            "clientRef" : "abc123",
            "siteRef" : "abc123",
            "reportedDate" : "12/09/2011", 
            "contactMode" : "2",
            "contactRef" : "2342",
            "contactSal" : "Mr",
            "contactForename" : "Barry",
            "contactSurname" : "Walters",
            "contactC1" : "08767 883788",
            "contactC1Type" : "1",
            "contactC2" : "08767 883788",
            "contactC2Type" : "1",
            "contactC3" : "08767 883788",
            "contactC3Type" : "1",
            "contactC4" : "08767 883788",
            "contactC4Type" : "1",
            "workLogTypeID" : "1",
            "workTypeID" : "7",
            "priorityID" : "3",             
            "description" : "fix photocopier",    
            "causeID" : "5",                 
            "raisedBy" : "colin",
            "serviceID" : "21",
            "workflowID" : "3",
            "supplierID" : "4",
            "resourceID" : "76",
            "eventNotes" : "a note",
            "targetDate" : "30/09/2011",
            "postcodeUse" : "0",
            "preferredContact" : "2",            
            "appointmentDate":"30/09/2011 08:30",
            "zoneType":"0",
            "jobDuration":"150", //Manually sets the job duration in minutes
            "codeID" : "1",
            "activities": [
                {
                    "libraryActivityCode" : "5647",
                    "activityRef" : "act123",                    
                    "description" : "optional desc",
                    "quantity" : "3",
                    "supplierId" : "13" //since v.11.4 - optional activity.supplier_id
                }
            ],
            "attributes": [
                {
                    "name":"Issued Date",
                    "value":"12/12/2012 12:23:56"
                }
            ]
        }
    ]


}

<?xml version="1.0" encoding="UTF-8" ?>
<jobs>
    <clientRef>abc123</clientRef>
    <siteRef>abc123</siteRef>
    <reportedDate>12/09/2011</reportedDate>
    <contactMode>2</contactMode>
    <contactRef>2342</contactRef>
    <contactSal>Mr</contactSal>
    <contactForename>Barry</contactForename>
    <contactSurname>Walters</contactSurname>
    <contactC1>08767 883788</contactC1>
    <contactC1Type>1</contactC1Type>
    <contactC2>08767 883788</contactC2>
    <contactC2Type>1</contactC2Type>
    <contactC3>08767 883788</contactC3>
    <contactC3Type>1</contactC3Type>
    <contactC4>08767 883788</contactC4>
    <contactC4Type>1</contactC4Type>
    <workLogTypeID>1</workLogTypeID>
    <workTypeID>7</workTypeID>
    <priorityID>3</priorityID>
    <description>fix photocopier</description>
    <causeID>5</causeID>
    <raisedBy>colin</raisedBy>
    <serviceID>21</serviceID>
    <workflowID>3</workflowID>
    <supplierID>4</supplierID>
    <resourceID>76</resourceID>
    <eventNotes>a note</eventNotes>
    <targetDate>30/09/2011</targetDate>
    <postcodeUse>0</postcodeUse>
    <preferredContact>2</preferredContact>
    <appointmentDate>30/09/2011 08:30</appointmentDate>
    <zoneType>0</zoneType>
    <activities>
        <libraryActivityCode>5647</libraryActivityCode>
        <activityRef>act123</activityRef>
        <description>optional desc</description>
        <quantity>3</quantity>
    </activities>
    <attributes>
        <name>Issued Date</name>
        <value>12/12/2012 12:23:56</value>
    </attributes>
</jobs>

Response

401 Unauthorized

Reason

This error occurs if the OS-REST-AUTH-TOKEN has not been provided, has expired, or does not exist in the system

Resolution

Verify your OS-REST-AUTH-TOKEN with support

Response

403 Forbidden

Reason

This error indicates that something is blocking your connection to the server

Resolution

Open a ticket with the support team with details of your connection so that your access can be verified

Response

404 Not Found

Reason

This error should only occur if the endpoint has been mistyped in some way, which will lead the call to an endpoint that does not exist

Resolution

Verify the endpoint matches the value specified in this article

Response

405 Method Not Allowed

Reason

This error will occur if an unacceptable method has been used in the call such as GET or DELETE

Resolution

Ensure that you are using a POST call to this endpoint

Response

{
    "result": "fail",
    "result_msg": "Job for job_client_ref could not be found."
}

Reason

This message appears if no valid clientRef has been provided

Resolution

Provide a clientRef and post the job again

Response

{
    "result": "fail",
    "result_msg": "WorkLog with Client Ref already exists."
}

Reason

This message appears if the clientRef has already been used

Resolution

Provide a different clientRef, or validate whether or not the job is already in the system

Response

{
    "result": "fail",
    "error_code": "REST0015",
    "result_msg": "Could not find Library Activity Code: xxx clientId: 1 wlt: 1"
}

Reason

This error occurs if the activity code specified does not exist or there is no valid cost for the client and work log type specified.

Resolution

If the code does not exist, it will need to be created in Oneserve first. If the code does exist, a valid cost needs to be created for the client and work log type specified in the call.

Response

{
    "result": "fail",
    "result_msg": "String index out of range: -14"
}

Reason

This error occurs if a field has been overfilled and is too long for the API to accept

Resolution

Ensure that all fields are under the maximum length per the file format spec

Response

{
    "result": "fail",
    "result_msg": "No job data found to add"
}

Reason

This error usually occurs if the job data presented in the call is improperly formatted leading to incomplete data being passed

Resolution

Validate your call using an online JSON validator to make sure everything is written correctly. Ensure that each JSON object starts with jobs={... as is required by the endpoint