Developer Portal

Invoyo API

Integrer fakturering og egeninkasso i din applikasjon

Invoyo API lar deg automatisere fakturering, betalinger, kundebehandling og inkasso. Bruk REST API-et vårt til å bygge skreddersydde integrasjoner.

Hurtigstart – opprett en faktura:

bash

curl -X POST https://api.invoyo.ai/api/external/invoices \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cust_123",
    "totalAmount": 150000,
    "currency": "NOK",
    "dueDate": "2025-03-01"
  }'

Autentisering

Alle API-kall krever en gyldig API-nøkkel sendt som Bearer-token i Authorization-headeren.

Hvor finner du API-nøkkelen?

Logg inn på Invoyo og gå til Innstillinger → API for å opprette og administrere dine API-nøkler.

bash

curl https://api.invoyo.ai/api/external/invoices \
  -H "Authorization: Bearer YOUR_API_KEY"

Oppbevar API-nøkkelen sikkert. Del den aldri i frontend-kode eller offentlige repositorier.

Fakturaer

Opprett, hent og administrer fakturaer

Betalinger

Spor innbetalinger og betalingsstatus

Kunder

Administrer kunderegisteret ditt

Inkasso

Egeninkasso og purreprosesser

Webhooks

Registrer og administrer webhook-endepunkter

Webhook-hendelser

Når du registrerer en webhook, kan du velge hvilke hendelser du vil lytte på. Følgende hendelsestyper er tilgjengelige:

Hendelse	Beskrivelse
`invoice.created`	Faktura er opprettet
`invoice.sent`	Faktura er sendt til kunde
`invoice.paid`	Faktura er betalt
`invoice.overdue`	Faktura er forfalt
`payment.received`	Betaling er mottatt
`payment.matched`	Betaling er matchet mot faktura
`collect.case_created`	Inkassosak er opprettet
`collect.reminder_sent`	Purring er sendt
`collect.resolved`	Inkassosak er løst

Eksempel webhook-payload:

json

{
  "event": "invoice.paid",
  "timestamp": "2025-02-15T14:00:00Z",
  "data": {
    "invoiceId": "inv_abc123",
    "amount": 150000,
    "currency": "NOK",
    "paidAt": "2025-02-15T14:00:00Z"
  }
}

Feilkoder

Invoyo API bruker standard HTTP-statuskoder for å indikere om en forespørsel var vellykket.

Kode	Beskrivelse
`200`	OK – Forespørselen var vellykket
`201`	Created – Ressursen ble opprettet
`400`	Bad Request – Ugyldig forespørsel, sjekk parametere
`401`	Unauthorized – Manglende eller ugyldig API-nøkkel
`403`	Forbidden – Ingen tilgang til denne ressursen
`404`	Not Found – Ressursen ble ikke funnet
`409`	Conflict – Ressursen er i konflikt med nåværende tilstand
`422`	Unprocessable Entity – Valideringsfeil i data
`429`	Too Many Requests – For mange forespørsler, vent litt
`500`	Internal Server Error – Serverfeil, prøv igjen senere

Eksempel feilrespons:

json

{
  "error": {
    "code": "validation_error",
    "message": "Feltet 'totalAmount' er påkrevd",
    "details": [
      {
        "field": "totalAmount",
        "message": "Må være et positivt heltall (øre)"
      }
    ]
  }
}

Kodeeksempler

Her er eksempler på hvordan du oppretter en faktura i forskjellige språk:

bash

curl -X POST https://api.invoyo.ai/api/external/invoices \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cust_123",
    "totalAmount": 150000,
    "currency": "NOK",
    "dueDate": "2025-03-01",
    "lines": [
      {
        "description": "Konsulenttjenester",
        "quantity": 10,
        "unitPrice": 15000
      }
    ]
  }'

Klar til å integrere?

Opprett en konto og få din API-nøkkel på minutter.

Opprett konto Gå til API-innstillinger