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.
- Id:
widget_386 - Price: Ƀ 20 a run, plus the Call Price, Ƀ 0.1 an API run. Your first 100 API runs carry no Call Price.
- Widget page: Run it in your browser
- Docs: Call Abyss from your code
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.csvA 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.