Skip to main content
El módulo CRM de A3ERP te permite registrar y gestionar toda la actividad comercial con tus clientes y contactos: tareas pendientes, citas programadas y comunicaciones por email. Estos endpoints te dan acceso completo a las acciones CRM, desde la consulta filtrada del histórico hasta la creación, modificación y borrado de registros individuales. Además, en esta misma sección encontrarás los endpoints de impresión de documentos y eliminación de líneas de documento.
Todos los endpoints de CRM requieren la cabecera Authorization: Bearer {token}.

Consultar acciones CRM

Consultar todas las acciones

Devuelve el listado completo de acciones CRM registradas en el sistema.
Ejemplo de petición
Respuesta 200 — Array de objetos acción CRM.

Filtrar acciones

Devuelve el listado de acciones que cumplen con el filtro especificado.
string
required
Expresión de filtro a aplicar sobre las acciones CRM (p. ej., TipoAccion='Tarea').
Ejemplo de petición

Ordenar acciones

Devuelve el listado de acciones ordenadas según el criterio indicado.
string
required
Criterio de ordenamiento (p. ej., nombre de campo ascendente o descendente).
Ejemplo de petición

Filtrar y ordenar acciones

Combina filtrado y ordenación en una sola llamada.
string
required
Expresión de filtro a aplicar.
string
required
Criterio de ordenamiento de los resultados.
Ejemplo de petición

Crear acción CRM

Crea una nueva acción CRM en A3ERP. Todos los campos del cuerpo son opcionales; la combinación de campos que envíes determinará el tipo y los datos de la acción.
Cuerpo de la petición (application/json)
string
Tipo de acción. Valores posibles: Tarea, Cita, Email.
string
Código del comercial o persona responsable de la acción.
string
Fecha de alta o creación de la acción (formato DD/MM/YYYY).
string
Fecha prevista de realización. Si no se indica, se toma la fecha actual en el momento de la llamada.
string
Hora prevista de realización. Si no se indica, se toma la hora actual en el momento de la llamada.
string
Código del canal de comunicación.
string
ID del contacto vinculado a la acción. Si se proporciona, el email se toma automáticamente del registro del contacto, ignorando el campo Email.
string
Dirección de email. Solo se usa si no se ha proporcionado Idcontacto.
string
Importe del gasto asociado a la acción.
string
Código del motivo de la acción.
string
ID de la organización o empresa vinculada a la acción.
string
Texto libre con observaciones sobre la acción.
string
Número de teléfono de contacto.
string
Asunto de la acción (corresponde al campo “Asunto” en la interfaz de A3ERP).
string
Tipo de contrato asociado.
string
Dirección(es) en copia (CC) para acciones de tipo Email.
string
Dirección(es) en copia oculta (CCO/BCC) para acciones de tipo Email.
Ejemplo de petición
Si no se indica FecPrevista ni HoraPrevista, la API asigna automáticamente la fecha y hora actuales en el momento de la llamada. Si incluyes Idcontacto, el email se tomará siempre del registro del contacto, aunque envíes el campo Email en el cuerpo.
Respuesta 200

Modificar acción CRM

Actualiza los datos de una acción CRM existente. Envía únicamente los campos que deseas modificar.
integer
required
ID numérico de la acción a modificar.
Cuerpo de la petición (application/json) Acepta los mismos campos que el endpoint de creación, a excepción de TipoAccion.
El campo TipoAccion no puede modificarse una vez creada la acción. Si lo incluyes en el cuerpo, será ignorado.
Ejemplo de petición
Respuesta 200

Borrar acción CRM

Elimina de forma permanente una acción CRM del sistema.
integer
required
ID numérico de la acción a borrar.
Ejemplo de petición
Respuesta 200 — La acción ha sido borrada correctamente.
Esta operación es irreversible. Asegúrate de que la acción que vas a borrar no esté vinculada a procesos activos antes de eliminarla.

Impresión de documentos

Obtiene los datos de impresión de un documento en formato Base64, listo para renderizar o descargar como PDF.
string
required
Tipo de documento a imprimir (p. ej., pedido, albaran, factura).
string
required
ID del documento cuya impresión se desea obtener.
Ejemplo de petición
Respuesta 200
string
Contenido del documento codificado en Base64. Decodifícalo en tu aplicación para obtener el fichero PDF.

Eliminar línea de documento

Elimina una línea concreta de un documento identificándola por el ID del documento y el número de línea (Numlin).
string
required
Tipo de documento (p. ej., pedido, albaran, factura).
string
required
ID del documento del que se eliminará la línea.
string
required
Número de línea (Numlin) dentro del documento que se desea eliminar.
Ejemplo de petición
Respuesta 200 — Línea eliminada correctamente (sin contenido).
La eliminación de una línea de documento es permanente y puede afectar al cálculo de totales, impuestos y cartera asociados al documento. Verifica el impacto antes de ejecutar esta operación.