# Update Fir

# API Description

This API is used to modify FIR.

case status:

replied: only modify failedModeCode and failPartCode
returned: modify all fields
other: throw 400 error with following message: "case status mismatch"

# Environment

# Test

https://oversea.saicmaxus.com/australia/test/fir/update (opens new window)

# Prod

https://oversea.saicmaxus.com/australia/fir/update (opens new window)

# Method

POST

# Request

# Authorization

Set 'maxus_jwt' in header,see in Get Maxus JWT Token

# Payload

Parameter	Type	Required	Web page field	Description	中文描述
caseId	String	Yes	Case No.	The ID returned by creating the FIR	案例编号
title	String(200)	Yes	Failure Description	The title of the FIR.	案例标题
creatorName	String(100)	Yes	Employee Name	The name of the person who created the FIR.	案例创建人
mobile	String(20)	No	Contacts	Contacts phone.	联系电话
vin	String(17)	Yes	VIN/ Chassis No	The Vehicle Identification Number.	车架号
carLine	String(60)	No	Model	The line of cars that the vehicle belongs to.	车系
mileage	String(10)	Yes	Mileage	The mileage of the vehicle.	行驶里程
troubleLevel1	String(60)	No		The primary level of trouble.	系统一级分类
troubleLevel1Code	String(20)	Yes	Classification 1	The code for the primary level of trouble.	系统一级分类代码
troubleLevel2	String(50)	No		The secondary level of trouble.	系统二级分类
troubleLevel2Code	String(20)	Yes	Classification 2	The code for the secondary level of trouble.	系统二级分类代码
troubleLevel3	String(50)	No		The tertiary level of trouble.	系统三级分类
troubleLevel3Code	String(20)	Yes	Classification 3	The code for the tertiary level of trouble.	系统三级分类代码
failedMode	String(50)	No		The mode in which the failure occurred.	失效模式
failedModeCode	String(20)	Yes	Failure Mode	The code for the failure mode.	失效模式代码
failPartCode	String(30)	Yes	Failure P/N	The code for the part that failed.	失效零件号
loseFunctionPartName	String(200)	No		The name of the part that lost function.	失效零件名称
isAuthorized	String(1)	Yes	Pre-Authorization Application	Whether the case applies for pre authorization or not	是否预授权
troubleCode	String(200)	No	Fault Code	The trouble code associated with the case.	诊断仪故障码
symptomComplaint	String(4000)	Yes	Fault Symptom	The symptom or complaint.	故障症状
corReactiveAction	String(4000)	Yes	Solution	The corrective or reactive action taken.	解决方案
probableCause	String(4000)	Yes	Repair Process	The probable cause of the issue.	维修经过
remark	String(4000)	No	Remark	Any additional remarks.	备注
pbList	List	No		A list of QualityReportAttachmentDto objects.	预授权问题
pbList.attachmentVoList	List	No		Upload attachments	预授权问题附件
pbList.attachmentVoList.fileType	String(255)	No		Upload file type	文件类型
pbList.attachmentVoList.fileUrl	String(2500)	No		Encrypted file upload url	文件地址
pbList.attachmentVoList.fileName	String(255)	No		Upload file name	文件名称
pbList.attachmentVoList.fileSize	String(255)	No		Upload file size	文件大小
pbList.pbDesc	String(255)	No	Failure Description	Fault Description	问题描述
pbList.pbAuthorizedMoney	String(255)	No	Amount	Pre authorization amount	预授权金额
attachmentVoList	List	Yes		A list of QualityReportAttachmentDto objects.	案例附件
attachmentVoList.attachmentVoList	List	Yes		Upload attachments
attachmentVoList.attachmentVoList.fileType	String(255)	Yes		Upload file type	附件文件类型
attachmentVoList.attachmentVoList.fileUrl	String(2500)	Yes		Encrypted file upload url	附件地址
attachmentVoList.attachmentVoList.fileName	String(255)	Yes		Upload file name	附件名称
attachmentVoList.attachmentVoList.fileSize	String(255)	Yes		Upload file size	附件大小
attachmentVoList.busiTag	String(255)	Yes		Attachment option code, refer to API doc (opens new window)	附件所属业务分类
caseClassification	String(50)	Yes	Case Classification	The classification of the case.	案例分类
positionCode	String(50)	No		Employee Position Code	员工岗位代码
country	String(100)	No		Country Name	所属国家
countryCode	String(100)	No		Country Code	所属国家代码
creator	String(100)	No		Employee xyx Id	创建人id
worksheetStartDate	Date	No	R/O Start Date	R/O Start Date	工单维修日期
worksheetEndDate	Date	No	R/O Finish Date	R/O Finish Date	工单维修结束日期
insuranceStartTime	Date	No	Warranty Start	Warranty Start	保修日期
vehicleSpeed	String(20)	Yes	Speed	Speed Code	车速
vehicleLoad	String(20)	No	Load	Vehicle load Code	车辆载重
roadCondition	String(20)	No	Road Condition	Road condition Code	路况
weather	String(50)	No	Weather	Weather Code	天气
purchaseDate	Date	No	Retail Date	Retail Date	购车日期
clientName	String(255)	No	Customer Name	Customer Name	客户姓名
clientMobile	String(255)	No	Contact	Contact	客户电话
clientEmail	String(255)	No	Email	Email	客户邮箱
clientAddr	String(255)	No	Address	Address	客户地址
dealerCode	String(20)	No	Dealer	Dealer code, refer to API doc (opens new window)	二级经销商代码

