{"openapi":"3.1.0","info":{"title":"Winstwaker Developer API","version":"1.0.0","description":"Officiële v1 API voor Winstwaker developer integraties. Inclusief credits, usage, omzetbelasting, ICP, OSS, dividendbelasting, vennootschapsbelasting en inkomstenbelasting-uitstel flows.","contact":{"name":"Winstwaker Developer Support","url":"https://winstwaker.nl/developers"}},"servers":[{"url":"https://api.winstwaker.nl/v1","description":"Winstwaker v1 API (live + test mode via API key prefix)."}],"tags":[{"name":"Health"},{"name":"Credits"},{"name":"Usage"},{"name":"Omzetbelasting"},{"name":"ICP"},{"name":"OSS"},{"name":"Dividendbelasting"},{"name":"Vennootschapsbelasting"},{"name":"Inkomstenbelasting uitstel"}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Gebruik `ww_live_...` of `ww_test_...` als Bearer token."}},"headers":{"XRequestId":{"description":"Unieke request-id voor tracing.","schema":{"type":"string","format":"uuid"}},"XRateLimitLimit":{"description":"Maximaal aantal requests in huidig minuutvenster.","schema":{"type":"integer"}},"XRateLimitRemaining":{"description":"Resterende requests in huidig minuutvenster.","schema":{"type":"integer"}},"XRateLimitReset":{"description":"ISO timestamp wanneer het huidige rate-limit venster reset.","schema":{"type":"string","format":"date-time"}}},"schemas":{"SuccessEnvelope":{"type":"object","additionalProperties":false,"properties":{"ok":{"type":"boolean","const":true},"request_id":{"type":"string","format":"uuid"},"mode":{"type":["string","null"],"enum":["live","test",null]},"status":{"type":["string","null"]},"message":{"type":"string"},"data":{"type":["object","array","string","number","boolean","null"]},"breakdown":{"type":["object","null"]},"errors":{"type":"null"}},"required":["ok","request_id","mode","status","message","data","breakdown","errors"]},"ErrorEnvelope":{"type":"object","additionalProperties":false,"properties":{"ok":{"type":"boolean","const":false},"request_id":{"type":"string","format":"uuid"},"mode":{"type":["string","null"],"enum":["live","test",null]},"status":{"type":"string","const":"ERROR"},"message":{"type":"string"},"data":{"type":"null"},"breakdown":{"type":"null"},"errors":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"details":{"type":["object","array","string","number","boolean","null"]}},"required":["code","details"]}},"required":["ok","request_id","mode","status","message","data","breakdown","errors"]},"HealthResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"status":{"type":"string","enum":["operational","degraded"]},"timestamp":{"type":"string","format":"date-time"},"error":{"type":"string"}},"required":["ok","service","status","timestamp"]},"CreditBalanceItem":{"type":"object","properties":{"mode":{"type":"string","enum":["live","test"]},"balance_cents":{"type":"integer"},"balance_eur":{"type":"number"},"updated_at":{"type":"string","format":"date-time"}},"required":["mode","balance_cents","balance_eur","updated_at"]},"CreditEvent":{"type":"object","properties":{"id":{"type":"integer"},"request_id":{"type":["string","null"],"format":"uuid"},"api_key_id":{"type":["integer","null"]},"event_type":{"type":"string"},"amount_cents":{"type":"integer"},"amount_eur":{"type":"number"},"balance_after_cents":{"type":"integer"},"balance_after_eur":{"type":"number"},"metadata":{"type":["object","array","string","number","boolean","null"]},"created_at":{"type":"string","format":"date-time"}},"required":["id","request_id","api_key_id","event_type","amount_cents","amount_eur","balance_after_cents","balance_after_eur","metadata","created_at"]},"UsageSummaryData":{"type":"object","properties":{"period":{"type":"string","enum":["day","month"]},"successful":{"type":"integer"},"failed":{"type":"integer"},"blocked":{"type":"integer"},"pending":{"type":"integer"}},"required":["period","successful","failed","blocked","pending"]},"VatData":{"type":"object","properties":{"1a_grondslag":{"type":"number"},"1a_btw":{"type":"number"},"1b_grondslag":{"type":"number"},"1b_btw":{"type":"number"},"1c_grondslag":{"type":"number"},"1c_btw":{"type":"number"},"1d_grondslag":{"type":"number"},"1d_btw":{"type":"number"},"1e_grondslag":{"type":"number"},"2a_grondslag":{"type":"number"},"2a_btw":{"type":"number"},"3a_grondslag":{"type":"number"},"3b_grondslag":{"type":"number"},"4a_grondslag":{"type":"number"},"4a_btw":{"type":"number"},"4b_grondslag":{"type":"number"},"4b_btw":{"type":"number"},"5_verschuldigd":{"type":"number"},"5b_voorbelasting":{"type":"number"},"totaal":{"type":"number"}}},"VatReturnCreate":{"type":"object","properties":{"ob_nummer":{"type":"string","pattern":"^NL[0-9]{9}B[0-9]{2}$"},"obNummer":{"type":"string","pattern":"^NL[0-9]{9}B[0-9]{2}$"},"periode":{"type":"string","pattern":"^[0-9]{4}-Q[1-4]$"},"year":{"type":"integer","minimum":2000,"maximum":2100},"quarter":{"type":"integer","minimum":1,"maximum":4},"vatData":{"$ref":"#/components/schemas/VatData"},"vat_data":{"$ref":"#/components/schemas/VatData"},"omzet":{"type":"number"},"btw_hoog":{"type":"number"}},"description":"Minimaal: geldig ob_nummer/obNummer + periode (YYYY-Q1..Q4) of year+quarter + inhoudelijke BTW data. Quickstart: omzet + btw_hoog."},"ICPEntry":{"type":"object","properties":{"country_code":{"type":"string","pattern":"^[A-Z]{2}$"},"countryCode":{"type":"string","pattern":"^[A-Z]{2}$"},"vat_number":{"type":"string"},"vatNumber":{"type":"string"},"full_vat_number":{"type":"string"},"fullVatNumber":{"type":"string"},"type":{"type":"string","enum":["L","D","B"]},"supplies_amount":{"type":"number"},"suppliesAmount":{"type":"number"},"services_amount":{"type":"number"},"servicesAmount":{"type":"number"},"total_amount":{"type":"number"},"totalAmount":{"type":"number"},"customer_name":{"type":"string"},"customerName":{"type":"string"}},"description":"Gebruik bij voorkeur country_code + vat_number + supplies/services splitsing. total_amount zonder split vereist type L of D.","example":{"country_code":"BE","vat_number":"0123456789","type":"D","services_amount":1250,"customer_name":"Acme Belgium BV"}},"ICPReturnCreate":{"type":"object","properties":{"ob_nummer":{"type":"string","pattern":"^NL[0-9]{9}B[0-9]{2}$"},"obNummer":{"type":"string","pattern":"^NL[0-9]{9}B[0-9]{2}$"},"periode":{"type":"string","pattern":"^[0-9]{4}-Q[1-4]$"},"year":{"type":"integer","minimum":2000,"maximum":2100},"quarter":{"type":"integer","minimum":1,"maximum":4},"entries":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/ICPEntry"}},"icp_entries":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/ICPEntry"}},"icpEntries":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/ICPEntry"}}},"description":"Minimaal: geldig ob_nummer/obNummer + periode (YYYY-Q1..Q4) of year+quarter + 1 of meer ICP entries.","example":{"ob_nummer":"NL123456789B01","periode":"2026-Q1","entries":[{"country_code":"BE","vat_number":"0123456789","type":"D","services_amount":1250,"customer_name":"Acme Belgium BV"}]}},"OSSLine":{"type":"object","required":["member_state_of_consumption","supply_type","member_state_type","eu_member_state","rate_type","rate","taxable_amount"],"properties":{"member_state_of_consumption":{"type":"string","pattern":"^[A-Z]{2}$"},"memberStateOfConsumption":{"type":"string","pattern":"^[A-Z]{2}$"},"supply_type":{"type":"string","enum":["Goods","Services"]},"supplyType":{"type":"string","enum":["Goods","Services"]},"member_state_type":{"type":"string","enum":["MSID","MSEST"]},"memberStateType":{"type":"string","enum":["MSID","MSEST"]},"eu_member_state":{"type":"string","pattern":"^[A-Z]{2}$"},"euMemberState":{"type":"string","pattern":"^[A-Z]{2}$"},"member_state_of_dispatch_or_vat_id":{"type":"string","enum":["A","B"]},"memberStateOfDispatchOrVatId":{"type":"string","enum":["A","B"]},"vat_id":{"type":"string"},"vatId":{"type":"string"},"rate_type":{"type":"string","enum":["Standard","Reduced"]},"rateType":{"type":"string","enum":["Standard","Reduced"]},"rate":{"type":"number","minimum":0.01,"maximum":99.99},"taxable_amount":{"type":"number","minimum":0},"taxableAmount":{"type":"number","minimum":0},"vat_amount":{"type":"number","minimum":0},"vatAmount":{"type":"number","minimum":0}},"description":"OBU/Unieregeling OSS-regel. Voor MSEST vereist selector A/B; selector B vereist vat_id. Services mogen selector A niet gebruiken.","example":{"member_state_of_consumption":"BE","supply_type":"Services","member_state_type":"MSID","eu_member_state":"NL","rate_type":"Standard","rate":21,"taxable_amount":100,"vat_amount":21}},"OSSCorrection":{"type":"object","required":["member_state_of_consumption","amount"],"properties":{"member_state_of_consumption":{"type":"string","pattern":"^[A-Z]{2}$"},"memberStateOfConsumption":{"type":"string","pattern":"^[A-Z]{2}$"},"amount":{"type":"number"},"vat_corrections_total":{"type":"number"},"vatCorrectionsTotal":{"type":"number"}},"example":{"member_state_of_consumption":"BE","amount":-5.5}},"OSSReturnCreate":{"type":"object","properties":{"ob_nummer":{"type":"string","pattern":"^NL[0-9]{9}B[0-9]{2}$"},"obNummer":{"type":"string","pattern":"^NL[0-9]{9}B[0-9]{2}$"},"scheme":{"type":"string","enum":["OBU"],"default":"OBU"},"periode":{"type":"string","pattern":"^[0-9]{4}-Q[1-4]$"},"year":{"type":"integer","minimum":2000,"maximum":2100},"quarter":{"type":"integer","minimum":1,"maximum":4},"referenceNumber":{"type":"string","maxLength":26},"vatReturnReferenceNumber":{"type":"string","maxLength":26},"vat_return_reference_number":{"type":"string","maxLength":26},"vatIdentificationContractRelation":{"type":"string"},"vat_identification_contract_relation":{"type":"string"},"lines":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/OSSLine"}},"entries":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/OSSLine"}},"ossEntries":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/OSSLine"}},"oss_entries":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/OSSLine"}},"corrections":{"type":"array","items":{"$ref":"#/components/schemas/OSSCorrection"}}},"description":"OSS indiening via Digipoort. Scope: OBU/Unieregeling. Gebruik lines voor reguliere bedragen en corrections voor correcties per lidstaat.","example":{"ob_nummer":"NL123456789B01","periode":"2026-Q1","scheme":"OBU","referenceNumber":"OSS-2026Q1-BE-SERV","lines":[{"member_state_of_consumption":"BE","supply_type":"Services","member_state_type":"MSID","eu_member_state":"NL","rate_type":"Standard","rate":21,"taxable_amount":100,"vat_amount":21}],"corrections":[]}},"DividendBeneficiary":{"type":"object","properties":{"name":{"type":"string"},"bsnOrRsin":{"type":"string"},"isLegalEntity":{"type":"boolean"},"numberOfShares":{"type":"number"},"sharePercentage":{"type":"number"},"grossDividend":{"type":"number"},"dividendTax":{"type":"number"},"netDividend":{"type":"number"},"treatyExemption":{"type":"boolean"},"treatyCountry":{"type":"string"},"exemptionPercentage":{"type":"number"}},"required":["name","bsnOrRsin"]},"DividendReturnCreate":{"type":"object","required":["distributionDate","grossDividend","dividendTax","netDividend","withholdingEntityName","withholdingEntityRsin","beneficiaries"],"properties":{"distributionDate":{"type":"string","format":"date"},"grossDividend":{"type":"number"},"dividendTax":{"type":"number"},"netDividend":{"type":"number"},"withholdingEntityName":{"type":"string"},"withholdingEntityRsin":{"type":"string","pattern":"^[0-9]{9}$"},"withholdingEntityAddress":{"type":"string"},"withholdingEntityStreet":{"type":"string"},"withholdingEntityHouseNumber":{"type":"string"},"withholdingEntityPostalCode":{"type":"string"},"withholdingEntityCity":{"type":"string"},"referenceNumber":{"type":"string"},"description":{"type":"string"},"beneficiaries":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/DividendBeneficiary"}}}},"CorporateTaxReturnCreate":{"type":"object","allOf":[{"anyOf":[{"required":["fiscalYear"]},{"required":["fiscal_year"]}]},{"anyOf":[{"required":["rsin"]},{"required":["company_rsin"]}]},{"anyOf":[{"required":["taxableProfit"]},{"required":["taxable_profit"]},{"required":["xbrlContent"]},{"required":["xbrl_content"]},{"required":["zeroReturn"]},{"required":["zero_return"]}]}],"properties":{"fiscalYear":{"type":"integer","minimum":2000,"maximum":2200},"fiscal_year":{"type":"integer","minimum":2000,"maximum":2200},"rsin":{"type":"string","pattern":"^[0-9]{9}$"},"company_rsin":{"type":"string","pattern":"^[0-9]{9}$"},"taxableProfit":{"type":"number","multipleOf":0.01},"taxable_profit":{"type":"number","multipleOf":0.01},"lossCarryForward":{"type":"number","multipleOf":0.01},"loss_carry_forward":{"type":"number","multipleOf":0.01},"innovationBoxProfit":{"type":"number","multipleOf":0.01},"innovation_box_profit":{"type":"number","multipleOf":0.01},"innovationBoxRate":{"type":"number","multipleOf":0.0001},"innovation_box_rate":{"type":"number","multipleOf":0.0001},"filingReference":{"type":"string","maxLength":120},"filing_reference":{"type":"string","maxLength":120},"xbrlContent":{"type":"string"},"xbrl_content":{"type":"string"},"zeroReturn":{"type":"boolean"},"zero_return":{"type":"boolean"},"companyName":{"type":"string","maxLength":200},"company_name":{"type":"string","maxLength":200},"bookYearStart":{"type":"string","format":"date"},"book_year_start":{"type":"string","format":"date"},"bookYearEnd":{"type":"string","format":"date"},"book_year_end":{"type":"string","format":"date"},"taxpayerType":{"type":"string","enum":["domestic","foreign"]},"taxpayer_type":{"type":"string","enum":["domestic","foreign"]},"softwareSupplierCode":{"type":"string","minLength":4,"maxLength":4},"software_supplier_code":{"type":"string","minLength":4,"maxLength":4},"softwarePackageName":{"type":"string","maxLength":30},"software_package_name":{"type":"string","maxLength":30},"softwarePackageVersion":{"type":"string","maxLength":20},"software_package_version":{"type":"string","maxLength":20},"softwareVendorAccountNumber":{"type":"string","maxLength":8},"software_vendor_account_number":{"type":"string","maxLength":8}},"description":"VPB create payload. Ondersteunt drie modi: reguliere payload met taxableProfit, officiële nul-aangifte via zeroReturn=true, of een provided official XBRL via xbrlContent/xbrl_content. xbrlContent en zeroReturn zijn wederzijds exclusief. Geldbedragen gebruiken maximaal 2 decimalen; innovationBoxRate maximaal 4 decimalen. Berekeningen worden deterministisch op centniveau afgerond. Voor zeroReturn gelden extra conditionele regels: companyName, bookYearStart, bookYearEnd en taxpayerType zijn vereist; taxableProfit, lossCarryForward en innovationBoxProfit moeten effectief 0 zijn; bookYearStart moet binnen fiscalYear vallen en bookYearEnd mag niet vóór bookYearStart liggen. In live mode is officiële VPB XBRL verplicht via xbrlContent/xbrl_content of via zeroReturn auto-generation. Er is geen dryRun-veld in de publieke v1 API; live of test wordt bepaald door het API key prefix. Live support is momenteel geconfigureerd voor 2024 en 2025.","examples":{"officialZeroReturn":{"summary":"Officiële VPB nul-aangifte","value":{"fiscalYear":2025,"rsin":"863682674","zeroReturn":true,"companyName":"Movere Transport B.V.","bookYearStart":"2025-01-01","bookYearEnd":"2025-12-31","taxpayerType":"domestic"}},"providedOfficialXbrl":{"summary":"Reguliere live submit met aangeleverde officiële VPB XBRL","value":{"fiscalYear":2025,"rsin":"863682674","filingReference":"VPB-2025-001","xbrlContent":"<official-vpb-xbrl-instance-with-schemaRef-and-rsin>"}}}},"CorporateTaxRequestStatus":{"type":"string","enum":["VALIDATING","BLOCKED","SUBMITTING","SUBMITTED","ACCEPTED","REJECTED","FAILED"]},"CorporateTaxSubmissionMode":{"type":"string","enum":["provided_official_xbrl","official_zero_return","estimate_only"]},"CorporateTaxXbrlSource":{"type":"string","enum":["provided","winstwaker_generated","official_zero_return_generated"]},"DigipoortEnv":{"type":["string","null"],"enum":["preprod","prod",null]},"DigipoortStatusItem":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string"},"description":{"type":"string"},"detail":{"type":["string","null"]},"timestamp":{"type":["string","null"],"format":"date-time"}},"required":["code","description","detail","timestamp"]},"CorporateTaxDigipoortRefresh":{"type":["object","null"],"additionalProperties":false,"properties":{"attempted":{"type":"boolean"},"ok":{"type":"boolean"},"source":{"type":"string","enum":["cache","digipoort"]},"refreshed_at":{"type":["string","null"],"format":"date-time"},"error":{"type":["string","null"]}},"required":["attempted","ok","source","refreshed_at","error"]},"CorporateTaxSubmissionSoftware":{"type":"object","additionalProperties":false,"properties":{"supplier_code":{"type":["string","null"]},"package_name":{"type":["string","null"]},"package_version":{"type":["string","null"]},"vendor_account_number":{"type":["string","null"]}},"required":["supplier_code","package_name","package_version","vendor_account_number"]},"CorporateTaxSubmissionSummary":{"type":"object","additionalProperties":false,"properties":{"zero_return":{"type":["boolean","null"]},"filing_reference":{"type":["string","null"]},"company_name":{"type":["string","null"]},"book_year_start":{"type":["string","null"],"format":"date"},"book_year_end":{"type":["string","null"],"format":"date"},"taxpayer_type":{"type":["string","null"],"enum":["domestic","foreign",null]},"xbrl_content_present":{"type":"boolean"},"xbrl_sha256":{"type":["string","null"]},"software":{"$ref":"#/components/schemas/CorporateTaxSubmissionSoftware"}},"required":["zero_return","filing_reference","company_name","book_year_start","book_year_end","taxpayer_type","xbrl_content_present","xbrl_sha256","software"]},"CorporateTaxCreateData":{"type":"object","additionalProperties":false,"properties":{"request_id":{"type":"string","format":"uuid"},"status":{"$ref":"#/components/schemas/CorporateTaxRequestStatus"},"fiscal_year":{"type":"integer"},"rsin":{"type":"string","pattern":"^[0-9]{9}$"},"submission_mode":{"$ref":"#/components/schemas/CorporateTaxSubmissionMode"},"xbrl_source":{"$ref":"#/components/schemas/CorporateTaxXbrlSource"},"digipoort":{"type":"object","additionalProperties":false,"properties":{"aanleverkenmerk":{"type":"string"},"winstwaker_kenmerk":{"type":"string"},"env":{"$ref":"#/components/schemas/DigipoortEnv"}},"required":["aanleverkenmerk","winstwaker_kenmerk","env"]}},"required":["request_id","status","fiscal_year","rsin","submission_mode","xbrl_source","digipoort"]},"CorporateTaxStatusData":{"type":"object","additionalProperties":false,"properties":{"request_id":{"type":"string","format":"uuid"},"status":{"$ref":"#/components/schemas/CorporateTaxRequestStatus"},"endpoint":{"type":"string","const":"vennootschapsbelasting"},"created_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":["string","null"],"format":"date-time"},"payload_hash":{"type":["string","null"]},"fiscal_year":{"type":["integer","null"]},"rsin":{"type":["string","null"]},"submission_mode":{"oneOf":[{"$ref":"#/components/schemas/CorporateTaxSubmissionMode"},{"type":"null"}]},"xbrl_source":{"oneOf":[{"$ref":"#/components/schemas/CorporateTaxXbrlSource"},{"type":"null"}]},"submission":{"$ref":"#/components/schemas/CorporateTaxSubmissionSummary"},"digipoort":{"type":"object","additionalProperties":false,"properties":{"winstwaker_kenmerk":{"type":["string","null"]},"aanleverkenmerk":{"type":["string","null"]},"statuses":{"type":"array","items":{"$ref":"#/components/schemas/DigipoortStatusItem"}},"refresh":{"$ref":"#/components/schemas/CorporateTaxDigipoortRefresh"}},"required":["winstwaker_kenmerk","aanleverkenmerk","statuses","refresh"]},"error":{"type":["object","null"]}},"required":["request_id","status","endpoint","created_at","updated_at","payload_hash","fiscal_year","rsin","submission_mode","xbrl_source","submission","digipoort","error"]},"CorporateTaxCreateResponse":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"type":"object","properties":{"status":{"$ref":"#/components/schemas/CorporateTaxRequestStatus"},"data":{"$ref":"#/components/schemas/CorporateTaxCreateData"},"breakdown":{"type":["object","null"]}},"required":["status","data","breakdown"]}]},"CorporateTaxStatusResponse":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"type":"object","properties":{"status":{"$ref":"#/components/schemas/CorporateTaxRequestStatus"},"data":{"$ref":"#/components/schemas/CorporateTaxStatusData"},"breakdown":{"type":["object","null"]}},"required":["status","data","breakdown"]}]},"IncomeTaxPostponementConsultant":{"allOf":[{"type":"object","required":["surname"],"properties":{"identificationNumber":{"type":"string","pattern":"^[0-9]{9}$"},"identification_number":{"type":"string","pattern":"^[0-9]{9}$"},"beconNumber":{"type":"string","pattern":"^[0-9]{6}$"},"becon_number":{"type":"string","pattern":"^[0-9]{6}$"},"initials":{"type":"string","maxLength":10},"prefix":{"type":"string","maxLength":10},"surname":{"type":"string","maxLength":200},"telephoneNumber":{"type":"string","maxLength":14},"telephone_number":{"type":"string","maxLength":14},"messageAttribute":{"type":"string","maxLength":34},"message_attribute":{"type":"string","maxLength":34}}},{"anyOf":[{"required":["identificationNumber"]},{"required":["identification_number"]}]},{"anyOf":[{"required":["beconNumber"]},{"required":["becon_number"]}]}],"description":"Belastingconsulent/intermediair. Gebruik camelCase of snake_case. identificationNumber is RSIN/finummer; beconNumber is het 6-cijferige beconnummer. In live mode mag Winstwaker deze consultant server-side invullen vanuit de globale admin-config."},"IncomeTaxPostponementRequest":{"allOf":[{"type":"object","properties":{"taxpayerIdentificationNumber":{"type":"string","pattern":"^[0-9]{9}$"},"taxpayer_identification_number":{"type":"string","pattern":"^[0-9]{9}$"},"taxpayerInitials":{"type":"string","maxLength":10},"taxpayer_initials":{"type":"string","maxLength":10},"taxpayerPrefix":{"type":"string","maxLength":10},"taxpayer_prefix":{"type":"string","maxLength":10},"taxpayerSurname":{"type":"string","maxLength":200},"taxpayer_surname":{"type":"string","maxLength":200},"requestType":{"oneOf":[{"type":"string","enum":["1","4","6","9"]},{"type":"string","enum":["becon_regeling","beconregeling","individueel_becon","aanvullend_uitstel","verzoek_aanvullend_uitstel","afmelden_uitstel"]},{"type":"integer","enum":[1,4,6,9]}]},"request_type":{"oneOf":[{"type":"string","enum":["1","4","6","9"]},{"type":"string","enum":["becon_regeling","beconregeling","individueel_becon","aanvullend_uitstel","verzoek_aanvullend_uitstel","afmelden_uitstel"]},{"type":"integer","enum":[1,4,6,9]}]},"motivationCode":{"type":"string","enum":["01","99","maatwerk_bijzonder_uitstel","vrije_tekst"]},"motivation_code":{"type":"string","enum":["01","99","maatwerk_bijzonder_uitstel","vrije_tekst"]},"specialMotivation":{"type":"string","maxLength":512},"special_motivation":{"type":"string","maxLength":512}}},{"anyOf":[{"required":["taxpayerIdentificationNumber"]},{"required":["taxpayer_identification_number"]}]}],"description":"IB-uitstelregel per belastingplichtige. Gebruik requestType 6 + specialMotivation voor aanvullend uitstel.","example":{"taxpayerIdentificationNumber":"123456782","taxpayerInitials":"A","taxpayerSurname":"Pieters","requestType":"aanvullend_uitstel","specialMotivation":"Buitenlandse consolidatie vertraagt de afronding van de definitieve cijfers."}},"IncomeTaxPostponementCreate":{"allOf":[{"type":"object","properties":{"fiscalYear":{"type":"integer","enum":[2024,2025]},"fiscal_year":{"type":"integer","enum":[2024,2025]},"consultant":{"$ref":"#/components/schemas/IncomeTaxPostponementConsultant"},"requests":{"type":"array","minItems":1,"maxItems":3000,"items":{"$ref":"#/components/schemas/IncomeTaxPostponementRequest"}},"entries":{"type":"array","minItems":1,"maxItems":3000,"items":{"$ref":"#/components/schemas/IncomeTaxPostponementRequest"}}}},{"anyOf":[{"required":["fiscalYear"]},{"required":["fiscal_year"]}]},{"anyOf":[{"required":["requests"]},{"required":["entries"]}]}],"description":"IB-uitstelverzoek voor officiële Belastingdienst becon-stromen 2024 of 2025. Digipoort verzorgt transport; inhoudelijke toekenning/afwijzing volgt via SBU. In live mode mag consultant worden weggelaten als Winstwaker een globale consultantconfig in admin heeft vastgelegd.","example":{"fiscalYear":2025,"consultant":{"identificationNumber":"123456789","beconNumber":"123456","initials":"J","surname":"Jansen","telephoneNumber":"+31612345678"},"requests":[{"taxpayerIdentificationNumber":"123456782","taxpayerInitials":"A","taxpayerSurname":"Pieters"}]}}}},"paths":{"/health":{"get":{"tags":["Health"],"summary":"Health check","description":"Publieke availability check voor de developer API.","security":[],"responses":{"200":{"description":"Service operationeel.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}},"503":{"description":"Service degraded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/credits/balance":{"get":{"tags":["Credits"],"summary":"Haal creditsaldo op","security":[{"BearerAuth":[]}],"parameters":[{"name":"mode","in":"query","required":false,"schema":{"type":"string","enum":["live","test"]},"description":"Optioneel: geef live of test mee voor enkel 1 saldo."}],"responses":{"200":{"description":"Creditsaldo opgehaald.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"type":"object","properties":{"data":{"oneOf":[{"type":"object","properties":{"selected_mode":{"type":"string","enum":["live","test"]},"balance_cents":{"type":"integer"},"balance_eur":{"type":"number"},"updated_at":{"type":"string","format":"date-time"}},"required":["selected_mode","balance_cents","balance_eur","updated_at"]},{"type":"object","properties":{"balances":{"type":"array","items":{"$ref":"#/components/schemas/CreditBalanceItem"}}},"required":["balances"]}]}}}]}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Wachtduur in seconden."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/credits/events":{"get":{"tags":["Credits"],"summary":"Haal credit-events op","security":[{"BearerAuth":[]}],"parameters":[{"name":"mode","in":"query","required":false,"schema":{"type":"string","enum":["live","test"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":25,"minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"integer"},"description":"ID cursor voor paginatie (descending timeline)."}],"responses":{"200":{"description":"Credit-events opgehaald.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"type":"object","properties":{"data":{"type":"object","properties":{"mode":{"type":"string","enum":["live","test"]},"events":{"type":"array","items":{"$ref":"#/components/schemas/CreditEvent"}},"next_cursor":{"type":["integer","null"]}},"required":["mode","events","next_cursor"]}}}]}}}},"400":{"description":"Ongeldige query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/usage/summary":{"get":{"tags":["Usage"],"summary":"Haal usage summary op","security":[{"BearerAuth":[]}],"parameters":[{"name":"period","in":"query","required":false,"schema":{"type":"string","enum":["day","month"],"default":"day"}}],"responses":{"200":{"description":"Usage summary opgehaald.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/UsageSummaryData"}}}]}}}},"400":{"description":"Ongeldige period query.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/omzetbelasting/returns":{"post":{"tags":["Omzetbelasting"],"summary":"Dien omzetbelasting in","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"},"description":"Unieke sleutel per create request."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VatReturnCreate"}}}},"responses":{"200":{"description":"Idempotent replay response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"202":{"description":"Aangifte geaccepteerd en ingestuurd.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"description":"Missing/invalid input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Onvoldoende credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Idempotency conflict (zelfde key, andere payload).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Validatie geblokkeerd.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"Downstream Digipoort submit mislukt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/omzetbelasting/returns/{requestId}":{"get":{"tags":["Omzetbelasting"],"summary":"Haal status van omzetbelasting request op","security":[{"BearerAuth":[]}],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Wanneer true wordt status herladen vanuit Digipoort context."}],"responses":{"200":{"description":"Status opgehaald.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Request niet gevonden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/icp/returns":{"post":{"tags":["ICP"],"summary":"Dien ICP-opgaaf in","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"},"description":"Unieke sleutel per create request."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ICPReturnCreate"}}}},"responses":{"200":{"description":"Idempotent replay response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"202":{"description":"ICP-opgaaf geaccepteerd en ingestuurd.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"description":"Missing/invalid input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Onvoldoende credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Idempotency conflict (zelfde key, andere payload).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Validatie geblokkeerd.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"Downstream Digipoort submit mislukt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/icp/returns/{requestId}":{"get":{"tags":["ICP"],"summary":"Haal status van ICP request op","security":[{"BearerAuth":[]}],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Wanneer true wordt status herladen vanuit Digipoort context."}],"responses":{"200":{"description":"Status opgehaald.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Request niet gevonden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/oss/returns":{"post":{"tags":["OSS"],"summary":"Dien OSS-melding in","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"},"description":"Unieke sleutel per create request."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OSSReturnCreate"}}}},"responses":{"200":{"description":"Idempotent replay response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"202":{"description":"OSS-melding geaccepteerd en ingestuurd.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"description":"Missing/invalid input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Onvoldoende credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Idempotency conflict (zelfde key, andere payload).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Validatie geblokkeerd.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"Downstream Digipoort submit mislukt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/oss/returns/{requestId}":{"get":{"tags":["OSS"],"summary":"Haal status van OSS request op","security":[{"BearerAuth":[]}],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Wanneer true wordt status herladen vanuit Digipoort context."}],"responses":{"200":{"description":"Status opgehaald.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Request niet gevonden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/dividendbelasting/returns":{"post":{"tags":["Dividendbelasting"],"summary":"Dien dividendbelasting in","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"},"description":"Unieke sleutel per create request."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DividendReturnCreate"}}}},"responses":{"200":{"description":"Idempotent replay response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"202":{"description":"Aangifte geaccepteerd en ingestuurd.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"description":"Missing/invalid input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Onvoldoende credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Idempotency conflict (zelfde key, andere payload).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Validatie geblokkeerd.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"Downstream submit mislukt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/dividendbelasting/returns/{requestId}":{"get":{"tags":["Dividendbelasting"],"summary":"Haal status van dividendbelasting request op","security":[{"BearerAuth":[]}],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"Status opgehaald.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Request niet gevonden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/vennootschapsbelasting/returns":{"post":{"tags":["Vennootschapsbelasting"],"summary":"Dien vennootschapsbelasting in","description":"Stuurt een VPB-aangifte in via Digipoort. In live mode is een officiële VPB XBRL-instance vereist, aangeleverd via xbrlContent of automatisch opgebouwd via zeroReturn voor een officiële nul-aangifte. xbrlContent en zeroReturn zijn wederzijds exclusief. Er is geen dryRun-veld in de publieke v1 API; live of test wordt bepaald door het API key prefix. In test mode ondersteunt Winstwaker ook generated smoke/test payloads.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"},"description":"Unieke sleutel per create request."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorporateTaxReturnCreate"},"examples":{"officialZeroReturn":{"summary":"Officiële VPB nul-aangifte","value":{"fiscalYear":2025,"rsin":"863682674","zeroReturn":true,"companyName":"Movere Transport B.V.","bookYearStart":"2025-01-01","bookYearEnd":"2025-12-31","taxpayerType":"domestic"}},"providedOfficialXbrl":{"summary":"Reguliere live submit met aangeleverde officiële VPB XBRL","value":{"fiscalYear":2025,"rsin":"863682674","filingReference":"VPB-2025-001","xbrlContent":"<official-vpb-xbrl-instance-with-schemaRef-and-rsin>"}}}}}},"responses":{"200":{"description":"Idempotent replay response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorporateTaxCreateResponse"},"examples":{"replay":{"summary":"Idempotent replay","value":{"ok":true,"request_id":"11111111-1111-4111-8111-111111111111","mode":"live","status":"SUBMITTED","message":"Idempotent replay response.","data":{"request_id":"11111111-1111-4111-8111-111111111111","status":"SUBMITTED","fiscal_year":2025,"rsin":"863682674","submission_mode":"provided_official_xbrl","xbrl_source":"provided","digipoort":{"aanleverkenmerk":"ALV-123456789","winstwaker_kenmerk":"DP-123456789","env":"prod"}},"breakdown":{"credit_effect":{"reserved_cents":98,"committed_cents":98,"refunded_cents":0}},"errors":null}}}}}},"202":{"description":"VPB-aangifte geaccepteerd en ingestuurd.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorporateTaxCreateResponse"}}}},"400":{"description":"Missing/invalid input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Onvoldoende credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Idempotency conflict (zelfde key, andere payload).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Validatie geblokkeerd.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"Downstream Digipoort submit mislukt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/vennootschapsbelasting/returns/{requestId}":{"get":{"tags":["Vennootschapsbelasting"],"summary":"Haal status van VPB request op","description":"Haalt de huidige status van een VPB-request op. Gebruik refresh=true om Digipoort eerst opnieuw te pollen; volg daarna een backoff schedule en stop zodra een terminale status is bereikt. Als een refreshpoging mislukt, kan de API nog steeds 200 teruggeven met de laatst bekende cached status en refresh-informatie in de response body.","security":[{"BearerAuth":[]}],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Wanneer true wordt status herladen vanuit Digipoort context. Bij een mislukte refresh blijft de laatst bekende cached status beschikbaar."}],"responses":{"200":{"description":"Status opgehaald.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorporateTaxStatusResponse"},"examples":{"status":{"summary":"Status met refresh-context","value":{"ok":true,"request_id":"11111111-1111-4111-8111-111111111111","mode":"live","status":"SUBMITTED","message":"VPB request status opgehaald.","data":{"request_id":"11111111-1111-4111-8111-111111111111","status":"SUBMITTED","endpoint":"vennootschapsbelasting","created_at":"2026-03-27T10:15:00.000Z","updated_at":"2026-03-27T10:16:12.000Z","payload_hash":"{\"fiscalYear\":2025}","fiscal_year":2025,"rsin":"863682674","submission_mode":"provided_official_xbrl","xbrl_source":"provided","submission":{"zero_return":false,"filing_reference":"VPB-2025-001","company_name":null,"book_year_start":null,"book_year_end":null,"taxpayer_type":null,"xbrl_content_present":true,"xbrl_sha256":"4a44dc15364204a80fe80e9039455cc1608281820fe2b24f1e5233ade6af1dd5","software":{"supplier_code":null,"package_name":null,"package_version":null,"vendor_account_number":null}},"digipoort":{"winstwaker_kenmerk":"DP-123456789","aanleverkenmerk":"ALV-123456789","statuses":[{"code":"BGW_BERICHT_ONTVANGEN","description":"Bericht ontvangen","detail":null,"timestamp":"2026-03-27T10:15:30.000Z"}],"refresh":{"attempted":true,"ok":true,"source":"digipoort","refreshed_at":"2026-03-27T10:16:12.000Z","error":null}},"error":null},"breakdown":{"credit_effect":{"reserved_cents":98,"committed_cents":98,"refunded_cents":0}},"errors":null}}}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Request niet gevonden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/inkomstenbelasting/uitstelverzoeken":{"post":{"tags":["Inkomstenbelasting uitstel"],"summary":"Dien een IB-uitstelverzoek in","description":"Verstuurt een officiële becon-uitstelbatch voor belastingjaar 2024 of 2025. Technische acceptatie loopt via Digipoort; de inhoudelijke Belastingdienstbeslissing volgt via SBU.","security":[{"BearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"},"description":"Unieke sleutel per create request."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncomeTaxPostponementCreate"}}}},"responses":{"200":{"description":"Idempotent replay response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"202":{"description":"IB-uitstelbatch geaccepteerd en technisch ingestuurd.","headers":{"X-Request-Id":{"$ref":"#/components/headers/XRequestId"},"X-RateLimit-Limit":{"$ref":"#/components/headers/XRateLimitLimit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/XRateLimitRemaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/XRateLimitReset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"description":"Missing/invalid input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"402":{"description":"Onvoldoende credits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Idempotency conflict (zelfde key, andere payload).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Validatie geblokkeerd.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"description":"Downstream Digipoort submit mislukt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/inkomstenbelasting/uitstelverzoeken/{requestId}":{"get":{"tags":["Inkomstenbelasting uitstel"],"summary":"Haal status van een IB-uitstelrequest op","description":"Geeft Digipoort-transportstatus en de huidige SBU business-status terug. PENDING_SBU betekent nog geen inhoudelijke toekenning.","security":[{"BearerAuth":[]}],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Wanneer true wordt technische transportstatus herladen vanuit Digipoort."}],"responses":{"200":{"description":"Status opgehaald.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"401":{"description":"Auth fout.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Request niet gevonden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate-limit overschreden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}}}