Feil

Alle feil har samme form. Velg handling etter code, aldri etter message: teksten kan endres. requestId står også i X-Request-Id; oppgi den hvis du spør om hjelp.

Formen

En feil


HTTP/1.1 422 Unprocessable Entity
X-Request-Id: req_8f2KQx7Lp0aZtR4mWc1V
 
{
  "error": {
    "code": "customer_required",
    "message": "Ordren må ha en kunde. …",
    "requestId": "req_8f2KQx7Lp0aZtR4mWc1V",
    "docs": "https://vbeslag.com/utviklere/referanse#feil-customer_required"
  }
}

Felt	Hva det er
`code`	Koden. Den endres aldri, og den er det du velger handling etter.
`message`	En forklaring på norsk til deg som utvikler. Den kan endres.
`requestId`	Kallets id, den samme som i `X-Request-Id`. Ta den med når du skriver til oss.
`docs`	Lenken til koden i dokumentasjonen.

Noen feil har flere felt som sier mer: fields (hvilke felt eller linjer), requiredScope, feature, reason, existingNumber, id, nextPossibleDate og retryAfterSeconds. Forklaringen under sier hvilke.

En 4xx handler om kallet ditt: code og ekstrafeltene sier hva. En 500 eller 503 er hos oss, og 503 har Retry-After.

Alle feilkodene

Her er alle de 51 kodene, ordnet etter HTTP-status. Lenk rett til en kode med /feil#<kode>, for eksempel /feil#rate_limited.

400 Feil i det du sendte

Bad Request

invalid_cursorMarkøren (cursor) er ikke en vi har gitt ut.

invalid_jsonInnholdet er ikke gyldig JSON.

invalid_requestNoe i forespørselen er feil eller ukjent. fields sier hva.

401 Nøkkelen virker ikke

Unauthorized

unauthorizedNøkkelen mangler, er feil, er slått av eller har gått ut. En nøkkel som slås av, slutter å virke innen 1 minutt.

403 Nøkkelen har ikke lov

Forbidden

account_closedVerkstedet er stengt.

customer_key_not_allowedEn kundenøkkel kan ikke gjøre dette.

dpa_requiredVerkstedet må godta databehandleravtalen før koblinger kan brukes.

feature_not_in_planVerkstedet har ikke slått på delen dette trenger. feature sier hvilken.

insufficient_scopeNøkkelen har ikke lov til dette. requiredScope sier hvilken rett som mangler.

prices_hiddenButikken viser ikke prisene sine, så en kundenøkkel får ingen pris på beslagene. En verkstedsnøkkel får alltid prisen.

test_key_not_allowedEn testnøkkel kan ikke dette: den endrer aldri kunderegisteret, og et avrop er alltid en ekte ordre.

404 Finnes ikke for denne nøkkelen

Not Found

not_foundFant ikke dette.

405 Feil metode

Method Not Allowed

method_not_allowedDenne adressen tar ikke imot denne metoden.

409 Står i strid med det som er lagret

Conflict

already_invoicedOrdren er fakturert og kan ikke endres.

cancel_not_allowedOrdren kan ikke avbrytes nå. Ring verkstedet: arbeidet kan være i gang.

customer_existsEn kunde med dette org.nr. finnes allerede. id er kunden.

duplicate_external_refDu har allerede sendt en ordre med denne externalRef. existingNumber er ordrenummeret.

erp_owned_fieldNavn og org.nr. eies av regnskapet for denne kunden. Endre dem der.

idempotency_in_progressEn forespørsel med samme Idempotency-Key holder på. Prøv igjen om litt.

key_owner_missingBrukeren som laget nøkkelen finnes ikke lenger. Lag en ny nøkkel.

not_readyOrdren er ikke klar.

stale_versionOrdren er endret siden du leste den. Hent den på nytt og send med ny versjon.

status_conflictOrdren kan ikke flyttes dit fra statusen den har nå. reason sier hvorfor.

413 For stor

Payload Too Large

payload_too_largeFilen er for stor.

415 Feil filtype

Unsupported Media Type

unsupported_media_typeFiltypen tas ikke imot. Send JPEG, PNG, WebP, HEIC eller PDF.

422 Reglene sier nei

Unprocessable Entity

agreement_not_activeAvtalen tar ikke imot avrop: den er ikke godtatt, er utløpt eller erstattet, eller finnes ikke for denne nøkkelen. reason sier hvorfor.

contact_invalidKontakten trenger et navn og en e-post eller et norsk mobilnummer.

content_requiredOrdren må ha minst en linje eller en merknad (note) på minst 3 tegn.

customer_fixed_by_keyDenne nøkkelen hører til en kunde, og ordren må være for den kunden.

customer_invalidNoe i kundefeltene er feil. fields sier hva.

customer_requiredOrdren må ha en kunde. Send customer, eller contact med createCustomer: true.

date_invalidDatoen er ikke en gyldig dag (ÅÅÅÅ-MM-DD).

delivery_date_not_allowedAvtalen leverer ikke den dagen. nextPossibleDate er den første dagen som går.

idempotency_key_reusedDenne Idempotency-Key ble brukt på en annen forespørsel. Bruk en ny nøkkel for ny handling.

intent_not_allowedEn kundenøkkel sender forespørsler ("intent": "request"), eller avrop på en godtatt avtale (agreementNumber).

length_over_maxLengden er over det avtalen tillater (maxLengthMm). fields sier hvilken linje.

material_not_offeredBeslaget selges ikke i dette materialet. Materialene står på beslaget (GET /catalog/products/{id}).

orderer_requiredDenne kunden krever bestiller (orderer).

params_impossibleBeslaget kan ikke lages med disse målene. fields sier hvilken linje.

params_invalidEt mål mangler eller er utenfor det beslaget tillater. fields sier hvilken linje.

position_not_in_agreementPosisjonen hører ikke til denne avtalen. Hent posisjonene med GET /agreements/{number}. fields sier hvilken linje.

price_unavailableLinjen har ingen pris nå, for eksempel fordi avtalen ikke er godtatt eller har gått ut. fields sier hvilken linje.

project_no_requiredDenne kunden krever prosjektnummer (projectNo).

quantity_invalidAntallet må være mellom 1 og 500.

too_many_attachmentsOrdren har allerede så mange filer som den kan ha.

too_many_linesOrdren kan ha høyst 100 linjer.

428 En overskrift mangler

Precondition Required

idempotency_key_requiredSend Idempotency-Key med denne forespørselen.

precondition_requiredSend If-Match med versjonen du så, for eksempel "v3".

429 Over grensen

Too Many Requests

rate_limitedFor mange kall. Vent retryAfterSeconds sekunder.

500 Feil hos oss

Internal Server Error

internalNoe gikk galt hos oss. Feilen er meldt. Oppgi requestId hvis du spør.

503 Midlertidig nede

Service Unavailable

unavailableTjenesten er midlertidig nede. Prøv igjen senere.