ClientRating

Calificación que un Provider otorga a un Client tras completar una asignación (OrderProvider). rate va de 1 a 5; comment es opcional. Un cliente solo puede editar la calificación mientras no tenga comentario.

Estructura de Datos

Atributo Tipo Descripción
id int
rate int Puntuación de 1 a 5
comment string\|null Comentario opcional de la calificación
created_at datetime\|null
updated_at datetime\|null
order_id int\|null {@link Order} de la que surge la calificación
client_id int {@link Client} calificado
provider_id int\|null {@link Provider} que califica
company_id int {@link Company} de la calificación (oculto)
allLogs ApiLog>
client Client {@link Client} calificado
logs ApiLog>
order Order\|null {@link Order} de la que surge la calificación
provider Provider\|null {@link Provider} que califica
rated Client Entidad calificada (el {@link Client}) 
{
    "id": 467,
    "order_id": 1529,
    "client_id": 39,
    "provider_id": 36,
    "rate": 4,
    "comment": "muy buen servicio",
    "created_at": "2020-05-01 02:07:19",
    "updated_at": "2020-05-01 02:07:19"
}

Endpoints

Insertar ClientRating

Insertar ClientRating de OrderProvider

Calificar al cliente de una asignación

Crea una ClientRating para el Client de la asignación (OrderProvider), que debe estar asignada y completada. Notifica al cliente.

Método URI Cabeceras
POST /companies/{companyId}/order-providers/{orderProviderId}/client-ratings Authorization 
{
    "rate": "required|integer|min:1|max:5",
    "comment": "string|max:255"
}

Listar ClientRating

Listar ClientRating de Client

{info} Soporta: Paginación Filters Carga dinámica

Listar calificaciones recibidas por un cliente

ClientRating otorgadas al Client indicado por los repartidores.

Método URI Cabeceras
GET /companies/{companyId}/clients/{clientId}/client-ratings Authorization

Listar ClientRating de Order

{info} Soporta: Paginación Filters Carga dinámica

Listar calificaciones de cliente de una orden

ClientRating asociadas a la Order indicada.

Método URI Cabeceras
GET /companies/{companyId}/orders/{orderId}/client-ratings Authorization

Mostrar ClientRating

{info} Soporta: Carga dinámica

Mostrar calificación de cliente

Devuelve la ClientRating por su id.

Método URI Cabeceras
GET /companies/{companyId}/client-ratings/{clientRatingId} Authorization

Actualizar ClientRating

Actualizar calificación de cliente

Modifica rate y comment de la ClientRating. Un cliente solo puede editarla mientras no tenga comentario.

Método URI Cabeceras
PATCH /companies/{companyId}/client-ratings/{clientRatingId} Authorization 
{
    "comment": "required|string|max:255"
}

Errores de negocio

Código HTTP Cuándo ocurre
EE300 400 La calificación ya tiene un comentario.

Relaciones