# Example

curl --location 'https://oversea.saicmaxus.com/australia/test/fir/update' \
--header 'maxus_jwt: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhc2NDb2RlIjoiNDE5ODEzMCIsImFzY0lkIjo0MTk4MTMwLCJhc2NOYW1lIjoiQVRFQ08iLCJjYWxsQmFja1VybCI6IjEiLCJleHBpcmVUaW1lU3RhbXAiOiIxNzA0MzY2NTY2NTY4IiwicmVtYXJrIjoicHJpdmF0ZT09MTI1Njk4NjU0ODQ3ODg4MTAyMjA2MjAxODEzMzgxNTA2MTE2ODk4Njg1MDgyMzUyNTcyNjAxMDg1MTkzMzg0OTE4MjEzOTUzNDUzMjY3NDAxNzgyMjQ3NTc4OTMwNDU4MTg3Mzg5Mjk5OTU1MjU5MjUwMTI4MzE5OTYxNTYzNjE5MTIxOTQ4MzI0MTA3NTI3MDc0NjEyMzg4MjM4NzAxMjQzNzA2ODE3NjgyNTEyNjk1NDc4OTQ1MjYzOTc5NTc2NjU2MTUwMzgyMTk0NzQ1OTY0OTg4OTc0NTc5ODIyNzc5NjM2NTYxNTYyOTM5Mjc1ODkwMTExNTQ3ODIxNjMzNzMxMzQ2MTc2MjU1ODMzOTEwNTE5NTYyNDg2NTI3OTE5MzMxMTYxMjY2ODA5OTE3ODc4Nzltb2R1bGVzPT0zNDQ2NzU5MjY3NjUwMDkzMjE4MDA3NTU2NTE5MTY1NDAxMTgyODEzNDE3MTYxOTMzMjY3MzE0MzQ4MzA4ODEwMTk2MDcyNzUwNTA5ODg2NjEwMzY1MDk1OTExMjk3MjE2MjI5NTEzOTA5NjE1NTU2MzUzMzk2MzY1NzExOTA0NjUwNjg3NDczOTkzOTUxMTE2MzkwMjcxNDE1MTUyMjE0Mzc3NDI4MjY1NTMwOTQyMzA4MTUxNTk2NjMxOTI0MTA0NTAyMTIwOTk0NzI2MDcxMDcxNTc3MTMwMzExMzg4NTg1MjAyMTA1NjM1MjMwNTIzMTc2NDY2MzU4MDA1NDU2MjQ3NjMwMjY5NzQzMzE1OTQxODAyNTQwNjcyNzM0ODg5MDExODAxMDI2ODAxOTIxNjkzMSIsInJzYVZPIjp7InJzYVB1YmxpY0V4cG9uZW50IjoiMTAwMDEiLCJyc2FNb2R1bGVzIjoiOGNmMDhkMjkxNzdjYTJiOTQyN2M1YTJiMWQ0MTUzZjg2MGVhNWVkNzAxZGFlYTk4Mzg5YWJmZmNjNGQ1OTQ0Mjk5ZWQ4YmRkZjRkMWI1MjhhNzQ2ZGE2Yjk3OTkyODJlOGJiNTUzMDQ5NWE0MjRkZTcwM2NjMTc4ZWQyZGUwNDE1OTliY2FjMWY1MTIzNjg5NmU2MWM3M2RkYTk1ODZmOWNjZjRlMjI0NzMxZmEzNzFkOTg0ODg5MzhlZWJmNDUzODhlMTc5MjMxNTExMjY3ODM4YTE5MGJmOWE2N2YzYjcwYzg5ZWRlMWE2ODQ2ZGNjZWZkY2I0OTUzNDRmMDIzZiIsInJzYVByaXZhdGVFeHBvbmVudCI6IjFlMTNjZmVjMmYwOGY4MjkxNTE5Mzg5Y2VlZDc1YzM2MmI2ODk4ZThjNThhOTQ3OWZiY2E3YWEyNTRkNzQ3OTY5NzA2ZWNjYzY3NGNjMTllNzU2NDU3ODQ5MjhiYWFkOTk0MTMxNDJlNmM0OGU1NWQ1YjEyN2MyZjc0NWU0ZmY3MGRmZWU4MWQ0YWY4OWM0ODg1NTViMzMwMmE4OWY3ZjcwM2JmMTU0YjM1ZmM5NmVhZjMxYTFhYjMwNTQwMTE4ZGEzY2ZhY2ViZTZkMTI3ZmEyODQzZWQ3MDQ0NDJlZWE5ZDc3ODUxMTlhN2Q3MjkzY2U3NTliNGE5ZmIwODA0MzEiLCJnYWluQ291bnQiOjkzfSwic2FwQWNjb3VudCI6IjQxOTgxMzAiLCJzZXJ2aWNlQ29kZSI6IkF0ZWNvIiwiaWF0IjoxNzA0MzY2Mzg2LCJleHAiOjE3MDQzNjc4MjZ9.vTVFWupN7dbBZeEnGbYnSHPT0h0IWhInLpubS5Hjjc8' \
--header 'Content-Type: application/json' \
--header 'Cookie: HttpOnly' \
--data '{
    "caseId": "4198130-20240405-01",
    "attachmentVoList": [
        {
            "attachmentVoList": [
                {
                    "fileType": "SupportRequest",
                    "fileUrl": "cb2bf31fca3f4dbeb6f8863c20d41eb4263a5ea46afae55aae70a8e3da74dd9b2d2410893ffcc1f40ff4465301b4fc8853554f2e5c8d63ed8e657e01f2f266089ecd6989963da9b5c81ed9fbe1a0290c0558667b9a3aee5fa5c6fb33c6e62b97682750d5df7f6def75c4e0ae310f5cca",
                    "fileName": "carImage - Copy 2.png",
                    "fileSize": "1503343",
                    "createBy": null
                }
            ],
            "busiTag": "10191002"
        },
        {
            "attachmentVoList": [
                {
                    "fileType": "SupportRequest",
                    "fileUrl": "cb2bf31fca3f4dbeb6f8863c20d41eb4263a5ea46afae55aae70a8e3da74dd9b2d2410893ffcc1f40ff4465301b4fc88ad1aa91c505b9796c470f88e5b45141d9907f4d54c368081bd9a8790eee6c296833b65f7efb343f170df7645ab624541ea37e42fe3b53fa02a28739415a05f80",
                    "fileName": "carImage -3.png",
                    "fileSize": "1503343",
                    "createBy": null
                }
            ],
            "busiTag": "10191003"
        },
        {
            "attachmentVoList": [
                {
                    "fileType": "SupportRequest",
                    "fileUrl": "cb2bf31fca3f4dbeb6f8863c20d41eb4263a5ea46afae55aae70a8e3da74dd9b2d2410893ffcc1f40ff4465301b4fc881483e34e957ce91df04187f29d44f293509c0fccba7d047de2777503bbb100367072c117fdb9c71c9b1612d14ec9f89f12749b1b8e433b2ab40de642ab4ca218",
                    "fileName": "carImage 4 - Copy.png",
                    "fileSize": "1503343",
                    "createBy": null
                }
            ],
            "busiTag": "10191004"
        },
        {
            "attachmentVoList": [
                {
                    "fileType": "SupportRequest",
                    "fileUrl": "cb2bf31fca3f4dbeb6f8863c20d41eb4263a5ea46afae55aae70a8e3da74dd9b2d2410893ffcc1f40ff4465301b4fc885e24a874e35dfec936ffac83b1fa10258291acf30b7458cfb1dcde3b9e9ef56ce522c91bb9052b3661ddd9b60989a885567109bde63406afe8dde9fb8f33ff66",
                    "fileName": "carImage 1.png",
                    "fileSize": "1503343",
                    "createBy": null
                }
            ],
            "busiTag": "10191001"
        }
    ],
    "pbList": null,
    "replies": [
        {
            "id": 940616510824849400,
            "feedbackId": "939547547144732672",
            "reply": "1.Dear sir, please do the repair when you receive the spare parts ,and reply to me after you have finished the repair.",
            "replyBy": "顾岳毅",
            "replyTime": "2024-04-08 14:34:11",
            "who": "TAC",
            "remark": null,
            "attachmentList": null
        },
        {
            "id": 940616928917266400,
            "feedbackId": "939547547144732672",
            "reply": "1.Dear sir, please do the repair when you receive the spare parts ,and reply to me after you have finished the repair.",
            "replyBy": "顾岳毅",
            "replyTime": "2024-04-08 14:35:51",
            "who": "TAC",
            "remark": null,
            "attachmentList": null
        },
        {
            "id": 942092699171196900,
            "feedbackId": "939547547144732672",
            "reply": "1.Dear sir, the information isn't enough for the problem, please fill in the right mileage ",
            "replyBy": "陈越",
            "replyTime": "2024-04-12 16:20:02",
            "who": "TAC",
            "remark": null,
            "attachmentList": null
        },
        {
            "id": 942092887646441500,
            "feedbackId": "939547547144732672",
            "reply": "1.Dear sir, the information isn't enough for the problem, please fill in the right mileage ",
            "replyBy": "陈越",
            "replyTime": "2024-04-12 16:20:47",
            "who": "TAC",
            "remark": null,
            "attachmentList": null
        },
        {
            "id": 942093087358226400,
            "feedbackId": "939547547144732672",
            "reply": "1.Dear sir, please do the repair when you receive the spare parts ,and reply to me after you have finished the repair.",
            "replyBy": "陈越",
            "replyTime": "2024-04-12 16:21:35",
            "who": "TAC",
            "remark": null,
            "attachmentList": null
        }
    ],
    "carLine": null,
    "channel": "1",
    "creator": null,
    "clientAddr": null,
    "clientEmail": null,
    "clientMobile": null,
    "clientName": null,
    "corReactiveAction": "Corection",
    "creatorName": "TOYOTA FINANCE AUSTRALIA LIMITED",
    "insuranceStartTime": "1709867591000",
    "isOversea": "1",
    "mobile": null,
    "probableCause": "Cause",
    "processStatus": null,
    "purchaseDate": null,
    "remark": null,
    "secondAscCode": null,
    "symptomComplaint": "20011005",
    "troubleCode": null,
    "dadangjiaTroubleDesc": null,
    "isDadangjia": "0",
    "vin": "LSKG5GC14KA076163",
    "worksheetEndDate": null,
    "worksheetStartDate": null,
    "tacType": "1",
    "engineNo": "000355",
    "feedbackId": "939547547144732672",
    "caseGrade": "B",
    "liveSupportAttachment": null,
    "liveStatus": null,
    "liveSupportor": "",
    "liveSupportRemark": "",
    "tacCreator": "陈越",
    "suggestStatus": null,
    "oneSuggestStatus": null,
    "tacDealDays": null,
    "solveTacDays": null,
    "closedKind": null,
    "tacFinishedTime": null,
    "mileage": "12",
    "troubleLevel1": "Body",
    "troubleLevel2": "Seat",
    "troubleLevel3": "Flip seat",
    "troubleLevel1Code": "20011005",
    "troubleLevel2Code": "20011049",
    "troubleLevel3Code": "20011221",
    "failedMode": "Battery flat",
    "failedModeCode": "10121042",
    "failPartCode": "99000103",
    "loseFunctionPartName": "BOLT/SCREW-CR/SHF TORQ DMPR",
    "vehicleLoad": null,
    "vehicleSpeed": "11011004",
    "roadCondition": null,
    "weather": null,
    "caseClassification": "Warranty",
    "isAuthorized": "1",
    "claimStatus": "1",
    "title": "Compiant",
    "managerClaimCode": null,
    "engineTypeCodes": null,
    "gearboxTypeCodes": null,
    "driveModeCodes": null,
    "entertainmentSystemCodes": null
}'

# Response

# Payload

Parameter	Type	Description
status	int	1: Success, 0: Failure
errMsg	String	Error message
data	String	fir id

# Response Code (errCode)

Status Code	Description
200	Success
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
500	Unknown Error
503	Dependency System Unavailable

# Example

# OK

{
  "status": 1,
  "errCode": "200",
  "errMsg": "SUCCESS",
  "data": "4198130-20240405-01"
}

# NOT FOUND

{
  "status": 0,
  "errMsg": "NOT FOUND",
  "errCode": "404",
  "data": null
}

# INTERNAL ERROR

{
  "status": 0,
  "errMsg": "DEPENDENCY SYSTEM UNAVAILABLE",
  "errCode": "503",
  "data": null
}

{
  "status": 0,
  "errMsg": "UNKNOWN ERROR",
  "errCode": "500",
  "data": null
}

# GATEWAY ERROR

http status code: 500

# Unit Test

TODO

← Submit Fir Reply Fir →