upload-income-statements

Uploads confirmed NetSuite income statement CSVs into ReturnPro for accuracy auditing.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/clenisa/optimal-cli --skill upload-income-statements
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upload-income-statements
Source: https://github.com/clenisa/optimal-cli/tree/main/skills/upload-income-statements
Command: npx skills add https://github.com/clenisa/optimal-cli --skill upload-income-statements

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Consolidates confirmed income statement CSVs exported from NetSuite into ReturnPro so finance teams have a single source of truth for accuracy audits and comparisons against staged financial data.

Core Features & Use Cases

  • Validated ingestion: Parses CSV rows, validates account codes against the account dimension, and ensures confirmed GL rows are accurate before insertion.
  • Controlled writes: Supports monthly replace-or-upsert behavior so teams can either append or fully replace confirmed month data.
  • Immediate feedback: Runs a quick staged versus confirmed accuracy check and logs activity so analysts can act on data quality issues immediately.

Quick Start

Upload a confirmed NetSuite income statement CSV by running the upload-income-statements command with an absolute file path and the month set to YYYY-MM.

Frequently Asked Questions about upload-income-statements

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upload confirmed income statement CSVs into ReturnPro for accuracy auditing?

To upload confirmed income statement CSVs into ReturnPro, run the upload command with an absolute file path and a month in YYYY-MM format. The Skill validates account codes against dim_account before writing the data as authoritative confirmed records.

Can I append or replace confirmed month data when loading income statements from NetSuite?

Yes, you can append or replace confirmed month data when loading income statements. Use the optional replace flag during the CSV upload to fully overwrite existing confirmed records for that specific month or append new rows.

Do I need Supabase environment variables to validate account codes during financial data ingestion?

Yes, you need the RETURNPRO_SUPABASE_URL and RETURNPRO_SUPABASE_SERVICE_KEY environment variables configured. These credentials allow the Skill to connect to Supabase, validate account codes against the account dimension, and write to confirmed_income_statements.

What is the best way to compare staged versus confirmed income statement data?

The best way to compare staged versus confirmed income statement data is to run the upload command, which automatically performs a quick staged-versus-confirmed accuracy check and logs activity so analysts can act on data quality issues immediately.

What happens if my NetSuite export contains account codes that fail validation?

If your NetSuite export contains invalid account codes, the validated ingestion process halts the CSV upload. The Skill parses rows and validates account codes against the account dimension to ensure confirmed GL rows are accurate before insertion.

When do I need to use a YYYY-MM format for monthly income statement uploads?

You need to use the YYYY-MM format whenever you upload a confirmed income statement CSV. This month parameter directs the replace-or-upsert behavior, ensuring the validated data writes to the correct monthly partition in the confirmed_income_statements table.