API documentation

WGO Management API

Interfaccia navigabile stile Swagger generata dal catalogo runtime dell'API. Include endpoint, policy, esempi curl e un pannello per testare le chiamate.

Endpoint 145

Anonymous 11

Write 73

Admin 9

Autenticazione e test

Quando l'autenticazione e attiva, esegui il login e usa il token Bearer nelle richieste protette. Il token inserito qui viene usato solo dal browser.

curl -X POST /api/auth/login \
  -H 'Content-Type: application/json' \
  --data '{"email":"info@wisegar.org","password":"***"}'

Base URL Bearer token JSON body

admin

6 endpoint

GET /api/admin/users management.admin

Lists local application users.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/admin/users"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/admin/users management.admin

Registers one local application user and optionally sends a password setup email.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/admin/users"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/admin/users/{id} management.admin

Reads one local application user.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/admin/users/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

PATCH /api/admin/users/{id} management.admin

Updates one local application user status, display name or roles.

Curl

curl -X PATCH \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/admin/users/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/admin/users/{id}/reset-password management.admin

Resets one local application user password directly.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/admin/users/{id}/reset-password"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/admin/users/{id}/send-password-reset-email management.admin

Sends one local application user a password reset email with validation token link.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/admin/users/{id}/send-password-reset-email"

Try request

Seleziona Esegui per testare questo endpoint.

Authentication

7 endpoint

GET /api/auth/entra-id management.read

Returns expected Entra ID policy names.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/auth/entra-id"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/auth/login anonymous

Authenticates one local user and returns access and refresh tokens.

Curl

curl -X POST \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/auth/login"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/auth/logout anonymous

Revokes one local refresh token.

Curl

curl -X POST \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/auth/logout"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/auth/me management.read

Returns the current authenticated local user.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/auth/me"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/auth/refresh anonymous

Rotates one local refresh token and returns a new session.

Curl

curl -X POST \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/auth/refresh"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/auth/register anonymous

Registers one local self-service user with the minimum local role and sends a password setup email.

Curl

curl -X POST \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/auth/register"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/auth/reset-password/complete anonymous

Completes a local password reset using the emailed validation token.

Curl

curl -X POST \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/auth/reset-password/complete"

Try request

Seleziona Esegui per testare questo endpoint.

Billing

68 endpoint

GET /api/billing/accounts management.read

Lists local billing accounts.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/accounts"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/accounts management.write

Creates one local billing account.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/accounts"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/accounts/{id} management.read

Reads one local billing account.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/accounts/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

PATCH /api/billing/accounts/{id} management.write

Updates one local billing account.

Curl

curl -X PATCH \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/accounts/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/companies management.read

Lists local billing company profiles.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/companies"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/companies management.write

Creates one local billing company profile.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/companies"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/companies/default management.read

Reads the default local billing company profile.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/companies/default"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/companies/{id} management.read

Reads one local billing company profile.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/companies/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

PATCH /api/billing/companies/{id} management.write

Updates one local billing company profile.

Curl

curl -X PATCH \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/companies/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/companies/{id}/make-default management.write

Marks one local billing company profile as default.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/companies/{id}/make-default"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/documents management.read

Lists local billing documents.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/documents"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/documents management.write

Creates one local draft billing document.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/documents/{documentId}/lines management.write

Creates one local billing document line.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{documentId}/lines"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/documents/{documentId}/lines/reorder management.write

Reorders local billing document lines.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{documentId}/lines/reorder"

Try request

Seleziona Esegui per testare questo endpoint.

PATCH /api/billing/documents/{documentId}/lines/{lineId} management.write

Updates one local billing document line.

Curl

curl -X PATCH \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{documentId}/lines/{lineId}"

Try request

Seleziona Esegui per testare questo endpoint.

DELETE /api/billing/documents/{documentId}/lines/{lineId} management.write

Deletes one local billing document line.

Curl

