proALPHA

• «¿Qué áreas de datos abre nuestro proALPHA por la interfaz?»
• «Muéstrame los 20 primeros registros del endpoint Artículos.»
• «¿Qué significan los nombres de campo de este endpoint?»
• «Lee el registro completo con este identificador.»
• «Resume qué campos devuelve el endpoint Clientes.»

El asistente siempre toma el mismo camino: primero listar las áreas, luego los endpoints, luego su versión, luego la descripción de los campos, y solo después los registros. Suena engorroso, pero es el único camino honesto, porque en proALPHA cada instalación es distinta.

Porque proALPHA no entrega una lista fija de interfaces. La API de lectura es un kit: qué endpoints hay lo decide vuestra instalación. Un consultor, un socio o vuestra propia IT los crea bajo Intercambio de datos, Configuración de endpoints REST. Dos clientes de proALPHA tienen por eso dos interfaces distintas.

Lo que es igual en todas partes es la construcción de la API de lectura misma, y por suerte se describe sola. Por eso el asistente pregunta primero a vuestro sistema qué ofrece, en vez de adivinar áreas que quizá no existan en vosotros.

1. 01En proALPHA abre la administración de usuarios y crea un usuario M2M propio. Un login ERP normal no basta.
2. 02En la pestaña Permiso marca solo REST-SERVICES.
3. 03Pon una contraseña fuerte y anota usuario y contraseña en un sitio seguro.
4. 04Aseguraos de que en Intercambio de datos, configuración de endpoints REST exista al menos un endpoint de lectura.

1. 01En anymize abre Apps, luego Conectores, y elige proALPHA.
2. 02Introduce la dirección de vuestra instalación, por ejemplo https://erp.tu-empresa.es, más el usuario M2M y su contraseña de la sección de arriba.
3. 03Define qué áreas puede usar el asistente: el directorio de endpoints y los registros.

Si vuestro proALPHA corre en casa, la interfaz debe ser alcanzable desde fuera. Es un acuerdo con vuestra IT, no un fallo del conector. En la nube de proALPHA ya lo es de regla.

No. Aquí incluso el fabricante traza el límite: la API de lectura es la mitad lectora del kit, la escritura va por otros caminos que anymize no aborda. Encima está nuestra propia regla de que no hay herramientas de escritura.

El usuario M2M debería llevar aun así solo el permiso REST-SERVICES. Dos límites son mejor que uno.

• Filtrar por contenido de campo aún no va. proALPHA filtra por parámetros nombrados según vuestros campos, y nadie los conoce de antemano. El asistente hojeará por páginas.
• Una página tiene como máximo 50 registros. Es a propósito: las extracciones grandes por la interfaz las nota vuestro servidor de aplicación; proALPHA lo escribe en su propia documentación.
• La descripción de campos ayuda a entender: los nombres de campo de proALPHA suelen ser columnas alemanas abreviadas, y el asistente puede traducirlos a etiquetas legibles.

proALPHA corre en vuestra propia instalación, en casa o en la nube del fabricante. anymize habla solo con la dirección que hayáis introducido, y las credenciales están cifradas en vuestro espacio de trabajo.

Lo que viene del ERP son datos de negocio en estado puro. Nombres de clientes, direcciones, interlocutores, números de cliente y proveedor y datos bancarios se sustituyen por placeholders antes de que un registro vaya a un modelo de IA.