Skip to content

Documentsjabloon · eu.trade.ioss_return

Import One-Stop Shop VAT Return

  • Rendering geverifieerd
  • Officieel document
  • Versie 1.0.0

Monthly IOSS return covering distance sales of imported goods with an intrinsic value not exceeding €150 sold to EU consumers. Filed in the member state of identification; VAT is allocated to each member state of consumption. The IOSS VAT ID on the customs declaration replaces import VAT for the end consumer.

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 28 velden:

Veld Verplicht Type Beschrijving
declarant Verplicht object
declarant.name Verplicht string
declarant.ioss_id Verplicht string IOSS VAT identification number (IMxxxyyyyy).
declarant.member_state_of_identification Verplicht string
declarant.intermediary_name Optioneel string Required for non-EU suppliers using an intermediary per Art. 369m.
declarant.address Optioneel string
declarant.contact_email Optioneel string
period Verplicht object
period.year Verplicht integer
period.month Verplicht integer
supplies Verplicht array of object
supplies[].member_state_of_consumption Verplicht string
supplies[].vat_rate_type Verplicht enum
supplies[].vat_rate Verplicht number
supplies[].taxable_amount Verplicht number
supplies[].vat_amount Verplicht number
supplies[].consignment_count Optioneel integer Number of consignments (low-value parcels) in this line.
corrections Optioneel array of object
corrections[].period_corrected Verplicht string YYYY-MM 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
totals.total_consignments Optioneel integer
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
curl -X POST https://api.papii.eu/render \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "eu.trade.ioss_return",
    "data": { ... },
    "options": {"language": "nl"}
  }' -o ioss-return.pdf

Veelgestelde vragen

Wat is een “Import One-Stop Shop VAT Return”?

Monthly IOSS return covering distance sales of imported goods with an intrinsic value not exceeding €150 sold to EU consumers. Filed in the member state of identification; VAT is allocated to each member state of consumption. The IOSS VAT ID on the customs declaration replaces import VAT for the end consumer. Op papii is dit document beschikbaar als sjabloon eu.trade.ioss_return: een JSON-schema plus een deterministische PDF-renderer — dezelfde data levert altijd hetzelfde document op.

Kan ik een “Import 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 “Import 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.