Hopp til innhold
↑ ↓ navigerEnter åpneEsc lukk

Sandkassen

Et fullt miljø for testing, gratis på alle planer. Ekte registerdata for Oppslag og Adresse, simulerte flyter for Faktura, Signering og Varsling.

Sandkassen er et komplett miljø på https://sandkasse.spireapi.com med samme API, samme SDK og samme webhooks som produksjon. Kall i sandkassen er gratis og teller ikke mot kvoten.

Hva som er ekte

Oppslag og Adresse bruker et øyeblikksbilde av de ekte registrene, oppdatert den første hver måned. Du kan slå opp hvilket som helst norsk selskap og hvilken som helst adresse, og svarene har samme form som i produksjon. Forskjellen er at dataene ikke oppdateres fortløpende, og at webhooks for registerendringer ikke sendes (bortsett fra for testselskapene under).

Hva som er simulert

Faktura, Signering og Varsling gjør ingenting mot omverdenen i sandkassen. Ingen EHF sendes, ingen e-post går ut, ingen SMS leveres. I stedet simulerer Spire flyten med realistiske forsinkelser og sender de samme webhookene som i produksjon:

ProduktHva som skjer
Fakturafaktura.sendt umiddelbart, faktura.levert etter 5–20 sekunder, faktura.betalt når du registrerer en innbetaling eller bruker et testscenario
SigneringParter får en lenke til en testsigneringsside der du kan signere, avvise eller la fristen gå ut med knapper
Varslingmelding.levert etter 1–3 sekunder, med simulert kanal basert på reglene dine

Testselskaper og scenarioer

Sandkassen har et sett oppdiktede organisasjonsnumre som utløser bestemte situasjoner. Organisasjonsnumrene begynner alle på 999 9, som ikke brukes i det ekte registeret.

OrgnrSituasjon
999900001Vanlig aktivt AS som kan motta EHF
999900002Aktivt AS som ikke er i Peppol (faktura går som e-post)
999900003Under konkursbehandling (status: "konkurs")
999900004Slettet selskap (404 på oppslag, virksomhet.slettet som webhook)
999900005Endrer daglig leder hvert 10. minutt (utløser virksomhet.roller_endret)
999900006Avviser alle EHF-fakturaer (faktura.avvist med årsak)
999900007Betaler alle fakturaer etter 60 sekunder (faktura.betalt)
999900008Betaler aldri (utløser purreløp i hurtigmodus: dager blir minutter)

For Varsling finnes tilsvarende testnumre:

MobilSituasjon
+4799990001Leveres på SMS
+4799990002Har push-enhet, leveres på push
+4799990003Alle kanaler feiler (melding.feilet)
+4799990004Står i reservasjonslisten (melding.reservert)

Hurtigmodus for tid

Purreløp, påminnelser og frister opererer i dager. I sandkassen kan du sette hodet Spire-Sandkasse-Tid: hurtig på et kall, så tolkes alle dager som minutter for objektet som opprettes. En faktura med forfall om 14 dager forfaller etter 14 minutter, og purring kommer etter ytterligere 14.

Nullstilling

Sandkassen kan nullstilles fra dashbordet eller med POST /v1/sandkasse/nullstill. Alle fakturaer, signeringer, meldinger og webhooks du har opprettet slettes. Registerdataene berøres ikke. Nyttig i CI: nullstill før hver testkjøring.

Begrensninger

  • Hastighetsgrensen er 20 kall per sekund uansett plan.
  • Objekter slettes automatisk etter 30 dager.
  • Signeringsnivå kvalifisert simuleres som eid.
  • Brev via print-partner simuleres som sendt uten PDF-forhåndsvisning.
Sist oppdatert 22. oktober 2026 Fant du en feil? Si fra, så retter vi innen en virkedag.