Documentación/ Integraciones con programas externos/ Ágora POS
Ágora
Con la conexión de Ágora, los documentos se registran directamente en el sistema. Lo que decide si el envío sale bien es que proveedores y productos tengan su código de Ágora: sin ellos, el sistema no sabe a qué corresponde cada cosa.
Listado de albaranes › marcar › Enviar a Ágora
En esta página
- Qué tipo de integración es
- Conexión de Ágora con Dijit
- Datos de conexión en Parámetros
- Consultas personalizadas de Ágora
- Los códigos de Ágora
- El aviso antes de enviar
- Continuar de todos modos
- Refrescar el catálogo
- El estado con el que llegan
- El IVA de los artículos
- El recargo de equivalencia
- Situaciones frecuentes
Qué tipo de integración es
Es envío directo. Al pulsar el botón, los documentos marcados se registran en Ágora y salen de la lista de pendientes. Los que fallan se quedan.
El resultado admite el caso parcial: puede entrar una parte del lote y quedar el resto. La aplicación informa de ambas cifras.
Conexión de Ágora con Dijit
La conexión se prepara una sola vez, en tres pasos. El ZIP y los datos están en Dijit, en Cuenta › Parámetros, bloque Ágora.
- Descarga el ZIP de consultas personalizadas y copia sus 5 ficheros XML en la carpeta custom-queries de Ágora. Este paso lo suele hacer tu distribuidor de Ágora, porque la carpeta no suele estar a tu alcance. Ver Consultas personalizadas de Ágora.
- Rellena los datos de conexión. Ver Datos de conexión en Parámetros.
- Pulsa Guardar al final de la página.
Datos de conexión en Parámetros
Estos son los campos del bloque Ágora y el dato que va en cada uno:
| Campo | Qué se escribe |
|---|---|
AGORA_ENDPOINT | La URL del servidor de Ágora. |
AGORA_ENDPOINT_APIKEY | La contraseña que genera Ágora automáticamente. |
WAREHOUSE_NAME | El nombre del almacén. |
WAREHOUSE_ID | El id del almacén. |
WAREHOUSE_IDN_SERIE | La serie del albarán. |
WAREHOUSE_IDN_LAST_NUMBER | El último número de esa serie de albarán. |
AGORA_DEFAULT_CONFIRMED_STATUS | El estado con el que se crea el albarán en Ágora: borrador o registrado. Ver El estado con el que llegan. |
Consultas personalizadas de Ágora
Para obtener y enviar las unidades de medida y los IVA o IGIC de compra, hay que copiar los ficheros XML en la carpeta de consultas personalizadas del equipo donde está Ágora: Disco › IGT Microelectronics › Agora › custom-queries.
Este paso lo suele hacer tu distribuidor de Ágora: lo normal es que no tengas acceso a esa carpeta. Descarga el ZIP y pásaselo.
Los ficheros se descargan en un ZIP desde Dijit, en Cuenta › Parámetros, bloque Ágora, con el botón Descargar consultas personalizadas (.zip). El ZIP trae 5 ficheros XML, uno por consulta:
| Funcionalidad | QueryGuid |
|---|---|
| Listar impuestos activos | {8BDD8D28-B7D7-43F2-AD46-ED91C9D91242} |
| Listar productos con unidad de compra | {1694B0BA-5D22-41E6-98A9-2499A95C008A} |
| Listar unidades de compra | {01209923-694D-4784-91B8-07D6EE99A045} |
| Insertar unidades de compra | {8AAC3D56-3040-4202-AFEA-DE1256A58F88} |
| Actualizar unidad de compra de producto | {DFD5BBAA-F4A1-4776-B323-4E9F267B1A5F} |
Los códigos de Ágora
Cada proveedor y cada producto necesitan tener asignado su código de Ágora. Son dos cosas distintas y fallan por separado:
| Falta el código en… | Dónde se arregla |
|---|---|
| El proveedor | En su ficha del maestro de proveedores, en el campo de referencia. |
| Un producto | En la línea del documento, asignando el artículo del catálogo de Ágora. |
Cuando un producto no existe todavía en Ágora, no hay que salir de la aplicación: se puede crear desde la propia línea del albarán.
El aviso antes de enviar
Antes de mandar nada, la aplicación revisa los documentos marcados y, si encuentra códigos sin asignar, lo dice con detalle. Los avisos nombran el documento, la línea y el nombre del elemento:
| Aviso | Significado |
|---|---|
| Faltan códigos de Ágora en proveedores | Uno o varios proveedores sin código. |
| Faltan códigos de Ágora en productos | Una o varias líneas sin artículo asignado. |
| Faltan códigos de Ágora en proveedores y productos | Ambas cosas. |
El detalle es preciso: «Documento X: Línea N — El producto "…" no tiene código de Ágora asignado». No hay que buscar dónde está el problema.
Continuar de todos modos
El aviso no bloquea el envío: pregunta. «Se encontraron N documentos sin códigos de Ágora configurados. ¿Desea continuar con el envío de todos modos?»
Continuar es una decisión consciente, y tiene consecuencia: esos documentos entrarán incompletos en Ágora, o los rechazará. Salvo que sepa exactamente por qué lo hace, lo razonable es cancelar, asignar los códigos y volver a enviar.
Refrescar el catálogo
La lista de artículos de Ágora se guarda en memoria mientras se trabaja. Cuando se da de alta un producto en Ágora y no aparece al buscarlo, el botón de refrescar vuelve a pedirla.
Está en la cabecera del bloque de datos ERP del diálogo de asignación, y también en el listado. Es el primer remedio ante un artículo que «debería estar y no está».
El estado con el que llegan
Un parámetro de la integración decide con qué estado se registran los documentos en Ágora: borrador o registrado.
| Opción | Efecto | Cuándo usarlo |
|---|---|---|
| Borrador | Entran sin confirmar, para revisarlos en Ágora. | Al empezar con la integración, o si se quiere doble revisión. |
| Registrado | Entran ya confirmados. | Cuando la revisión se hace en Dijit.app y no se quiere repetir. |
Se configura en Parámetros, en el apartado de Ágora.
El IVA de los artículos
En el diálogo de asignación, el campo de IVA de compra es de solo lectura y muestra el tipo que tiene el artículo en Ágora, no el del catálogo propio de Dijit.app.
Si aparece como sin configurar, el artículo no tiene tipo definido en Ágora. La aplicación no inventa un porcentaje: se corrige en Ágora.
El recargo de equivalencia
En los albaranes de entrada, el recargo de equivalencia viaja a Ágora junto con el resto de la línea. Antes se quedaba fuera y había que repasarlo en destino.
Lo que se envía es el recargo que tenga el documento, así que revísalo antes en la cabecera: ver Recargo de equivalencia.
Situaciones frecuentes
| Situación | Causa | Actuación |
|---|---|---|
| Avisa de proveedores sin código | Falta la referencia del ERP en su ficha. | Completarla en el maestro de proveedores. |
| Un artículo recién creado en Ágora no aparece | La lista está cacheada. | Pulsar refrescar y volver a buscar. |
| No se pudo conectar con Ágora | El servicio puede estar momentáneamente caído. | Reintentar. Si persiste, esperar unos minutos. |
| El IVA del artículo sale sin configurar | No lo tiene definido en Ágora. | Asignárselo en Ágora y refrescar. |
| Los documentos llegan a Ágora sin confirmar | El parámetro está en borrador. | Cambiarlo a registrado en Parámetros, si ese es el criterio. |