1. Objetivos del documento

Este documento tiene como objetivo detallar el funcionamiento técnico y funcional de nuestro conector. Define el alcance de acción (lo que está cubierto o no) y enumera los prerrequisitos necesarios para su implementación.

Nota importante: Nuestros equipos están disponibles si necesitas alguna aclaración o información adicional.

¿Cómo utilizar este documento? Recomendamos revisar este documento con todas las personas conocedoras (CIO, CFO, Contador Jefe, Responsable de IT), cuyo objetivo es:

Verificar si los flujos propuestos se ajustan a las necesidades de tu negocio.
Confirmar que tu entorno técnico cumple con los prerrequisitos de instalación.

⚠️ Metodología de despliegue: Nuestro enfoque es pragmático. Si, tras el análisis, los prerrequisitos parecen estar validados, favoreceremos la instalación del conector nativo. Sin embargo, si por una razón técnica o una configuración específica no se pudiera activar el conector, cambiaremos sin problema a un método alternativo vía SFTP para asegurar la continuidad de tu proyecto.

2. Prerrequisitos y despliegue

2.1 Obligatorio para cualquier conexión

Categoría	Requisito	Cómo comprobar
Edición de NetSuite	Solo Oracle NetSuite OneWorld	Una opción de Subsidiary Settings Manager está disponible en la pestaña Setup.
Funcionalidad `Subsidiaries`	Debe estar habilitada	Requerido para descargar e instalar la SuiteApp de Agicap desde el marketplace de NetSuite. Si está desactivada, no se puede instalar la SuiteApp.
Rol de usuario	El usuario que realiza la configuración debe tener un rol de administrador	Setup > Users/Roles > Manage Users
Características de la cuenta	`REST WEB SERVICES`, `OAUTH 2.0`, `SuiteAnalytics Workbook`	Setup > Company > Enable Features (ver A, paso 2)
Agicap SuiteApp	Agicap for NetSuite instalada	Crea el `AgicapIntegrationRole` dedicado y soporta la autenticación OAuth 2.0 M2M.

🔒 Recomendamos un usuario de integración dedicado en lugar de una cuenta personal. Es solo una recomendación, no un requisito: una cuenta personal funciona si lo prefieres. El motivo de la recomendación es que la autenticación basada en certificado está vinculada a un usuario y un rol de NetSuite, por lo que la conexión dejará de funcionar si esa persona deja la empresa o se modifican sus permisos.

2.2 Prerrequisitos adicionales por flujo

Flujo	SuiteApp adicional	Configuración adicional de NetSuite
Importación de archivo de pagos	SFTP Connector (obligatorio) Electronic Bank Payments (bundle ID 416781) si aún no generas archivos de pago	Dos carpetas en File Cabinet, una clave privada RSA 2048 en formato PEM y tus cuentas bancarias configuradas para la ejecución de pagos en Agicap.
Exportación de extracto bancario	Auto Bank Statement Import (ABSI)	`Client SuiteScript` y `Server SuiteScript` habilitados, una clave privada RSA 2048 en formato PEM y un formato de extracto bancario compatible con un parser de NetSuite.

2.3 Quién hace qué

Paso	Responsable
Instalación de las SuiteApps, habilitación de características de la cuenta, asignación del rol	Tu administrador de NetSuite / usuario avanzado
Rellenar el formulario de conexión en Agicap (ID de cuenta, certificado, ID de certificado)	Tú, guiado por este documento
Mapear tus subsidiarias de NetSuite con tus entidades de Agicap y validar la conexión	Agicap — este paso lo realizamos nosotros y es necesario antes de que fluyan los datos
Activar cada flujo en tu conexión	Tú, desde la página de Bancos e integraciones una vez creada la conexión. Cada flujo tiene su propio interruptor en los detalles de sincronización de la conexión.
Configurar los flujos SFTP en NetSuite (ABSI, SFTP Connector, parsers)	Tu administrador de NetSuite. El lado Agicap de estos flujos lo configura nuestro equipo técnico, así que planifica una reunión con ellos antes de empezar.

3. Información general

El conector Agicap NetSuite es una integración bidireccional desarrollada y mantenida internamente por Agicap. Utiliza los REST API y endpoints SuiteQL de NetSuite, asegurados con autenticación por certificado OAuth 2.0 machine-to-machine, para importar tus documentos de negocio y datos contables en Agicap, y para escribir extractos bancarios, asientos de pago y diarios de vuelta en NetSuite.

Un conector, una SuiteApp. Cada flujo es una funcionalidad opcional que se activa en tu conexión: puedes empezar solo con la recogida de documentos de negocio y añadir flujos más adelante, en la misma conexión, sin rehacer la configuración.

