Status: 400 Bad Request, com dados: "errorMessage": "There is no match for the Ref. code value entered","propertyName": "Clients[n].Id"
Motivo
Representa que não foi possível identificar uma pessoa do tipo “Cliente” (profileType = 1) ou “Agente e Cliente” (profileType = 3) para ser inserida como cliente do ticket.
Pode representar tanto que não há nenhum cadastro com o ID passado no seu sistema atualmente, ou que a pessoa deste ID não é do tipo “cliente” ou “Agente e Cliente”, dependendo do campo (propertyName) onde o erro ocorreu.
Observação: Esse erro também pode aparecer com outros “propertyName”, como “Actions[n].CreatedBy”, e “CreatedBy”, visto que tem relação com o id inserido nos campos em questão, para relacionar essas informações com algum usuário já cadastrado no sistema.
Por exemplo, no Body abaixo, é informado um ID inexistente no campo de “id”, dentro da coleção de “clients”, assim como no campo de “createdBy” do próprio ticket, e da primeira ação dele:
{
"type": 2,
"subject": "EXEMPLO - There is no match for the Ref. code value entered",
"category": null,
"urgency": null,
"createdBy": {
"id": "Cod Ref 00002"
},
"status": "Novo",
"justification": null,
"serviceFirstLevelId": null,
"contactForm": null,
"clients": [
{
"id": "Cod Ref 00002"
}
],
"actions": [
{
"id": 1,
"type": 2,
"origin": 0,
"description": "Exemplo\n",
"htmlDescription": "<p>Exemplo</p>",
"status": "Novo",
"justification": null,
"createdDate": "2022-06-06T22:19:16.7843512",
"createdBy": {
"id": "Cod Ref 00002"
},
"isDeleted": false,
"timeAppointments": [],
"attachments": [],
"expenses": [],
"tags": []
}
],
"customFieldValues": [
{
"customFieldId": 101443,
"customFieldRuleId": 51230,
"line": 1,
"value": "00000000000",
"items": []
},
],
"assets": [],
"webhookEvents": null
}
Consequentemente, recebemos o erro em questão para cada uma das 3 propertyNames mencionadas:
Resolução
Para este erro deixar de ser retornado em sua requisição da API, basta alterar o valor dos campos onde o erro foi retornado para o Cod Ref de pessoas existentes em sua base de atendimento, e que tenham o tipo de perfil necessário de acordo com o campo (“Cliente”, “Agente”, ou “Agente e Cliente”, ou qualquer um deles) onde o erro ocorreu.
Por exemplo, alterando o Body da requisição acima de forma a usar o id “Cod Ref 000023” já cadastrado na base de dados que estamos usando nestes exemplos, o erro deixa de ser retornado, em vez do id antigo “Cod Ref 00002”, que não existe na base de dados, podemos ver que a requisição é realizada com sucesso.
Novo body:
{
"type": 2,
"subject": "EXEMPLO - There is no match for the Ref. code value entered",
"category": null,
"urgency": null,
"createdBy": {
"id": "Cod Ref 000023"
},
"status": "Novo",
"justification": null,
"serviceFirstLevelId": null,
"contactForm": null,
"clients": [
{
"id": "Cod Ref 000023"
}
],
"actions": [
{
"id": 1,
"type": 2,
"origin": 0,
"description": "Exemplo\n",
"htmlDescription": "<p>Exemplo</p>",
"status": "Novo",
"justification": null,
"createdDate": "2022-06-06T22:19:16.7843512",
"createdBy": {
"id": "Cod Ref 000023"
},
"isDeleted": false,
"timeAppointments": [],
"attachments": [],
"expenses": [],
"tags": []
}
],
"customFieldValues": [
{
"customFieldId": 101443,
"customFieldRuleId": 51230,
"line": 1,
"value": "00000000000",
"items": []
},
],
"assets": [],
"webhookEvents": null
}