Operación e Integración

• Uso desde REST/API
• Instalación y 2Pack

Uso desde REST/API

Los clientes externos pueden crear citas directamente en CDS_Appointment mediante la API REST estándar de iDempiere. No se requiere un proceso custom para crear la cita.

Idea clave: REST/API y ventana iDempiere comparten la misma seguridad funcional porque el evento de modelo valida el registro antes de guardarlo.

Flujo recomendado

1. Consultar servicios activos en CDS_AppointmentService.
2. Consultar empleados activos y sus relaciones en CDS_EmployeeService.
3. Consultar o calcular disponibilidad usando la misma información de horarios y días libres.
4. Crear un registro CDS_Appointment con cliente, empleado, servicio, fecha, hora inicial, hora final, precio, duración y estado.
5. Dejar que AppointmentModelValidator valide consistencia, disponibilidad y conflictos.

Campos importantes

Campo	Uso
C_BPartner_ID	Cliente o tercero de la cita.
CDS_AppointmentEmployee_ID	Empleado que atiende.
CDS_AppointmentService_ID	Servicio solicitado.
AppointmentDate	Día operativo de la cita.
StartDateTime / EndDateTime	Rango exacto de atención.
Price / DurationMinutes	Valores efectivos de la cita, validados contra servicio/slot cuando aplique.
R_Request_ID	Referencia opcional/manual si una implementación quiere vincular una solicitud. El código del plugin no depende de este campo.

Instalación y 2Pack

La instalación requiere desplegar el bundle OSGi del plugin y aplicar el 2Pack correspondiente en iDempiere 12.

2Packs incluidos

Archivo	Uso
2Pack_1.0.0.zip	Paquete inicial del diccionario de aplicación.
2Pack_1.0.1.zip	Paquete actualizado con traducciones es_CO para campos, elementos, menús, ventanas, pestañas, procesos, parámetros, referencias y valores de lista.

Pasos de instalación

1. Compilar y desplegar el bundle com.cdsoftware.appointment en iDempiere 12.
2. Aplicar el 2Pack más reciente desde com.cdsoftware.appointment/META-INF.
3. Reiniciar o refrescar iDempiere para activar servicios OSGi, factories, anotaciones, callouts, procesos y eventos.
4. Configurar CDS_AppointmentConfig para la organización.
5. Crear servicios en CDS_AppointmentService.
6. Crear empleados en CDS_AppointmentEmployee.
7. Relacionar empleados con servicios en CDS_EmployeeService.
8. Configurar horarios semanales en CDS_EmployeeScheduleLine.
9. Configurar días no disponibles en CDS_OrgDayOff o CDS_EmployeeDayOff.
10. Probar la generación de slots y creación de citas desde la ventana.

Importante: después de aplicar cambios de diccionario que modifiquen columnas o referencias, se deben regenerar modelos y revisar que el código siga usando las constantes generadas.