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).