Documentsjabloon · eu.trade.oss_return
One-Stop Shop VAT Return
- Rendering geverifieerd
- Officieel document
- Versie 1.0.0
Quarterly OSS return covering B2C distance sales of goods and B2C telecommunications/broadcasting/electronic services supplied from one member state into another, above the €10 000 EU-wide threshold. Filed in the member state of identification; VAT is allocated to each member state of consumption.
JSON Schema
Velden in dit sjabloon
Data die naar de API wordt gestuurd, wordt gevalideerd tegen het JSON-schema van het sjabloon vóór er iets wordt gerenderd. Dit sjabloon definieert 27 velden:
| Veld | Verplicht | Type | Beschrijving |
|---|---|---|---|
| declarant | Verplicht | object | |
| declarant.name | Verplicht | string | |
| declarant.oss_id | Verplicht | string | OSS scheme identifier (often EUxxxyyyyy). |
| declarant.member_state_of_identification | Verplicht | string | |
| declarant.address | Optioneel | string | |
| declarant.contact_email | Optioneel | string | |
| period | Verplicht | object | |
| period.year | Verplicht | integer | |
| period.quarter | Verplicht | integer | |
| scheme | Optioneel | enum | Union scheme (EU suppliers) vs non-Union scheme (non-EU suppliers of services). Union by default. |
| supplies | Verplicht | array of object | One entry per member state of consumption × VAT rate. |
| supplies[].member_state_of_consumption | Verplicht | string | |
| supplies[].supply_type | Verplicht | enum | |
| supplies[].vat_rate_type | Verplicht | enum | |
| supplies[].vat_rate | Verplicht | number | |
| supplies[].taxable_amount | Verplicht | number | |
| supplies[].vat_amount | Verplicht | number | |
| corrections | Optioneel | array of object | Corrections to earlier OSS returns (Art. 61a IR 282/2011). |
| corrections[].period_corrected | Verplicht | string | YYYY-Qn of the period being corrected. |
| corrections[].member_state_of_consumption | Verplicht | string | |
| corrections[].vat_amount_adjustment | Verplicht | number | |
| totals | Verplicht | object | |
| totals.currency | Verplicht | string | |
| totals.total_taxable_amount | Optioneel | number | |
| totals.total_vat_due | Verplicht | number | |
| filed_on | Optioneel | date | |
| reference | Optioneel | string |
POST /render
Genereer het
Eén POST /render-oproep: stuur je JSON, ontvang de afgewerkte PDF. Of sla de JSON over en beschrijf het document in gewone taal op chut.app.
curl -X POST https://api.papii.eu/render \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"template": "eu.trade.oss_return",
"data": { ... },
"options": {"language": "nl"}
}' -o oss-return.pdf Veelgestelde vragen
Wat is een “One-Stop Shop VAT Return”?
Quarterly OSS return covering B2C distance sales of goods and B2C telecommunications/broadcasting/electronic services supplied from one member state into another, above the €10 000 EU-wide threshold. Filed in the member state of identification; VAT is allocated to each member state of consumption. Op papii is dit document beschikbaar als sjabloon eu.trade.oss_return: een JSON-schema plus een deterministische PDF-renderer — dezelfde data levert altijd hetzelfde document op.
Kan ik een “One-Stop Shop VAT Return” genereren met AI?
Ja. chut.app — de AI-backoffice aangedreven door papii — vult dit sjabloon in op basis van een beschrijving in gewone taal: jij beschrijft het document in één zin, de AI structureert de data, papii valideert die tegen het schema en rendert de PDF. Ontwikkelaars kunnen de papii-API ook rechtstreeks aanroepen met gestructureerde JSON.
Is het sjabloon “One-Stop Shop VAT Return” juridisch conform?
Dit sjabloon heeft een geverifieerde rendering: het schema, de voorbeelddata en de PDF-uitvoer worden bij elke release automatisch getest. Het is gepubliceerd met status “ready”, wat betekent dat het de finale juridische review van papii nog niet heeft doorlopen. Waar het naar specifieke wetgeving verwijst, staat dat vermeld in de sjabloonbeschrijving — laat documenten met juridische gevolgen altijd door een professional nakijken voor je erop vertrouwt.