- Dokumentasjon
- Kom i gang
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:
| Produkt | Hva som skjer |
|---|---|
| Faktura | faktura.sendt umiddelbart, faktura.levert etter 5–20 sekunder, faktura.betalt når du registrerer en innbetaling eller bruker et testscenario |
| Signering | Parter får en lenke til en testsigneringsside der du kan signere, avvise eller la fristen gå ut med knapper |
| Varsling | melding.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.
| Orgnr | Situasjon |
|---|---|
999900001 | Vanlig aktivt AS som kan motta EHF |
999900002 | Aktivt AS som ikke er i Peppol (faktura går som e-post) |
999900003 | Under konkursbehandling (status: "konkurs") |
999900004 | Slettet selskap (404 på oppslag, virksomhet.slettet som webhook) |
999900005 | Endrer daglig leder hvert 10. minutt (utløser virksomhet.roller_endret) |
999900006 | Avviser alle EHF-fakturaer (faktura.avvist med årsak) |
999900007 | Betaler alle fakturaer etter 60 sekunder (faktura.betalt) |
999900008 | Betaler aldri (utløser purreløp i hurtigmodus: dager blir minutter) |
For Varsling finnes tilsvarende testnumre:
| Mobil | Situasjon |
|---|---|
+4799990001 | Leveres på SMS |
+4799990002 | Har push-enhet, leveres på push |
+4799990003 | Alle kanaler feiler (melding.feilet) |
+4799990004 | Stå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å
kvalifisertsimuleres someid. - Brev via print-partner simuleres som sendt uten PDF-forhåndsvisning.