Skip to main content
A3ERP API ofrece un conjunto de endpoints de utilidades que encapsulan operaciones comunes de negocio: desde recalcular stocks y precios medios hasta obtener el plan de vencimientos de un documento, pasando por consultar tipos de cambio, comisiones de representantes o cuentas contables asociadas a artículos. Esta página recoge todos estos endpoints agrupados por área funcional.

​
Stock y precios

​
Recalcular stock de un artículo

Recalcula el stock de un artículo concreto en un almacén determinado.
Ejemplo:
​
string
required
El código del artículo cuyo stock se recalculará.
​
string
required
El código del almacén en el que se recalculará el stock.
​
string
required
Token de autenticación en formato Bearer <JWT_token>.

​
Recalcular todos los stocks y precios medios

Recalcula el stock y el precio medio de coste de todos los artículos. Opcionalmente puede actualizar también el coste en los documentos de venta.
Ejemplo:
​
string
required
Indica si se debe actualizar el coste en los documentos de venta. Valores posibles: F (no actualizar) o T (actualizar).
​
string
required
Token de autenticación en formato Bearer <JWT_token>.

​
IVA / IGIC

​
Crear cierre de IVA/IGIC

Crea los cierres de IVA o IGIC para el periodo indicado.
Ejemplo:
​
string
required
El tipo contable al que pertenece el cierre.
​
string
required
Fecha de inicio del periodo de cierre en formato YYYYMMDD.
​
string
required
Fecha de fin del periodo de cierre en formato YYYYMMDD.
​
string
required
Indica si se debe realizar el cierre de documentos. Valores posibles: F (no) o T (sí).
​
string
required
Indica si se debe realizar el cierre contable. Valores posibles: F (no) o T (sí).
​
string
required
Token de autenticación en formato Bearer <JWT_token>.

​
Borrar cierres de IVA/IGIC

Elimina los cierres de IVA o IGIC del periodo indicado.
Ejemplo:
​
string
required
El tipo contable al que pertenece el cierre a eliminar.
​
string
required
Fecha de inicio del periodo en formato YYYYMMDD.
​
string
required
Fecha de fin del periodo en formato YYYYMMDD.
​
string
required
Token de autenticación en formato Bearer <JWT_token>.

​
Filtros y utilidades

​
Evaluar filtro

Devuelve la sentencia SQL generada por un filtro configurado en A3ERP.
Ejemplo:
​
string
required
El código del filtro a evaluar.
​
string
required
El alias del filtro. Si el filtro no tiene alias, pasa una cadena vacía ('').
​
string
required
Token de autenticación en formato Bearer <JWT_token>.
No es posible evaluar filtros que contengan valores variables (parámetros dinámicos).

​
Obtener siguiente identificador único

Devuelve el siguiente identificador único disponible para el campo indicado. Si el identificador no existe en la tabla de identificadores, lo crea y le asigna el valor 1.
Ejemplo:
​
string
required
El nombre del identificador en la tabla de identificadores de A3ERP. Por ejemplo: CODCLI, CODPRO, CODART.
​
string
required
Token de autenticación en formato Bearer <JWT_token>.

​
Moneda

​
Cambio entre moneda y EUR

Devuelve el tipo de cambio entre la moneda indicada y la moneda principal (EURO) en la fecha especificada.
Ejemplo:
​
string
required
El código de la moneda para la que se desea obtener el tipo de cambio.
​
string
required
La fecha del tipo de cambio en formato YYYYMMDD.
​
string
required
Token de autenticación en formato Bearer <JWT_token>.

​
Cambio entre dos monedas cualesquiera

Devuelve el tipo de cambio entre una moneda de origen y una moneda de destino en la fecha especificada.
Ejemplo:
​
string
required
El código de la moneda de origen.
​
string
required
El código de la moneda de destino.
​
string
required
La fecha del tipo de cambio en formato YYYYMMDD.
​
string
required
Token de autenticación en formato Bearer <JWT_token>.

​
Artículos

​
Descripción de artículo por idioma