Mecanismo	Usado para	Qué instalas en NetSuite
REST API + SuiteQL (OAuth 2.0 M2M)	Documentos de negocio, plan contable y terceros, plan analítico, claves de IVA, exportación de diario bancario, exportación de registro de compras	SuiteApp Agicap for NetSuite — eso es todo. Crea el `AgicapIntegrationRole` dedicado y contiene todo lo que necesita el conector.
SFTP (servidor alojado por Agicap)	Importación de archivos de pago, exportación de extractos bancarios	SuiteApp SFTP Connector (salida), SuiteApp Auto Bank Statement Import (ABSI) (entrada)

Frecuencia de sincronización

El flujo de documentos de negocio se sincroniza automáticamente dos veces al día. Los demás flujos API se sincronizan una vez al día. Todos pueden ser lanzados manualmente.
La mayoría de las llamadas API filtran por la fecha de modificación del registro, por lo que solo se transfiere lo que ha cambiado.
Los flujos SFTP se ejecutan según la programación que configures en NetSuite, junto con la programación configurada en el lado de Agicap.
Se crea una conexión identificable por cada cuenta de NetSuite.

💡 Por defecto, Agicap recoge documentos de negocio cuya fecha de modificación en NetSuite sea inferior a un año en el momento de crear la conexión. Un documento emitido antes aún puede aparecer si se modificó recientemente en NetSuite. Si necesitas un historial más largo, avísanos antes de la primera sincronización.

4. Flujos y casos de uso

4.1 NetSuite → Agicap

Flujo	Estado	Transporte	Alimenta
Importar documentos de negocio	En producción con limitaciones	REST API	Treasury, Accounts Receivable, purchase-to-pay
Importar plan contable y terceros	En beta	REST API	Asociación, diario bancario
Importar plan analítico	En producción	REST API	Treasury y los asientos que Agicap escribe de vuelta
Importar claves de IVA	En producción	REST API	Gestión de IVA en los documentos que Agicap exporta y prerrequisito para el registro de compras
Importar pedidos de compra con líneas (P2P)	En producción	REST API	Pagos, purchase-to-pay
Importar archivos de pago	En producción con limitaciones (vía SFTP)	SFTP	Pagos
Importar proveedores	En beta	REST API	Purchase-to-pay, base de terceros
Importar beneficiarios / IBANs	En beta	REST API	Pagos
Importar PDFs de Accounts Receivable	Planificado	REST API	Accounts Receivable
Importar base de clientes y contactos	Planificado	REST API	Accounts Receivable

4.2 Agicap → NetSuite

Flujo	Estado	Transporte	Escribe en NetSuite
Exportar extractos bancarios	En producción con limitaciones (vía SFTP)	SFTP + ABSI	Registros de extractos bancarios para conciliación y reporte financiero
Exportar diario bancario desde Treasury, asientos contables	En beta	REST API	Asientos contables, para movimientos bancarios sin documento de negocio detrás y para contrapartidas manuales
Exportar diario bancario desde Treasury, conciliación de facturas	En beta	REST API	Pagos de clientes y proveedores aplicados a tus facturas abiertas de AR / AP. NetSuite genera el asiento contable a partir del propio pago.
Exportar facturas de proveedor, registro de compras	Planificado	REST API	Facturas de proveedor, con el PDF de la factura adjunto. NetSuite generará los asientos contables a partir de ellas. Aún no activable.
Emisión y recepción de factura electrónica (Francia)	Planificado	—	—
Exportar diario bancario de Spend, asientos de tránsito, deuda, financiación intragrupo, reclamaciones de AR, inversiones financieras, previsiones	No disponible	—	Actualmente no está cubierto. Avísanos si alguno de estos temas te interesa.

📘 Lectura de los estados.  En producción significa desplegado y funcionando en varias cuentas de clientes. En producción con limitaciones significa disponible, con una limitación descrita en el §5 y en la tabla de Limitaciones. (vía SFTP) significa que el flujo no lo lleva el conector API: el archivo se produce o consume en NetSuite a través de SuiteApps dedicadas y se intercambia mediante un servidor SFTP alojado por Agicap. En beta significa disponible, en despliegue gradual y aún en mejora — la activación se acuerda caso por caso con tu contacto de Agicap. Planificado significa que está en la hoja de ruta y aún no es activable. No disponible significa que no hay compromiso por ahora.

5. Documentación técnica detallada por caso de uso

5.1 Importar documentos de negocio (NetSuite → Agicap)

Qué hace. Alimenta Agicap Treasury con movimientos de efectivo pendientes, Agicap Accounts Receivable con las facturas a cobrar y reclamar, y el flujo purchase-to-pay con tus pedidos y albaranes.

Cómo. Agicap consulta los endpoints REST API y SuiteQL de NetSuite. Las llamadas filtran por la fecha de modificación del registro, por lo que solo se transfiere lo que ha cambiado y solo se recuperan los campos que Agicap necesita.

Qué se recoge — una sincronización, todos los tipos de documentos juntos:

Facturas de cliente y abonos de cliente
Facturas de proveedor y abonos de proveedor
Pedidos de venta y pedidos de compra con sus líneas
Albaranes
Presupuestos
Referenciales: divisas, subsidiarias, entidades, clientes, proveedores, medios de pago

