Módulo Contactos

El módulo Contactos (ERP.Contacts) constituye el directorio centralizado de entidades maestras de BaseGes ERP. Gestiona todas las relaciones comerciales e internas necesarias para facturación, compras, partes de trabajo y seguimiento de obras.

---

Recursos Incluidos en el Módulo

Recurso	Endpoint Base	Descripción
Clientes	/customers	Consulta de fichas de clientes, datos fiscales, direcciones de entrega y condiciones de pago.
Proveedores	/providers	Directorio de proveedores y subcontratistas con identificación fiscal y canales de contacto.
Personal / Empleados	/employees	Equipo interno, técnicos, operarios y responsables asignables a proyectos y partes.
Obras / Proyectos	/projects	Centros de coste y obras vinculadas a clientes con control de estado y fechas de ejecución.

---

Principios Comunes de la API

Todos los endpoints del módulo Contactos siguen los mismos estándares de diseño:

1. Autenticación Obligatoria: Cabecera X-Api-Key: SU_API_KEY o Authorization: Bearer <TOKEN_JWT>.
2. Búsqueda Global (search): Un único parámetro que busca coincidencias parciales de forma simultánea en código, nombre, NIF/CIF, dirección, población, teléfono y email.
3. Paginación Eficiente:
   • page: Número de página (predeterminado: 1, mínimo: 1).
   • pageSize: Elementos por página (predeterminado: 50, rango: 1 a 100).
4. Sincronización Incremental (updatedAfter):
   • Formato estándar ISO 8601: ?updatedAfter=2026-10-01T00:00:00Z.
   • Permite consultar únicamente las fichas que hayan cambiado desde la última sincronización de su sistema externo.

Guía de Integración

Si desea ver ejemplos completos de llamadas HTTP y snippets en C#, cURL y Python, consulte la Guía de Integración Práctica.