B2B-ApiFactureren met buitenlandse BTW (OSS)
Vanaf 1 juli 2021 kan een ondernemer de in andere EU-landen verschuldigde btw via de OSS-portal van de Nederlandse Belastingdienst aangeven. Dit doe je met een aanmelding voor de 'Unieregeling'. Je hebt dan geen btw-registratie in andere EU-landen nodig. Voor meer informatie zie informatie van de Belastingdienst.
Instelling in Desktop SnelStart 12 applicatie
Hiervoor dient de klant een instelling te zetten in Desktop (SnelStart 12).
Wanner deze instelling is gezet komt er een VAT model beschikbaar naast het bestaande Nederlandse btw model van SnelStart.
Om gebruik te maken van het VAT model dient de gebruiker bij grootboekrekeningen met functie 84 een VAT tarief te kiezen.
Vervolgens is het aan de gebruiker om deze grootboekrekeningen te koppelen aan de juiste artikelomzetgroep, zodat het juiste VAT percentage wordt berekend voor het artikel op de order, adhv het afleveradres van de klant.
Voor testdoeleinden hebben we de volgende aanpassingen gedaan:
Het is mogelijk om een PUT te doen op Companyinfo waarmee “factureerBuitenlandsBtw" op true kan worden gezet.
Hiervoor dienen er geen grootboekrekeningen te zijn met een functie: ‘InstallatieTeleverkoopBinnenEUgeen’ omdat icm "factureerBuitenlandsBtw" er een Vattarief verplicht is op deze grootboekrekening.
Dit kun je aanpassen door eerst de grootboeken te verwijderen via desktop.
Vervolgens het vinkje te zetten en grootboekrekeningen aanmaken met functie ‘InstallatieTeleverkoopBinnenEUgeen’.
Dan kan er een boeking of order worden ingeschoten voor een klant binnen EU zonder btw nummer met datum op of na 01-07-2021 of vanaf datum dat vinkje is gezet na 01-07-2021.
Deze boeking zal geboekt worden met VAT ipv btw.
Het is mogelijk om de vat-tarieven op te halen dmv /v2/vatrates, zie b2b developerportal.
Stappenplan setting en grootboekrekeningen
Stap 1:
Voer de volgende odata query uit om alle grootboeken met functie 'InstallatieTeleverkoopBinnenEUgeen' te krijgen die geen VatRateCode hebben:
GET /grootboeken?$select=Nummer, Omschrijving&$filter=Grootboekfunctie eq 'InstallatieTeleverkoopBinnenEUgeen' and VatRateCode eq null
Stap 2:
Verwijder in SnelStart Desktop alle grootboeken uit Stap 1 of geef de grootboeken een andere functie
Stap 3:
Controleer of er geen grootboeken meer zijn met de functie 'InstallatieTeleverkoopBinnenEUgeen' zonder VatRateCode. De volgende odata query zal dan een leeg resultaat geven
GET /grootboeken?$select=Nummer, Omschrijving&$filter=Grootboekfunctie eq 'InstallatieTeleverkoopBinnenEUgeen' and VatRateCode eq null
Stap 4:
Geef aan dat je buitenlandse btw wilt facturen:
PUT /CompanyInfo
{
"factureerBuitenlandsBtw": true
}
Stap 5:
Maak nieuwe grootboeken met functie 'InstallatieTeleverkoopBinnenEUgeen' en een VatRateCode. De VatRateCode mag 1 van de volgende waarden zijn (SR, RRH, RRL, PR, SRR)
POST /grootboeken
{
"omschrijving": "Grootboek met Standard Rate",
"kostenplaatsVerplicht": false,
"rekeningCode": "WinstEnVerlies",
"nonactief": false,
"nummer": 8077,
"grootboekfunctie": "InstallatieTeleverkoopBinnenEUgeen",
"vatRateCode" : "SR"
}
Wat houdt dit in voor jouw koppeling:
Op verkoopboekingen zijn drie condities toegevoegd:
- Indien vinkje actief en klant is een EU particulier dan geen btw op de verkoopboeking accepteren indien datum op/na 1-7-2021 valt
- Indien vinkje actief en klant is een EU particulier dan alle grootboeken die meegegeven worden in de boeking hebben een functie ‘InstallatieTeleverkoopBinnenEUgeen’ op een grootboek of het grootboek is het BuitenlandseBTWboeking (op te halen in de companysettings)
- Het totaal bedrag aan BuitenlandseBTWboeking is gelijk aan de som van de te betalen btw van de grootboeken met functies ‘InstallatieTeleverkoopBinnenEUgeen’
- om afrondingsverschillen te voorkomen is een het totaal +- 1 cent per regel
Een klant is een particulier als er geen btw nummer op de klantkaart staat.
Om een verkoopboeking te kunnen maken dien je het volgende te doen:
De CompanySettings uitlezen om te bepalen of buitenlandse Btw geboekt moet worden of dat er ‘normale btw’ geboekt mag worden (factureerBuitenlandsBtw). Bij deze company settings staat ook het grootboek waar de Btw op geboekt moet worden (buitenlandseBtwGrootboek)
Voorbeeld:
Call: /companyInfo
Response body:
……..
"buitenlandseBtwGrootboek": {
"id": "e7f09202-c0da-4175-80b9-265db0f18afc",
"uri": "/grootboeken/e7f09202-c0da-4175-80b9-265db0f18afc"
},
"factureerBuitenlandsBtw": true
De verkoopboeking kan nu als volgt worden ingeschoten:
Voorbeeld:
Post /verkoopboekingen
"factuurbedrag": 500,
"betalingstermijn": 0,
"eenmaligeIncassoMachtiging": null,
"doorlopendeIncassoMachtiging": null,
"boekingsregels": [
{
"omschrijving": "Duits",
"grootboek": {
"id": "e7f09202-c0da-4175-80b9-265db0f18afc",
"uri": "/grootboeken/e7f09202-c0da-4175-80b9-265db0f18afc"
},
"kostenplaats": null,
"bedrag": 100,
"btwSoort": "Geen"
},
{
"omschrijving": "Duits",
"grootboek": {
"id": "26f9f109-2714-4759-8307-63e79e687415",
"uri": "/grootboeken/26f9f109-2714-4759-8307-63e79e687415"
},
"kostenplaats": null,
"bedrag": 400,
"btwSoort": "Geen"
}
In de verkooporders is niets gewijzigd, SnelStart rekent de te betalen VAT uit en boekt op grootboekrekening gekoppeld aan de artikelomzetgroep
{
"relatie": {
"id": "96588D87-DE68-4345-A999-F7F4ED07A9DC",
"uri": "/relaties/96588D87-DE68-4345-A999-F7F4ED07A9DC"
},
"procesStatus": "Pakbon",
"datum": "2022-01-01T00:00:00",
"krediettermijn": 0,
"omschrijving": "POST regel ex btw",
"betalingskenmerk": "Nieuw 16",
"incassomachtiging": null,
"verkooporderBtwIngaveModel": "Exclusief",
"kostenplaats": null,
"verkoopordersjabloon": {
"id": "00000000-0000-0000-0000-000000000000",
"uri": "/verkoopordersjablonen/00000000-0000-0000-0000-000000000000"
},
"regels": [
{
"artikel": {
"id": "36cda20f-3b9b-4abe-8764-d0ec4b869707",
"uri": "/artikelen/36cda20f-3b9b-4abe-8764-d0ec4b869707"
},
"omschrijving": "Artikel 9000135 BTW Overig",
"stuksprijs": 35.00,
"aantal": 100,
"kortingsPercentage": 10,
"extraRegelVelden": []
}
],
}
Het aantal en de stuksprijs maakt het totaal. Tijdens het factureren wordt de Vat berekend aan de hand van hoe de order is ingeschoten (Inclusief/ Exclusief)