> ## Documentation Index
> Fetch the complete documentation index at: https://developers.tesoria.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar NetSuite

> Guía para el administrador de NetSuite: acceso de solo lectura para Tesoria, en seis pasos dentro de su cuenta.

Tesoria lee de NetSuite las facturas de proveedores y de clientes, las órdenes de compra y los anticipos, para que cuentas por pagar, cobranza y el flujo de efectivo estén al día sin exportar reportes. La conexión usa la API oficial de NetSuite (SuiteTalk REST) con autenticación por certificado (OAuth 2.0, Machine to Machine).

**Solo lectura · Nada que instalar · Sin contraseñas · Revocable en cualquier momento**

## El recorrido

| # | Paso | Quién |
| - | - | - |
| 1 | Habilitar REST Web Services | Su administrador de NetSuite |
| 2 | Crear el rol de solo lectura | Su administrador de NetSuite |
| 3 | Asignar el rol a un usuario | Su administrador de NetSuite |
| 4 | Registrar la integración | Su administrador de NetSuite |
| 5 | Vincular el certificado de Tesoria | Su administrador de NetSuite |
| 6 | Enviar 3 datos a Tesoria | Su administrador → Tesoria |

## Antes de empezar

1. **¿Quién lo configura?** Un usuario con rol Administrator en su NetSuite, de su equipo o de su partner.
2. **¿A qué usuario se asigna?** Su usuario dedicado a integraciones, si ya existe. Si no, uno nuevo (NetSuite lo cuenta como usuario con acceso) o uno existente.
3. **¿En qué ambiente?** Con sandbox, se empieza ahí y se repite en producción. Sin sandbox, directo en producción: el rol solo puede consultar.

## Paso 1 · Habilitar REST Web Services

`Setup › Company › Setup Tasks › Enable Features`

1. Subpestaña **SuiteCloud**, sección *SuiteTalk (Web Services)*: marcar **REST Web Services** y aceptar los *SuiteCloud Terms of Service*.
2. Subpestaña **Analytics**: marcar **SuiteAnalytics Workbook**.
3. Guardar.

Es una función de NetSuite que se prende; no es un módulo adicional.

## Paso 2 · Crear el rol «Tesoria – Solo lectura»

`Setup › Users/Roles › User Management › Manage Roles › New`

Nombre **Tesoria – Solo lectura**, con acceso a **todas las subsidiarias**. En la pestaña *Permissions*, agregar:

| Subpestaña | Permiso | Nivel |
| - | - | - |
| Setup | REST Web Services · Log in using Access Tokens | Full |
| Reports | SuiteAnalytics Workbook | Edit |
| Transactions | Find Transaction · Purchase Order · Bills · Vendor Prepayment · Invoice | View |
| Lists | Vendors · Customers · Subsidiaries · Currency · Accounts | View |

Un rol dedicado, no Administrator: NetSuite no recomienda usar Administrator en integraciones, por seguridad. Este rol solo consulta.

## Paso 3 · Asignar el rol al usuario

`Lists › Employees › Employees`

1. Editar el usuario elegido.
2. Pestaña **Access**: marcar **Give Access**.
3. Subpestaña **Roles**: agregar **Tesoria – Solo lectura**. Guardar.

Es el usuario que se elige en el paso 5.

## Paso 4 · Registrar la integración «Tesoria»

`Setup › Integration › Manage Integrations › New`

1. Name **Tesoria** · State **Enabled**.
2. Subpestaña **Authentication**: marcar **Client Credentials (Machine to Machine) Grant** y **REST Web Services**.
3. Guardar y **copiar el Client ID**: NetSuite lo muestra una sola vez, al guardar.

## Paso 5 · Vincular usuario, rol, integración y certificado

`Setup › Integration › Manage Authentication › OAuth 2.0 Client Credentials (M2M) Setup`

1. **Create New**.
2. Elegir el usuario del paso 3, el rol **Tesoria – Solo lectura** y la aplicación **Tesoria**.
3. Subir el certificado que les entrega Tesoria (archivo `.pem`) y guardar.
4. **Copiar el Certificate ID** del registro recién creado.

El certificado es la parte pública: sirve para que NetSuite reconozca a Tesoria y, por sí solo, no da acceso a nada.

## Paso 6 · Enviar tres datos a Tesoria, por correo

| Dato | Dónde está |
| - | - |
| Account ID | `Setup › Company › Company Information` |
| Client ID | Paso 4 |
| Certificate ID | Paso 5 |

Ninguno es una contraseña: sin la llave privada, que solo tiene Tesoria, no permiten entrar.

Después de la configuración, Tesoria hace la primera lectura y les comparte el cuadre de las facturas abiertas por sociedad contra su reporte de cuentas por pagar del mismo día. Si lo prefieren, acompañamos la configuración en una llamada con pantalla compartida.

## Seguridad y control

* **Solo lectura.** El rol solo consulta. Cualquier ampliación se configura aparte y con su autorización.
* **Revocable.** Desde la pantalla del paso 5 se revoca el certificado y el acceso se corta de inmediato.
* **Trazable.** Cada consulta queda en la bitácora de NetSuite a nombre del rol de Tesoria.
* **Certificado con vigencia.** NetSuite acepta hasta 2 años; Tesoria entrega el nuevo antes de que venza.
* **Si usan sandbox.** La configuración no se copia entre ambientes y se borra al refrescarlo: se repite ahí, con su propio certificado.
* **Sin carga para su NetSuite.** Tesoria consulta solo lo que cambió, dentro de los límites de conexiones de su cuenta.

## Documentación oficial de Oracle NetSuite

* [Prerequisites and Setup for REST Web Services](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_5085602973.html)
* [Create Integration Records for Applications to Use OAuth 2.0](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_157771733782.html)
* [OAuth 2.0 Client Credentials (M2M) Setup](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_162686838198.html)
* [Certificate Conditions](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/subsect_162755332391.html)
* [Giving an Employee Access](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_N896195.html)
* [Company Information (Account ID)](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_1104025021.html)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.