A inclusão de tarefas de contato realizadas pela assessoria para clientes que estejam distribuídos para a assessoria pode ser realizada através do método Tarefas API - Incluir tarefa manual.
O parâmetro de entrada cliente deve ser informado, obrigatoriamente, com o ID do cliente ou com o ID externo do cliente ou com o CPF/CNPJ do cliente para o qual a tarefa de contato deve ser incluída. O parâmetro de entrada acao deve ser informado, obrigatoriamente, com o ID do tipo da tarefa de contato a ser incluída, que pode ser obtido conforme descrito em Obtendo os Tipos de Tarefa de Contato. O parâmetro de entrada motivoContato deve ser informado, obrigatoriamente, com o ID do motivo de contato da tarefa a ser incluída, que pode ser obtido conforme descrito em Obtendo os Motivos de Contato. O parâmetro motivoAtraso, de preenchimento opcional, pode ser informado com o ID do motivo de atraso da tarefa a ser incluída, que pode ser obtido conforme descrito em Obtendo os Motivos de Atraso. O parâmetro de entrada observacao deve ser informado, obrigatoriamente, com as observações da tarefa de contato a ser incluída. Através do parâmetro de entrada anexos, de preenchimento opcional, pode ser informada uma lista com um ou mais arquivos previamente enviados (upload) que devem ser anexados à tarefa de contato a ser incluída. Cada arquivo da lista deve ser informado com o parâmetro de entrada nomeArquivo contendo o nome único interno que foi atribuído quando o arquivo foi enviado e com o parâmetro de entrada nomeOriginalArquivo contendo o nome original do arquivo enviado, conforme descrito em Enviando os Arquivos a serem Anexados à Tarefas de Contato.
O método retorna, no atributo id, o identificador gerado para a tarefa de contato que foi incluída, além de todas as demais informações detalhadas da tarefa de contato, dentre as quais, nos atributos acao, motivoContato e motivoAtraso, as informações do tipo, do motivo de contato e do motivo de atraso da tarefa de contato incluída.
Se a assessoria não possuir permissão para a inclusão de tarefas de contato para o cliente, um código de erro 400 (Tratamento de Erros) é retornado com a mensagem "Você não tem permissão para incluir tarefa para o cliente".
Exemplos de chamadas e de retornos deste método constam no arquivo Assessorias - Tarefas API.postman_collection.json, disponível como anexo em Integrando Assessorias através da API do CobranSaaS.
0 Comentários