Contactos

Administra contactos asociados a clientes.

Personas de contacto asociadas a clientes.

Dependencia: Requiere cargar Clientes primero.

Endpoint

POST /full-csv-integration/upload-contacts

Campo de Formulario: contactsFile

Campos Requeridos

Campo	Tipo	Descripción	Validaciones
`erp_customer_id`	String	ID del cliente en ERP	No puede estar vacío. Debe existir en Clientes — ver la advertencia más abajo
`names`	String	Nombres del contacto	No puede estar vacío
`lastnames`	String	Apellidos del contacto	No puede estar vacío
`is_primary`	Boolean	¿Es contacto principal?	Obligatorio: `1` o `0`. Otro valor (`true`, `si`, `yes`) se rechaza

Campos Opcionales

Campo	Tipo	Descripción	Validaciones	Por Defecto
`email`	String	Email del contacto	Formato de email válido. Se requiere al menos email O celular	null
`mobile_phone`	String	Número de celular	Solo dígitos: se rechazan espacios, `+` y guiones. Si se proporciona, `mobile_phone_code` es requerido	null
`mobile_phone_code`	String	Código de país para celular	Solo dígitos. Requerido si `mobile_phone` está presente	null
`phone`	String	Número de teléfono fijo	Solo dígitos. No exige `phone_code`	null
`phone_code`	String	Código de país para teléfono fijo	Solo dígitos	null
`job_title`	String	Cargo/Título	-	null

Contacto principal

Si varios contactos del mismo cliente vienen con is_primary = 1, se conserva como principal el primero del archivo y el resto pasa a 0. Esto no genera error.
El principal del archivo reemplaza al que el cliente ya tenía: el contacto anterior deja de ser principal, incluso si no viene en el archivo.

⚠️ Filas con un cliente que no existe: se descartan al procesar el archivo y eso no se refleja en la respuesta, que ya confirmó la carga. Si ningún erp_customer_id del archivo existe en Clientes, no se procesa nada. Cargue Clientes primero.

Contactos repetidos: este archivo no deduplica. Si la misma persona viene dos veces, se crean dos contactos.

Al actualizar un contacto que ya existe, el teléfono fijo (phone) no se modifica: solo se guarda cuando el contacto se crea.

Ejemplo CSV

erp_customer_id,names,lastnames,email,mobile_phone,mobile_phone_code,is_primary,job_title
CUST001,Juan,Pérez,juan.perez@abc.com,3001234567,57,1,Gerente General
CUST001,María,García,maria.garcia@abc.com,3009876543,57,0,Asistente
CUST002,Carlos,Rodríguez,carlos@xyz.com,3012345678,57,1,Director