Skip to content
Helpcentrum-gids · Account- & werkruimte-instellingen
3 min leestijdGecontroleerd 2026-11-16

Bedrijfsinstellingen

Beheer bedrijfsnaam, btw-nummer, standaard afzendernaam en geverifieerde eigen domeinen.

In deze gids

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

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
SYSTEEMARCHITECTUURSTROOM: DOORGIFTE VAN WERKRUIMTE-IDENTITEIT & REGIONALE INSTELLINGEN
FASE 01 DASHBOARD- / API-CONFIGURATIELAAG
Bedrijfs- & Juridische Identiteit
GET/ PUT /api/v1/customer/:idPUT/api/v1/billing/settings
companyName, btw/Tax ID, adres
Regionale & Dataresidency-instell.
`GET / PUT/api/v1/customer/
:customerId/regional-settings`
timezone, countryIso, currency
FASE 02 AFNEMENDE SYSTEEMCOMPONENTEN
Facturerings- & Btw-eng
PDF-factuurkoppen
Btw-verlegging
Analytics & Mechanieken
Dagelijkse afkap
Tegoedgrootboek
Sjabloon & PassFlow
Standaardvaluta
Subdomeinroutering

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):

VeldEindpunt (DTO)Operationele impact
name / companyNamePUT /api/v1/customer/:id (request payload)Weergavenaam van de werkruimte en officiële organisatienaam die op passen worden afgedrukt.
email / notificationEmailsPUT /api/v1/customer/:idPrimair contact-e-mailadres van de werkruimte en ontvangerslijst voor operationele meldingen.
street, zipCode, city, state, countryPUT /api/v1/customer/:idAdresvelden van de statutaire vestiging (street2 optioneel).
subdomain / domain / logo / iconPUT /api/v1/customer/:idWerkruimte-slug, koppeling van aangepast domein en URL's voor logo/pictogram.
exportFormat (`'legacy''new'`)PUT /api/v1/customer/:idStandaard CSV-kolomindeling voor werkruimte-exporten.
taxId, vatNumber, billingEmail, addressPUT /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)

HTTP
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)

JSON
{
  "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. 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 van OncePerDayRule-afkoelperioden voor scanners.
  2. 2
    countryIso (ISO 3166-1 alpha-2, bijv. "DE"): Primaire landjurisdictie voor de werkruimte.
  3. 3
    defaultCurrency (ISO 4217 3-letterige code, bijv. "EUR"): Standaardvaluta voor PREPAID_CARD-tegoedgrootboeken en POS-verzilveringen in winkels (POST /v1/pos/redeem).
  4. 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. 5
    dataResidencyRegion (optionele tekenreeks, bijv. "eu-central-1"): Metadata voor gegevensopslaglocatie van de werkruimte.

Regionale instellingen bijwerken via API

HTTP
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"
}
JSON
{
  "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

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.