Entity aquí se refiere al registro de entidad de NetSuite (clientes, proveedores y otras entidades de NetSuite). No tiene nada que ver con una entidad de Agicap, que se corresponde con tus subsidiarias de NetSuite.

No hay opción por tipo de documento: el flujo de documentos de negocio los recoge todos. Lo que varía es dónde aparece cada tipo en Agicap, lo que depende de los módulos de Agicap activos en tu cuenta, así como de los filtros activados para cada módulo.

Siempre activo. La importación de documentos de negocio se activa por defecto en cada conexión NetSuite y no se puede desactivar. Los demás flujos son opcionales y se activan uno a uno.

⚠️ Limitación conocida — grandes volúmenes. Las conexiones con un volumen muy alto de documentos comerciales, o que funcionan en una instancia limitada de NetSuite, pueden experimentar errores de tiempo de espera durante la sincronización. Entonces, los documentos dejan de actualizarse en Agicap hasta la siguiente ejecución exitosa. Nuestros equipos están trabajando activamente en ello. Si ocurre, mantén la conexión API activa y contacta con el Soporte de Agicap indicando el nombre de la conexión y el mensaje de error que aparece en los detalles de la sincronización.

Opcional — campos personalizados. Puedes hacer que Agicap recoja los campos personalizados de NetSuite y los utilice para construir la etiqueta de tus documentos comerciales en Treasury y Accounts Receivable, o solicitar un filtro específico. Al hacer clic en la etiqueta de un campo en NetSuite se muestra su id interno, por ejemplo custbody_phy_patient_name. Esto funciona para los campos a nivel de cabecera del documento de operación; los campos a nivel de línea no están cubiertos. Declara los campos que necesitas al crear la conexión (ver B, paso 5); añadirlos más tarde requiere renovar las credenciales de la conexión.

5.1.1 Importar pedidos de compra con líneas (NetSuite → Agicap)

Qué hace. Trae tus pedidos de compra de NetSuite, línea por línea, al flujo purchase-to-pay de Agicap para que las facturas de proveedor puedan asociarse a su pedido.

La recogida en sí forma parte de la sincronización de documentos comerciales (§5.1). Lo que añade este flujo es la exposición de esos pedidos en el módulo de Accounts Payable de Agicap, lo que requiere que el módulo correspondiente de Agicap esté activo en tu cuenta — avisa a tu contacto de Agicap si esperas ver los pedidos de compra ahí y no aparecen.

5.2 Importar plan contable y terceros (NetSuite → Agicap)

Qué hace. Mantiene sincronizadas tus cuentas contables y terceros para que nunca tengas que mantener esas listas manualmente en Agicap.

Cuentas contables. Agicap recupera la lista completa de cuentas desde NetSuite (ID interno, nombre, número, tipo, asignación de subsidiaria) y vincula cada cuenta a las entidades de Agicap correspondientes mediante el mapeo multi-entidad configurado en la puesta en marcha.

Excluidos de la importación: cuentas sin número de cuenta y cuentas de tipo NonPosting.

Terceros. Los clientes y proveedores se importan al modelo de terceros de Agicap con su nombre, código, cuenta contable vinculada e ID interno de NetSuite.

💡 Si las listas de selección de cuentas en Agicap resultan confusas, inactivar las cuentas que nunca han tenido movimientos, por subsidiaria, es la forma más rápida de limpiarlas.

5.3 Importar plan analítico y claves de IVA (NetSuite → Agicap)

Qué hace. Importa tus dimensiones analíticas de NetSuite para que los flujos de efectivo puedan analizarse por eje en Agicap, y para que esas mismas dimensiones puedan devolverse en los asientos que Agicap escribe en NetSuite.

Qué se sincroniza: class, department, location y tus segmentos personalizados.

Las claves de IVA se importan mediante el mismo mecanismo y alimentan la gestión del IVA en los documentos que Agicap exporta.

👀 Segmentos personalizados. Para importar segmentos personalizados, el AgicapIntegrationRole (o tu rol personalizado) debe tener permiso de lectura sobre cada segmento personalizado correspondiente. Compruébalo con tu administrador de NetSuite.

5.4 Importar archivos de pagos (NetSuite → Agicap, vía SFTP)

Qué hace. Tus archivos de pagos, generados en NetSuite, se exportan a un servidor SFTP alojado por Agicap y alimentan el módulo de Pagos de Agicap. Luego ejecutas los pagos a través de la conectividad bancaria de Agicap, lo que te da un único punto de ejecución y control.

❗ Este flujo no lo gestiona el conector API. Tú mismo generas el archivo de pagos en NetSuite, en un formato que NetSuite soporte, y la SuiteApp SFTP Connector lo entrega. Configuración en C.

Qué necesitas

