API Quickstart & Overview

curl -X POST https://api-production-618c.up.railway.app/v1/invoices \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "X-Workspace-Id: CMP-001" \
  -H "Idempotency-Key: idem_tx_20261029_001" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "CMP-001",
    "company_code": "CMP-001",
    "invoice_no": "000000001",
    "tran_date": "2026-10-29T08:30:00.000Z",
    "currency": "PHP",
    "status": "Ok",
    "customer": {
      "customer_code": "CUS-00001",
      "name": "Medical Health Experts Inc.",
      "email": "billing@medicalhealth.ph",
      "tin": "123-456-789-000",
      "address": "Pasig City, Philippines",
      "contact_number": "0917-123-4567",
      "taxpayer_classification": "SC",
      "birthdate": "1958-04-15",
      "age": 68,
      "osca_id": "OSCA-2026-8821"
    },
    "items": [
      {
        "barcode": "4806539930001",
        "itemdesc": "Alaprime SG Cap 1x30",
        "unit": "box",
        "qty": 10,
        "srp": 96000,
        "grossamt": 960000,
        "vatclass": "VAT_EXEMPT_SC",
        "scpwd": true,
        "discper1": 0,
        "discount1": 0,
        "discper2": 0,
        "discount2": 0,
        "scper": 20,
        "scdisc": 171429,
        "spldisc": 171429,
        "spldiscper": 20,
        "spldesc": "Senior Citizen 20% Discount (RA 9994)",
        "vatsales": 0,
        "vatamt": 0,
        "vatexempt": 685714,
        "zerorated": 0,
        "netamt": 685714
      }
    ],
    "md_code": "MD-0012",
    "md_name": "Dr. Josefa Cruz, MD",
    "md_prc_no": "PRC-0129481"
  }'

import { EInvoiceClient } from '@einvoice/sdk';

const client = new EInvoiceClient({
  apiKey: process.env.EINVOICE_SECRET_KEY,
  workspaceId: 'CMP-001',
});

// Idempotent BIR Invoice creation aligned with invoices, customers, and invoice_items tables
const invoice = await client.invoices.create({
  workspace_id: 'CMP-001',
  company_code: 'CMP-001',
  status: 'Ok',
  currency: 'PHP',
  customer: {
    customer_code: 'CUS-00001',
    name: 'Medical Health Experts and Associates Inc.',
    email: 'billing@medicalhealth.ph',
    tin: '123-456-789-000',
    address: 'Pasig City, Philippines',
    contact_number: '0917-123-4567',
    taxpayer_classification: 'SC', // 'VAT' | 'NonVAT' | 'SC' | 'PWD' | 'NAAC' | 'SOLO_PARENT'
    birthdate: '1958-04-15',
    age: 68,
    osca_id: 'OSCA-2026-8821',
  },
  items: [
    {
      barcode: '4806539930001',
      itemdesc: 'Alaprime SG Cap 1x30',
      unit: 'box',
      qty: 10,
      srp: 96000, // Integer centavos (₱960.00)
      vatclass: 'VAT_EXEMPT_SC',
      scpwd: true,
      scper: 20,
      discper1: 0,
      discper2: 0,
    },
  ],
}, { idempotencyKey: 'idem_tx_20261029_001' });

console.log('Invoice Public ID:', invoice.id);
console.log('9-Digit BIR Series:', invoice.invoice_no);
console.log('Net Payable (centavos):', invoice.attributes.summary.net_amount);
console.log('Streamed BIR PDF receipt:', invoice.receipt_url);