Skip to Content

Endringer

Endringslisten under er den samme som i OpenAPI-dokumentet  (info.x-changelog), nyeste først. v1 lever i minst tolv måneder etter at v2 kommer. Nye felt, operasjoner og hendelser kan komme i v1; noe som fjernes eller endres, kommer først i v2.

Siste versjon av dokumentet: 1.19, 6. oktober 2026.

18 endringer
  • En ordre har nå production: hvor mange bøyeark den har (bendingSheets), hvor mange som er bøyd (bent) og hvor mange som venter på at kunden godkjenner (waitingForCustomer). Feltet er null når verkstedet ikke har Produksjon, og for en kundenøkkel. Det følger ordren i svarene fra ordreoperasjonene, ikke i webhooks eller GET /events.
  • GET /orders/{number}/bending-sheets gir gjeldende versjon av hvert bøyeark på en ordre, etter arknummer. Alle sju operasjonene for Produksjon står nå under «Produksjon» i referansen. Et verksted uten Produksjon får 403 feature_not_in_plan med feature: "produksjon" før noe leses.
  • Produksjon i API-et: hent et bøyeark med profil, utbrett og godkjenning, som PDF eller som DXF av platen; dagens bøyeliste som JSON eller CSV, for alle kantbenker eller en; kantbenkene; og «Bøyd» fra maskinen eller planleggingsprogrammet. For verkstedets nøkler med production:read og production:status, når Produksjon er slått på.
  • De fire operasjonene for nettbutikken står nå under «Nettbutikk» i referansen. POST /delivery-quotes tar subtotalOre, summen av handlekurven i øre, så prisen blir den samme som i kassen når et leveringsvalg er gratis over en sum; uten den regnes leveringen som før. POST /orders/{number}/payment-link krever at kortbetaling er slått på i tillegg til nettbutikken: ellers svarer den 403 feature_not_in_plan med feature: "shop_payments".
  • Nettbutikken i API-et: GET /shop (adresse, kassen, leveringsvalg og vilkår), POST /delivery-quotes (leveringen regnet som i kassen), POST /orders/{number}/payment-link (betalingslenke for en mottatt ordre, bare verkstedets nøkler) og GET /orders/{number}/payments (betalingene, aldri en id hos Stripe). Ingen nye tilganger.
  • Nytt: GET /reports/months/{month} gir tallene for en måned (ordrer, fakturert, betalt og utestående) som summer, aldri kundenavn. Krever reports:read og en nøkkel for verkstedet, ikke en kundenøkkel. GET /me viser nå modulene som er slått på, og avdelingene når verkstedet har to eller flere.
  • Fakturaer: GET /invoices (sendte fakturaer, kreditnotaer og «Fakturert i regnskapet»; utkast bare med includeDrafts=true), GET /invoices/{id} med linjer, KID og ordrene den dekker, og GET /invoices/{id}/pdf, laget på serveren av den utstedte fakturaen. Krever invoices:read og Kontor. Status på bokmål; beløp i hele øre.
  • Avtaler i API-et: GET /agreements og GET /agreements/{number} viser avtalene med posisjoner, leveringsdager og pristabell (pris per stykk ved hver platelengde). Aldri et utkast. En kundenøkkel ser bare sin egen kundes avtaler. Et avrop er en ordre.
  • POST /prices tar discountCode og deliveryOptionId og regner rabatten og frakten som kassen i nettbutikken: shippingOre er frakten, den nye discountOre er rabatten, og grossOre blir det samme som en bestilling i butikken. En linje som ikke kan prises, svarer med sin egen kode: params_invalid, params_impossible, material_not_offered og price_unavailable (422) og prices_hidden (403). Product og ProductList har fått navn i dokumentet. drawingUrl og 3D-modellen i media kommer.
  • Katalog og priser er åpne: GET /catalog/library (beslagsbiblioteket verkstedet kan selge), GET /catalog/products og GET /catalog/products/{id} (beslagene i nettbutikken, med ETag) og POST /prices (pris fra den samme prismotoren som butikken og kalkylen, opptil 50 linjer, ingenting lagres).
  • Avrop med POST /orders: agreementNumber og linjer av typen position (positionId, lengthMm, quantity) gir en ordre som er Mottatt, med avtalens priser og source: "avrop". Nye feilkoder: agreement_not_active, position_not_in_agreement, length_over_max og delivery_date_not_allowed (med nextPossibleDate). GET /orders?agreementNumber= lister avropene på en avtale. GET /agreements og GET /invoices tar limit og cursor som alle lister.
  • En kundenøkkel med invoices:read kan nå lese sin egen kundes sendte fakturaer: GET /invoices, GET /invoices/{id} og PDF-en. Aldri et utkast, og en annen kundes faktura svarer 404.
  • «Send videre»: en ordre verkstedet sender videre til et annet verksted i Beslagsnettet, får hendelsen order.forwarded, ikke order.cancelled. Lytter du etter order.cancelled for å se at en ordre går ut av listen, lytt også etter order.forwarded.
  • Webhooks for avtaler og fakturaer sender nå det samme objektet som GET /agreements/{number} og GET /invoices/{id} (Agreement og Invoice; WebhookAgreement og WebhookInvoice er borte): en avslått avtale har status avvist, en utløpt utlopt, og validUntil og leadDays kan være null; et utkast og «Fakturert i regnskapet» har ingen forfallsdag eller KID, currency er alltid NOK, og en fakturalinjes unit er alltid null.
  • Sju nye webhooks (28 i alt): order.prepaid (betalt på nett, med payment) og order.refunded (med refund) fra Nettbutikk, order.forwarded fra Beslagsnettet, og bending_sheet.sent_for_approval, bending_sheet.approved, bending_sheet.change_requested og bending_sheet.bent fra Produksjon, med gruppen bending_sheet.*. Et bøyeark i en hendelse er WebhookBendingSheet; hele arket får du med GET /bending-sheets/{id}. En kundenøkkels adresse får betalingen, refusjonen og bøyearkene til godkjenning for sin egen kunde, aldri «Bøyd».
  • En ordre kan nå komme fra Min side (source «portal») og fra Beslagsnettet (source «nettverk»). Feltet source kan derfor ha to nye verdier i listOrders og getOrder.
  • Nye tilganger for verkstedets nøkler: production:read, production:status og reports:read. Nye formål på nøkkelen: maskin, regneark og leverandor. En kundenøkkel kan nå ha invoices:read. GET /me kan vise modulene som er slått på og avdelingene.
  • Webhooks for avtaler (sendt, godtatt, avslått), fakturaer (sendt, betalt), kunder (ny, endret) og «Merk som omarbeid». Hendelsene har avtalen, fakturaen eller kunden slik den var da hendelsen ble sendt.

1 endring
  • Første versjon: nøkler, GET /me, ordre (lese, sende inn, endre, bekrefte, avbryte, status, filer, tidslinje), kunder og prosjekter, GET /events og webhooks med signatur.