Ya sabes cómo generar archivos de pagos en NetSuite, o instalas la SuiteApp Electronic Bank Payments (bundle ID 416781).
La SuiteApp SFTP Connector.
Cada cuenta bancaria referenciada en esos archivos está configurada en Agicap para la ejecución de pagos: host-to-host, EBICS TS, un banco centralizador o exportación global de archivos.

Dónde llega el archivo en Agicap. Si el formato del archivo es aceptado por el banco para esa cuenta, puede importarse como Por pagar o Por preparar. Si el formato no es aceptado por el banco, se importa como Por preparar para que Agicap Payment pueda convertirlo a un formato aceptado por el banco.

5.5 Exportar extractos bancarios (Agicap → NetSuite, vía SFTP)

Qué hace. Agicap recupera tus extractos bancarios a través de su propia conectividad bancaria (EBICS, H2H, SWIFT), luego los envía a un servidor SFTP. La SuiteApp ABSI los recoge e importa en NetSuite, donde se analizan y asignan a tus cuentas contables para conciliación y reporte financiero.

Esto significa que ya no necesitas mantener una conexión bancaria separada en NetSuite: una sola configuración bancaria en Agicap sirve para ambas herramientas.

⚠️ El formato del archivo es la principal limitación, por favor revísalo cuanto antes. NetSuite soporta una lista fija de formatos y versiones de extractos. Por ejemplo, CAMT.053.001.02 está soportado por defecto, mientras que CAMT.053.001.08 no lo está. Enfoque recomendado: pide a tu banco que entregue los extractos en un formato y versión que NetSuite soporte. Es el camino más sencillo y robusto. Si no es posible: Agicap puede construir una transformación personalizada de archivos, que se evalúa caso por caso. Estas transformaciones se entregan como funcionalidades beta bajo el compromiso de mejor esfuerzo y se acuerdan por escrito antes de su implementación.

Configuración en D.

5.6 Exportar diario bancario y conciliación automática (Agicap → NetSuite)

Qué hace. Conciliar los movimientos bancarios contra facturas en Agicap. Agicap luego escribe el resultado en NetSuite, de modo que tu diario bancario y tus partidas abiertas de AR/AP se actualizan sin reintroducción manual.

Cómo funciona. Dos mecanismos, según lo que se haya conciliado:

Caso	Qué escribe Agicap en NetSuite
Un movimiento bancario conciliado contra un documento comercial	Un objeto de pago: un pago de cliente o un pago a proveedor. NetSuite luego genera el asiento contable siguiendo tus propias reglas contables. Es el mismo mecanismo que el flujo manual "Realizar pago" en NetSuite.
Un movimiento bancario sin documento comercial asociado, o contrapartidas manuales añadidas a un movimiento bancario conciliado.	La operación bancaria se escribe directamente como un asiento contable.

Estado: En beta.

Requisitos previos.

El flujo de plan contable (§5.2) debe estar activo, para que las cuentas se resuelvan en ambos lados.
Las funcionalidades de diario bancario y conciliación deben estar activas en tu cuenta de Agicap, con la opción de exportación manual desactivada. El Soporte de Agicap activa estos ajustes por ti: consúltales antes de activar el flujo.

💡 El campo Causale del diario bancario de Agicap no tiene equivalente en NetSuite, por lo que no se mapea. Esto no es bloqueante: la exportación funciona sin él.

Pagos que cubren varios terceros. NetSuite requiere que cada pago de cliente haga referencia a un solo tercero. Cuando un pago bancario liquida facturas de varios registros de terceros de NetSuite, Agicap lo divide automáticamente en un pago por cada tercero. Las líneas sin tercero identificable se exportan directamente como un asiento contable separado.

⚠️ Dos cosas que debes preparar en tu lado. Elimina duplicados de tus proveedores y clientes en NetSuite. Un pago debe referenciar la factura y el tercero de forma coherente. Dos registros para la misma empresa pueden hacer que la exportación sea rechazada. Las facturas de proveedor creadas en Agicap, no en NetSuite, aún no pueden conciliarse automáticamente con este flujo: el conector busca una referencia en NetSuite que no existe en ellas. Está previsto el soporte nativo. Si este es tu caso, habla con tu contacto de Agicap sobre las opciones provisionales.

5.7 Importar proveedores y beneficiarios (NetSuite → Agicap)

Estado: En beta. Dos flujos separados, misma configuración: nada más allá de A y B, más su activación.

Importar proveedores alimenta la base de proveedores de Accounts Payable y el flujo purchase-to-pay con datos de proveedores desde NetSuite.
Importar beneficiarios / IBANs alimenta la lista de beneficiarios del módulo de Pagos, para que no tengas que mantenerla manualmente en Agicap.

Si este flujo forma parte de tu proyecto, habla con tu contacto de Agicap sobre el alcance y la planificación en vez de planificar desde esta página.

5.8 Exportar facturas de proveedor, registro de compras (Agicap → NetSuite)

Estado: Previsto. El desarrollo está en curso y el flujo aún no puede activarse.