curl -X DELETE \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/documents/{documentId}/lines/{lineId}"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/documents/{id} management.read

Reads one local billing document.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/documents/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

PATCH /api/billing/documents/{id} management.write

Updates one local draft billing document.

Curl

curl -X PATCH \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

DELETE /api/billing/documents/{id} management.write

Deletes one local draft billing document.

Curl

curl -X DELETE \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/documents/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/documents/{id}/cancel management.write

Cancels one local billing document.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{id}/cancel"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/documents/{id}/deliver management.write

Prepares, drafts or sends one local billing document using dynamic company and customer data.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{id}/deliver"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/documents/{id}/notifications management.read

Lists local billing notifications for one document.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/documents/{id}/notifications"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/documents/{id}/notifications management.write

Creates a local billing notification for one document.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{id}/notifications"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/documents/{id}/package management.write

Generates a local billing document invoice and Swiss QR-bill package PDF.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{id}/package"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/documents/{id}/pdf management.write

Generates a local billing document invoice PDF.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{id}/pdf"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/documents/{id}/post management.write

Posts one local billing document.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{id}/post"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/documents/{id}/print management.write

Prepares and tracks a local billing document print workflow.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{id}/print"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/documents/{id}/print-package management.write

Prepares a local billing document print package.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{id}/print-package"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/documents/{id}/register-payment management.write

Registers and allocates a payment directly on one posted billing document.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{id}/register-payment"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/documents/{id}/reset-to-draft management.write

Resets one cancelled local billing document to draft.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/documents/{id}/reset-to-draft"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/fiscal-positions management.read

Lists local billing fiscal positions.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/fiscal-positions"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/fiscal-positions management.write

Creates one local billing fiscal position.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/fiscal-positions"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/fiscal-positions/{id} management.read

Reads one local billing fiscal position.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/fiscal-positions/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

PATCH /api/billing/fiscal-positions/{id} management.write

Updates one local billing fiscal position.

Curl

curl -X PATCH \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/fiscal-positions/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/import/odoo/configuration management.write

Imports Odoo accounting configuration into local billing configuration tables.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/import/odoo/configuration"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/import/odoo/documents management.write

Imports Odoo accounting moves and invoice lines into local billing documents.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/import/odoo/documents"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/import/odoo/payments management.write

Imports Odoo payments and matched document relationships into local billing payments.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/import/odoo/payments"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/import/odoo/reconcile-relationships management.write

Reconciles Odoo billing import relationships to local entity references when possible.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/import/odoo/reconcile-relationships"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/invoices/register management.write

Registers one local invoice from catalog products and optionally posts/delivers it.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/invoices/register"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/journals management.read

Lists local billing journals.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/journals"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/journals management.write

Creates one local billing journal.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/journals"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/journals/{id} management.read

Reads one local billing journal.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/journals/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

PATCH /api/billing/journals/{id} management.write

Updates one local billing journal.

Curl

curl -X PATCH \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/journals/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/notifications/{id}/confirm-sent management.write

Confirms one local billing notification as sent.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/notifications/{id}/confirm-sent"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/notifications/{id}/create-email-draft management.write

Creates a mail draft for one local billing notification through the configured mail provider.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/notifications/{id}/create-email-draft"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/notifications/{id}/prepare-email management.write

Prepares local billing notification email HTML and attachment package.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/notifications/{id}/prepare-email"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/notifications/{id}/retry management.write

Retries one failed local billing notification.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/notifications/{id}/retry"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/notifications/{id}/send-email management.write

Sends one local billing notification email through the configured mail provider.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/notifications/{id}/send-email"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/payment-terms management.read

Lists local billing payment terms.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/payment-terms"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/payment-terms management.write

Creates one local billing payment term.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/payment-terms"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/payment-terms/{id} management.read

Reads one local billing payment term.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/payment-terms/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

PATCH /api/billing/payment-terms/{id} management.write

Updates one local billing payment term.

