API: Angebote erstellen

Mit der Ressource cotizaciones (Angebote) erzeugen Sie dynamische Angebote aus Ihrem Backend – ideal für Integrationen mit Ihrem CRM oder ERP.

Angebot erstellen

Senden Sie einen POST an /api/v1/cotizaciones mit mindestens einer Position (erfordert die Berechtigung Schreiben):

curl -X POST https://cordhq.app/api/v1/cotizaciones \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "cliente_id": "customer-id",
    "terminos": "net30",
    "vigencia_dias": 15,
    "send": true,
    "items": [
      {
        "descripcion": "Annual ERP license",
        "cantidad": 1,
        "precio_unitario": 15000
      }
    ]
  }'

Antwort:

{ "data": { "id": "...", "folio": "COT-0149", "status": "sent", "link_publico": "/q/abc123" } }

Felder im Body:

• items (Pflichtfeld): Array von Positionen. Jede mit descripcion, cantidad, precio_unitario und optional producto_id, precio_negociado, costo_unitario und tax_rate (Anteil 0–1, z. B. 0.16; fehlt der Wert, gilt der Standardsatz Ihrer Organisation – die Steuer ist eine Angabe der Position, nicht des Dokuments).
• cliente_id (optional): ID eines bestehenden Kunden (legen Sie ihn mit API: Kunden verwalten an).
• cliente (optional, Alternative zu cliente_id): Objekt { empresa, email?, contacto?, telefono?, rfc? } für einen Kunden, den es noch nicht gibt – Cord sucht ihn in Ihrer Organisation nach Firma bzw. E-Mail und legt ihn an, wenn er nicht gefunden wird.
• terminos: contado (sofort fällig) oder net<N> für N Tage Zahlungsziel: net7, net15, net30, net45, net60, net90.
• vigencia_dias: Anzahl der Tage, die das Angebot gültig bleibt.
• notas: Freitext, der am Ende des Angebots erscheint.
• send: Bei true sendet Cord den öffentlichen Link beim Erstellen an die E-Mail-Adresse des Kunden.
• base_currency/fiscal_currency (optional): Währung, in der der Kunde das Angebot sieht, und Buchungswährung, in der abgerechnet wird, falls sie sich unterscheiden. fx_buffer_pct schlägt einen Puffer auf den festgeschriebenen Wechselkurs auf.
• iva_incluido (optional): Bei true enthalten die precio_unitario der Positionen bereits die Steuer.

Wichtig:

• Alle Beträge werden in Pesos angegeben (15000 = 15.000,00 MXN), nicht in Centavos.
• Die Summen (Steuern, Einbehalte und Währung) werden auf dem Server mit derselben Engine berechnet, die auch die App verwendet – verlassen Sie sich nie auf eine im Client berechnete Summe.
• link_publico ist der Pfad des Links, den Ihr Kunde sieht (/q/{token}); stellen Sie https://cordhq.app voran.

Angebote auflisten

curl "https://cordhq.app/api/v1/cotizaciones?status=sent&limit=50" \
  -H "Authorization: Bearer sk_live_your_key"

Gibt { "data": [ ... ], "meta": { "limit": 50, "offset": 0, "total": 87 } } zurück. Die Details eines Angebots (mit Positionen und Ereignissen) finden Sie unter GET /api/v1/cotizaciones/{id}.