# vendesk
<a href="https://github.com/Induxsoft/vendesk" target="_blank">https://github.com/Induxsoft/vendesk</a>

Paquete para la gestión de ventas y atención a clientes.

## Variables
## Privilegios
- `VC10` Atención a clientes.
- `VC11` Agregar nota al cliente.
- `VC12` Registrar atención.
- `VC13` Activar alertas.
- `VC14` Desactivar alertas.
- `VC15` Administrar cliente.
- `VC21` Crear caso.
- `VC22` Editar caso.
- `VC23` Anexar notas a un caso.
- `VC24` Adjuntar archivos a un caso.
- `VC25` Eliminar archivos adjuntos a un caso.
- `VC26` Cerrar caso.
- `VC27` Re-abrir caso.
- `VC30` Administración de casos .
- `VC40` Administración de tipos de casos.
- `VC50` Administración de prioridades de casos.
- `VC60` Configurar notificaciones de atención a clientes.
- `VC61` Asignar Notificación.

## Tipos de elementos de datos
- `DET014` Cliente.
- `DET01C` Documento de venta.

## Servicios
## Tareas
## Bibliotecas
## Eventos
- `VC13` Activar alertas.
- `VC21` Crear caso.
- `VC22` Editar caso.
- `VC23` Anexar notas a un caso.
- `VC24` Adjuntar archivos a un caso.
- `VC26` Cerrar caso.
- `VC27` Reabrir caso.


## Simple Integration service endpoint (SISE)

#### Agregar prospecto
- Punto final: /!/sise/lead-add/

##### Campos esperados

- **name -** Nombre del prospecto (requerido).
- *email -* Correo electronico.
- *phone -* Teléfono.
- *organization -* Organización a la que pertenece el prospecto.
- *position -* Puesto del prospecto en la Organización.
- *subject -* Asunto o motivo por la cual está interesado en el producto o servicio.
- *remarks -* Comentarios adicionales.
- *agent_id -* Usuario a la que se asignará el prospecto.
- *leadstatus -* Estado.

###### Estados
- *0 -* Recibido.
- *1 -* Atendido.
- *2 -* Descartado.
- *3 -* Oportunidad.
- *4 -* Ganado.
- *5 -* Perdido.

###### Retorno
"Se ha registrado con éxito la información de contacto""

---

#### Agregar ticket
- Punto final: /!/sise/open-ticket/

##### Campos esperados
- **customer_id -** Identificador del cliente `código` (requerido).
- **ticket_type -** Tipo de ticket (requerido).
- **description -** Descripción del ticket (requerido).
- **subject -** Asunto por la cual se apertura el ticket (requerido).
- *date_open -* Fecha de apertura (si se omite, se asigna la fecha actual).
- *hour_open -* Hora de apertura (si se omite, se asigna la hora actual).
- *user -* Usuario quien apertura el ticket.

##### Tipos de tickets
- *611857F14E5611E3BA6975DAE5EEF70A -* Quejas
- *AA8BF7234E5611E3BA6975DAE5EEF70A -* Sugerencias
- *AD4732804E5611E3BA6975DAE5EEF70A -* Soporte técnico
- *AFE659D64E5611E3BA6975DAE5EEF70A -* Garantías
- *B31E7E504E5611E3BA6975DAE5EEF70A -* Logística y operaciones
- *B70771D84E5611E3BA6975DAE5EEF70A -* Otros

##### Retorno
"Se ha creado un nuevo caso con el id # Número de ticket"

#### Listar tickets de un cliente
- Punto final: /!/sise/list-tickets/

##### Campos esperados
- **customer_id -** Identificador del cliente `código` (requerido).

##### Retorno
JSON
```
[
    {
        "id_ticket":"Número de ticket",
        "id_unique":"Identificador único (sys_guid)",
        "date_open":"Fecha de apertura",
        "hour_open":"Hora de apertura",
        "date_close":"Fecha de cierre",
        "hour_close":"Hora de cierre",
        "user_open":"Usuario quien aperturó el ticket",
        "user_close":"Usuario quien cerró el ticket",
        "user_assing":"Usuario al fue asignado",
        "subject":"Asunto de ticket",
        "description":"Descripción por la cual se aperturó",
        "ticket_type":"Tipo de ticket",
        "duration":"Tiempo de duración",
        "priority":"Prioridad",
        "status":"Estado"
    },
    ....
]
```
#### Información de un ticket en especifico
- Punto final: /!/sise/info-ticket/

##### Campos esperados
- **ticket -** Número de ticket.

##### Retorno
JSON

```
{
    "id_ticket":"Número de ticket",
    "id_unique":"Identificador único (sys_guid)",
    "date_open":"Fecha de apertura",
    "hour_open":"Hora de apertura",
    "date_close":"Fecha de cierre",
    "hour_close":"Hora de cierre",
    "user_open":"Usuario quien aperturó el ticket",
    "user_close":"Usuario quien cerró el ticket",
    "user_assing":"Usuario al fue asignado",
    "subject":"Asunto de ticket",
    "description":"Descripción por la cual se aperturó",
    "ticket_type":"Tipo de ticket",
    "duration":"Tiempo de duración",
    "priority":"Prioridad",
    "status":"Estado"
}
```
---