API: Opret tilbud med linjer

Når et tilbud skal have prislinjer, der kan vises på den offentlige side og kopieres til Dinero: Opret faktura, skal linjerne gemmes på tilbuddet.

Artiklen er til integratorer, der opretter tilbud via REST API.

Forudsætninger

• API-nøgle med write-adgang til tilbud
• En virksomhed i workspacet (companyRef), hvis tilbuddet skal knyttes til CRM

Sådan gør du

1. Kald POST /api/v1/offers
2. Send title og lineItems
3. Hver linje skal have name (eller description), quantity og unitPrice
4. Tjek svaret: calculatorResult.lineItems har to rækker med et server-genereret id
5. Send tilbuddet med POST /api/v1/offers/:id/send

Eksempel:

{
  "title": "Testtilbud",
  "companyRef": "<virksomheds-id>",
  "lineItems": [
    { "name": "Linje A", "quantity": 2, "unit": "stk", "unitPrice": 123.45, "vatRate": 25 },
    { "name": "Linje B", "quantity": 3, "unit": "stk", "unitPrice": 67.89, "vatRate": 25 }
  ]
}

Resultat

Tilbuddet gemmes som kladde med linjer. Brug tilbudslinjer i en Dinero-automation kan kopiere dem efter accept.

Fejlsøgning

Symptom	Løsning
HTTP 400	Tjek at hver linje har antal og enhedspris
Offentlig side viser ingen produkter	Tilbuddet har tomme linjer. Brug lineItems, ikke kun totaler
Dinero: ingen linjer	Acceptér først et tilbud hvor GET viser linjer i calculatorResult.lineItems

calculatorResult er readback. I kan sende den ved oprettelse, men lineItems er den rigtige write-kontrakt.

Relateret

• API: Tilbuds- og e-mailskabeloner
• Opret dit første tilbud
• Opret Dinero-faktura