Overzicht
Onder Werkruimte-instellingen -> Bedrijf & Regionaal (/settings/workspace/general, /settings/workspace/company en /settings/workspace/regional) configureren werkruimtebeheerders de bedrijfsidentiteit (Account Settings API), het fiscale factureringsprofiel (PUT /api/v1/billing/settings & PUT /api/v1/billing/tax-profile) en de standaard regionale opmaak die wordt gedeeld over alle passjablonen, openbare downloadportalen, tijdreeksaggregaties in analytics en btw-facturen van Stripe.
Werkruimtemetadata en stroom voor regionale configuratie
Belangrijk: Controleer en bewaar altijd uw Officiële bedrijfsnaam, Factuuradres en Btw-nummer / Tax ID (
PUT /api/v1/billing/settings) voordat u een betaalde abonnementsupgrade of -verlenging uitvoert. Gegenereerde fiscale PDF-facturen (GET /api/v1/billing/invoices/:id/download) zijn onveranderlijk zodra ze door de factureringsengine zijn afgerond.
Werkruimteprofiel (Account Settings API) en fiscaal profiel (Billing API)
De basisbron voor klanten (GET /api/v1/customer/:id en PUT /api/v1/customer/:id, strikt gevalideerd tegen request payload met forbidNonWhitelisted) beheert de kernidentiteit van de werkruimte, terwijl PUT /api/v1/billing/settings de metadata voor btw- en belastingfacturering opslaat (request payload):
| Veld | Eindpunt (DTO) | Operationele impact | |
|---|---|---|---|
name / companyName | PUT /api/v1/customer/:id (request payload) | Weergavenaam van de werkruimte en officiële organisatienaam die op passen worden afgedrukt. | |
email / notificationEmails | PUT /api/v1/customer/:id | Primair contact-e-mailadres van de werkruimte en ontvangerslijst voor operationele meldingen. | |
street, zipCode, city, state, country | PUT /api/v1/customer/:id | Adresvelden van de statutaire vestiging (street2 optioneel). | |
subdomain / domain / logo / icon | PUT /api/v1/customer/:id | Werkruimte-slug, koppeling van aangepast domein en URL's voor logo/pictogram. | |
exportFormat (`'legacy' | 'new'`) | PUT /api/v1/customer/:id | Standaard CSV-kolomindeling voor werkruimte-exporten. |
taxId, vatNumber, billingEmail, address | PUT /api/v1/billing/settings (request payload) | EU-btw-nummer (bijv. DE301928374), belasting-ID en metadata van de factuurontvanger die op PDF-facturen van Stripe worden afgedrukt. |
Werkruimteprofiel bijwerken via API (PUT /api/v1/customer/:id)
PUT /api/v1/customer/cus_89a12b34-56c7-4d89-9e01-23456789abcd HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json
{
"name": "Phenix Hospitality Europe",
"companyName": "Phenix Hospitality GmbH",
"email": "passes@phenix-hospitality.example.com",
"street": "Friedrichstrasse 114A",
"zipCode": "10117",
"city": "Berlin",
"country": "DE",
"exportFormat": "new"
}
Antwoordpayload (200 OK)
{
"id": "cus_89a12b34-56c7-4d89-9e01-23456789abcd",
"name": "Phenix Hospitality Europe",
"companyName": "Phenix Hospitality GmbH",
"email": "passes@phenix-hospitality.example.com",
"street": "Friedrichstrasse 114A",
"city": "Berlin",
"zipCode": "10117",
"country": "DE",
"exportFormat": "new",
"isActive": true,
"updatedAt": "2026-11-16T09:33:12.000Z"
}
Regionale instellingen van de werkruimte (request payload)
Regionale instellingen (GET /api/v1/customer/:customerId/regional-settings en PUT /api/v1/customer/:customerId/regional-settings) definiëren de standaardwaarden voor tijd, valuta en lokalisatie via request payload:
-
1
timezone(IANA-tekenreeks, max. 50 tekens): Bepaalt het afkappunt om middernacht voor dagelijkse analytics-buckets (GET /api/v1/analytics), workflowschema's en het resetten vanOncePerDayRule-afkoelperioden voor scanners. -
2
countryIso(ISO 3166-1 alpha-2, bijv."DE"): Primaire landjurisdictie voor de werkruimte. -
3
defaultCurrency(ISO 4217 3-letterige code, bijv."EUR"): Standaardvaluta voorPREPAID_CARD-tegoedgrootboeken en POS-verzilveringen in winkels (POST /v1/pos/redeem). -
4
defaultLocale(BCP-47-tag, bijv."de-DE"): Terugvaltaal die wordt weergegeven op openbare downloadpagina's (/d/:slug,/s/:token) en in transactionele e-mails. -
5
dataResidencyRegion(optionele tekenreeks, bijv."eu-central-1"): Metadata voor gegevensopslaglocatie van de werkruimte.
Regionale instellingen bijwerken via API
PUT /api/v1/customer/cus_89a12b34-56c7-4d89-9e01-23456789abcd/regional-settings HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json
{
"timezone": "Europe/Berlin",
"countryIso": "DE",
"defaultCurrency": "EUR",
"defaultLocale": "de-DE",
"dataResidencyRegion": "eu-central-1"
}
{
"customerId": "cus_89a12b34-56c7-4d89-9e01-23456789abcd",
"timezone": "Europe/Berlin",
"countryIso": "DE",
"defaultCurrency": "EUR",
"defaultLocale": "de-DE",
"dataResidencyRegion": "eu-central-1",
"updatedAt": "2026-11-16T09:34:00.000Z"
}
Gerelateerde documentatie
-
Configureer aangepaste vanity-domeinen (
CNAME) en merkeigen SMTP/DKIM-e-mailafzenders in Aangepaste branding en white-label opties. -
Download btw-conforme PDF-facturen in Facturen en factureringsgeschiedenis.
-
Beheer bureauhiërarchieën met meerdere werkruimten in Beheer van meerdere klanten.
