How the N/sftp Module Works
A SuiteScript first establishes a connection to an approved SFTP server using details such as the host, port, user credentials, host key, and remote directory. Authentication can use supported credential references, key-based methods, or other configured options rather than embedding sensitive values directly in script logic.
Once connected, a netsuite script can upload a file from the File Cabinet, download a remote file into NetSuite, inspect directory contents, or move processed files into another folder. This approach also supports ERP Workflow Automation because a scheduled or triggered script can coordinate file exchange as part of a broader ERP activity.
ERP Integration Layer: How It Powers Finance Automation provides useful architectural context because SFTP can form one part of an ERP integration layer that connects NetSuite finance data with banking, payment, reporting, or operational applications.
Core SFTP Capabilities
The N/sftp module provides several operations that help developers manage secure file exchange between NetSuite and remote servers.
- Connect: Establishes an authenticated session with an approved SFTP server using defined connection settings.
- Upload: Transfers files from NetSuite to a remote SFTP location.
- Download: Retrieves files from an SFTP server so SuiteScript can store or process them in NetSuite.
- Directory listing: Returns information about files available in a specified remote directory.
- Move: Relocates remote files after processing when the target SFTP environment supports the required action.
- Remove: Deletes designated files from the remote server when appropriate permissions are available.
These capabilities complement Company Specific Configurations, where ERP integrations, workflows, roles, and GL structures are tailored to organizational requirements. SFTP folders, file naming standards, connection settings, and processing rules can likewise vary by entity or finance activity.
Role in Finance and ERP Integrations
SFTP remains widely used in finance integrations where leading ERPs exchange structured files securely with banks, payment providers, treasury applications, reporting systems, or external business partners. N/sftp gives SuiteScript a direct way to participate in those file-based exchanges.
This supports Finance Operations Integration by connecting ERP records with downstream finance activities that depend on controlled file movement. The Hyperbots Platform applies agentic AI to finance and accounting tasks through document processing and ERP integration, illustrating how secure file exchange can complement connected finance automation.
Because SFTP connections may carry sensitive financial information, ERP Security Best Practices for Finance Teams (2026) is relevant to credential handling, host verification, role permissions, access controls, and secure management of integration endpoints.
Practical Finance Use Cases
A treasury script could generate a payment file in NetSuite and use N/sftp to deliver it to a banking endpoint. Another scheduled script might retrieve a bank statement file from an SFTP directory, store it in the File Cabinet, and make it available for reconciliation processing.
Finance teams can also use SFTP for vendor master exchanges, tax files, reporting extracts, or structured data sent between entities. These scenarios align with Process Specific Capabilities, where domain-trained finance automation supports defined AP, AR, reconciliation, close, or treasury activities.
Ready to Deploy Capabilities similarly combine pre-trained agents, ERP connectors, and configurable setup, making secure SFTP connectivity useful where finance tasks depend on controlled file transfer. The same architectural principle appears in How Hyperbots AI Agents 10x Datacor ERP Finance Operations, where ERP-connected capabilities extend AP, AR, cash application, collections, and close automation.
Implementation Best Practices
SFTP integrations should use clearly defined folders, predictable file naming conventions, appropriate credentials, and verified host information. Scripts should validate files before upload or processing and maintain a clear distinction between incoming, processed, and archived files where the finance workflow requires it.
- Use secure credential references or approved authentication methods instead of embedding sensitive values in source code.
- Verify SFTP host keys before establishing trusted production connections.
- Use dedicated inbound, outbound, processed, or archive folders where appropriate.
- Validate expected file names, formats, and contents before downstream finance processing.
- Apply role-based access to NetSuite files, scripts, deployments, and connection configuration.
- Test uploads, downloads, directory access, and file movement in a representative non-production environment.
These practices help SFTP-based finance exchanges remain organized, traceable, and aligned with ERP governance while supporting operational efficiency.
Summary
The NetSuite SuiteScript N/sftp Module provides secure SFTP connectivity for transferring files between NetSuite and external servers. It supports connection management, uploads, downloads, directory listings, file movement, and removal operations for approved finance workflows. Used with verified hosts, controlled credentials, clear folder structures, and appropriate permissions, N/sftp helps finance teams support banking, payments, reconciliation, reporting, and other file-based ERP activities.