Devuelve la descripción y el texto del artículo en el idioma indicado.
Ejemplo:
​
string
required
El código del artículo.
​
string
required
El código del idioma en el que se quiere obtener la descripción. Por ejemplo: ESP, ENG, FRA.
​
string
required
Token de autenticación en formato Bearer <JWT_token>.
Respuesta:

​
Representantes y comisiones

​
Obtener representante de un cliente

Devuelve el código del representante asignado a un cliente.
Ejemplo:
​
string
required
El código del cliente del que se quiere obtener el representante.
​
string
required
Token de autenticación en formato Bearer <JWT_token>.

​
Calcular comisión

Devuelve el porcentaje de comisión aplicable y su origen, dados los parámetros de la línea de venta.
Ejemplo:
​
string
required
El código del representante.
​
string
required
El código del artículo.
​
string
required
El código del cliente.
​
string
required
Las unidades del artículo en la línea de venta.
​
string
required
El descuento aplicado a la línea.
​
string
required
La fecha de la comisión en formato YYYYMMDD.
​
string
required
Token de autenticación en formato Bearer <JWT_token>.
Respuesta:

​
Cuentas contables

​
Cuenta de ventas de un artículo

Devuelve la cuenta contable de ventas para la combinación artículo/cliente, siguiendo el siguiente orden de prioridad:
  1. Cuenta de ventas del artículo (si existe)
  2. Cuenta de ventas del cliente (si existe)
  3. Cuenta de ventas de los datos generales
Ejemplo:
​
string
required
El código del artículo.
​
string
required
El código del cliente.
​
string
required
Token de autenticación en formato Bearer <JWT_token>.

​
Cuenta de compras de un artículo

Devuelve la cuenta contable de compras para la combinación artículo/proveedor, siguiendo el siguiente orden de prioridad:
  1. Cuenta de compras del artículo (si existe)
  2. Cuenta de compras del proveedor (si existe)
  3. Cuenta de compras de los datos generales
Ejemplo:
​
string
required
El código del artículo.
​
string
required
El código del proveedor.
​
string
required
Token de autenticación en formato Bearer <JWT_token>.

​
Vencimientos

​
Calcular plan de vencimientos

Genera el plan de vencimientos para un documento de cobro o pago, aplicando la forma de pago y las condiciones especificadas.
Ejemplo:
​
string
required
Indica si se trata de un cobro o un pago. Valores posibles: T (cobro) o F (pago).
​
string
required
El código del cliente (si es cobro) o del proveedor (si es pago).
​
string
required
El total en la moneda del documento.
​
string
required
El importe total del documento.
​
string
required
El código de la forma de pago a aplicar.
​
string
required
El documento de pago asociado.
​
string
required
El código de la moneda. Por ejemplo: EURO.
​
string
required
La fecha base para el cálculo de vencimientos en formato YYYYMMDD.
​
string
required
Token de autenticación en formato Bearer <JWT_token>.
Respuesta:

​
Configuración

​
Datos de configuración de A3ERP

Devuelve la información de configuración de la instalación de A3ERP: versión, gama y moneda principal.
Ejemplo:
​
string
required
Token de autenticación en formato Bearer <JWT_token>.
Respuesta:

​
Obtener programas externos

Devuelve la lista de programas externos configurados en A3ERP. Admite filtrado y ordenación.
Ejemplo:
​
string
required
Token de autenticación en formato Bearer <JWT_token>.
​
array
Array con los programas externos configurados en A3ERP.

​
Ficheros

​
Descargar un fichero del servidor

Descarga un fichero del servidor donde está alojada la API a partir de su ruta en el sistema de archivos.
Ejemplo:
El carácter \ (barra invertida) debe codificarse como %5C en la ruta. Por ejemplo, C:\informes\factura.pdf se convierte en C:%5Cinformes%5Cfactura.pdf.
​
string
required
Ruta del fichero a descargar en el servidor. Sustituye cada \ por %5C. Ejemplo: C:%5Ccarpeta%5Cfichero.pdf.
​
string
required
Token de autenticación en formato Bearer <JWT_token>.
Respuesta: El fichero solicitado en formato binario (application/octet-stream).