Curl

curl -X PATCH \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/payment-terms/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/payments management.read

Lists local billing payments.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/payments"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/payments management.write

Creates one local billing payment.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/payments"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/payments/{id} management.read

Reads one local billing payment.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/payments/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

PATCH /api/billing/payments/{id} management.write

Updates one local draft billing payment.

Curl

curl -X PATCH \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/payments/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/payments/{id}/allocate management.write

Allocates one local billing payment to a document.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/payments/{id}/allocate"

Try request

Seleziona Esegui per testare questo endpoint.

DELETE /api/billing/payments/{id}/allocations/{allocationId} management.write

Removes one local billing payment allocation.

Curl

curl -X DELETE \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/payments/{id}/allocations/{allocationId}"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/print/batch management.write

Prepares and tracks print packages for a filtered batch of billing documents.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/print/batch"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/reports/aged-payable management.read

Reports open vendor bills by aging bucket.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/reports/aged-payable"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/reports/aged-receivable management.read

Reports open customer invoices by aging bucket.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/reports/aged-receivable"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/reports/open-documents management.read

Reports open local billing documents.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/reports/open-documents"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/reports/revenue-by-customer management.read

Reports posted customer invoice revenue by customer.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/reports/revenue-by-customer"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/reports/revenue-by-product management.read

Reports posted customer invoice revenue by product.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/reports/revenue-by-product"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/taxes management.read

Lists local billing taxes.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/taxes"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing/taxes management.write

Creates one local billing tax.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/taxes"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/billing/taxes/{id} management.read

Reads one local billing tax.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing/taxes/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

PATCH /api/billing/taxes/{id} management.write

Updates one local billing tax.

Curl

curl -X PATCH \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing/taxes/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

Billing items

5 endpoint

GET /api/billing-items management.read

Lists local billing items.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing-items"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing-items management.write

Creates one local billing item.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing-items"

Try request

Seleziona Esegui per testare questo endpoint.

PATCH /api/billing-items/{id} management.write

Updates one local billing item.

Curl

curl -X PATCH \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing-items/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

DELETE /api/billing-items/{id} management.admin

Deletes one local billing item when it is not billed.

Curl

curl -X DELETE \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/billing-items/{id}"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/billing-items/{id}/mark-billed management.write

Marks one local billing item as billed.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/billing-items/{id}/mark-billed"

Try request

Seleziona Esegui per testare questo endpoint.

docs

2 endpoint

GET /api/docs anonymous

Returns an HTML API documentation page.

Curl

curl -X GET \
  "$BASE_URL/api/docs"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/docs/endpoints anonymous

Returns the API endpoint documentation model as JSON.

Curl

curl -X GET \
  "$BASE_URL/api/docs/endpoints"

Try request

Seleziona Esegui per testare questo endpoint.

Documents

8 endpoint

POST /api/documents/invoices/package management.write

Generates an invoice and Swiss QR-bill package PDF.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/documents/invoices/package"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/documents/invoices/pdf management.write

Generates an invoice PDF.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/documents/invoices/pdf"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/documents/invoices/qr-bill management.write

Generates a Swiss QR-bill PDF.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/documents/invoices/qr-bill"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/documents/invoices/template-preview management.write

Generates an invoice template preview PDF.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/documents/invoices/template-preview"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/documents/pdf/merge management.write

Merges PDF files.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/documents/pdf/merge"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/documents/pdf/ocr management.read

Extracts embedded text from PDF files.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/documents/pdf/ocr"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/documents/scans/apply-classification management.write

Applies planned scan classification moves.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/documents/scans/apply-classification"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/documents/scans/classify management.read

Classifies scanned PDF files without moving them.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/documents/scans/classify"

Try request

Seleziona Esegui per testare questo endpoint.

Microsoft Graph

12 endpoint

POST /api/graph/invoices/sync-drafts management.write

