Conectar Acumatica: recibir pedidos y clientes, consultar inventario

Inicie sesión en su instancia de Acumatica con un usuario API dedicado, complete la URL de la instancia, la empresa y la versión del endpoint en Integration, pruebe, mapee y active.

El conector de Acumatica conecta su instancia de Acumatica Cloud ERP con Integration: trae pedidos de venta y clientes al sistema y permite consultar el inventario guardado en Acumatica. Una conexión sirve para una empresa de Acumatica. El inventario se puede leer desde Acumatica, pero los cambios de stock no se devuelven a Acumatica por esta conexión.

Requisitos previos#

• Una instancia de Acumatica a la que pueda iniciar sesión, y el nombre exacto de la empresa (tenant) usado al iniciar sesión.
• Un usuario de acceso para esta conexión — se recomienda un usuario API dedicado — que pueda leer pedidos de venta, clientes y artículos de stock en esa empresa.
• Un endpoint publicado en Acumatica → Web Service Endpoints. Si su instancia publica el endpoint estándar, su nombre suele ser Default y su versión coincide con su versión de Acumatica.
• Si el inicio de sesión de su empresa requiere una sucursal, conozca también el nombre de la sucursal. Si el inicio de sesión no pide sucursal, ese campo puede quedar vacío más adelante.

Obtener credenciales#

1. No hay una clave aparte que crear para este conector. Las credenciales son el propio usuario de acceso de Acumatica: prepare un usuario API dedicado en Acumatica, confirme que puede iniciar sesión con él y anote su nombre de usuario y contraseña.
2. Anote el nombre de la empresa (tenant) exactamente como aparece al iniciar sesión, y el nombre de la sucursal si su acceso la requiere. Estos valores deben coincidir palabra por palabra con la instancia.
3. Anote la dirección de su instancia: la dirección raíz de su instancia de Acumatica, por ejemplo https://mycompany.acumatica.com. No añada /entity al final.
4. En Acumatica, abra Web Service Endpoints y revise el endpoint publicado: anote su nombre de endpoint y su versión de endpoint. Solo tendrá que completarlos después si difieren de Default y 24.200.001.

Completar en Integration#

1. Abra Integration → Marketplace → Acumatica → Nueva conexión.
2. base_url — Instance URL, obligatorio: complete la dirección raíz de su instancia de Acumatica, por ejemplo https://mycompany.acumatica.com. No añada /entity al final.
3. company — Company, obligatorio: complete el nombre de la empresa (tenant) exactamente como aparece cuando inicia sesión en Acumatica.
4. branch — Branch, opcional: complételo solo si el inicio de sesión de su empresa requiere una sucursal. Si el inicio de sesión no pide sucursal, déjelo vacío.
5. username — Username, obligatorio: complete el nombre de acceso del usuario API dedicado que preparó en Acumatica.
6. password — Password, obligatorio: complete la contraseña de ese mismo usuario de acceso. Se guarda cifrada y nunca se muestra.
7. endpoint_name — Endpoint name, opcional: déjelo vacío si su instancia publica el endpoint estándar; el sistema usará Default. Complételo solo cuando Web Service Endpoints muestre un nombre distinto.
8. endpoint_version — Endpoint version, opcional: déjelo vacío si su instancia publica la versión 24.200.001; el sistema usará 24.200.001. Complete la versión exacta mostrada en Web Service Endpoints cuando la suya difiera; la versión debe coincidir con su versión de Acumatica.

Probar la conexión#

Haga clic en Probar la conexión. La prueba hace dos cosas en orden. Primero inicia sesión en su instancia con el nombre de usuario, la contraseña, la empresa y la sucursal que completó: el inicio de sesión solo tiene éxito cuando la instancia responde y devuelve una sesión, que la prueba usa de inmediato y cierra al final. Después, con esa sesión, lee un solo artículo de stock mediante el nombre y la versión del endpoint de la conexión. Si pasa, el inicio de sesión funciona, el endpoint responde y el usuario de acceso puede leer artículos de stock. La prueba espera unos 12 segundos; si se agota el tiempo, compruebe que la dirección de la instancia sea accesible e inténtelo de nuevo. Si falla, conserve el código de error exacto mostrado: las preguntas frecuentes relacionan cada código con su causa y su solución.

