Obtiene información sobre las visitas en el período indicado. Se admite filtrado por ID de tareas y por ID de usuario.
Solicitud
Endpoint
POST https://yourdomain.pharmahrm.com/crm-api/db-function/run
Autenticación
Bearer Token (obligatorio)
Estructura de la solicitud
Encabezados
| Clave | Valor |
|---|---|
| Authorization | Bearer <token>
|
| Content-Type | application/json |
Cuerpo
{
"function": "api_get_tasks",
"format": "csv",
"arguments": {
"date_from": "2025-08-04",
"date_till": "2025-08-04",
"ids": "1,2,3,4",
"user_id": 1
}
}| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| function | string | Sí | Nombre del método — "api_get_tasks" |
| format | string | Sí | Formato de respuesta — csv |
| arguments | object | Sí | Conjunto de parámetros |
| date_from | string | Sí | Fecha inicial |
| date_till | string | Sí | Fecha final |
| ids | string | No | Lista de IDs de visitas |
| user_id | integer | No | ID del usuario |
Respuesta exitosa
200 OK
Formato csv — texto CSV simple.
Content-Type
text/plain
Ejemplo de respuesta
task_id,task_datefrom,task_datetill,task_gmt_offset,task_type,task_user_id,task_user2_id,task_company_id,task_contact_id,task_target,task_spec,task_taskstate,task_created,task_fact_start,task_fact_end,task_dist,task_gps_lng,task_gps_lat
1234,2025-08-04T08:00:00Z,2025-08-04T08:30:00Z,180,Visit,5,,101,201,A,Cardiologist,Done,2025-08-03T12:15:00Z,2025-08-04T08:03:00Z,2025-08-04T08:28:00Z,0.5,30.5238,50.4501
| Campo | Descripción |
|---|---|
| task_id | ID de la visita |
| task_datefrom | Inicio planificado |
| task_datetill | Fin planificado |
| task_gmt_offset | Offset UTC |
| task_type | Tipo de visita |
| task_user_id | Ejecutor |
| task_user2_id | Observador |
| task_company_id | ID de institución |
| task_contact_id | ID del cliente |
| task_target | Grupo objetivo |
| task_spec | Especialización del cliente |
| task_taskstate | Estado de la visita |
| task_created | Fecha de creación |
| task_fact_start | Inicio real |
| task_fact_end | Final real |
| task_dist | Distancia |
| task_gps_lng | Longitud |
| task_gps_lat | Latitud |
Error
40x/50x
{
"message": "string"
}| Código | Descripción |
|---|---|
| 400 | Petición inválida |
| 401 | No autorizado |
| 500 | Error del servidor |