Skip to main content
Los endpoints /api/maestro/{maestro} te proporcionan acceso CRUD completo a cualquier tabla maestra de A3ERP. Con una única familia de rutas puedes leer, crear, modificar y eliminar registros de entidades como clientes, proveedores, artículos, almacenes, representantes, formas de pago y muchas más, sin necesidad de endpoints específicos para cada una.
Cadenas con relleno de espacios. Muchos campos de código en A3ERP se almacenan como cadenas de longitud fija rellenadas con espacios a la derecha (por ejemplo, "codalm": " 1"). Cuando uses estos valores como parámetros de ruta o en filtros, asegúrate de tratar el valor exactamente como lo devuelve la API o bien usa el valor sin espacios: ambas formas son aceptadas en la ruta {codigo}.

Maestros disponibles

Los siguientes identificadores de maestro son válidos como parámetro {maestro}:

GET — Obtener todos los registros

string
required
Nombre del maestro a consultar (p. ej. almacenes, clientes, articulos).
string
required
Token JWT con prefijo Bearer. Ejemplo: Bearer eyJhbGci...
Ejemplo:
Respuesta 200 — Lista de registros del maestro:

GET — Obtener un registro por código

string
required
Nombre del maestro a consultar.
string
required
Código del registro a recuperar.
string
required
Token JWT con prefijo Bearer.
Ejemplo:
Respuesta 200 — Registro individual:

POST — Crear un registro

Usa este endpoint para dar de alta nuevos registros en el maestro indicado. Incluye en el cuerpo de la petición únicamente los campos que necesites; los campos obligatorios dependen del maestro.
string
required
Nombre del maestro en el que crear el registro.
string
required
Token JWT con prefijo Bearer.
Ejemplo — Dar de alta un artículo:
Respuesta 200:
La respuesta incluye el código asignado al nuevo registro, que puedes usar directamente en peticiones posteriores.

PUT — Actualizar un registro

Actualiza uno o varios campos de un registro existente. Solo es necesario incluir en el cuerpo los campos que deseas modificar; el resto permanecen sin cambios.
string
required
Nombre del maestro que contiene el registro a actualizar.
string
required
Código del registro a actualizar. En maestros con clave múltiple (clave compuesta por más de un campo), deja este parámetro en blanco e incluye los valores de clave dentro del cuerpo JSON.
string
required
Token JWT con prefijo Bearer.
Ejemplo — Modificar precios de un artículo:
Respuesta 200: El servidor confirma la modificación sin cuerpo de respuesta.
Maestros con clave múltiple. Cuando el maestro utiliza una clave primaria compuesta (p. ej. tarifas, descuentos), deja el segmento {codigo} vacío en la URL y añade los campos de clave en el JSON del cuerpo.

DELETE — Eliminar un registro

Elimina de forma permanente el registro indicado del maestro.
string
required
Nombre del maestro que contiene el registro a eliminar.
string
required
Código del registro a eliminar.
string
required
Token JWT con prefijo Bearer.
Ejemplo:
Respuesta 200: Eliminado correctamente
La eliminación de registros maestros es irreversible. Asegúrate de que el registro no tenga dependencias activas en documentos u otras entidades antes de proceder.