Synchronizes Graph invoice drafts to registry/Odoo state.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/graph/invoices/sync-drafts"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/graph/invoices/sync-sent management.write

Synchronizes Graph sent invoice messages to registry/Odoo state.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/graph/invoices/sync-sent"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/graph/licenses/skus management.read

Lists Microsoft 365 subscribed SKUs.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/graph/licenses/skus"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/graph/licenses/users management.read

Lists Microsoft 365 users with assigned license details.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/graph/licenses/users"

Try request

Seleziona Esegui per testare questo endpoint.

PUT /api/graph/onedrive/files management.write

Uploads or replaces one Microsoft OneDrive file.

Curl

curl -X PUT \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/graph/onedrive/files"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/graph/onedrive/folders management.write

Creates one Microsoft OneDrive folder.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/graph/onedrive/folders"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/graph/onedrive/items management.read

Lists Microsoft OneDrive files and folders.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/graph/onedrive/items"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/graph/onedrive/items/{itemId} management.read

Reads one Microsoft OneDrive driveItem.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/graph/onedrive/items/{itemId}"

Try request

Seleziona Esegui per testare questo endpoint.

PATCH /api/graph/onedrive/items/{itemId} management.write

Renames or moves one Microsoft OneDrive driveItem.

Curl

curl -X PATCH \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/graph/onedrive/items/{itemId}"

Try request

Seleziona Esegui per testare questo endpoint.

DELETE /api/graph/onedrive/items/{itemId} management.admin

Moves one Microsoft OneDrive driveItem to the recycle bin.

Curl

curl -X DELETE \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/graph/onedrive/items/{itemId}"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/graph/onedrive/items/{itemId}/content management.read

Downloads one Microsoft OneDrive file as base64 or to a local output path.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/graph/onedrive/items/{itemId}/content"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/graph/onedrive/search management.read

Searches Microsoft OneDrive files and folders.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/graph/onedrive/search"

Try request

Seleziona Esegui per testare questo endpoint.

health

1 endpoint

GET /health anonymous

Returns API health.

Curl

curl -X GET \
  "$BASE_URL/health"

Try request

Seleziona Esegui per testare questo endpoint.

Imports

2 endpoint

POST /api/imports/odoo/reconcile-relationships management.write

Reconciles saved Odoo relationships to local entity references when possible.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/imports/odoo/reconcile-relationships"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/imports/odoo/relationships management.read

Lists Odoo external relationships saved during local imports.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/imports/odoo/relationships"

Try request

Seleziona Esegui per testare questo endpoint.

Infomaniak

5 endpoint

GET /api/infomaniak/calendar-events management.read

Lists Infomaniak calendar events with flexible date filters.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/infomaniak/calendar-events"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/infomaniak/events management.read

Lists Infomaniak events.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/infomaniak/events"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/infomaniak/events/{eventId} management.read

Reads one Infomaniak event.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/infomaniak/events/{eventId}"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/infomaniak/mailboxes management.read

Lists Infomaniak mailboxes.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/infomaniak/mailboxes"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/infomaniak/mailing-lists management.read

Lists Infomaniak mailing lists.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/infomaniak/mailing-lists"

Try request

Seleziona Esegui per testare questo endpoint.

Invoices

8 endpoint

POST /api/invoices/archive/status-sync management.write

Synchronizes local invoice archive status from registry CSV.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/invoices/archive/status-sync"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/invoices/draft-package management.write

Prepares a local Odoo invoice draft package.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/invoices/draft-package"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/invoices/email/confirm management.write

Confirms one invoice email in the registry.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/invoices/email/confirm"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/invoices/email/prepare management.write

Prepares one invoice email package.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/invoices/email/prepare"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/invoices/email/send-pending management.write

Sends pending invoice email packages.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/invoices/email/send-pending"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/invoices/mark-paid management.write

Marks one invoice as paid in the registry.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/invoices/mark-paid"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/invoices/migrate management.admin

