Användning

Förhandsgranska en order

Varje slutförd order får en Vismaz-panel i Commerce egen ordervy, som visar hur ordern beskattas, varför den beskattas så, och vilka konton den bokförs på.

Preview bygger verifikatet utan att skicka det. Den kör samma byggare som den skarpa sändningen, med uppslag mot Visma avstängda, så den skapar ingenting i Visma. Det du ser är det som skulle bokföras — inte en ungefärlig bild av det.

Skicka

Send to Visma bokför nu. I verifikatläge dras en enskild order i stället in i periodens verifikat, eftersom det är där den hör hemma.

Slår du på Send automatically when an order completes lägger Vismaz ett jobb i kön när ordern slutförs. Det är ett köjobb och inte ett direktanrop, medvetet: ett driftstopp hos Visma, en utgången token eller en trög VIES-slagning får aldrig kunna hindra en kund från att betala.

Samlingsverifikat

Från Vismaz → Documents, välj ett datumintervall och tryck Send summary voucher. Eller från konsolen, där du kan repetera först:

php craft vismaz/sync/voucher --from=2026-08-01 --to=2026-08-31 --dryRun

Torrkörningen skriver ut verifikatet med debet och kredit och talar om huruvida det balanserar:

Webshop sales 2026-08-01 – 2026-08-31 (412 orders)

  Account                                            Debit         Credit
  1580     Settlement                            512 340,90
  6570     Payment fees                            7 685,10
  1580     Payment fees                                          7 685,10
  3001     Försäljning varor inom Sverige, 25 %                409 872,00
  2610     Utgående moms, 25 %                                 102 468,00
  3740     Öresavrundning                                            0,90

  Balances.

Ett verifikat som inte balanserar avvisas i stället för att skickas, med differensen namngiven. Visma avvisar det också, men dess felmeddelande säger inte vilken rad som är fel.

Krediteringar

Credit refunds skapar en kreditfaktura på det belopp som faktiskt har återbetalats. Den nycklas på återbetalningstransaktionerna snarare än på ordern, så en andra delåterbetalning ger en andra kreditfaktura medan ett nytt försök på den första inte gör det.

Vad som händer efter en sändning

Vismaz sparar fakturanumret eller verifikationsnumret Visma tilldelar, och stämmer sedan av summan Visma bokförde mot summan som skickades. Skiljer de sig — Vismas egen fakturaavrundning, en koppling som är subtilt fel — markeras verifikatet mismatched i stället för att rapporteras som skickat.

Det spelar roll eftersom en felaktig koppling inte kastar något fel. Den bokför fel belopp, tyst, och ingen märker det förrän någon stämmer av banken månader senare.

Ett verifikat med avvikelse ligger redan i Visma, så Vismaz erbjuder inget nytt försök — det skulle bokföra det en gång till. Rätta det för hand.

Göra om misslyckade sändningar

php craft vismaz/sync/retry

Misslyckade verifikat byggs om från ordern som den ser ut nu, inte återuppspelade från det sparade anropet. En order som rättats efter ett fel skickas i rättat skick.

OSS-rapporten

Vismaz → OSS report delar upp ett kvartal per destinationsland och momssats — den form deklarationen frågar efter. Den läser samma momsbedömningar som bokföringen byggdes på, så rapporten och bokföringen kan inte säga emot varandra.

SIE 4-export

För handlare som kör Visma Administration som skrivbordsprogram, vilket inte har något publikt API. Samma verifikat som annars hade bokförts skrivs till en .se-fil som redovisningskonsulten läser in för hand.

php craft vismaz/sie/export --from=2026-08-01 --to=2026-08-31 --path=./augusti.se

Eller hämta den från Vismaz → Documents. Ordrar som redan skickats till Visma utesluts som standard — att ta med dem också är hur en handlare bokför en månad två gånger.

Konsolreferens

php craft vismaz/sync/orders --dryRun --from=2026-08-01 --to=2026-08-31
php craft vismaz/sync/orders --from=2026-08-01 --to=2026-08-31
php craft vismaz/sync/voucher --from=2026-08-01 --to=2026-08-31 [--dryRun]
php craft vismaz/sync/retry
php craft vismaz/sie/export --from=… --to=… [--path=…] [--includeSynced]
php craft vismaz/auth/status
php craft vismaz/auth/refresh
php craft vismaz/log/prune [--days=30]

En torrkörning kräver ingen Visma-anslutning alls. Det är själva poängen med den.

Twig

{% if craft.vismaz.isConnected() %}
  {% set treatment = craft.vismaz.treatment(order) %}
  {{ treatment.getLabel() }} — {{ treatment.reason }}

  {% for document in craft.vismaz.documentsForOrder(order) %}
    {{ document.type }}: {{ document.vismaNumber ?? 'pending' }}
  {% endfor %}
{% endif %}