Endpoint para crear un nuevo seed

Este endpoint permite crear un nuevo seed en el sistema. Un seed es un potencial cliente o lead que se introduce en la base de datos para su posterior seguimiento y gestión.

Método y URL

• Método: POST
• URL: /api/add_seed

Cuerpo de la petición

El cuerpo de la petición debe ser un objeto JSON con los siguientes campos:

• nombre (string, obligatorio): Nombre del seed.
• email (string, obligatorio): Correo electrónico del seed.
• telefono (string, obligatorio): Número de teléfono del seed.
• razon_social (string, opcional): Razón social del seed.
• tipo_via (string, opcional): Tipo de vía (calle, avenida, etc.).
• direccion (string, opcional): Dirección del seed.
• direccion2 (string, opcional): Dirección adicional del seed.
• portal (string, opcional): Número de portal.
• piso (string, opcional): Número de piso.
• municipio (string, opcional): Municipio del seed.
• codigo_postal (string, opcional): Código postal del seed.
• provincia (string, opcional): Provincia del seed.
• codigo_cnae (string, opcional): Código CNAE del seed.
• nombre_comercial (string, opcional): Nombre comercial del seed.
• observaciones (string, opcional): Observaciones sobre el seed.
• telefono2 (string, opcional): Número de teléfono adicional del seed.
• telefono3 (string, opcional): Número de teléfono adicional del seed.
• tipo (string, opcional): Tipo de seed.
• origen_txt (string, opcional): Origen del seed (texto descriptivo).
• origen (int, opcional): ID numérico del origen del seed.
• dni (string, opcional): DNI del seed.
• cif (string, opcional): CIF del seed.
• seccion_creador (string, opcional): Sección del creador del seed.
• situacion_laboral (string, opcional): Situación laboral del seed.
• titulacion (string, opcional): Titulación del seed.
• actuacion (object, opcional): Objeto con los datos de la actuación a crear junto con el seed.

Parámetros del objeto actuación

Todos los parámetros son opcionales:

• texto (string, opcional): Descripción de la actuación. Por defecto: “Actuación creada via API”
• via_actuacion (int, opcional): Canal de comunicación. Por defecto: 8 (API)
• tipo_actuacion (int, opcional): Tipo de actuación. Por defecto: 9 (Contacto)
• exito_actuacion (int, opcional): Estado del éxito. Por defecto: 1 (En proceso)
• sentido (int, opcional): Dirección de la comunicación. Por defecto: 0 (Recibida)

Valores de referencia para actuaciones

Via actuación:

• 1 = Teléfono
• 2 = Email
• 3 = Presencial
• 7 = WordPress
• 8 = API

Tipo actuación:

• 1 = Llamada
• 9 = Contacto

Éxito actuación:

• 0 = Sin éxito
• 1 = En proceso
• 2 = Éxito

Sentido:

• 0 = Recibida
• 1 = Enviada

Ejemplos de petición

Ejemplo con actuación completa

{
    "nombre": "Juan Pérez Garcías",
    "email": "ana@example.com",
    "telefono": "666123236",
    "razon_social": "Empresa Ejemplo S.L.",
    "direccion": "Gran Vía 123",
    "municipio": "Madrid",
    "provincia": "Madrid",
    "observaciones": "Cliente potencial interesado en cursos",
    "origen_txt": "Wordpress",
    "origen": 2,
    "actuacion": {
        "texto": "Contacto inicial desde formulario web",
        "via_actuacion": 7,
        "tipo_actuacion": 9,
        "exito_actuacion": 1,
        "sentido": 0
    }
}

Ejemplo solo con seed (sin actuación)

{
    "nombre": "María López",
    "email": "maria.lopez@example.com",
    "telefono": "677654321",
    "municipio": "Barcelona",
    "provincia": "Barcelona"
}

Respuesta

La respuesta será un objeto JSON con los siguientes campos:

• success (boolean): Indica si la operación fue exitosa o no.
• message (string): Mensaje descriptivo del resultado de la operación.
• seed_id (int, opcional): ID del seed creado, solo presente si la operación fue exitosa.
• actuacion_id (int, opcional): ID de la actuación creada, solo presente si se creó una actuación exitosamente.
• missing_fields (array, opcional): Lista de campos obligatorios que faltaban en la petición, solo presente si la operación falló por falta de datos.

Ejemplos de respuesta

Éxito con actuación

{
    "success": true,
    "message": "Seed y actuación creados correctamente",
    "seed_id": 12345,
    "actuacion_id": 67890
}

Éxito sin actuación

{
    "success": true,
    "message": "Seed creado correctamente",
    "seed_id": 12345
}

Error en actuación (seed se crea igual)

{
    "success": true,
    "message": "Seed creado correctamente, pero hubo un error al crear la actuación",
    "seed_id": 12345,
    "actuacion_error": "Error en los datos de la actuación"
}