Qué hará. Las facturas de proveedor digitalizadas por Agicap (OCR) se crean en NetSuite como vendor bills, con el PDF de la factura adjunto al registro. NetSuite luego genera los asientos contables a partir de esas facturas, de modo que tu registro de compras se alimenta sin reintroducción manual.

Si este flujo forma parte de tu proyecto, habla con tu contacto de Agicap sobre el alcance y la planificación en vez de planificar desde esta página.

Procedimiento de configuración

🧭 Orden de operaciones. A y B son obligatorios para cada flujo API y deben completarse antes de activar cualquier flujo. C y D son los flujos SFTP: son independientes y pueden prepararse en paralelo. Calcula unos 30 minutos con tu administrador de NetSuite para A y B.

A - Configuración de NetSuite

Paso 1 — Instalar la SuiteApp de Agicap

Empieza aquí: una instalación exitosa es en sí misma la prueba de que tu edición de NetSuite es compatible.

Haz clic en los tres puntos en la parte superior derecha y luego en SuiteApps.
Busca Agicap for NetSuite (cuadro de búsqueda en la parte superior izquierda) y haz clic en Instalar.
Verifica la instalación: Personalización → SuiteCloud Development → Lista de SuiteApps instaladas. Deberías ver el registro AgicapSuiteApp.

⚠️ Si la SuiteApp no puede instalarse, comprueba que la funcionalidad de Subsidiarias está activada. En una cuenta que no sea OneWorld no está disponible y el conector API no puede usarse — en ese caso pasaríamos a la alternativa SFTP.

Paso 2 — Activa las funcionalidades necesarias de la cuenta

Ve a Configuración → Compañía → Activar funcionalidades. La mayoría suelen estar ya activas, pero revisa cuidadosamente estas tres:

Funcionalidad	Subpestaña → sección	Por qué es necesaria
`REST WEB SERVICES`	SuiteCloud → SuiteTalk (Servicios web)	Todas las llamadas de lectura y escritura de registros
`OAUTH 2.0`	SuiteCloud → Gestionar autenticación	Autenticación máquina a máquina
`SuiteAnalytics Workbook`	Analytics → SuiteAnalytics Workbook	Consultas SuiteQL utilizadas para documentos comerciales y el plan contable

Guardar. Habilitar una funcionalidad puede tardar un momento en hacerse efectiva.

Paso 3 — Asignar el AgicapIntegrationRole

La SuiteApp de Agicap crea un rol dedicado que contiene exactamente los permisos que necesita el conector, y nada más.

Configuración → Usuarios/Roles → Gestionar usuarios.
Selecciona el usuario que llevará la integración — recomendamos crear un usuario dedicado para la integración — y haz clic en Editar.
En la pestaña Acceso en la parte inferior de la página, añade AgicapIntegrationRole.
Haz clic en Añadir y luego en Guardar.

🔒 El rol es mantenido por Agicap y se entrega con la SuiteApp. Cuando un nuevo flujo o una corrección requiere un permiso adicional, actualizamos el rol y se propaga con la versión de la SuiteApp: no es necesario reconectar ni generar un nuevo certificado por tu parte. Si tu política de seguridad lo requiere, puedes reemplazar el rol estándar por un rol personalizado dedicado a tu cuenta, limitado a tus equipos. Coméntalo con tu contacto de Agicap antes de la llamada de configuración. Una consecuencia a tener en cuenta antes de elegirlo: un rol personalizado no recibe las actualizaciones automáticas de permisos mencionadas arriba. Cuando un nuevo flujo o una corrección requiere un permiso, tu conexión puede entrar en error hasta que tu equipo lo añada manualmente.

B - Formulario de conexión de Agicap

En Agicap, abre Bancos e integraciones y busca NetSuite. Se abrirá el formulario de conexión. Mantén una pestaña de NetSuite abierta junto a ella: tendrás que ir y volver dos veces.

Paso 1 — ID de cuenta

El ID de tu cuenta de NetSuite es visible directamente en la URL de tu sesión de NetSuite, o en Configuración → Empresa → Información de la empresa.

Paso 2 — Descarga la clave pública de Agicap

Agicap se autentica con un flujo de credenciales de cliente OAuth 2.0 respaldado por un certificado. Agicap genera el certificado; tú lo subes a NetSuite.

En el formulario de conexión, haz clic en Descargar la clave pública y guarda el archivo.

Paso 3 — Crea la integración M2M en NetSuite

En NetSuite, ve a Configuración → Integración → Configuración de credenciales de cliente OAuth 2.0 (M2M).
Crea una nueva asignación de credenciales de cliente entre:
1. la entidad, es decir, el usuario de NetSuite del paso 3 de la sección A,
2. el rol AgicapIntegrationRole,
3. la aplicación Agicap SuiteApp,

y sube el certificado que descargaste en el paso 2.

Guardar.

Paso 4 — Copia el ID del certificado en Agicap

