Difference between revisions of "Get Job By Job Number"

From MyMobileWorkers API
Jump to: navigation, search
(→‎Example response)
(→‎Example response)
 
Line 402: Line 402:
 
         }
 
         }
 
     ],
 
     ],
−
     "job_links":[  
+
     "job_links": [
−
 
+
        {
−
    ],
+
            "created_at": "2019-10-07T00:00:00+01:00",
−
    "damage_sheets":[
+
            "linked_to": "M81715_2"
−
 
+
        }
 
     ],
 
     ],
 
     "tracking_references":[  
 
     "tracking_references":[  

Latest revision as of 11:49, 6 November 2019

[edit] Summary

Jobs
URL https://:base_url/:api_path/:version/jobs/job?api_key=YOUR_KEY&job_number=A_JOB_NUMBER
Type GET
Params: api_key required
job_number required
Response JSON

The get job method returns a job corresponding to the job number supplied in the request

[edit] Example response

{ 
    "secondary_users":[ 
 
    ],
    "type":"repair",
    "signatures":[ 
 
    ],
    "date":"2017-03-28",
    "time":null,
    "status":"NEW",
    "task":null,
    "duration":0,
    "product":null,
    "weight":100.15,
    "branch":{ 
        "name":"BranchA",
        "number":null,
        "external_id":null,
        "contact_name":"Joe Bloggs",
        "address_1":"",
        "address_2":"",
        "address_3":"",
        "address_4":"",
        "postcode":"",
        "created_at":1473425398000,
        "contact_number":"06575346575",
        "contact_email":"branch@example.com"
    },
    "route":{ 
        "external_id":null,
        "route_name":"Liverpool-AM",
        "route_code":"LIV-001",
        "route_limit":180
    },
    "customer":null,
    "customer_sites":{ 
        "external_id":null,
        "contact_name":"Joe",
        "address_1":"29 bath road",
        "address_2":"",
        "address_3":"",
        "address_4":"",
        "postcode":"la1 3cd",
        "created_at":1465210944000,
        "updated_at":1465210944000,
        "contact_number":"06709253543",
        "contact_email":"joe@example.com",
        "sic_code":null,
        "customer_site_emails":[ 
            { 
                "customer_email":"joe@example.com"
            }
        ]
    },
    "created_at":"2017-03-28T10:54:41+01:00",
    "updated_at":"2017-03-28T10:54:41+01:00",
    "actualStart":null,
    "job_number":"123",
    "gas_safe_inspection":[ 
 
    ],
    "mobile_user":{ 
        "username":"Darren_test32",
        "email":"darren.atherton19@yahoo.com",
        "color":"AE3B94",
        "engineer_registration_number":null
    },
    "priorityDetails":{ 
        "colour":"00731D",
        "name":"Very Low"
    },
    "timeslot":null,
    "asset_histories":[ 
        { 
            "location":"aPlace2",
            "status":{ 
                "external_id":null,
                "name":"test"
            },
            "description":"describingwords",
            "item":{ 
                "external_id":null,
                "category":"test2",
                "name":"Woo"
            },
            "serial_number":"serialNo456",
            "external_id":"sss32",
            "last_scanned_by":null,
            "last_updated_by":null,
            "created_at":"2013-10-08 14:19:17",
            "job":{ 
                "job_ number":"123"
            },
            "asset":{ 
                "external_id":"sss32",
                "serial_number":"serialNo456"
            },
            "custom_fields":{ 
                "testFieldName3":"testFieldValue3",
                "testFieldName2":"testFieldValue2",
                "testFieldName1":"testFieldValue1"
            },
            "customer":{ 
                "name":"john"
            },
            "branch":{ 
                "name":"DarrenDevTest"
            },
            "photos":[ 
 
            ]
        },
        { 
            "location":"aPlace2",
            "status":{ 
                "external_id":null,
                "name":"test"
            },
            "description":"describingwords",
            "item":{ 
                "external_id":null,
                "category":"test2",
                "name":"Woo"
            },
            "serial_number":"serialNo456",
            "external_id":"sss32",
            "last_scanned_by":null,
            "last_updated_by":null,
            "created_at":"2013-10-08 14:19:17",
            "job":{ 
                "job_ number":"123"
            },
            "asset":{ 
                "external_id":"sss32",
                "serial_number":"serialNo456"
            },
            "custom_fields":{ 
                "testFieldName3":"testFieldValue3",
                "testFieldName2":"testFieldValue2",
                "testFieldName1":"testFieldValue1"
            },
            "customer":{ 
                "name":"john"
            },
            "branch":{ 
                "name":"DarrenDevTest"
            },
            "photos":[ 
 
            ]
        },
        { 
            "location":"aPlace2",
            "status":{ 
                "external_id":null,
                "name":"test"
            },
            "description":"describingwords",
            "item":{ 
                "external_id":null,
                "category":"test2",
                "name":"Woo"
            },
            "serial_number":"serialNo456",
            "external_id":"sss32",
            "last_scanned_by":null,
            "last_updated_by":null,
            "created_at":"2013-10-08 14:19:17",
            "job":{ 
                "job_ number":"123"
            },
            "asset":{ 
                "external_id":"sss32",
                "serial_number":"serialNo456"
            },
            "custom_fields":{ 
                "testFieldName3":"testFieldValue3",
                "testFieldName2":"testFieldValue2",
                "testFieldName1":"testFieldValue1"
            },
            "customer":{ 
                "name":"john"
            },
            "branch":{ 
                "name":"DarrenDevTest"
            },
            "photos":[ 
 
            ]
        },
        { 
            "location":"aPlace2",
            "status":{ 
                "external_id":null,
                "name":"test"
            },
            "description":"describingwords",
            "item":{ 
                "external_id":null,
                "category":"test2",
                "name":"Woo"
            },
            "serial_number":"serialNo789",
            "external_id":"sss34",
            "last_scanned_by":null,
            "last_updated_by":null,
            "created_at":"2013-10-08 14:19:17",
            "job":{ 
                "job_ number":"123"
            },
            "asset":{ 
                "external_id":"sss34",
                "serial_number":"serialNo789"
            },
            "custom_fields":{ 
                "testFieldName3":"testFieldValue3",
                "testFieldName2":"testFieldValue2",
                "testFieldName1":"testFieldValue1"
            },
            "customer":{ 
                "name":"john"
            },
            "branch":{ 
                "name":"DarrenDevTest"
            },
            "photos":[ 
                { 
                    "file_name":"www.testFileName.com/test"
                },
                { 
                    "file_name":"www.testFileName.com/test"
                }
            ]
        }
    ],
    "contact_name":"qwerty",
    "address_1":"qwerty",
    "address_2":null,
    "postcode":"qqwerty",
    "notes":null,
    "address_3":null,
    "address_4":null,
    "contact_number_1":"0",
    "contact_number_2":null,
    "special_instructions":null,
    "fault":null,
    "repair_code":null,
    "repair_description":null,
    "signee":null,
    "satisfaction":null,
    "failure_type":null,
    "attachments":[ 
 
    ],
    "items":[ 
        { 
            "name":"Bob",
            "type":"C",
            "status":"COMPLETED",
            "notes":"exampleNotes",
            "expected_quantity":4,
            "other":"test",
            "actual_quantity":null,
            "barcodes":"test1,test2"
        },
        { 
            "name":"Bob",
            "type":"C",
            "status":"COMPLETED",
            "notes":"exampleNotes",
            "expected_quantity":4,
            "other":"test",
            "actual_quantity":null,
            "barcodes":""
        },
        { 
            "name":"darrenItem",
            "type":"C",
            "status":"COMPLETED",
            "notes":"exampleNotes",
            "expected_quantity":4,
            "other":"test",
            "actual_quantity":null,
            "barcodes":""
        },
        { 
            "name":"darrenItem245",
            "type":"C",
            "status":"COMPLETED",
            "notes":"exampleNotes",
            "expected_quantity":4,
            "other":"test",
            "actual_quantity":null,
            "barcodes":""
        },
        { 
            "name":"darrenItem245",
            "type":"C",
            "status":"COMPLETED",
            "notes":"exampleNotes",
            "expected_quantity":4,
            "other":"test",
            "actual_quantity":null.            "barcodes":""
        },
        { 
            "name":"darrenItem245",
            "type":"C",
            "status":"COMPLETED",
            "notes":"exampleNotes",
            "expected_quantity":4,
            "other":"test",
            "actual_quantity":null,
            "barcodes":""
        },
        { 
            "name":"darrenItem",
            "type":"C",
            "status":"COMPLETED",
            "notes":"exampleNotes",
            "expected_quantity":4,
            "other":"test",
            "actual_quantity":null,
            "barcodes":""
        }
    ],
    "activities":[ 
        { 
            "type":"JOB_VIEWED",
            "created_at":"2014-01-13T10:15:00+00:00"
        },
        { 
            "type":"JOB_VIEWED",
            "created_at":"2014-01-13T10:15:00+00:00"
        },
        { 
            "type":"JOB_STARTED",
            "created_at":"2014-01-13T10:16:00+00:00"
        },
        { 
            "type":"JOB_ARRIVED",
            "created_at":"2014-01-13T10:21:00+00:00"
        }
    ],
    "audits":[ 
        { 
            "created_at":"2019-10-30T17:19:31+00:00",
            "updated_at":"2019-10-30T17:19:31+00:00",
            "audit_checklists":[ 
                { 
                    "name":"Post Job Audit",
                    "createdAt":"2019-10-30T17:19:31+00:00",
                    "updatedAt":"2019-10-30T17:19:31+00:00",
                    "orderId":0,
                    "checklist_questions":[ 
                        { 
                            "type":"yesno",
                            "createdAt":"2019-10-30T17:19:31+00:00",
                            "notes":null,
                            "updatedAt":"2019-10-30T17:19:31+00:00",
                            "orderId":0,
                            "question":"Are there adequate photos on the job?",
                            "answer":"yes"
                        }
                    ]
                }
            ],
            "mobile_user":"user",
            "audited_portal_user":null,
            "byPortalUser":"portal_user",
            "total_score":7,
            "percentage":7000,
            "max_score":10,
            "score_threshold":0
        }
    ],
    "job_links": [
        {
            "created_at": "2019-10-07T00:00:00+01:00",
            "linked_to": "M81715_2"
        }
    ],
    "tracking_references":[ 
        { 
            "job_number":"B523",
            "tracking_reference":"GGJL4",
            "expiry_datetime":"2019-10-31T06:06:03+00:00"
        }
    ],
    "post_job_checks":[ 
 
    ],
    "pre_job_checks":[ 
 
    ],
    "photos":[ 
 
    ],
    "job_invoices":[ 
 
    ],
"damage_sheets": [
        {
            "name": "Bike damage sheet",
            "type": "customer_vehicle_damage_diagram",
            "created_at": "2019-10-18T13:57:42+01:00",
            "uuid": "9780d33d-167e-4e09-b17b-18affe98da8e",
            "image_url": "https://mmw-test-digital.s3-eu-west-1.amazonaws.com/damage_sheets/52437/bike-2.png",
            "position_order": 0,
            "damage_points": [
                {
                    "hidden_damage": false,
                    "created_at": "2019-10-18T14:00:21+01:00",
                    "uuid": "08d2515f-c840-4344-9a38-83eb54de3bce",
                    "position_order": 0,
                    "x_position": 398,
                    "y_position": 346,
                    "damage_colour": "#C6AA8E",
                    "area_text": "Brakes",
                    "damage_type": "crack"
                },
                {
                    "hidden_damage": false,
                    "created_at": "2019-10-18T14:00:25+01:00",
                    "uuid": "e958b6c9-eab9-4435-903c-d0c9a86d4c82",
                    "position_order": 0,
                    "x_position": 448,
                    "y_position": 650,
                    "damage_colour": "#AA00AA",
                    "area_text": "exhaust",
                    "damage_type": "scratch"
                },
                {
                    "hidden_damage": false,
                    "created_at": "2019-10-18T14:00:30+01:00",
                    "uuid": "63814b3c-8e7f-4fa9-a980-22dc2089da46",
                    "position_order": 0,
                    "x_position": 139,
                    "y_position": 189,
                    "damage_colour": "#55AA00",
                    "area_text": "lights",
                    "damage_type": "dent"
                }
            ]
        },
        {
            "name": "Car damage sheet",
            "type": "hire_vehicle_damage_diagram",
            "created_at": "2019-10-18T13:57:42+01:00",
            "uuid": "ffe4f81f-a57d-41a5-9612-058e27df8aa5",
            "image_url": "https://mmw-test-digital.s3.amazonaws.com/damage_sheets/52437/car-3.png",
            "position_order": 0,
            "damage_points": [
                {
                    "hidden_damage": false,
                    "created_at": "2019-10-18T14:00:37+01:00",
                    "uuid": "5e4dacb3-630d-4a8d-a934-4cd23a8078a1",
                    "position_order": 0,
                    "x_position": 381,
                    "y_position": 629,
                    "damage_colour": "#AA00AA",
                    "area_text": "windscreen",
                    "damage_type": "scratch"
                }
            ]
        }
    ],
    "pre_job_details":[ 
        { 
            "invoice_number":null,
            "po_no":"TestPo"
        }
    ]
}

[edit] Example curl request

curl "https://api.mymobileworkers.com:8181/api/1/jobs/job?api_key=TESTKEY&job_number=sss32"
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox