Crear Contacto Asociado a un Tercero

Notas importantes

Unicidad del nombre: El nombre del contacto debe ser único dentro del tercero especificado. No se puede crear dos contactos con el mismo nombre para el mismo tercero.
Unicidad del email: Si se proporciona un email, este debe ser único en toda la compañía. No se puede crear dos contactos con el mismo email, incluso si pertenecen a terceros diferentes.
Validación de tercero: El third_party_code debe corresponder a un tercero existente y activo en el sistema. La búsqueda es case-insensitive.
Validación de sucursal: Si se proporciona branch_code, debe corresponder a una sucursal válida que pertenezca al tercero especificado. La sucursal debe estar configurada como hijo (id_parent) del tercero principal.
Campos opcionales: Los campos email, telephone, movil, skype, linkedin y branch_code son opcionales. Si no se proporcionan o están vacíos, el contacto se creará sin esa información.
Case-insensitive: Las validaciones de third_party_code, branch_code, email y name son case-insensitive.

Parámetros de entrada

Se debe enviar el siguiente body:

Parámetro	Tipo	Requerido	Descripción
`third_party_code`	Texto	Si	Código del tercero al que se asociará el contacto. Debe existir en el sistema.
`name`	Texto	Si	Nombre completo del contacto. Debe ser único para el tercero especificado.
`role`	Texto	Si	Cargo o rol del contacto dentro de la organización del tercero.
`email`	Texto	No	Correo electrónico del contacto. Si se proporciona, debe ser único en toda la compañía.
`telephone`	Texto	No	Número de teléfono fijo del contacto.
`movil`	Texto	No	Número de teléfono móvil del contacto.
`skype`	Texto	No	Usuario de Skype del contacto.
`linkedin`	Texto	No	Perfil de LinkedIn del contacto.
`branch_code`	Texto	No	Código de la sucursal del tercero a la que pertenece el contacto. Si se proporciona, debe corresponder a una sucursal válida del tercero.

Nota: Los campos email, telephone, movil, skype, linkedin y branch_code son opcionales y pueden enviarse como cadenas vacías o no incluirse en el body.

Parámetros de salida

Parámetro	Tipo	Descripción
`id`	Entero	ID único del contacto creado.
`third_party_code`	Texto	Código del tercero asociado.
`third_party_name`	Texto	Nombre del tercero asociado.
`name`	Texto	Nombre del contacto.
`email`	Texto	Email del contacto.
`telephone`	Texto	Número de teléfono fijo del contacto.
`movil`	Texto	Número de teléfono móvil del contacto.
`skype`	Texto	Usuario de Skype del contacto.
`linkedin`	Texto	Perfil de LinkedIn del contacto.
`role`	Texto	Cargo o rol del contacto.
`branch_code`	Texto	Código de la sucursal asociada (si aplica).
`branch_name`	Texto	Nombre de la sucursal asociada (si aplica).

Ejemplo

Petición (POST): https://app.fracttal.com/api/third_parties_contacts/

{
    "third_party_code": "THIRD002",
    "name": "mateo pereze",
    "email": "[email protected]",
    "telephone": "+57 1 234 5678",
    "movil": "+57 300 123 4567",
    "skype": "mateo.pereze",
    "linkedin": "linkedin.com/in/mateo-pereze",
    "role": "Gerente de Compras",
    "branch_code": "sucursal01"

{
    "success": true,
    "message": "200",
    "total": 1,
    "data": {
        "id": 12345,
        "third_party_code": "THIRD002",
        "third_party_name": "Proveedor ABC S.A.S",
        "name": "mateo pereze",
        "email": "[email protected]",
        "telephone": "+57 1 234 5678",
        "movil": "+57 300 123 4567",
        "skype": "mateo.pereze",
        "linkedin": "linkedin.com/in/mateo-pereze",
        "role": "Gerente de Compras",
        "branch_code": "sucursal01",
        "branch_name": "Sucursal Norte"
    }