Copia el ID del certificado que acabas de crear y pégalo en el campo ID del certificado del formulario de Agicap.

👀 La lista de certificados de NetSuite no está ordenada por fecha de creación. Si creaste más de un certificado, asegúrate de seleccionar el más reciente. Comprueba el usuario y el rol vinculados al certificado para confirmarlo.

Paso 5 — Opcional: declara los campos personalizados que quieres recoger

Si quieres que Agicap construya etiquetas de documentos comerciales a partir de campos personalizados de NetSuite, declara aquí sus IDs internos, en el momento de la conexión. Al hacer clic en la etiqueta de un campo en NetSuite se revela su ID interno, por ejemplo custbody_phy_patient_name. Solo campos a nivel de cabecera en documentos de operación.

Para añadir campos personalizados después de que la conexión esté activa:

Abre la conexión en Bancos e integraciones → Gestionar conexión → Renovar autorización y completa el flujo.
La conexión volverá a Configurando: Soporte de Agicap debe validarla de nuevo antes de que se reanuden las sincronizaciones.
Una vez que vuelva a sincronizar, contacta con Soporte de Agicap indicando el tipo de documento comercial y el módulo donde debe construirse la etiqueta.

⚠️ Una vez que hagas clic en Renovar autorización o Editar credenciales, se genera una nueva clave pública y se eliminan los datos de autenticación anteriores. Debes completar el flujo, de lo contrario todas las sincronizaciones posteriores fallarán. Si ocurre, simplemente repite el flujo hasta el final.

Paso 6 — Agicap valida la conexión

Después de enviar el formulario, la conexión aparece en Bancos e integraciones con el estado Configurando. Agicap completa entonces el mapeo multi-entidad entre tus filiales de NetSuite y tus entidades de Agicap, y valida la conexión.

⚠️ Este mapeo no puede modificarse una vez validado. Por favor, revisa tu lista de filiales con tu contacto de Agicap antes de guardarla. Corregir un error implica eliminar la conexión y recrearla desde cero.

No es necesario seleccionar las filiales inactivas: el conector las ignora.

Mientras la conexión esté en Configurando, no fluirán datos. Esto es lo esperado.

Paso 7 — Comprueba la primera sincronización

La conexión ha salido del estado Configurando

La línea de tiempo de sincronización muestra una ejecución completada

Tus documentos aparecen en Treasury y Accounts Receivable, al menos para una entidad

Los importes y divisas coinciden con lo que ves en NetSuite

La sincronización automática se ejecuta dos veces al día para documentos comerciales y una vez al día para los demás flujos, y puede lanzarse manualmente en cualquier momento.

💡 En una cuenta grande, la primera sincronización puede tardar significativamente más que las diarias, ya que recoge el histórico en ventanas de tiempo sucesivas. Si parece atascada, contacta con tu contacto de Agicap en vez de recrear la conexión.

C - Archivos de pago vía SFTP (NetSuite → Agicap)

📌 Empieza pidiendo a tu contacto de Agicap que habilite la transferencia de archivos. La URL del servidor, el puerto, el nombre de usuario y la clave del host te los proporcionará él, y la configuración de NetSuite que sigue no puede completarse sin ellos.

Paso 1 — Prepara la clave SSH

⚠️ Restricciones de formato de clave. El conector SFTP de NetSuite acepta claves RSA, ECDSA y DSA, y la clave privada debe estar en formato PEM. Los servidores de Agicap aceptan RSA y EdDSA. La opción segura es una clave RSA de 2048 bits cuya clave privada esté en formato PEM. La exportación OpenSSH de WinSCP que se menciona a continuación es cómo se produce ese archivo, no es un formato diferente.

Genera un par de claves RSA de 2048 bits, por ejemplo con el generador de claves de WinSCP.
Asegúrate de que el archivo de clave privada comienza con -----BEGIN RSA PRIVATE KEY-----. Si no es así, conviértelo: WinSCP → Herramientas → Convertir archivo de clave → carga la clave privada → Exportar clave OpenSSH. No marques "forzar nuevo formato".
Envía la clave pública a tu contacto de Agicap, quien habilitará tu transferencia de archivos y te devolverá la URL del servidor, el puerto, el nombre de usuario y la clave del host.

Paso 2 — Prepara los archivos de pago en NetSuite

Si ya generas archivos de pago en NetSuite, no tienes que hacer nada aquí.

Si no es así, instala la SuiteApp Electronic Bank Payments: Personalización → SuiteBundler → Buscar e instalar paquetes → Lista, ID del paquete 416781, y luego configura tus plantillas de archivos de pago por banco.

💡 La generación de archivos de pago es un tema de configuración de NetSuite más que de Agicap. Tu integrador de NetSuite suele ser la vía más rápida si lo configuras por primera vez.

Paso 3 — Crea las carpetas en el File Cabinet

Crea dos carpetas en tu File Cabinet, una para archivos pendientes de transferencia y otra para archivos ya transferidos. Nombres sugeridos:

