Process sales CSVs into invoices with email notifications API

Turn a sales CSV into checked, priced invoices: one per customer, with subtotal, tax and grand total, and a ready-to-send order-confirmation email for each.

Input

Send these Fields as input. A Field not listed here is refused.

sales_csv

Sales CSV (sku, quantity, customer_email, order_date)

An https URL or an upload id.

  • Type: string
  • Required: no

csv_text

Or paste the sales CSV text (instead of the file)

  • Type: string
  • Required: no
  • Length in characters: at most 30000

products

Product catalog CSV (sku, name, price, tax_rate)

An https URL or an upload id.

  • Type: string
  • Required: yes
  • Length in characters: at least 1

existing_invoices

Invoices made before (optional CSV with customer_email, order_date), to skip duplicates

An https URL or an upload id.

  • Type: string
  • Required: no

Run it

One call presses the Widget and answers the run once its status is succeeded or failed, however long it takes. The key is read from ABYSS_API_KEY. Install the library with npm install abysshub or pip install abysshub; cURL sends the Fields as a form.

JavaScript

// index.mjs
import Abyss, { file } from "abysshub";

const abyss = new Abyss();

const run = await abyss.run("widget_386", {
  sales_csv: file("sales-2026-11-week1.csv"),
  products: file("products.csv"),
  existing_invoices: file("previous-invoices.csv"),
});

console.log(run.result);
for (const path of await run.save("output")) {
  console.log(path);
}

Python

from abysshub import Abyss, file

abyss = Abyss()

run = abyss.run("widget_386", {
    "sales_csv": file("sales-2026-11-week1.csv"),
    "products": file("products.csv"),
    "existing_invoices": file("previous-invoices.csv"),
})

print(run.result)
for path in run.save("output"):
    print(path)

cURL

curl https://api.abysshub.com/v1/widgets/widget_386/runs \
  -H "Authorization: Bearer $ABYSS_API_KEY" \
  -F sales_csv=@sales-2026-11-week1.csv \
  -F products=@products.csv \
  -F existing_invoices=@previous-invoices.csv

A succeeded run carries its result and its output_files. Their URLs are signed for each read: re-read the run, never store a URL. A run still queued or running in the answer (after an hour, or when the API is busy) is read again at its Location with ?wait=true.

What it answers

The Example Run's result, the JSON the Widget wrote to output/output.json:

{
  "success": true,
  "processed_at": "2026-11-20T12:09:58.662Z",
  "invoice_count": 1,
  "invoices": {
    "to": "amara.okafor@example.com",
    "subject": "Invoice INV-1795176598661-1 - Order Confirmation",
    "body": "Dear Customer,\n\nThank you for your order!\n\nInvoice ID: INV-1795176598661-1\nOrder Date: 11/2/2026\n\nSubtotal: $63.50\nTax: $9.07\nGrand Total: $72.57\n\nThank you for your business!\n\nBest regards,\nSales Team"
  },
  "email_notifications": [
    {
      "to": "sofia.marino@example.com",
      "subject": "Invoice INV-1795176598661-3 - Order Confirmation",
      "body": "Dear Customer,\n\nThank you for your order!\n\nInvoice ID: INV-1795176598661-3\nOrder Date: 11/2/2026\n\nSubtotal: $58.60\nTax: $8.78\nGrand Total: $67.38\n\nThank you for your business!\n\nBest regards,\nSales Team"
    },
    {
      "to": "kenji.watanabe@example.com",
      "subject": "Invoice INV-1795176598661-4 - Order Confirmation",
      "body": "Dear Customer,\n\nThank you for your order!\n\nInvoice ID: INV-1795176598661-4\nOrder Date: 11/3/2026\n\nSubtotal: $68.00\nTax: $8.60\nGrand Total: $76.60\n\nThank you for your business!\n\nBest regards,\nSales Team"
    },
    {
      "to": "hannah.cole@example.com",
      "subject": "Invoice INV-1795176598661-5 - Order Confirmation",
      "body": "Dear Customer,\n\nThank you for your order!\n\nInvoice ID: INV-1795176598661-5\nOrder Date: 11/3/2026\n\nSubtotal: $61.90\nTax: $6.23\nGrand Total: $68.13\n\nThank you for your business!\n\nBest regards,\nSales Team"
    },
    {
      "to": "diego.ruiz@example.com",
      "subject": "Invoice INV-1795176598661-6 - Order Confirmation",
      "body": "Dear Customer,\n\nThank you for your order!\n\nInvoice ID: INV-1795176598661-6\nOrder Date: 11/3/2026\n\nSubtotal: $44.70\nTax: $3.13\nGrand Total: $47.83\n\nThank you for your business!\n\nBest regards,\nSales Team"
    },
    {
      "to": "tom.ellis@example.com",
      "subject": "Invoice INV-1795176598661-8 - Order Confirmation",
      "body": "Dear Customer,\n\nThank you for your order!\n\nInvoice ID: INV-1795176598661-8\nOrder Date: 11/4/2026\n\nSubtotal: $108.50\nTax: $16.96\nGrand Total: $125.46\n\nThank you for your business!\n\nBest regards,\nSales Team"
    },
    {
      "to": "ines.duarte@example.com",
      "subject": "Invoice INV-1795176598661-9 - Order Confirmation",
      "body": "Dear Customer,\n\nThank you for your order!\n\nInvoice ID: INV-1795176598661-9\nOrder Date: 11/4/2026\n\nSubtotal: $48.80\nTax: $7.26\nGrand Total: $56.06\n\nThank you for your business!\n\nBest regards,\nSales Team"
    },
    {
      "to": "oliver.grant@example.com",
      "subject": "Invoice INV-1795176598661-10 - Order Confirmation",
      "body": "Dear Customer,\n\nThank you for your order!\n\nInvoice ID: INV-1795176598661-10\nOrder Date: 11/5/2026\n\nSubtotal: $72.20\nTax: $6.00\nGrand Total: $78.20\n\nThank you for your business!\n\nBest regards,\nSales Team"
    },
    {
      "to": "leila.haddad@example.com",
      "subject": "Invoice INV-1795176598662-11 - Order Confirmation",
      "body": "Dear Customer,\n\nThank you for your order!\n\nInvoice ID: INV-1795176598662-11\nOrder Date: 11/5/2026\n\nSubtotal: $43.00\nTax: $3.01\nGrand Total: $46.01\n\nThank you for your business!\n\nBest regards,\nSales Team"
    },
    {
      "to": "marta.kowalska@example.com",
      "subject": "Invoice INV-1795176598662-12 - Order Confirmation",
      "body": "Dear Customer,\n\nThank you for your order!\n\nInvoice ID: INV-1795176598662-12\nOrder Date: 11/6/2026\n\nSubtotal: $53.90\nTax: $9.24\nGrand Total: $63.14\n\nThank you for your business!\n\nBest regards,\nSales Team"
    }
  ],
  "message": "All invoices processed and customers notified",
  "duplicates": [
    {
      "invoice_id": "INV-1795176598661-2",
      "customer_email": "lukas.brenner@example.com",
      "order_date": "2026-11-02",
      "reason": "Duplicate order for this customer and date"
    },
    {
      "invoice_id": "INV-1795176598661-7",
…

More

Keys, files, errors and limits: API access.