Migrates legacy Markdown invoices to invoice JSON.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/invoices/migrate"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/invoices/{number}/sent-verification management.read

Verifies whether an invoice appears in sent mail.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/invoices/{number}/sent-verification"

Try request

Seleziona Esegui per testare questo endpoint.

Mail

1 endpoint

POST /api/mail/send management.write

Creates or sends an email through the configured mail sender.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/mail/send"

Try request

Seleziona Esegui per testare questo endpoint.

MCP

2 endpoint

GET /api/mcp/publication management.read

Returns MCP public publication readiness details.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/mcp/publication"

Try request

Seleziona Esegui per testare questo endpoint.

POST /mcp management.read

Serves the remote MCP JSON-RPC endpoint for ChatGPT and Codex.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/mcp"

Try request

Seleziona Esegui per testare questo endpoint.

Quotes

5 endpoint

POST /api/quotes/confirm management.write

Confirms one quote in the registry.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/quotes/confirm"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/quotes/convert-to-invoice management.write

Converts a quote payload into an invoice draft JSON.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/quotes/convert-to-invoice"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/quotes/prepare management.write

Prepares one quote email package.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/quotes/prepare"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/quotes/registry/init management.write

Initializes the local quote registry.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/quotes/registry/init"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/quotes/send-pending management.write

Sends pending quote email packages.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/quotes/send-pending"

Try request

Seleziona Esegui per testare questo endpoint.

root

1 endpoint

GET / anonymous

Redirects to the interactive API documentation page.

Curl

curl -X GET \
  "$BASE_URL/"

Try request

Seleziona Esegui per testare questo endpoint.

Services

3 endpoint

GET /api/services management.read

Lists available management services.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/services"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/services/{name} management.read

Returns one management service descriptor.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/services/{name}"

Try request

Seleziona Esegui per testare questo endpoint.

GET /api/services/{name}/plan management.read

Returns the implementation plan for one service.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/services/{name}/plan"

Try request

Seleziona Esegui per testare questo endpoint.

settings

1 endpoint

GET /api/settings management.read

Returns redacted management settings loaded from Core user-secrets, environment and local config files.

Curl

curl -X GET \
  -H 'Authorization: Bearer <token>' \
  "$BASE_URL/api/settings"

Try request

Seleziona Esegui per testare questo endpoint.

Synchronization

3 endpoint

POST /api/sync/entra-odoo/email-report management.write

Creates and emails an Entra/Odoo synchronization report.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/sync/entra-odoo/email-report"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/sync/entra-odoo/plan management.read

Builds a read-only Entra/Odoo synchronization plan.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/sync/entra-odoo/plan"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/sync/entra-odoo/report management.read

Creates a read-only Entra/Odoo synchronization report.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/sync/entra-odoo/report"

Try request

Seleziona Esegui per testare questo endpoint.

Validation

3 endpoint

POST /api/validation/archive management.read

Validates the local management archive.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/validation/archive"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/validation/customers management.read

Validates local customer snapshots.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/validation/customers"

Try request

Seleziona Esegui per testare questo endpoint.

POST /api/validation/work-items management.read

Validates local work item snapshots.

Curl

curl -X POST \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  --data '{}' \
  "$BASE_URL/api/validation/work-items"

Try request

Seleziona Esegui per testare questo endpoint.

Well-known

2 endpoint

GET /.well-known/oauth-protected-resource anonymous

Returns OAuth protected-resource metadata for ChatGPT MCP linking.

Curl

curl -X GET \
  "$BASE_URL/.well-known/oauth-protected-resource"

Try request

Seleziona Esegui per testare questo endpoint.

GET /.well-known/openai-apps-challenge anonymous

Returns the OpenAI Apps domain verification challenge token when configured.

Curl

curl -X GET \
  "$BASE_URL/.well-known/openai-apps-challenge"

Try request

Seleziona Esegui per testare questo endpoint.