agicap payment - processing
agicap payment - processed

Anota el ID interno de cada carpeta, los necesitarás en el paso 5.

Paso 4 — Instala la SuiteApp SFTP Connector

Personalización → SuiteApps → busca SFTP Connector → Instalar.

Paso 5 — Crea y mapea la configuración de salida

SFTP → Registros SFTP → Configuraciones de salida → Nuevo.
Rellena el nombre, la URL del servidor, el puerto, la clave del host y el método de autenticación, usando las credenciales proporcionadas por Agicap.
En la subpestaña Mapeo de salida, introduce los IDs internos de las dos carpetas del File Cabinet del paso 3, y el nombre de la carpeta en el servidor SFTP de Agicap en el campo Carpeta bancaria.
Guarda, luego vuelve a abrir la configuración en modo Editar y haz clic en Probar conexión. Nota: Probar conexión no funciona en modo Ver.
Haz clic en Salida-manual para ejecutar una exportación manualmente y confirmar que el archivo llega.

Paso 6 — Programa la exportación

SFTP → Registros SFTP → Configuraciones de salida → Ver en tu registro.
Haz clic en Salida-programada. Se abrirá una página de despliegue de script.
Configura la frecuencia que necesites y haz clic en Guardar.

💡 Si gestionas varias entidades, acuerda la estructura de carpetas y el nombre de los archivos con tu contacto de Agicap antes de programar, para que los archivos de pago puedan separarse por entidad al llegar.

D - Extractos bancarios vía SFTP y ABSI (Agicap → NetSuite)

📌 Mismo punto de partida que en C: pide primero a tu contacto de Agicap que habilite la transferencia de archivos. Las credenciales y la clave del host te las proporcionará él.

Paso 1 — Comprueba primero los formatos de tus extractos

Antes de cualquier configuración, haz una lista de los bancos y formatos de extracto implicados y confirma que cada uno es compatible con un parser de NetSuite. Aquí es donde suelen atascarse los proyectos. Consulta el recuadro en §5.5.

Paso 2 — Permisos y SuiteApp

Asegúrate de tener permisos de administrador o los permisos específicos de ABSI.
Instala Auto Bank Statement Import: Personalización → SuiteApps (o SuiteCloud Development → SuiteApp Marketplace) → buscar → Instalar.

Paso 3 — Habilita SuiteScript

Configuración → Empresa → Habilitar funcionalidades → subpestaña SuiteCloud.
En SuiteScript, marca Client SuiteScript y Server SuiteScript.
Guardar. Esto es lo que hace accesible la página de claves privadas.

Paso 4 — Sube la clave privada

Configuración → Empresa → Preferencias → Claves → Crear nueva.
Pestaña Detalles: un Nombre descriptivo, un ID de script sin espacios ni caracteres especiales (NetSuite lo antepone con custkey), y una Descripción indicando para qué es la clave y quién la mantiene.
Pestaña Archivos: selecciona el archivo de clave privada. Debe estar en formato PEM — consulta C, paso 1 para saber cómo producir uno.
Contraseña: la frase de contraseña utilizada al generar la clave, si la hay.
Pestaña Público, opcional: marque Restringir a empleados para limitar qué empleados pueden usar la clave en SuiteScript, y utilice Restringir a scripts para limitarla a scripts específicos.
Guardar. NetSuite valida y almacena la clave.

Paso 5 — Crear el registro de la Institución Financiera y el Perfil de Formato

❗ Cree un registro de Institución Financiera por banco, luego un Perfil de Formato por cada formato y versión de archivo dentro de ella. Mezclar formatos en un solo perfil es la causa más común de fallos en las importaciones.

Configuración → Contabilidad → Instituciones Financieras → Lista → Nuevo.
En el registro, agregue un Perfil de Formato y elija Conectividad SFTP como método.
Ingrese la URL del servidor, nombre de usuario, contraseña y clave de host proporcionados por Agicap. Para un servidor de Agicap la URL es files.agicap.com; el puerto, nombre de usuario y clave de host se incluyen con las credenciales que le envía su contacto.
Defina el patrón de nombre de archivo de descarga. Acuerde el nombre exacto del archivo y el directorio con su contacto de Agicap.

Paso 6 — Vinculación de cuentas

Asocie los datos que NetSuite analizará con sus cuentas contables. Enumere cada cuenta involucrada en los extractos que importa, y para cada valor que el parser extraerá, coloque ese valor en la primera columna y vincúlelo a la cuenta contable correspondiente de NetSuite en la tercera columna.

El formato de la primera columna debe coincidir exactamente con lo que produce el parser elegido.

Paso 7 — Configurar el parser

