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.