Laat ons een factuur opbouwen in onze eigen app, en met één knop
definitief maken en naar de klant mailen via de boekhouding.
Verkoopfacturen zijn een prima voorbeeld van werk dat in twee systemen tegelijk hoort. Het opbouwen van een factuur is bedrijfswerk: welke regels, welk tarief, welke klant. Het versturen en het boeken is boekhoudwerk, en dat hoort in de boekhouding, niet in een eigen app.
Voor een café bouwden we dat zo: concept in de eigen app, en één knop die hem definitief maakt, boekt en mailt via Nmbrs Accounting. Het staat gebouwd en er is één echte factuur mee verstuurd, als test. De klant blijft anoniem en er staan hier geen bedragen, prijzen of marges.
Dit is wat we daarvan leerden. De eigenaardigheden van de API zelf staan in de Nmbrs Accounting-API.
Eén knop, drie dingen
De operatie waarmee je verkoopfacturen aanbiedt doet meer dan boeken. Je geeft per factuur een paar schakelaars mee, en die bepalen alles:
Verwerken, ja of nee. Staat die uit, dan komt de factuur als concept in de boekhouding en is er niets geboekt. Handig om één keer te kijken of je document goed is opgebouwd.
Mailen naar de klant, ja of nee. Staat die aan, dan verstuurt de boekhouding de factuur zelf naar het mailadres van het contact.
En daar zit de eerste les. Wij hadden al een eigen mailfunctie gebouwd, met een eigen afzender en een eigen tekst. Na drie dagen is die er weer uit gegaan. De boekhouding verstuurt vanuit het adres dat de klant kent, houdt bij dat er gemaild is en zet de factuur bij het contact. Dat alles nabouwen levert niets op behalve twee plekken waar iets fout kan gaan.
Je eigen opmaak mag mee, maar niet altijd
Wat wij wel wilden houden is de opmaak. De factuur die de klant krijgt, moet die van het bedrijf zijn, niet de standaardopmaak van een boekhoudpakket.
Dat kan: je stuurt je eigen PDF mee en de boekhouding bewaart en verstuurt die in plaats van zijn eigen versie. Bij ons geldt een grens van een paar megabyte per document, wat voor een factuur ruim is.
Hier zit wel een regel in die je één keer tegenkomt en dan nooit vergeet: je eigen PDF mag alleen mee als je de factuur ook echt verwerkt. Stuur je een concept mét document, dan weigert de boekhouding de hele factuur, met een melding dat verwerken aan moet staan als je een document meegeeft.
Dat heeft gevolgen voor je testopstelling. Een testfactuur die je niet wil boeken, gaat dus zonder PDF. In onze app bouwt de generator de document-elementen dan niet mee, en de controle vooraf keurt een onverwerkte factuur mét PDF af. Zo kan die combinatie niet per ongeluk de deur uit.
Niet elke regel een nieuw artikel
Elke factuurregel heeft in de boekhouding een artikel nodig, met een omschrijving, een prijs zonder btw, een percentage en een grootboekrekening. De verleiding is om per regel een artikel aan te bieden met de tekst van die regel erin.
Doe dat niet. Dan groeit de artikellijst in de boekhouding met elke factuur, en na een jaar is die lijst onbruikbaar voor degene die er echt mee werkt.
Wij werken met een vast artikel per regelsoort. Vijf soorten was genoeg: omzet tegen het hoge tarief, omzet tegen het lage tarief, overige omzet, een bijdrage van een leverancier, en emballage of statiegeld. Elke soort heeft een eigen grootboekrekening en een eigen btw-aanduiding, afgeleid uit de manier waarop de boekhouder het altijd deed. De tekst die de klant op zijn factuur ziet, staat in de omschrijving van de regel, niet in het artikel.
Let op dat de btw-aanduiding van het pakket niet hetzelfde is als het percentage. Er is een eigen lijst met soorten, waaronder vrijgesteld en nultarief naast hoog en laag. Vul je alleen het percentage, dan kan de boeking op de verkeerde rubriek belanden.
Het contact: niet opnieuw aanmaken
De grootste angst bij deze koppeling was een dubbel contact. Een boekhouding met twee keer dezelfde klant erin is maanden rommel.
Wat er gebeurde bij de eerste echte factuur: we stuurden het contact mee met naam, adres en onze eigen klantcode. De boekhouding koppelde dat op naam aan het bestaande contact, zette onze code op dat contact en vinkte het aan als klant. Er kwam geen tweede contact bij.
Dat is prettig gedrag, maar het betekent ook dat de naam die je meestuurt bepalend is. Stuur dus de naam zoals die in de boekhouding staat, niet de naam zoals iemand hem in jouw app typte.
Nummers, en wat je niet zelf verzint
Twee dingen die we bewust aan de boekhouding laten:
De betaaltermijn. We sturen geen vervaldatum mee. Die komt uit de instellingen van de boekhouding, en dan is er één plek waar hij veranderd wordt.
Het volgnummer. Voor het volgende nummer kijken we naar het hoogste nummer dat al in de boekhouding staat. Dat kost een aanroep, maar het voorkomt dat er twee reeksen naast elkaar gaan lopen.
Dat tweede bleek meer werk dan verwacht, want in een bestaande administratie staan nummers met tikfouten. Een jaartal dat niet klopt, een streepje op een vreemde plek. Onze lezer gaat daar tolerant mee om en negeert een volgnummer dat zo hoog is dat het geen nummer kan zijn. Anders springt je nummering door één tikfout ineens honderden vooruit.
Wat het antwoord je vertelt
Per aanroep gaat er één factuur de deur uit, en het antwoord zegt per factuur of hij gelukt is, of hij geboekt is en of de mail eruit is. Die drie zijn niet hetzelfde en we bewaren ze apart.
Bij een concept geeft de boekhouding je eigen nummer niet terug. Reken daar niet op in je verwerking.
Veelgemaakte fouten
Zelf gaan mailen. De boekhouding mailt vanuit het adres dat de klant kent en legt het vast. Eén afzender is beter dan twee.
Een concept met je eigen PDF aanbieden. Dat weigert de hele factuur. Concept zonder document, definitief met document.
Per factuurregel een nieuw artikel maken. Gebruik een vast artikel per regelsoort en zet de tekst in de regel.
Alleen het btw-percentage vullen. Vul ook de btw-aanduiding van het pakket, anders klopt de rubriek niet.
Je eigen nummerreeks bijhouden. Lees het hoogste nummer uit de boekhouding, en lees het tolerant.
Wat een koppeling op dit pakket kan doen, staat op Nmbrs koppelen. Wil je facturen uit je eigen app versturen, kijk dan op maatwerk.