Forderungsmanagement

Entwickelt, um Frühwarnsysteme, KI-Agenten und automatische Erinnerungen zu speisen.

Überblick

Die Forderungsmanagement-API ist ein analytischer Endpoint für Massenabfragen, der speziell für Workflows zur Forderungsbeitreibung entwickelt wurde. Statt Sie zu zwingen, Tausende von Angeboten herunterzuladen und Fristen manuell zu berechnen, berechnet Cord die vollständige Altersstruktur (Aging) und die Salden im Backend.

Dieser Endpoint eignet sich ideal für einen Cron-Job (node-cron oder GitHub Actions), der SMS-Erinnerungen auslöst, oder um ein PowerBI-Dashboard zu speisen.

Den Stand der offenen Forderungen abrufen

Der Endpoint GET /api/v1/cobranza gibt eine Gesamtübersicht über die finanzielle Lage der Organisation zurück.

Erfordert den Professional-Tarif oder höher. Das Forderungsmanagement ist eine kostenpflichtige Funktion. Ohne den erforderlichen Tarif antwortet der Endpoint statt mit Daten mit 402 Payment Required und code: "subscription_required" – siehe Fehlerbehandlung.

Anfrage:

curl -X GET "https://cordhq.app/api/v1/cobranza" \
     -H "Authorization: Bearer sk_live_tU..."

Antwort (analytische Momentaufnahme):

Die Antwort ist für die sofortige Verwendung aufgebaut und entfernt aus Sicherheitsgründen das geheime öffentliche token jeder Forderung – es in einer Liste zu veröffentlichen, würde jeden nur lesenden Schlüssel in einen Verteiler von Zahlungslinks verwandeln. Jeder total ist der Gesamtbetrag des Angebots in seiner eigenen Verkaufswährung, ohne Umrechnung; die Antwort enthält die Währung der einzelnen Forderungen nicht. resumen, aging und clientes addieren diese Beträge unverändert; wenn Ihr Unternehmen Angebote in mehr als einer Währung erstellt, mischen diese Summen also Währungen. Die offenen Forderungen umfassen bestätigte oder abgerechnete Angebote (approved, invoiced), die keine wiederkehrenden Monatspauschalen sind; Rechnungen aus Cord Invoicing fragen Sie mit der Rechnungs-API ab.

{
  "data": {
    "resumen": {
      "totalPorCobrar": 450000,
      "totalVencido": 150000,
      "totalVigente": 300000,
      "nPorCobrar": 24,
      "nVencidas": 12,
      "nClientes": 9,
      "nExcedidos": 1,
      "interesTotal": 3200,
      "interesPct": 3,
      "avgDelay": 6,
      "esperado7": 80000,
      "esperado30": 220000
    },
    "aging": [
      { "key": "vigente", "label": "Not yet due", "monto": 300000, "n": 12, "color": "#3b82f6" },
      { "key": "d30", "label": "1–30 days", "monto": 50000, "n": 6, "color": "#f59e0b" },
      { "key": "d60", "label": "31–60 days", "monto": 20000, "n": 3, "color": "#f97316" },
      { "key": "d60p", "label": "60+ days", "monto": 80000, "n": 3, "color": "#ef4444" }
    ],
    "items": [
      {
        "id": "2a9d8e4f-6b1c-4d7a-9e3f-5c8b1a2d4e6f",
        "folio": "COT-00104",
        "empresa": "Stark Industries",
        "clienteId": "8f7b2c1e-4d3a-4b9f-a6e2-1c5d7e9f0a3b",
        "status": "invoiced",
        "total": 5000,
        "overdue": true,
        "diasVencido": 14,
        "interes": 42
      }
    ],
    "clientes": [
      {
        "empresa": "Stark Industries",
        "saldo": 55000,
        "limite": 500000,
        "n": 3,
        "excede": false,
        "uso": 11
      }
    ]
  }
}

aging ist ein Array mit 4 festen Klassen, kein Objekt nach Tagesbereich: vigente (noch nicht fällig), d30 (1 bis 30 Tage überfällig), d60 (31 bis 60) und d60p (mehr als 60). status in items ist der tatsächliche Status des Angebots (approved oder invoiced); ist es überfällig, kommt overdue als true zurück, und diasVencido zählt die Tage.