Formato	Qué tener en cuenta
CAMT.053	Agregue todos los códigos de operación que puedan aparecer en los extractos que recibe. Un código faltante hace que toda la importación falle. Luego verifique la asignación de etiquetas para cada campo de NetSuite.
MT940	Parser estándar de NetSuite, siga la documentación de NetSuite.
BAI2	Parser estándar de NetSuite, siga la documentación de NetSuite.
CSV	Alternativa cuando fue necesaria una transformación. Las columnas y los formatos deben coincidir exactamente con la definición de importación CSV de NetSuite.

Paso 8 — Probar y activar

Pida a Agicap que coloque primero un archivo coincidente en el servidor SFTP, para que la prueba sea significativa.
Haga clic en Enviar, no en Guardar directamente.
Si el resultado es verde, haga clic en Guardar.
Haga clic en Rastrear estado para confirmar que el archivo fue recuperado y analizado.

💡 Frecuencia. El flujo de importación se ejecuta aproximadamente una vez al día. Puede activarlo manualmente reenviando el Perfil de Formato, con un mínimo de 60 minutos entre dos ejecuciones. Retención. NetSuite no mueve ni elimina archivos una vez procesados. La estrategia de archivado en el servidor SFTP se acuerda con su contacto de Agicap durante la configuración, para que el mismo extracto no se importe dos veces.

Evitar importaciones duplicadas. NetSuite debería omitir un archivo que ya haya importado, pero recomendamos una de estas estrategias, acordadas con su contacto de Agicap:

Fecha en el nombre del archivo — cada nombre de archivo incluye su fecha (por ejemplo bank_statement_2024-06-15.csv), y su patrón de nombre de archivo de NetSuite acepta esa fecha.
Flujo de dos carpetas — los archivos se entregan en una carpeta por procesar y se mueven a una carpeta procesados una vez que ha pasado la ventana de procesamiento de NetSuite.
SuiteScript personalizado de su parte que renombra o mueve los archivos después de la importación.

Varios bancos o formatos. Cada parser de NetSuite debe recoger solo los archivos de su propio banco. Puede usar una carpeta por banco (por ejemplo /Bank_A/, /Bank_B/), o una sola carpeta con una convención de nombres (un prefijo o sufijo de banco en cada nombre de archivo, por ejemplo BANKA_20240615.csv) y configurar cada Perfil de Formato para que recoja solo su propio patrón. Es posible una combinación de ambos.

Cómo activar cada caso de uso

Una vez finalizada la configuración y realizada una primera recogida de documentos empresariales, puede activar los demás flujos directamente en la página Bancos e integraciones > Detalles de sincronización. Cada flujo tiene su propio interruptor de activación/desactivación. La importación de documentos empresariales está activada por defecto y no se puede desactivar.

6. Errores frecuentes

Error	Lo que ve	Causa	Qué hacer
Tiempo de espera en la primera sincronización	No aparecen operaciones pendientes en Treasury después de la primera sincronización	Se recuperó demasiada historia de una vez (por defecto, los últimos 365 días de documentos modificados)	Contacte con el Soporte de Agicap: pueden reducir la ventana de recogida inicial, por ejemplo a 90 días.
Tiempo de espera en una conexión activa Mensaje en los detalles de sincronización: `The request was canceled due to the configured HttpClient.Timeout of 300 seconds elapsing. > The operation was canceled.`	Los documentos ya no se actualizan en Agicap	NetSuite tardó más de 5 minutos en responder a una llamada API. Agicap detiene las llamadas después de 5 minutos para que las sincronizaciones no queden colgadas indefinidamente.	Ejecute la sincronización de nuevo un poco más tarde. Si el error persiste, contacte con el Soporte de Agicap con el nombre de la conexión y el mensaje de error. No elimine ni reemplace la conexión.
`Aggregator error : Invalid URL: The hostname could not be parsed.`	Todas las sincronizaciones fallan después de editar las credenciales	Se inició pero no se completó Editar credenciales o Renovar autorización. Se genera una nueva clave pública en cuanto hace clic, y los datos de autenticación anteriores se eliminan.	Repita el flujo de credenciales y complételo hasta el final (B, pasos 2 a 4).
La conexión permanece en Configurando	La conexión fue creada pero nada se sincroniza	La asociación entre sus filiales de NetSuite y sus entidades de Agicap no se ha completado y validado aún, o una autorización renovada no ha sido revalidada	Contacte con el Soporte de Agicap: la asociación y validación se realizan en el lado de Agicap (B, paso 6).
Exportación de diario bancario rechazada en un tercero específico	Una exportación falla, las demás pasan	Tercero duplicado en NetSuite, por lo que la referencia de la factura y la referencia del tercero no apuntan al mismo registro	Elimine duplicados de proveedores y clientes en NetSuite.
Pedidos de compra recogidos pero no visibles en Accounts Payable	No aparece nada en Accounts Payable tras una sincronización exitosa	La funcionalidad correspondiente de Agicap no está activada en su cuenta	Contacte con el Soporte de Agicap para activarla.

¿Necesita ayuda o más información?

Contacte con su soporte de Agicap.

Oracle NetSuite (externo)