Saltar al contenido principal

14. Qué pedirle al administrador del ERP

Si algo no aparece o no se puede hacer, casi siempre es configuración del lado de Acqua ERP. Esta es la lista para pasarle, en orden.

nota

Del otro lado del mostrador. Cada punto de esta lista tiene su procedimiento exacto — con las tablas y el SQL — en la guía del implementador, que es interna del equipo que administra el servidor. Si sos el administrador y no la tenés, pedila; no se publica acá porque incluye credenciales de configuración.

Para que una entidad aparezca​

  1. La entidad tiene que estar activa en el catálogo OData.
  2. Tiene que estar asignada a mi cliente de integración, con la operación read entre las permitidas.
  3. El objeto del ERP detrás de la entidad tiene que tener clave primaria definida y tabla de origen; si no, la entidad no se publica.
  4. Opcionalmente, un alias más legible que el form_id (solo letras, números y guión bajo, sin empezar con número).
  5. Una descripción, que es el título que ven Excel y Power BI en el navegador.
nota

Una entidad asignada sin permiso de read no aparece en el documento de servicio ni en el $metadata, justamente para que las herramientas de BI no la listen y fallen. Si necesitás leerla, lo que falta es el permiso.

Para poder escribir​

  1. Las operaciones create, update o delete entre las permitidas, y habilitadas en el objeto del ERP.
  2. Un usuario del ERP asociado a mi cliente de integración, con los permisos de grupo sobre la pantalla del maestro. Sin esto las escrituras fallan aunque los permisos OData estén bien.
  3. Que la pantalla del maestro exponga cada campo que necesito escribir.

Para que $search funcione​

  1. $search habilitado para la entidad.
  2. Columnas de texto marcadas para el listado, o un campo descriptivo definido en el objeto. Los campos Memo no cuentan.

Para que haya maestros relacionados​

  1. La relación definida entre los dos objetos en el ERP.
  2. Los dos maestros habilitados para el mismo cliente: si falta uno, la navegación no se publica.
  3. Una etiqueta estable en la relación, porque de ahí sale el nombre de la navegación.

Acceso​

  1. Mi API key activa, o mi usuario y id_client para el flujo JWT.
  2. Mi IP de salida en la lista blanca — la del proxy o el NAT si salgo por uno. Si el campo queda vacío en lugar de nulo, no se permite ninguna dirección.

Documentación de la API OData de Acqua ERP. Las entidades, campos y relaciones que ves son los que tu cliente de integración tiene habilitados: el documento de servicio y el $metadata son siempre la fuente de verdad por sobre los ejemplos de esta página.