Mapping / elegir plantilla#

Elija la plantilla estándar de Acumatica. Mapea los pedidos de venta de Acumatica a pedidos estándar y trae los clientes con ellos, para que números de pedido, líneas, cantidades y datos del cliente caigan en los campos correctos. Los campos que la plantilla puede leer vienen del endpoint publicado en su instancia, así que si su instancia publica un nombre o una versión de endpoint distintos del estándar, configure primero endpoint_name y endpoint_version en la conexión y revise de nuevo la vista previa del mapping. Antes de activar, abra la vista previa y confirme en un pedido real que las líneas y los nombres de cliente se ven bien; la consulta de inventario lee los artículos de stock directamente y no necesita mapping de pedidos.

Activar#

Tras activar, Integration inicia sesión en su instancia de Acumatica según la frecuencia definida, trae nuevos pedidos de venta y clientes, y responde las consultas de inventario leyendo los artículos de stock de Acumatica. Cada sesión de acceso se usa solo para esa ejecución y se cierra cuando termina. Lo que esta conexión no hace: no devuelve los cambios de stock a Acumatica, así que ajuste las cantidades en la propia Acumatica cuando el stock deba corregirse allí. Vigile los primeros pedidos en Runs / Logs antes de dejarlo sin supervisión.

Preguntas frecuentes#

La prueba falla con ENDPOINT_VERSION_MISMATCH: la lectura del artículo de stock devuelve 404

El inicio de sesión funcionó, pero el nombre o la versión del endpoint de la conexión no coincide con el endpoint publicado en su instancia. La prueba busca el artículo de stock bajo el nombre y la versión indicados, y la instancia no tiene nada publicado en esa dirección, así que la lectura vuelve con 404. Es la causa más común cuando el acceso en sí está bien.

En Acumatica, abra Web Service Endpoints y copie exactamente el nombre y la versión del endpoint publicado. Póngalos en endpoint_name y endpoint_version de la conexión, o borre ambos campos si el endpoint publicado realmente es Default y 24.200.001. Guarde y pruebe de nuevo.

La prueba falla con INVALID_CREDENTIALS: el inicio de sesión devuelve 401 o 400

La instancia rechazó el inicio de sesión: el nombre de usuario, la contraseña o el nombre de la empresa no coincide con lo que la instancia espera. Un nombre de empresa escrito de forma ligeramente distinta a la pantalla de acceso cuenta como credencial incorrecta, y también una sucursal que el acceso requiere pero la conexión omite.

Inicie sesión en Acumatica en su navegador con el mismo usuario y confirme que el nombre de usuario, la contraseña y el nombre de la empresa funcionan allí. Después vuelva a completar username, password y company en la conexión exactamente como se usaron en el navegador, añada branch si ese acceso lo pide, y pruebe de nuevo.

La prueba falla con MISSING_SCOPE: la lectura del artículo de stock devuelve 401 o 403

El inicio de sesión funcionó y el endpoint existe, pero el usuario de acceso no tiene permiso para leer artículos de stock en esa empresa. Por eso la instancia rechaza la lectura del artículo de stock aunque el usuario pueda iniciar sesión.

En Acumatica, dé al usuario API dedicado acceso de lectura a los artículos de stock — y a los pedidos de venta y clientes, que la conexión también lee — en esa empresa, o cambie la conexión a un usuario que ya tenga ese acceso. Guarde y pruebe de nuevo.

La prueba falla con MISSING_BASE_URL o MISSING_CREDENTIALS, o el inicio de sesión no llega a la instancia

Falta un campo obligatorio o la propia dirección de la instancia es incorrecta. MISSING_BASE_URL significa que base_url quedó vacío; MISSING_CREDENTIALS significa que falta username, company o password. Un error frecuente de dirección es terminar base_url con /entity: la conexión añade sus propias rutas tras la dirección raíz, así que una dirección que ya lleva ese sufijo apunta el inicio de sesión al lugar equivocado.

Complete todos los campos obligatorios — base_url, company, username y password — y revise base_url: use solo la dirección raíz de la instancia, por ejemplo https://mycompany.acumatica.com, sin nada después. Guarde y pruebe de nuevo.