Stop Guessing. Build Your AP Automation on Verifiable Coordinate Proof.

// Frontend: Upload invoice to your server (secure pattern)
const formData = new FormData();
formData.append('invoice', invoiceFile); // The PDF invoice from a vendor
formData.append('processor_id', 'your-invoice-processor-uuid');

const response = await fetch('/api/invoices/process', {
  method: 'POST',
  body: formData
});

const { jobId } = await response.json();
console.log('Job started:', jobId);

// Poll your server for status (your server proxies to Ninjadoc)
const pollResponse = await fetch(`/api/jobs/${jobId}/status`);
const result = await pollResponse.json();
console.log('Extraction complete:', result);

// Server-side: Production-ready invoice processing with robust polling
async function processInvoice(invoiceFile, processorId) {
  try {
    // 1. Submit the vendor invoice and get a job ID
    const formData = new FormData();
    formData.append('document', invoiceFile);
    formData.append('processor_id', processorId);

    const submitResponse = await fetch('https://ninjadoc.ai/api/extract', {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${process.env.NINJADOC_API_KEY}` },
      body: formData
    });
    if (!submitResponse.ok) throw new Error(`Submit failed: ${submitResponse.status}`);
    const job = await submitResponse.json();

    // 2. Poll for completion with exponential backoff and timeout
    let result;
    const maxAttempts = 30; // 5 minutes with backoff
    const initialDelay = 1000; // 1 second
    let attempt = 0;
    let delay = initialDelay;

    while (attempt < maxAttempts) {
      attempt++;

      const statusResponse = await fetch(`https://ninjadoc.ai/api/jobs/${job.id}/status`, {
        headers: { 'Authorization': `Bearer ${process.env.NINJADOC_API_KEY}` }
      });

      if (statusResponse.status === 429) {
        // Rate limited: honor Retry-After header or exponential backoff
        const retryAfter = statusResponse.headers.get('Retry-After');
        delay = retryAfter ? parseInt(retryAfter) * 1000 : Math.min(delay * 2, 30000);
        await new Promise(resolve => setTimeout(resolve, delay));
        continue;
      }

      if (!statusResponse.ok) throw new Error(`Status check failed: ${statusResponse.status}`);
      result = await statusResponse.json();

      if (!['queued', 'processing'].includes(result.status)) break;

      // Exponential backoff with jitter
      delay = Math.min(delay * 1.5, 10000) + Math.random() * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
    }

    if (result.status !== 'completed') {
      throw new Error(`Invoice processing failed: ${result.status}`);
    }

    // 3. Extract and structure the data for your AP system
    const extractedData = result.data.reduce((acc, f) => {
      acc[f.field_name] = { value: f.value, coordinates: f.geometry };
      return acc;
    }, {});

    // Validate critical fields
    if (!extractedData.invoice_number?.value || !extractedData.total_amount?.value) {
      throw new Error('Missing critical data for payment processing');
    }

    return { success: true, data: extractedData };
  } catch (error) {
    console.error('Invoice processing failed:', error);
    return { success: false, error: error.message };
  }
}

{
  "id": "job_abc123",
  "status": "completed",
  "data": [
    {
      "field_name": "invoice_number",
      "value": "INV-2024-001",
      "confidence": 0.98,
      "geometry": [
        {
          "text": "INV-2024-001",
          "boundingBox": [100, 150, 200, 170],
          "pageNumber": 1
        }
      ],
      "page_number": 1
    },
    {
      "field_name": "total_amount",
      "value": "1250.00",
      "confidence": 0.95,
      "geometry": [
        {
          "text": "$1,250.00",
          "boundingBox": [400, 500, 480, 520],
          "pageNumber": 1
        }
      ],
      "page_number": 1
    }
  ],
  "page_metadata": {
    "1": {
      "dimensions": {
        "width": 612,
        "height": 792
      }
    }
  }
}

{
  "field_name": "line_items",
  "value": [
    {
      "description": "Office Supplies",
      "quantity": "5",
      "unit_price": "25.00",
      "line_total": "125.00",
      "coordinates": {
        "description": [100, 200, 200, 220],
        "quantity": [300, 200, 320, 220],
        "unit_price": [350, 200, 400, 220],
        "line_total": [450, 200, 500, 220]
      }
    }
  ],
  "confidence": 0.92,
  "geometry": [...], // Overall table region
  "page_number": 1
}

// app/routes/api.ninjadoc.$.tsx
import { createRemixApiRoute } from '@ninjadoc-ai/sdk/frameworks/remix';

const { loader, action } = createRemixApiRoute({
  // API key automatically read from NINJADOC_API_KEY env var
});

export { loader, action };

// Add to app/routes.ts:
// route("/api/ninjadoc/*", "routes/api.ninjadoc.$.tsx")