{"openapi":"3.0.0","paths":{"/health/live":{"get":{"operationId":"HealthController_live","parameters":[],"responses":{"200":{"description":""}},"tags":["Health"]}},"/health/ready":{"get":{"operationId":"HealthController_ready","parameters":[],"responses":{"200":{"description":""}},"tags":["Health"]}},"/admin/stats":{"get":{"operationId":"AdminController_getStats","parameters":[],"responses":{"200":{"description":"Aggregate platform statistics (companies, users, kyc, recent logs)"}},"security":[{"bearer":[]}],"summary":"Get global platform statistics and KPI aggregates","tags":["Platform Administration"]}},"/admin/finance-summary":{"get":{"operationId":"AdminController_getFinanceSummary","parameters":[],"responses":{"200":{"description":"Aggregate platform subscription revenue figures"}},"security":[{"bearer":[]}],"summary":"Platform-wide finance breakdown (facture/encaisse/impayes/prevision)","tags":["Platform Administration"]}},"/admin/accountants":{"get":{"operationId":"AdminController_getAccountants","parameters":[{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string"}},{"name":"cabinetId","required":false,"in":"query","description":"Cabinet id","schema":{"type":"string"}},{"name":"sort","required":false,"in":"query","schema":{"enum":["name","email","cabinet","clients","status","createdAt"],"type":"string"}},{"name":"dir","required":false,"in":"query","schema":{"enum":["asc","desc"],"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{}},{"name":"limit","required":false,"in":"query","description":"Page size; total in X-Total-Count","schema":{}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Platform Administration"]},"post":{"operationId":"AdminController_createAccountant","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAccountantDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Platform Administration"]}},"/admin/accountants/stats":{"get":{"operationId":"AdminController_getAccountantStats","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: headline figures of the accountants list (whole platform)","tags":["Platform Administration"]}},"/admin/accountants/clients":{"get":{"operationId":"AdminController_getAccountantClients","parameters":[{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"cabinetId","required":false,"in":"query","schema":{"type":"string"}},{"name":"ids","required":false,"in":"query","description":"Comma-separated company ids","schema":{"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{}},{"name":"limit","required":false,"in":"query","schema":{}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Platform Administration"]}},"/admin/accountants/{userId}":{"get":{"operationId":"AdminController_getAccountant","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: one accountant (the detail page)","tags":["Platform Administration"]},"patch":{"operationId":"AdminController_updateAccountant","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountantDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Platform Administration"]},"delete":{"operationId":"AdminController_removeAccountant","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Platform Administration"]}},"/admin/accountants/{userId}/resend-invite":{"post":{"operationId":"AdminController_resendAccountantInvite","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Platform Administration"]}},"/admin/accountants/{userId}/clients":{"put":{"operationId":"AdminController_assignAccountantClients","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignAccountantClientsDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Platform Administration"]}},"/admin/accountants/{userId}/cabinets":{"post":{"operationId":"AdminController_addAccountantCabinet","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddAccountantCabinetDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: Add an accountant to another accounting firm","tags":["Platform Administration"]}},"/admin/accountants/{userId}/cabinets/{cabinetId}":{"delete":{"operationId":"AdminController_removeAccountantCabinet","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: End an accountant's membership at one accounting firm","tags":["Platform Administration"]}},"/admin/cabinets":{"get":{"operationId":"AdminController_getCabinets","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: List all accounting firms","tags":["Platform Administration"]},"post":{"operationId":"AdminController_createCabinet","parameters":[],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreateCabinetDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: Create a new accounting firm, with its Justificatif d’activité","tags":["Platform Administration"]}},"/admin/cabinets/eligible":{"get":{"operationId":"AdminController_getEligibleCabinets","parameters":[{"name":"search","required":false,"in":"query","description":"Part of the firm name","schema":{"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{}},{"name":"limit","required":false,"in":"query","description":"Page size; total in X-Total-Count","schema":{}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: List accounting firms with at least one validated accountant","tags":["Platform Administration"]}},"/admin/cabinets/print":{"get":{"operationId":"AdminController_printCabinets","parameters":[{"name":"ids","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Platform Administration"]}},"/admin/cabinets/{id}":{"get":{"operationId":"AdminController_getCabinet","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: Get accounting firm details","tags":["Platform Administration"]},"put":{"operationId":"AdminController_updateCabinet","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveCabinetDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: Edit an accounting firm","tags":["Platform Administration"]},"delete":{"operationId":"AdminController_removeCabinet","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: Archive an accounting firm","tags":["Platform Administration"]}},"/admin/cabinets/{id}/status":{"patch":{"operationId":"AdminController_setCabinetStatus","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCabinetStatusDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: Suspend, reactivate, validate or restore an accounting firm (status only)","tags":["Platform Administration"]}},"/admin/cabinets/{id}/reject":{"post":{"operationId":"AdminController_rejectCabinet","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RejectCabinetDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: Reject a Demande d’ouverture with its Motif: the Cabinet becomes « Rejeté », its matricule is freed and a Ticket de rejet opens with the requester","tags":["Platform Administration"]}},"/admin/cabinets/{id}/validate-rejected":{"post":{"operationId":"AdminController_validateRejectedCabinet","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: Validate a rejected Demande d’ouverture after all: the Cabinet becomes « Actif », its requester its administrator again, and its Ticket de rejet closes (ADR 0033)","tags":["Platform Administration"]}},"/admin/cabinets/{id}/plan":{"put":{"operationId":"AdminController_assignCabinetPlan","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignCabinetPlanDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: Change an accounting firm's JCF plan","tags":["Platform Administration"]}},"/admin/cabinets/{id}/accountants":{"put":{"operationId":"AdminController_assignCabinetAccountants","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignCabinetAccountantsDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: Set an accounting firm's accountant roster","tags":["Platform Administration"]}},"/admin/companies":{"get":{"operationId":"AdminController_getCompanies","parameters":[{"name":"search","required":false,"in":"query","description":"Filter by name or matricule fiscal","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","description":"Filter by company status","schema":{"type":"string"}},{"name":"kycStatus","required":false,"in":"query","description":"Filter by KYC compliance status","schema":{"type":"string"}},{"name":"plan","required":false,"in":"query","description":"Latest plan label","schema":{"type":"string"}},{"name":"accountantId","required":false,"in":"query","schema":{"type":"string"}},{"name":"createdSince","required":false,"in":"query","description":"ISO date","schema":{"type":"string"}},{"name":"ids","required":false,"in":"query","description":"Comma-separated ids","schema":{"type":"string"}},{"name":"sort","required":false,"in":"query","schema":{"enum":["name","createdAt","status","pack","accountant"],"type":"string"}},{"name":"dir","required":false,"in":"query","schema":{"enum":["asc","desc"],"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{}},{"name":"limit","required":false,"in":"query","description":"Page size (SQL); total in X-Total-Count","schema":{}}],"responses":{"200":{"description":"List of tenant companies"}},"security":[{"bearer":[]}],"summary":"Admin: Search and list all tenant companies","tags":["Platform Administration"]},"post":{"operationId":"AdminController_createCompany","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCompanyAdminDto"}}}},"responses":{"201":{"description":"Company created"}},"security":[{"bearer":[]}],"summary":"Admin: Create a company with its Pièces justificatives in one request (ADR 0027)","tags":["Platform Administration"]}},"/admin/companies/stats":{"get":{"operationId":"AdminController_getCompanyStats","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: headline figures of the client list (whole platform)","tags":["Platform Administration"]}},"/admin/companies/print":{"get":{"operationId":"AdminController_printCompanies","parameters":[{"name":"ids","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Platform Administration"]}},"/admin/declarations":{"get":{"operationId":"AdminController_getDeclarations","parameters":[{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: List all platform declarations","tags":["Platform Administration"]}},"/admin/companies/{companyId}":{"patch":{"operationId":"AdminController_updateCompany","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCompanyAdminDto"}}}},"responses":{"200":{"description":"Company updated"},"404":{"description":"Company not found"}},"security":[{"bearer":[]}],"summary":"Admin: Edit core company identification fields","tags":["Platform Administration"]}},"/admin/companies/{companyId}/accountant":{"put":{"operationId":"AdminController_assignCompanyAccountant","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignCompanyAccountantDto"}}}},"responses":{"200":{"description":"Accountant assigned to company"},"404":{"description":"Company or accountant not found"}},"security":[{"bearer":[]}],"summary":"Admin: Assign an accountant to a company (company side)","tags":["Platform Administration"]},"delete":{"operationId":"AdminController_unassignCompanyAccountants","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: Remove all accountant assignments from a company","tags":["Platform Administration"]}},"/admin/companies/{companyId}/firm":{"put":{"operationId":"AdminController_assignCompanyFirm","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignCompanyFirmDto"}}}},"responses":{"200":{"description":"Firm assigned to company"},"404":{"description":"Company or cabinet not found"}},"security":[{"bearer":[]}],"summary":"Admin: Assign (or unassign, with a null cabinetId) the accounting firm handling a company","tags":["Platform Administration"]}},"/admin/companies/{companyId}/status":{"patch":{"operationId":"AdminController_updateCompanyStatus","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCompanyAdminStatusDto"}}}},"responses":{"200":{"description":"Company status updated"},"404":{"description":"Company not found"}},"security":[{"bearer":[]}],"summary":"Admin: Update company lifecycle status","tags":["Platform Administration"]}},"/admin/companies/{companyId}/document-requests":{"post":{"operationId":"AdminController_requestCompanyDocuments","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestCompanyDocumentsDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: request documents from a company","tags":["Platform Administration"]}},"/admin/companies/{companyId}/access-reset":{"post":{"operationId":"AdminController_requestCompanyAccessReset","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: send an access reset link to the company owner","tags":["Platform Administration"]}},"/admin/audit-logs":{"get":{"operationId":"AdminController_getAuditLogs","parameters":[{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"action","required":false,"in":"query","schema":{"type":"string"}},{"name":"actor","required":false,"in":"query","description":"Exact actor label","schema":{"type":"string"}},{"name":"module","required":false,"in":"query","schema":{"type":"string"}},{"name":"result","required":false,"in":"query","schema":{"enum":["success","failure"],"type":"string"}},{"name":"scope","required":false,"in":"query","schema":{"enum":["platform","company","cabinet"],"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{}},{"name":"limit","required":false,"in":"query","description":"Number of audit entries to fetch","schema":{"example":50}}],"responses":{"200":{"description":"List of audit entries"}},"security":[{"bearer":[]}],"summary":"Admin: Retrieve platform security and mutation audit logs","tags":["Platform Administration"]}},"/admin/audit-logs/facets":{"get":{"operationId":"AdminController_getAuditLogFacets","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: filter options of the audit journal","tags":["Platform Administration"]}},"/admin/login-events":{"get":{"operationId":"AdminController_getLoginEvents","parameters":[{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"userId","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["success","failure","mfa_required"],"type":"string"}},{"name":"eventType","required":false,"in":"query","schema":{"enum":["login","logout","failed"],"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: login journal (connexions, déconnexions, failed attempts), paged with ?limit&offset","tags":["Platform Administration"]}},"/admin/login-events/facets":{"get":{"operationId":"AdminController_getLoginEventFacets","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: users and 24 h counters of the login journal","tags":["Platform Administration"]}},"/practice/cabinets/self":{"post":{"operationId":"AccountantOnboardingController_createOwnCabinet","parameters":[],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreateSelfServiceCabinetDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"An authenticated accountant requests a cabinet they administer, with its Justificatif d’activité","tags":["Accountant onboarding"]}},"/practice/cabinets/self/{id}":{"delete":{"operationId":"AccountantOnboardingController_withdrawOwnCabinet","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"The cabinet_admin of a pending cabinet withdraws the request (frees its matricule)","tags":["Accountant onboarding"]}},"/companies/{companyId}/messages/threads":{"get":{"operationId":"MessagingController_getThreads","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["open","closed"],"type":"string"}},{"name":"withMessages","required":false,"in":"query","description":"true: each thread carries its messages (one request instead of one per thread)","schema":{"type":"string"}}],"responses":{"200":{"description":"List of message threads"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List message threads for company","tags":["Communications - Messaging"]},"post":{"operationId":"MessagingController_createThread","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateThreadDto"}}}},"responses":{"201":{"description":"Message thread created with initial message"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Create a new message thread","tags":["Communications - Messaging"]}},"/companies/{companyId}/messages/threads/{threadId}":{"get":{"operationId":"MessagingController_getThread","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"threadId","required":true,"in":"path","description":"Thread UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Thread details"},"404":{"description":"Thread not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Get thread details by ID","tags":["Communications - Messaging"]}},"/companies/{companyId}/messages/threads/{threadId}/messages":{"get":{"operationId":"MessagingController_getMessages","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"threadId","required":true,"in":"path","description":"Thread UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Chronological list of messages"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List all messages inside a thread","tags":["Communications - Messaging"]},"post":{"operationId":"MessagingController_sendMessage","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"threadId","required":true,"in":"path","description":"Thread UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendMessageDto"}}}},"responses":{"201":{"description":"Message posted"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Post a reply message in a thread","tags":["Communications - Messaging"]}},"/companies/{companyId}/messages/stream/token":{"post":{"operationId":"MessagingController_getStreamToken","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"201":{"description":"GetStream token and public API key"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Obtain GetStream authentication token for currently logged-in user","tags":["Communications - Messaging"]}},"/companies/{companyId}/messages/stream/channel":{"post":{"operationId":"MessagingController_getStreamCompanyChannel","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"201":{"description":"Stream channel details and token"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Provision or retrieve GetStream channel for company client & accountant","tags":["Communications - Messaging"]}},"/realtime/token":{"post":{"operationId":"RealtimeController_token","parameters":[],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Stream token for the signed-in user (live notifications and messages)","tags":["Communications - Realtime"]}},"/realtime/sync":{"post":{"operationId":"RealtimeController_sync","parameters":[],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Makes sure every conversation of the signed-in user exists in Stream (channel, membership, messages)","tags":["Communications - Realtime"]}},"/integrations/rne/lookup/{identifier}":{"get":{"operationId":"IntegrationsController_lookupRne","parameters":[{"name":"identifier","required":true,"in":"path","description":"Matricule Fiscal or Trade Register number","schema":{"type":"string"}}],"responses":{"200":{"description":"Verified enterprise profile"}},"security":[{"bearer":[]}],"summary":"Lookup company in Tunisian RNE business register by Matricule Fiscal or RC","tags":["Integrations & 3rd-Party APIs"]}},"/integrations/ttn/process-invoice":{"post":{"operationId":"IntegrationsController_processTtnInvoice","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TtnInvoiceDto"}}}},"responses":{"201":{"description":"TTN validation result with XML and QR code data URL"}},"security":[{"bearer":[]}],"summary":"Process invoice for TTN El-Fatura (validates, computes digest, and produces 2D QR code)","tags":["Integrations & 3rd-Party APIs"]}},"/integrations/tej/generate-certificate":{"post":{"operationId":"IntegrationsController_generateTejCertificate","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TejCertificateDto"}}}},"responses":{"201":{"description":"TEJ certificate result with totals, SHA-256 hash, and QR code"}},"security":[{"bearer":[]}],"summary":"Generate a TEJ-compliant electronic withholding tax certificate with QR verification","tags":["Integrations & 3rd-Party APIs"]}},"/integrations/sms/send-otp":{"post":{"operationId":"IntegrationsController_sendSmsOtp","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendOtpDto"}}}},"responses":{"201":{"description":"SMS dispatch confirmation"}},"security":[{"bearer":[]}],"summary":"Dispatch a 2FA OTP verification code via SMS (code is generated server-side)","tags":["Integrations & 3rd-Party APIs"]}},"/auth/register":{"post":{"operationId":"IdentityController_register","parameters":[{"name":"origin","required":true,"in":"header","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterDto"}}}},"responses":{"201":{"description":""}},"tags":["Identity"]}},"/auth/verify-email":{"post":{"operationId":"IdentityController_verifyEmail","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmailDto"}}}},"responses":{"204":{"description":""}},"tags":["Identity"]}},"/auth/verify-email-code":{"post":{"operationId":"IdentityController_verifyEmailCode","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmailCodeDto"}}}},"responses":{"204":{"description":""}},"tags":["Identity"]}},"/auth/resend-verification":{"post":{"operationId":"IdentityController_resendVerification","parameters":[{"name":"origin","required":true,"in":"header","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordDto"}}}},"responses":{"204":{"description":""}},"tags":["Identity"]}},"/auth/forgot-password":{"post":{"operationId":"IdentityController_forgotPassword","parameters":[{"name":"origin","required":true,"in":"header","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgotPasswordDto"}}}},"responses":{"204":{"description":""}},"tags":["Identity"]}},"/auth/reset-password":{"post":{"operationId":"IdentityController_resetPassword","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetPasswordDto"}}}},"responses":{"204":{"description":""}},"tags":["Identity"]}},"/auth/login":{"post":{"operationId":"IdentityController_login","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginDto"}}}},"responses":{"201":{"description":""}},"tags":["Identity"]}},"/auth/refresh":{"post":{"operationId":"IdentityController_refresh","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshDto"}}}},"responses":{"201":{"description":""}},"tags":["Identity"]}},"/auth/logout":{"post":{"operationId":"IdentityController_logout","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshDto"}}}},"responses":{"204":{"description":""}},"tags":["Identity"]}},"/auth/me":{"get":{"operationId":"IdentityController_me","parameters":[],"responses":{"200":{"description":""}},"tags":["Identity"]}},"/auth/me/memberships":{"get":{"operationId":"IdentityController_myMemberships","parameters":[],"responses":{"200":{"description":""}},"tags":["Identity"]}},"/auth/me/memberships/{id}/visit":{"post":{"operationId":"IdentityController_recordVisit","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"tags":["Identity"]}},"/auth/me/locale":{"patch":{"operationId":"IdentityController_setLocale","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetLocaleDto"}}}},"responses":{"204":{"description":""}},"tags":["Identity"]}},"/auth/change-password":{"post":{"operationId":"IdentityController_changePassword","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangePasswordDto"}}}},"responses":{"204":{"description":""}},"tags":["Identity"]}},"/auth/delete-account":{"post":{"operationId":"IdentityController_deleteAccount","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAccountDto"}}}},"responses":{"204":{"description":""}},"tags":["Identity"]}},"/auth/mfa/enroll":{"post":{"operationId":"IdentityController_enrollMfa","parameters":[],"responses":{"201":{"description":""}},"tags":["Identity"]}},"/auth/mfa/confirm":{"post":{"operationId":"IdentityController_confirmMfa","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmMfaDto"}}}},"responses":{"204":{"description":""}},"tags":["Identity"]}},"/auth/mfa/status":{"get":{"operationId":"IdentityController_mfaStatus","parameters":[],"responses":{"200":{"description":""}},"tags":["Identity"]}},"/companies/{companyId}/documents":{"get":{"operationId":"DocumentsController_getDocuments","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"zone","required":false,"in":"query","schema":{"enum":["operational","vault"],"type":"string"}},{"name":"category","required":false,"in":"query","description":"Document category","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["to_classify","processing","filed","to_correct"],"type":"string"}},{"name":"search","required":false,"in":"query","description":"File name","schema":{"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{}},{"name":"limit","required":false,"in":"query","description":"SQL page size; total in X-Total-Count","schema":{}}],"responses":{"200":{"description":"List of documents"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List and filter indexed documents","tags":["Documents & Vault"]},"post":{"operationId":"DocumentsController_createDocument","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDocumentDto"}}}},"responses":{"201":{"description":"Document successfully registered and hashed"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Index and register a new document","tags":["Documents & Vault"]}},"/companies/{companyId}/documents/presign-upload":{"post":{"operationId":"DocumentsController_presignUpload","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignUploadDto"}}}},"responses":{"201":{"description":"Presigned upload URL and assigned storageKey generated"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Obtain a signed Cloudinary upload (URL and form fields) for direct client-to-storage upload","tags":["Documents & Vault"]}},"/companies/{companyId}/documents/{id}/presign-download":{"get":{"operationId":"DocumentsController_presignDownload","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Document UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Presigned download URL"},"404":{"description":"Document not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Obtain a temporary presigned download URL for a document","tags":["Documents & Vault"]}},"/companies/{companyId}/documents/{id}/versions":{"get":{"operationId":"DocumentsController_getDocumentVersions","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Document UUID","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List retained versions of a document","tags":["Documents & Vault"]},"post":{"operationId":"DocumentsController_addDocumentVersion","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Document UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddDocumentVersionDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Upload a new version of a document (the previous one is retained)","tags":["Documents & Vault"]}},"/companies/{companyId}/documents/{id}/content":{"get":{"operationId":"DocumentsController_content","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Document UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"File content"},"404":{"description":"Document or its file not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Document bytes for viewing in the browser (inline for PDF/images/text, attachment otherwise)","tags":["Documents & Vault"]}},"/companies/{companyId}/documents/{id}/versions/{version}/presign-download":{"get":{"operationId":"DocumentsController_presignVersionDownload","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"version","required":true,"in":"path","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Obtain a temporary URL for a retained document version","tags":["Documents & Vault"]}},"/companies/{companyId}/documents/{id}":{"get":{"operationId":"DocumentsController_getDocument","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Document UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Document metadata details"},"404":{"description":"Document not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Get document details by ID","tags":["Documents & Vault"]},"patch":{"operationId":"DocumentsController_updateDocument","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Document UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDocumentDto"}}}},"responses":{"200":{"description":"Document metadata successfully updated"},"404":{"description":"Document not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Update document metadata or status","tags":["Documents & Vault"]},"delete":{"operationId":"DocumentsController_deleteDocument","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Document UUID","schema":{"type":"string"}}],"responses":{"204":{"description":"Document deleted"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Remove a document","tags":["Documents & Vault"]}},"/companies/{companyId}/documents/{id}/extract":{"post":{"operationId":"DocumentsController_extractDocument","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Document UUID","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Run field extraction (text PDFs and images) and store the result on the document","tags":["Documents & Vault"]}},"/companies/{companyId}/documents/{id}/archive":{"post":{"operationId":"DocumentsController_archiveDocument","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Document UUID","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Archive a document while retaining its metadata and storage object","tags":["Documents & Vault"]}},"/practice/cabinets/{cabinetId}/requests":{"get":{"operationId":"RequestsController_getRequests","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List client requests","tags":["Practice - Client Requests"]},"post":{"operationId":"RequestsController_createRequest","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateClientRequestDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a client document or query request","tags":["Practice - Client Requests"]}},"/practice/cabinets/{cabinetId}/requests/{id}":{"get":{"operationId":"RequestsController_getRequest","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get client request details","tags":["Practice - Client Requests"]},"patch":{"operationId":"RequestsController_updateRequest","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateClientRequestDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update a client request","tags":["Practice - Client Requests"]},"delete":{"operationId":"RequestsController_deleteRequest","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a client request","tags":["Practice - Client Requests"]}},"/practice/cabinets/{cabinetId}/requests/{id}/remind":{"post":{"operationId":"RequestsController_sendReminder","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Send a reminder for a client request","tags":["Practice - Client Requests"]}},"/practice/cabinets/{cabinetId}/requests/{id}/comments":{"post":{"operationId":"RequestsController_addComment","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateClientRequestCommentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Add a persisted comment to a client request","tags":["Practice - Client Requests"]}},"/practice/cabinets/{cabinetId}/requests/{id}/documents":{"post":{"operationId":"RequestsController_attachDocument","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttachClientRequestDocumentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Attach a company-owned document to a client request","tags":["Practice - Client Requests"]}},"/practice/cabinets/{cabinetId}/dashboard":{"get":{"operationId":"WorkspaceController_getDashboard","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Real KPIs of the caller portfolio","tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/clients/{companyId}":{"get":{"operationId":"WorkspaceController_clientFile","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"year","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Client file overview: company, counters, assigned team, contacts","tags":["Practice - Workspace"]},"patch":{"operationId":"PortfolioController_updateClient","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePortfolioClientDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update a client company in this cabinet","tags":["Practice - Portfolio"]}},"/practice/cabinets/{cabinetId}/clients/{companyId}/accounting-periods":{"get":{"operationId":"WorkspaceController_accountingPeriods","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Open accounting periods of a client","tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/validation-queue":{"get":{"operationId":"WorkspaceController_validationQueue","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"query","schema":{"type":"string"}},{"name":"kind","required":true,"in":"query","schema":{"type":"string"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"period","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Validation queue: declarations awaiting company approval or correction, bilans awaiting approval","tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/declarations":{"get":{"operationId":"WorkspaceController_declarations","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Declarations across the caller clients","tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/declarations/{id}":{"get":{"operationId":"WorkspaceController_declaration","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Declaration detail: versions, controls, transmissions","tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/clients/{companyId}/feedback":{"post":{"operationId":"WorkspaceController_feedback","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Record a client satisfaction rating for a team member","tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/documents/{id}/review":{"post":{"operationId":"WorkspaceController_review","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewDocumentDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Validate or reject a document from the review queue","tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/signatures":{"get":{"operationId":"WorkspaceController_signatures","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]},"post":{"operationId":"WorkspaceController_createSignature","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSignatureDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/signatures/{id}/cancel":{"post":{"operationId":"WorkspaceController_cancelSignature","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/messages/threads":{"get":{"operationId":"WorkspaceController_threads","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]},"post":{"operationId":"WorkspaceController_createThread","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateThreadDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/messages/threads/{threadId}/messages":{"get":{"operationId":"WorkspaceController_messages","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"threadId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]},"post":{"operationId":"WorkspaceController_postMessage","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"threadId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostMessageDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/messages/threads/{threadId}/messages/{messageId}/convert":{"post":{"operationId":"WorkspaceController_convert","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"threadId","required":true,"in":"path","schema":{"type":"string"}},{"name":"messageId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConvertMessageDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a task, request, mission or anomaly from a message","tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/reminder-rules":{"get":{"operationId":"WorkspaceController_listRules","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]},"post":{"operationId":"WorkspaceController_createRule","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReminderRuleDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/reminder-rules/{id}":{"get":{"operationId":"WorkspaceController_getRule","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]},"put":{"operationId":"WorkspaceController_updateRule","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReminderRuleDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]},"delete":{"operationId":"WorkspaceController_deleteRule","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/reminder-rules/{id}/active":{"patch":{"operationId":"WorkspaceController_setRuleActive","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetActiveDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/reminders":{"get":{"operationId":"WorkspaceController_listReminders","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/reminders/{id}/cancel":{"post":{"operationId":"WorkspaceController_cancelReminder","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/notifications":{"get":{"operationId":"WorkspaceController_listNotifications","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"archived","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/notifications/unread-count":{"get":{"operationId":"WorkspaceController_unreadCount","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/notifications/{id}":{"get":{"operationId":"WorkspaceController_getNotification","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/notifications/read-all":{"post":{"operationId":"WorkspaceController_readAll","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/notifications/{id}/read":{"patch":{"operationId":"WorkspaceController_markRead","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/notifications/{id}/archive":{"patch":{"operationId":"WorkspaceController_archive","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/team":{"get":{"operationId":"WorkspaceController_listTeam","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/team/invite":{"post":{"operationId":"WorkspaceController_inviteTeamMember","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteTeamMemberDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/team/absences":{"get":{"operationId":"WorkspaceController_listAbsences","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/team/roles":{"get":{"operationId":"WorkspaceController_listRoles","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/team/roles/{roleId}/permissions":{"patch":{"operationId":"WorkspaceController_updateRolePermissions","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"roleId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRolePermissionsDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/team/{userId}":{"get":{"operationId":"WorkspaceController_teamMember","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]},"delete":{"operationId":"WorkspaceController_removeTeamMember","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Remove a member from the team (administrators; never the last administrator)","tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/team/{userId}/suspend":{"post":{"operationId":"WorkspaceController_suspendTeamMember","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Suspend a member: access ends, assignments are kept (administrators; never the last administrator)","tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/team/{userId}/reactivate":{"post":{"operationId":"WorkspaceController_reactivateTeamMember","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Give a suspended member their access back","tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/team/{userId}/absences":{"post":{"operationId":"WorkspaceController_addAbsence","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbsenceDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/team/{userId}/absences/{id}":{"delete":{"operationId":"WorkspaceController_removeAbsence","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/team/{userId}/role":{"patch":{"operationId":"WorkspaceController_changeMemberRole","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeMemberRoleDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/team/{userId}/assignments":{"post":{"operationId":"WorkspaceController_assign","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignClientDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/team/{userId}/assignments/{companyId}":{"delete":{"operationId":"WorkspaceController_unassign","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"userId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/settings":{"get":{"operationId":"WorkspaceController_getSettings","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/settings/cabinet":{"put":{"operationId":"WorkspaceController_updateCabinet","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCabinetDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/settings/profile":{"put":{"operationId":"WorkspaceController_updateProfile","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProfileDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/settings/notification-preferences":{"put":{"operationId":"WorkspaceController_setPreferences","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetPreferencesDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/settings/operational/{kind}":{"get":{"operationId":"WorkspaceController_getOperationalSettings","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"kind","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]},"put":{"operationId":"WorkspaceController_updateOperationalSettings","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"kind","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationalSettingsDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Workspace"]}},"/practice/cabinets/{cabinetId}/documents":{"get":{"operationId":"LibraryController_list","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"zone","required":true,"in":"query","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"query","schema":{"type":"string"}},{"name":"mine","required":true,"in":"query","schema":{"type":"string"}},{"name":"review","required":true,"in":"query","schema":{"type":"string"}},{"name":"internal","required":true,"in":"query","schema":{"type":"string"}},{"name":"archived","required":true,"in":"query","schema":{"type":"string"}},{"name":"favorite","required":true,"in":"query","schema":{"type":"string"}},{"name":"folderId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Documents (zone, mine, review, internal, archived, favorite, companyId filters)","tags":["Practice - Documents library"]},"post":{"operationId":"LibraryController_create","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateLibraryDocumentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Documents library"]}},"/practice/cabinets/{cabinetId}/documents/presign-upload":{"post":{"operationId":"LibraryController_presign","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Documents library"]}},"/practice/cabinets/{cabinetId}/documents/{id}":{"get":{"operationId":"LibraryController_detail","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Documents library"]},"patch":{"operationId":"LibraryController_update","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateLibraryDocumentDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Documents library"]}},"/practice/cabinets/{cabinetId}/documents/{id}/download":{"get":{"operationId":"LibraryController_download","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Documents library"]}},"/practice/cabinets/{cabinetId}/documents/{id}/content":{"get":{"operationId":"LibraryController_content","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Document bytes (inline)","tags":["Practice - Documents library"]}},"/practice/cabinets/{cabinetId}/documents/{id}/favorite":{"put":{"operationId":"LibraryController_favorite","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FavoriteDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Documents library"]}},"/practice/cabinets/{cabinetId}/documents/{id}/comments":{"post":{"operationId":"LibraryController_comment","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Documents library"]}},"/practice/cabinets/{cabinetId}/documents/{id}/versions":{"post":{"operationId":"LibraryController_version","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddVersionDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Documents library"]}},"/practice/cabinets/{cabinetId}/document-folders":{"get":{"operationId":"LibraryController_folders","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"query","schema":{"type":"string"}},{"name":"internal","required":true,"in":"query","schema":{"type":"string"}},{"name":"zone","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Documents library"]},"post":{"operationId":"LibraryController_createFolder","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FolderDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Documents library"]}},"/practice/cabinets/{cabinetId}/document-folders/{id}":{"put":{"operationId":"LibraryController_updateFolder","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FolderDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Documents library"]},"delete":{"operationId":"LibraryController_deleteFolder","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Documents library"]}},"/practice/cabinet-invitations":{"get":{"operationId":"CabinetInvitationsController_list","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Cabinet invitations waiting for my answer","tags":["Cabinet invitations"]}},"/practice/cabinet-invitations/{membershipId}/accept":{"post":{"operationId":"CabinetInvitationsController_accept","parameters":[{"name":"membershipId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Join the cabinet","tags":["Cabinet invitations"]}},"/practice/cabinet-invitations/{membershipId}/decline":{"post":{"operationId":"CabinetInvitationsController_decline","parameters":[{"name":"membershipId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Decline the invitation","tags":["Cabinet invitations"]}},"/practice/cabinet-memberships/{id}/leave":{"post":{"operationId":"CabinetMembershipsController_leave","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeaveCabinetDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Leave this cabinet (never as its last administrator)","tags":["Cabinet invitations"]}},"/practice/cabinet-memberships/{id}/successors":{"get":{"operationId":"CabinetMembershipsController_successors","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Whether leaving needs a successor, and the members who can take the role","tags":["Cabinet invitations"]}},"/practice/cabinets/{cabinetId}/dossiers":{"get":{"operationId":"DossiersController_list","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"scope","required":false,"in":"query","description":"`all` (administrators): every client of the cabinet","schema":{"enum":["mine","all"],"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"The caller's client files with their live workload (declarations, missions, tasks, documents, requests, messages)","tags":["Practice - Dossiers"]}},"/billing/subscriptions":{"post":{"operationId":"PlatformBillingController_subscribe","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Subscribe company or cabinet to a plan","tags":["Billing - Subscriptions & AI Credits"]}},"/billing/subscriptions/preview-change":{"post":{"operationId":"PlatformBillingController_previewChange","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Proration breakdown of a plan change (no writes)","tags":["Billing - Subscriptions & AI Credits"]}},"/billing/subscriptions/{subscriberType}/{subscriberId}":{"get":{"operationId":"PlatformBillingController_getSubscription","parameters":[{"name":"subscriberType","required":true,"in":"path","schema":{"type":"string"}},{"name":"subscriberId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get active subscription for company or cabinet","tags":["Billing - Subscriptions & AI Credits"]}},"/billing/subscriptions/{id}/cancel":{"post":{"operationId":"PlatformBillingController_cancelSubscription","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Cancel a subscription","tags":["Billing - Subscriptions & AI Credits"]}},"/billing/renewals/run":{"post":{"operationId":"PlatformBillingController_runRenewals","parameters":[],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Run subscription renewals and dunning now","tags":["Billing - Subscriptions & AI Credits"]}},"/billing/issuer":{"get":{"operationId":"PlatformBillingController_getIssuer","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Legal identity of JCF as invoice issuer","tags":["Billing - Subscriptions & AI Credits"]}},"/billing/invoices/{subscriberType}/{subscriberId}":{"get":{"operationId":"PlatformBillingController_getInvoices","parameters":[{"name":"subscriberType","required":true,"in":"path","schema":{"type":"string"}},{"name":"subscriberId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List platform invoices for subscriber","tags":["Billing - Subscriptions & AI Credits"]}},"/billing/payment-instructions":{"get":{"operationId":"PlatformBillingController_paymentInstructions","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"JCF bank details for a transfer","tags":["Billing - Subscriptions & AI Credits"]}},"/billing/transfers/cabinet/{cabinetId}":{"get":{"operationId":"PlatformBillingController_cabinetTransfers","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List the cabinet's bank transfers to JCF","tags":["Billing - Subscriptions & AI Credits"]}},"/billing/transfers/cabinet/{cabinetId}/invoices/{invoiceId}/pay":{"post":{"operationId":"PlatformBillingController_payCabinetInvoice","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"invoiceId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Pay a JCF invoice by bank transfer","tags":["Billing - Subscriptions & AI Credits"]}},"/billing/transfers/cabinet/{cabinetId}/{paymentId}/proof/presign":{"post":{"operationId":"PlatformBillingController_presignCabinetProof","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"paymentId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignTransferProofDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Signed upload for a proof of transfer","tags":["Billing - Subscriptions & AI Credits"]}},"/billing/transfers/cabinet/{cabinetId}/{paymentId}/proof":{"post":{"operationId":"PlatformBillingController_submitCabinetProof","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"paymentId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitTransferProofDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Submit the proof of transfer","tags":["Billing - Subscriptions & AI Credits"]}},"/billing/usage-pricing":{"get":{"operationId":"UsageBillingController_pricing","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Pack grid and per-unit rates beyond the largest pack","tags":["Billing - Usage"]}},"/billing/usage-pricing/rates":{"put":{"operationId":"UsageBillingController_setRates","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageRatesDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Set the per-unit rates beyond the largest pack","tags":["Billing - Usage"]}},"/billing/usage/{subscriberType}/{subscriberId}":{"get":{"operationId":"UsageBillingController_summary","parameters":[{"name":"subscriberType","required":true,"in":"path","schema":{"type":"string"}},{"name":"subscriberId","required":true,"in":"path","schema":{"type":"string"}},{"name":"period","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"A company's monthly usage and estimated bill","tags":["Billing - Usage"]}},"/companies/{companyId}/kyc":{"get":{"operationId":"KycController_getCompanyKyc","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"KYC dossier view"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Get the KYC dossier status and required documents of a company","tags":["Governance - KYC"]}},"/companies/{companyId}/kyc/submit":{"post":{"operationId":"KycController_submitKyc","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitKycDto"}}}},"responses":{"201":{"description":"KYC dossier marked for verification; returns the dossier view"},"400":{"description":"Required documents missing or expired"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Submit KYC dossier for compliance review","tags":["Governance - KYC"]}},"/admin/kyc/files":{"get":{"operationId":"KycController_listKycFiles","parameters":[{"name":"status","required":false,"in":"query","description":"Filter by KYC status","schema":{"type":"string"}}],"responses":{"200":{"description":"List of KYC files"}},"security":[{"bearer":[]}],"summary":"Admin: List KYC dossier files pending review","tags":["Governance - KYC"]}},"/admin/kyc/files/{id}":{"get":{"operationId":"KycController_getKycFile","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: Get a KYC dossier with documents and decision history","tags":["Governance - KYC"]}},"/admin/kyc/files/{id}/decide":{"post":{"operationId":"KycController_decideKyc","parameters":[{"name":"id","required":true,"in":"path","description":"KYC file UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KycDecisionDto"}}}},"responses":{"201":{"description":"KYC decision recorded and company updated"},"404":{"description":"KYC file not found"}},"security":[{"bearer":[]}],"summary":"Admin: Record compliance decision on KYC dossier","tags":["Governance - KYC"]}},"/companies/{id}":{"get":{"operationId":"CompanyController_getCompany","parameters":[{"name":"id","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Company profile details"},"404":{"description":"Company not found"}},"security":[{"bearer":[]}],"summary":"Get company profile by ID","tags":["Companies"]},"patch":{"operationId":"CompanyController_updateCompany","parameters":[{"name":"id","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCompanyDto"}}}},"responses":{"200":{"description":"Company profile updated successfully"},"404":{"description":"Company not found"}},"security":[{"bearer":[]}],"summary":"Update company profile","tags":["Companies"]}},"/companies/{id}/representatives":{"get":{"operationId":"CompanyController_getRepresentatives","parameters":[{"name":"id","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Array of legal representatives"}},"security":[{"bearer":[]}],"summary":"List legal representatives for company","tags":["Companies"]},"post":{"operationId":"CompanyController_createRepresentative","parameters":[{"name":"id","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRepresentativeDto"}}}},"responses":{"201":{"description":"Legal representative created"}},"security":[{"bearer":[]}],"summary":"Add a new legal representative","tags":["Companies"]}},"/companies/{id}/bank-accounts":{"get":{"operationId":"CompanyController_getBankAccounts","parameters":[{"name":"id","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Array of company bank accounts"}},"security":[{"bearer":[]}],"summary":"List company bank accounts","tags":["Companies"]},"post":{"operationId":"CompanyController_createBankAccount","parameters":[{"name":"id","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBankAccountDto"}}}},"responses":{"201":{"description":"Company bank account registered"}},"security":[{"bearer":[]}],"summary":"Register a company bank account","tags":["Companies"]}},"/companies/{companyId}/fiscal-profile":{"get":{"operationId":"CompanyWorkspaceController_getFiscal","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]},"put":{"operationId":"CompanyWorkspaceController_putFiscal","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertFiscalProfileDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]}},"/companies/{companyId}/social-profile":{"get":{"operationId":"CompanyWorkspaceController_getSocial","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]},"put":{"operationId":"CompanyWorkspaceController_putSocial","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertSocialProfileDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]}},"/companies/{companyId}/representatives/{id}":{"patch":{"operationId":"CompanyWorkspaceController_updateRepresentative","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRepresentativeDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]}},"/companies/{companyId}/bank-accounts/{id}":{"patch":{"operationId":"CompanyWorkspaceController_updateBankAccount","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateBankAccountDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]}},"/companies/{companyId}/bank-accounts/{id}/primary":{"post":{"operationId":"CompanyWorkspaceController_setPrimary","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]}},"/companies/{companyId}/legal-documents":{"get":{"operationId":"CompanyWorkspaceController_listLegalDocuments","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]}},"/companies/{companyId}/legal-documents/{id}":{"put":{"operationId":"CompanyWorkspaceController_updateLegalDocument","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateLegalDocumentDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Attach a new uploaded version to a legal document","tags":["Companies"]}},"/companies/{companyId}/change-requests":{"get":{"operationId":"CompanyWorkspaceController_listChangeRequests","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]},"post":{"operationId":"CompanyWorkspaceController_createChangeRequest","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateChangeRequestDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]}},"/companies/{companyId}/members":{"get":{"operationId":"CompanyWorkspaceController_listMembers","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]},"post":{"operationId":"CompanyWorkspaceController_inviteMember","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteMemberDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]}},"/companies/{companyId}/members/{id}/resend-invite":{"post":{"operationId":"CompanyWorkspaceController_resendMemberInvite","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]}},"/companies/{companyId}/members/{id}":{"patch":{"operationId":"CompanyWorkspaceController_updateMember","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMemberDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]}},"/companies/{companyId}/login-events":{"get":{"operationId":"CompanyWorkspaceController_listLoginEvents","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]}},"/companies/{companyId}/access-policy":{"get":{"operationId":"CompanyWorkspaceController_getAccessPolicy","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]},"put":{"operationId":"CompanyWorkspaceController_updateAccessPolicy","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccessPolicyDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Companies"]}},"/me/company-invitations":{"get":{"operationId":"CompanyInvitationsController_list","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Company invitations waiting for my answer","tags":["Company invitations"]}},"/me/company-invitations/{membershipId}/accept":{"post":{"operationId":"CompanyInvitationsController_accept","parameters":[{"name":"membershipId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Join the company","tags":["Company invitations"]}},"/me/company-invitations/{membershipId}/decline":{"post":{"operationId":"CompanyInvitationsController_decline","parameters":[{"name":"membershipId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Decline the invitation","tags":["Company invitations"]}},"/practice/cabinets/{cabinetId}/change-requests":{"get":{"operationId":"CabinetChangeRequestsController_list","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Change requests of the caller clients","tags":["Practice - Change requests"]}},"/practice/cabinets/{cabinetId}/change-requests/{id}/review":{"post":{"operationId":"CabinetChangeRequestsController_review","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewChangeRequestDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Approve (applies the change) or reject a request","tags":["Practice - Change requests"]}},"/companies/{companyId}/api-keys":{"get":{"operationId":"ApiKeysController_list","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"API keys of the company (never the secret)","tags":["API keys"]},"post":{"operationId":"ApiKeysController_create","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a key: the response `key` is the only time the secret is shown","tags":["API keys"]}},"/companies/{companyId}/api-keys/{id}":{"delete":{"operationId":"ApiKeysController_revoke","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Revoke a key (immediate, cannot be undone)","tags":["API keys"]}},"/admin/roles":{"get":{"operationId":"AccessController_roles","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"AccessController_createRole","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRoleDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/roles/{id}":{"get":{"operationId":"AccessController_role","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"patch":{"operationId":"AccessController_updateRole","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRoleDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"delete":{"operationId":"AccessController_removeRole","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/roles/{id}/duplicate":{"post":{"operationId":"AccessController_duplicateRole","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/roles/{id}/members":{"put":{"operationId":"AccessController_roleMembers","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoleMembersDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/platform-users":{"get":{"operationId":"AccessController_users","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/platform-members":{"get":{"operationId":"AccessController_members","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"AccessController_invite","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteMemberDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/platform-members/{id}":{"patch":{"operationId":"AccessController_updateMember","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMemberDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"delete":{"operationId":"AccessController_removeMember","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/announcements":{"get":{"operationId":"AnnouncementsFeedController_feed","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Published announcements addressed to the caller (« Actualités & Informations »)","tags":["Announcements"]}},"/announcements/{id}/read":{"post":{"operationId":"AnnouncementsFeedController_read","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]}],"summary":"Mark one of the caller’s announcements as read","tags":["Announcements"]}},"/admin/doc-templates":{"get":{"operationId":"ContentController_templates","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"ContentController_createTemplate","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/doc-templates/{id}":{"get":{"operationId":"ContentController_template","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"patch":{"operationId":"ContentController_updateTemplate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTemplateDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"delete":{"operationId":"ContentController_removeTemplate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/doc-templates/preview":{"post":{"operationId":"ContentController_previewTemplate","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplatePreviewDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/doc-templates/{id}/duplicate":{"post":{"operationId":"ContentController_duplicateTemplate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/fiscal-rules":{"get":{"operationId":"ContentController_rules","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"ContentController_createRule","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFiscalRuleDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/fiscal-rules/{id}/versions":{"post":{"operationId":"ContentController_addVersion","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewVersionDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/fiscal-rules/versions/{id}/status":{"patch":{"operationId":"ContentController_versionStatus","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VersionStatusDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/fiscal-rules/attachments/presign-upload":{"post":{"operationId":"ContentController_presignFiscalAttachment","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignFiscalAttachmentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/fiscal-rules/attachments/confirm":{"post":{"operationId":"ContentController_confirmFiscalAttachment","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmFiscalAttachmentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/fiscal-rules/attachments/{id}/download":{"get":{"operationId":"ContentController_downloadFiscalAttachment","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/settings/{section}":{"get":{"operationId":"ContentController_section","parameters":[{"name":"section","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"put":{"operationId":"ContentController_saveSection","parameters":[{"name":"section","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettingsDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/settings/company/logo/presign":{"post":{"operationId":"ContentController_presignBrandLogo","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandLogoUploadDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/settings/company/logo/confirm":{"post":{"operationId":"ContentController_confirmBrandLogo","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandLogoConfirmDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/settings/company/logo/{id}/download":{"get":{"operationId":"ContentController_downloadBrandLogo","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/integrations":{"get":{"operationId":"ContentController_integrations","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/integrations/{id}":{"put":{"operationId":"ContentController_saveIntegration","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/integrations/{id}/test":{"post":{"operationId":"ContentController_testIntegration","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/settings/{section}/test":{"post":{"operationId":"ContentController_testSetting","parameters":[{"name":"section","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/tasks":{"get":{"operationId":"ContentController_tasks","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/tasks/{id}":{"patch":{"operationId":"ContentController_taskEnabled","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskEnabledDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/tasks/{id}/run":{"post":{"operationId":"ContentController_runTask","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/me/preferences":{"get":{"operationId":"ContentController_myPreferences","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"put":{"operationId":"ContentController_saveMyPreferences","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreferencesDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/me/password":{"post":{"operationId":"ContentController_changePassword","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminPasswordDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/me/notification-preferences":{"get":{"operationId":"ContentController_myNotifPrefs","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"put":{"operationId":"ContentController_saveMyNotifPrefs","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationPrefsDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/document-layouts/{kind}":{"get":{"operationId":"DocumentLayoutController_layout","parameters":[{"name":"kind","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Document layouts"]}},"/admin/audiences/estimate":{"post":{"operationId":"OutreachController_estimate","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/announcements":{"get":{"operationId":"OutreachController_announcements","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"OutreachController_createAnnouncement","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnnouncementDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/announcements/{id}":{"put":{"operationId":"OutreachController_updateAnnouncement","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnnouncementDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"delete":{"operationId":"OutreachController_removeAnnouncement","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/campaigns/attachments/presign-upload":{"post":{"operationId":"OutreachController_presignCampaignAttachment","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignFiscalAttachmentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/campaigns/attachments/confirm":{"post":{"operationId":"OutreachController_confirmCampaignAttachment","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmFiscalAttachmentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/campaigns":{"get":{"operationId":"OutreachController_campaigns","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"OutreachController_createCampaign","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/campaigns/{id}":{"put":{"operationId":"OutreachController_updateCampaign","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"delete":{"operationId":"OutreachController_removeCampaign","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/campaigns/{id}/send":{"post":{"operationId":"OutreachController_sendCampaign","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/campaigns/{id}/cancel":{"post":{"operationId":"OutreachController_cancelCampaign","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/email-templates":{"get":{"operationId":"OutreachController_emailTemplates","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"OutreachController_createEmailTemplate","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailTemplateDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/email-templates/{id}":{"put":{"operationId":"OutreachController_updateEmailTemplate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailTemplateDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"delete":{"operationId":"OutreachController_removeEmailTemplate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/notifications":{"get":{"operationId":"OutreachController_notifications","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"OutreachController_sendNotification","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendNotificationDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/notifications/mine":{"get":{"operationId":"OutreachController_myNotifications","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/notifications/batches/{id}":{"get":{"operationId":"OutreachController_notificationBatch","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/notifications/{id}":{"get":{"operationId":"OutreachController_notification","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/notifications/{id}/read":{"patch":{"operationId":"OutreachController_markNotificationRead","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/support/tickets":{"get":{"operationId":"SupportAdminController_tickets","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"SupportAdminController_openTicket","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenTicketDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/support/tickets/new/attachments/presign-upload":{"post":{"operationId":"SupportAdminController_presignNewTicketAttachment","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignTicketAttachmentDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/support/tickets/new/attachments":{"post":{"operationId":"SupportAdminController_registerNewTicketAttachment","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterTicketAttachmentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/support/tickets/summary":{"get":{"operationId":"SupportAdminController_ticketSummary","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/support/tickets/{id}":{"get":{"operationId":"SupportAdminController_ticket","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"patch":{"operationId":"SupportAdminController_updateTicket","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TicketUpdateDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/support/tickets/{id}/attachments/{documentId}":{"get":{"operationId":"SupportAdminController_attachment","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"documentId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/support/tickets/{id}/attachments/presign-upload":{"post":{"operationId":"SupportAdminController_presignAttachment","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignTicketAttachmentDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/support/tickets/{id}/attachments":{"post":{"operationId":"SupportAdminController_registerAttachment","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterTicketAttachmentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/support/tickets/{id}/messages":{"post":{"operationId":"SupportAdminController_reply","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TicketMessageDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/support/agents":{"get":{"operationId":"SupportAdminController_agents","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"SupportAdminController_createAgent","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/support/agents/{id}":{"patch":{"operationId":"SupportAdminController_updateAgent","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAgentDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/support/agents/{id}/status":{"patch":{"operationId":"SupportAdminController_agentStatus","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentStatusDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/payments/instructions":{"get":{"operationId":"OpsController_instructions","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/payments/transfers":{"get":{"operationId":"OpsController_bankTransfers","parameters":[{"name":"state","required":true,"in":"query","schema":{"type":"string"}},{"name":"page","required":true,"in":"query","schema":{"type":"string"}},{"name":"pageSize","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/payments/{id}/proof":{"get":{"operationId":"OpsController_transferProof","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/payments/{id}/proof/content":{"get":{"operationId":"OpsController_transferProofContent","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/payments/{id}/confirm-transfer":{"post":{"operationId":"OpsController_confirmTransfer","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/payments/{id}/reject-transfer":{"post":{"operationId":"OpsController_rejectTransfer","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RejectTransferDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/finance/summary":{"get":{"operationId":"OpsController_summary","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/finance/transactions":{"get":{"operationId":"OpsController_transactions","parameters":[{"name":"type","required":true,"in":"query","schema":{"type":"string"}},{"name":"search","required":true,"in":"query","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"category","required":true,"in":"query","schema":{"type":"string"}},{"name":"method","required":true,"in":"query","schema":{"type":"string"}},{"name":"minAmount","required":true,"in":"query","schema":{"type":"string"}},{"name":"maxAmount","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/finance/invoices/{id}":{"get":{"operationId":"OpsController_invoice","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/payments":{"get":{"operationId":"OpsController_payments","parameters":[{"name":"search","required":true,"in":"query","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/payments/stats":{"get":{"operationId":"OpsController_paymentStats","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/payments/{id}/receipt":{"get":{"operationId":"OpsController_paymentReceipt","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/documents":{"get":{"operationId":"OpsController_documents","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"ExtrasController_createDocument","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAdminDocumentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/companies/{id}/file":{"get":{"operationId":"OpsController_companyFile","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/companies/{id}/print":{"get":{"operationId":"OpsController_companyPrint","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/accountants/{id}/file":{"get":{"operationId":"OpsController_accountantFile","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/me/permissions":{"get":{"operationId":"ExtrasController_myPermissions","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/document-folders":{"get":{"operationId":"ExtrasController_folders","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"ExtrasController_createFolder","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FolderDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/document-folders/{id}":{"put":{"operationId":"ExtrasController_renameFolder","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FolderDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"delete":{"operationId":"ExtrasController_removeFolder","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/documents/presign-upload":{"post":{"operationId":"ExtrasController_presignDocumentUpload","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignAdminDocumentDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/documents/{id}/download":{"get":{"operationId":"ExtrasController_documentDownload","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/documents/{id}/meta":{"patch":{"operationId":"ExtrasController_documentMeta","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentMetaDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/companies/{id}/notes":{"post":{"operationId":"ExtrasController_addNote","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/companies/{id}/notes/{noteId}":{"delete":{"operationId":"ExtrasController_removeNote","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"noteId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/finance/expenses":{"get":{"operationId":"ExtrasController_expenses","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"ExtrasController_createExpense","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpenseDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/finance/expenses/{id}":{"put":{"operationId":"ExtrasController_updateExpense","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExpenseDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"delete":{"operationId":"ExtrasController_removeExpense","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/bulk/{section}":{"post":{"operationId":"BulkController_run","parameters":[{"name":"section","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkActionDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Admin: run one action on selected rows or every filtered row (companies, cabinets, accountants, finance)","tags":["Admin console"]}},"/admin/notification-templates":{"get":{"operationId":"NotificationTemplatesController_list","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"post":{"operationId":"NotificationTemplatesController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationTemplateDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/notification-templates/events":{"get":{"operationId":"NotificationTemplatesController_events","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/notification-templates/preview":{"post":{"operationId":"NotificationTemplatesController_preview","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationTemplatePreviewDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/notification-templates/{id}":{"put":{"operationId":"NotificationTemplatesController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationTemplateDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]},"delete":{"operationId":"NotificationTemplatesController_remove","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/notification-templates/{id}/enabled":{"patch":{"operationId":"NotificationTemplatesController_setEnabled","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnabledDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/admin/notification-templates/{id}/reset":{"post":{"operationId":"NotificationTemplatesController_reset","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/companies/{companyId}/warehouses":{"get":{"operationId":"PortalController_warehouses","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]},"post":{"operationId":"PortalController_createWarehouse","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWarehouseDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/warehouses/{id}":{"patch":{"operationId":"PortalController_updateWarehouse","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWarehouseDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/stock-movements":{"get":{"operationId":"PortalController_movements","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"articleId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]},"post":{"operationId":"PortalController_createMovement","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStockMovementDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/credit-notes":{"get":{"operationId":"PortalController_salesCreditNotes","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]},"post":{"operationId":"PortalController_createSalesCreditNote","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCreditNoteDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/credit-notes/{id}/cancel":{"post":{"operationId":"PortalController_cancelSalesCreditNote","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/purchase-credit-notes":{"get":{"operationId":"PortalController_purchaseCreditNotes","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]},"post":{"operationId":"PortalController_createPurchaseCreditNote","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePurchaseCreditNoteDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/bank-transactions":{"get":{"operationId":"PortalController_bankTransactions","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"treasuryAccountId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]},"post":{"operationId":"PortalController_createBankTransaction","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBankTransactionDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/bank-transactions/import-csv":{"post":{"operationId":"PortalController_importBankStatementCsv","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportBankStatementCsvDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/bank-transactions/import":{"post":{"operationId":"PortalController_importBankStatement","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportBankStatementCsvDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/bank-reconciliation":{"get":{"operationId":"PortalController_bankReconciliation","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"treasuryAccountId","required":false,"in":"query","schema":{"type":"string"}},{"name":"from","required":false,"in":"query","schema":{"type":"string"}},{"name":"to","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["pending","reconciled","unjustified"]}},{"name":"search","required":false,"in":"query","schema":{"maxLength":200,"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/bank-transactions/{id}/candidates":{"get":{"operationId":"PortalController_bankTransactionCandidates","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"q","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/bank-transactions/{id}/reconcile":{"post":{"operationId":"PortalController_reconcileBankTransaction","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MatchBankTransactionDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/bank-transactions/{id}/reconcile/cancel":{"post":{"operationId":"PortalController_unreconcileBankTransaction","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/bank-transactions/{id}":{"patch":{"operationId":"PortalController_updateBankTransaction","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateBankTransactionDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]},"get":{"operationId":"PortalExtraController_bankTransaction","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/bank-transactions/{id}/suggestion/accept":{"post":{"operationId":"PortalController_acceptBankTransactionSuggestion","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/bank-transactions/{id}/suggestion/reject":{"post":{"operationId":"PortalController_rejectBankTransactionSuggestion","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/treasury/balances":{"get":{"operationId":"PortalController_balances","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/reports/trial-balance":{"get":{"operationId":"PortalController_trialBalance","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/reports/income-statement":{"get":{"operationId":"PortalController_incomeStatement","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/reports/balance-sheet":{"get":{"operationId":"PortalController_balanceSheet","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/reports/financial-statements":{"get":{"operationId":"PortalController_etatsFinanciers","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/reports/general-ledger":{"get":{"operationId":"PortalController_generalLedger","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"accountCode","required":true,"in":"query","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/reports/fiscal-years":{"get":{"operationId":"PortalController_fiscalYears","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/reports/customer-balance":{"get":{"operationId":"PortalController_customerBalance","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/reports/supplier-balance":{"get":{"operationId":"PortalController_supplierBalance","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/reports/journals":{"get":{"operationId":"PortalController_journals","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/reports/aged-balance":{"get":{"operationId":"PortalController_agedBalance","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/calendar":{"get":{"operationId":"PortalController_month","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"month","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/calendar/events":{"post":{"operationId":"PortalController_createEvent","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCalendarEventDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/calendar/events/{id}":{"delete":{"operationId":"PortalController_removeEvent","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/accountant-space":{"get":{"operationId":"PortalController_accountantOverview","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/activity":{"get":{"operationId":"PortalController_activityFeed","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/activity/facets":{"get":{"operationId":"PortalController_activityFacets","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/audit-log":{"get":{"operationId":"PortalController_auditLog","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/accountant-space/cabinets":{"get":{"operationId":"PortalController_accountantDirectory","parameters":[{"name":"search","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/accountant-space/requests/{id}/respond":{"post":{"operationId":"PortalController_respondToRequest","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/accountant-space/links":{"post":{"operationId":"PortalController_inviteAccountant","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteAccountantDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/accountant-space/links/{id}":{"patch":{"operationId":"PortalController_respondToLink","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespondLinkDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/withholding-certificates":{"get":{"operationId":"PortalController_withholdings","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]},"post":{"operationId":"PortalController_generateWithholding","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateTejDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/withholding-certificates/{id}":{"patch":{"operationId":"PortalController_updateWithholding","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTejStatusDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]},"get":{"operationId":"PortalExtraController_withholding","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/ttn/invoices":{"get":{"operationId":"PortalController_ttnInvoices","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/ttn/invoices/{id}/qr":{"get":{"operationId":"PortalController_ttnQr","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/ttn/invoices/{id}/submit":{"post":{"operationId":"PortalController_submitToTtn","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/declarations/compute":{"post":{"operationId":"PortalExtraController_computeDeclaration","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComputeDeclarationDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/declarations/{id}/approve":{"post":{"operationId":"PortalExtraController_approveDeclaration","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/declarations/{id}/request-correction":{"post":{"operationId":"PortalExtraController_requestDeclarationCorrection","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestCorrectionDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/declarations/{id}/documents":{"get":{"operationId":"PortalExtraController_declarationDocuments","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/declaration-tasks":{"get":{"operationId":"PortalExtraController_tasks","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/declaration-tasks/{id}":{"patch":{"operationId":"PortalExtraController_updateTask","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTaskDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/document-requests":{"get":{"operationId":"PortalExtraController_documentRequests","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/document-requests/{id}/answer":{"post":{"operationId":"PortalExtraController_answerDocumentRequest","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerDocumentRequestDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/notifications":{"get":{"operationId":"PortalExtraController_listNotifications","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/notifications/read-all":{"post":{"operationId":"PortalExtraController_readAll","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/notifications/{id}/read":{"post":{"operationId":"PortalExtraController_read","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/notifications/{id}/archive":{"post":{"operationId":"PortalExtraController_archive","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/pilotage/dashboard":{"get":{"operationId":"PortalExtraController_dashboard","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/pilotage/cash-plan":{"get":{"operationId":"PortalExtraController_cashPlan","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"months","required":true,"in":"query","schema":{"type":"string"}},{"name":"start","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/pilotage/compliance":{"get":{"operationId":"PortalExtraController_compliance","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/sales/{id}/convert":{"post":{"operationId":"PortalExtraController_convert","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConvertSalesDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/supplier-orders":{"get":{"operationId":"PortalExtraController_orders","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]},"post":{"operationId":"PortalExtraController_createOrder","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSupplierOrderDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/supplier-orders/{id}":{"get":{"operationId":"PortalExtraController_order","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/supplier-orders/{id}/status":{"patch":{"operationId":"PortalExtraController_orderStatus","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderStatusDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/receipt-notes":{"get":{"operationId":"PortalExtraController_receiptNotes","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]},"post":{"operationId":"PortalExtraController_createReceiptNote","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateReceiptNoteDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/billing/invoices/{id}/pay":{"post":{"operationId":"PortalExtraController_pay","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/accountant-space/invoices/{id}/pay":{"post":{"operationId":"PortalExtraController_payCabinetInvoice","parameters":[],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/accountant-space/bank-details":{"get":{"operationId":"PortalExtraController_cabinetBankDetails","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/billing/transfers":{"get":{"operationId":"PortalExtraController_transfersList","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/billing/transfers/{paymentId}/proof/presign":{"post":{"operationId":"PortalExtraController_presignTransferProof","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"paymentId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignTransferProofDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/billing/transfers/{paymentId}/proof":{"post":{"operationId":"PortalExtraController_submitTransferProof","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"paymentId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitTransferProofDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/billing/access":{"get":{"operationId":"PortalExtraController_billingAccess","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/billing/payment-instructions":{"get":{"operationId":"PortalExtraController_paymentInstructions","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/billing/payments":{"get":{"operationId":"PortalExtraController_payments","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/companies/{companyId}/reports/documents-by-account":{"get":{"operationId":"PortalExtraController_documentsByAccount","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"accountCode","required":true,"in":"query","schema":{"type":"string"}},{"name":"from","required":true,"in":"query","schema":{"type":"string"}},{"name":"to","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Client portal"]}},"/me/settings":{"get":{"operationId":"MeSettingsController_settings","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Client portal"]},"patch":{"operationId":"MeSettingsController_update","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSettingsDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Client portal"]}},"/me/notification-preferences":{"patch":{"operationId":"MeSettingsController_preference","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateNotificationPreferenceDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Client portal"]}},"/me/avatar/presign-upload":{"post":{"operationId":"MeSettingsController_presignAvatar","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignAvatarUploadDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Client portal"]}},"/me/avatar/confirm":{"post":{"operationId":"MeSettingsController_confirmAvatar","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmAvatarUploadDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Client portal"]}},"/me/avatar/{id}/download":{"get":{"operationId":"MeSettingsController_avatarDownload","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Client portal"]}},"/practice/cabinets/{cabinetId}/invites":{"get":{"operationId":"CabinetInvitesController_list","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Pending client-initiated invites awaiting this cabinet’s answer","tags":["Practice - Cabinet invites"]}},"/practice/cabinets/{cabinetId}/invites/{linkId}/respond":{"post":{"operationId":"CabinetInvitesController_respond","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"linkId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RespondCabinetInviteDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Accept or reject a pending client-initiated invite","tags":["Practice - Cabinet invites"]}},"/companies/{companyId}/bilans":{"get":{"operationId":"BilanController_list","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Bilan"]}},"/companies/{companyId}/bilan":{"get":{"operationId":"BilanController_get","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Bilan"]},"put":{"operationId":"BilanController_save","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveBilanDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Bilan"]}},"/companies/{companyId}/bilans/{id}":{"get":{"operationId":"BilanController_getById","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Bilan"]}},"/companies/{companyId}/bilan/preview":{"post":{"operationId":"BilanController_preview","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveBilanDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Bilan"]}},"/companies/{companyId}/bilans/{id}/submit":{"post":{"operationId":"BilanController_submit","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Bilan"]}},"/companies/{companyId}/bilans/{id}/approve":{"post":{"operationId":"BilanController_approve","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Bilan"]}},"/companies/{companyId}/bilans/{id}/request-correction":{"post":{"operationId":"BilanController_requestCorrection","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BilanCorrectionDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Bilan"]}},"/companies/{companyId}/receipts":{"get":{"operationId":"FinanceController_getReceipts","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"from","required":false,"in":"query","description":"YYYY-MM-DD, inclusive","schema":{"example":"2026-01-01","type":"string"}},{"name":"to","required":false,"in":"query","description":"YYYY-MM-DD, inclusive","schema":{"example":"2026-12-31","type":"string"}},{"name":"dir","required":false,"in":"query","schema":{"enum":["asc","desc"],"type":"string"}},{"name":"sort","required":false,"in":"query","schema":{"enum":["date","reference","amount","status"],"type":"string"}},{"name":"treasuryAccountId","required":false,"in":"query","schema":{}},{"name":"customerId","required":false,"in":"query","schema":{}},{"name":"offset","required":false,"in":"query","schema":{}},{"name":"limit","required":false,"in":"query","description":"SQL page size; total in X-Total-Count","schema":{}},{"name":"status","required":false,"in":"query","schema":{}},{"name":"search","required":false,"in":"query","description":"Reference, payment reference or customer name","schema":{}}],"responses":{"200":{"description":"List of receipts"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List customer payment receipts","tags":["Finance & Treasury"]},"post":{"operationId":"FinanceController_createReceipt","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateReceiptDto"}}}},"responses":{"201":{"description":"Receipt successfully recorded"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Record a new customer receipt (encaissement)","tags":["Finance & Treasury"]}},"/companies/{companyId}/receipts/summary":{"get":{"operationId":"FinanceController_getReceiptsSummary","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Receipt KPIs (month, total, unallocated) and customer receivables","tags":["Finance & Treasury"]}},"/companies/{companyId}/receipts/{id}/cancel":{"post":{"operationId":"FinanceController_cancelReceipt","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelFinanceOperationDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Cancel a receipt and reverse its invoice allocations","tags":["Finance & Treasury"]}},"/companies/{companyId}/disbursements":{"get":{"operationId":"FinanceController_getDisbursements","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"from","required":false,"in":"query","description":"YYYY-MM-DD, inclusive","schema":{"example":"2026-01-01","type":"string"}},{"name":"to","required":false,"in":"query","description":"YYYY-MM-DD, inclusive","schema":{"example":"2026-12-31","type":"string"}},{"name":"dir","required":false,"in":"query","schema":{"enum":["asc","desc"],"type":"string"}},{"name":"sort","required":false,"in":"query","schema":{"enum":["date","amount","status","kind"],"type":"string"}},{"name":"treasuryAccountId","required":false,"in":"query","schema":{}},{"name":"purchaseInvoiceId","required":false,"in":"query","schema":{}},{"name":"supplierId","required":false,"in":"query","schema":{}},{"name":"kind","required":false,"in":"query","schema":{"enum":["invoiced","uninvoiced"],"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{}},{"name":"limit","required":false,"in":"query","description":"SQL page size; total in X-Total-Count","schema":{}},{"name":"status","required":false,"in":"query","schema":{}},{"name":"search","required":false,"in":"query","description":"Reference or supplier name","schema":{}}],"responses":{"200":{"description":"List of disbursements"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List supplier disbursements","tags":["Finance & Treasury"]},"post":{"operationId":"FinanceController_createDisbursement","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDisbursementDto"}}}},"responses":{"201":{"description":"Disbursement successfully recorded"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Record a new supplier disbursement (décaissement)","tags":["Finance & Treasury"]}},"/companies/{companyId}/disbursements/summary":{"get":{"operationId":"FinanceController_getDisbursementsSummary","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Disbursement KPIs (month, invoiced, uninvoiced, to pay)","tags":["Finance & Treasury"]}},"/companies/{companyId}/disbursements/{id}/cancel":{"post":{"operationId":"FinanceController_cancelDisbursement","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelFinanceOperationDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Cancel a disbursement","tags":["Finance & Treasury"]}},"/companies/{companyId}/disbursements/{id}/pay":{"post":{"operationId":"FinanceController_payDisbursement","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Mark a pending disbursement as paid","tags":["Finance & Treasury"]}},"/companies/{companyId}/cash-movements":{"get":{"operationId":"FinanceController_getCashMovements","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List cash-desk movements","tags":["Finance & Treasury"]},"post":{"operationId":"FinanceController_createCashMovement","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCashMovementDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Record a cash-desk movement","tags":["Finance & Treasury"]}},"/companies/{companyId}/treasury-accounts":{"get":{"operationId":"FinanceController_getTreasuryAccounts","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"List of treasury accounts"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List company treasury accounts (bank & cash)","tags":["Finance & Treasury"]},"post":{"operationId":"FinanceController_createTreasuryAccount","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTreasuryAccountDto"}}}},"responses":{"201":{"description":"Treasury account created"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Create a new treasury account","tags":["Finance & Treasury"]}},"/companies":{"post":{"operationId":"TenancyController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCompanyDto"}}}},"responses":{"201":{"description":""}},"tags":["Tenancy"]}},"/matricule-fiscal/availability":{"get":{"operationId":"MatriculeAvailabilityController_availability","parameters":[],"responses":{"200":{"description":""}},"tags":["MatriculeAvailability"]}},"/public/newsletter":{"post":{"operationId":"PublicSiteController_subscribe","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeNewsletterDto"}}}},"responses":{"200":{"description":""}},"tags":["Public site"]}},"/public/newsletter/unsubscribe":{"get":{"operationId":"PublicSiteController_unsubscribe","parameters":[{"name":"token","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Public site"]}},"/public/site":{"get":{"operationId":"PublicSiteController_site","parameters":[],"responses":{"200":{"description":""}},"tags":["Public site"]}},"/public/plans":{"get":{"operationId":"PublicSiteController_plans","parameters":[{"name":"audience","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Public site"]}},"/public/usage-pricing":{"get":{"operationId":"PublicSiteController_usagePricing","parameters":[],"responses":{"200":{"description":""}},"tags":["Public site"]}},"/admin/newsletter/subscribers":{"get":{"operationId":"NewsletterAdminController_subscribers","parameters":[{"name":"search","required":true,"in":"query","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Admin console"]}},"/companies/{companyId}/customers":{"get":{"operationId":"CommercePartiesController_getCustomers","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"search","required":false,"in":"query","description":"Search term for name or code","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"dir","required":false,"in":"query","schema":{"enum":["asc","desc"],"type":"string"}},{"name":"sort","required":false,"in":"query","schema":{"enum":["name","code","status","ca","solde"],"type":"string"}},{"name":"maxInvoiced","required":false,"in":"query","schema":{}},{"name":"minInvoiced","required":false,"in":"query","schema":{}},{"name":"maxDue","required":false,"in":"query","schema":{}},{"name":"minDue","required":false,"in":"query","schema":{}},{"name":"tva","required":false,"in":"query","schema":{"enum":["true","false"],"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{}},{"name":"limit","required":false,"in":"query","description":"SQL page size; total in X-Total-Count","schema":{}}],"responses":{"200":{"description":"List of customers"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List all customers for company","tags":["Commerce - Parties"]},"post":{"operationId":"CommercePartiesController_createCustomer","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCustomerDto"}}}},"responses":{"201":{"description":"Customer successfully created"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Create a new customer","tags":["Commerce - Parties"]}},"/companies/{companyId}/customers/summary":{"get":{"operationId":"CommercePartiesController_getCustomersSummary","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Customer counts and balance totals","tags":["Commerce - Parties"]}},"/companies/{companyId}/customers/{id}/balance":{"get":{"operationId":"CommercePartiesController_getCustomerBalance","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Customer balance: invoiced, received, credited, withheld, overdue, due","tags":["Commerce - Parties"]}},"/companies/{companyId}/customers/{id}":{"get":{"operationId":"CommercePartiesController_getCustomer","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Customer UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Customer details"},"404":{"description":"Customer not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Get customer by ID","tags":["Commerce - Parties"]},"patch":{"operationId":"CommercePartiesController_updateCustomer","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Customer UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCustomerDto"}}}},"responses":{"200":{"description":"Customer successfully updated"},"404":{"description":"Customer not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Update an existing customer","tags":["Commerce - Parties"]}},"/companies/{companyId}/customers/{id}/notes":{"get":{"operationId":"CommercePartiesController_listCustomerNotes","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Internal notes on a customer, newest first","tags":["Commerce - Parties"]},"post":{"operationId":"CommercePartiesController_createCustomerNote","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerNoteDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Add an internal note on a customer","tags":["Commerce - Parties"]}},"/companies/{companyId}/customers/{id}/notes/{noteId}":{"patch":{"operationId":"CommercePartiesController_updateCustomerNote","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"noteId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerNoteDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Edit one of your own notes on a customer","tags":["Commerce - Parties"]},"delete":{"operationId":"CommercePartiesController_deleteCustomerNote","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"noteId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Delete one of your own notes on a customer","tags":["Commerce - Parties"]}},"/companies/{companyId}/suppliers":{"get":{"operationId":"CommercePartiesController_getSuppliers","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"search","required":false,"in":"query","description":"Search term for name or code","schema":{"type":"string"}},{"name":"status","required":true,"in":"query","schema":{"type":"string"}},{"name":"incomplete","required":false,"in":"query","description":"true: missing matricule fiscal or RNE number","schema":{}},{"name":"offset","required":false,"in":"query","schema":{}},{"name":"limit","required":false,"in":"query","description":"SQL page size; total in X-Total-Count","schema":{}}],"responses":{"200":{"description":"List of suppliers"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List all suppliers for company","tags":["Commerce - Parties"]},"post":{"operationId":"CommercePartiesController_createSupplier","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSupplierDto"}}}},"responses":{"201":{"description":"Supplier successfully created"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Create a new supplier","tags":["Commerce - Parties"]}},"/companies/{companyId}/suppliers/summary":{"get":{"operationId":"CommercePartiesController_getSuppliersSummary","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Supplier counts, balances and top 5 by purchases / amount due","tags":["Commerce - Parties"]}},"/companies/{companyId}/suppliers/{id}/balance":{"get":{"operationId":"CommercePartiesController_getSupplierBalance","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Supplier balance on validated purchase invoices","tags":["Commerce - Parties"]}},"/companies/{companyId}/suppliers/{id}":{"get":{"operationId":"CommercePartiesController_getSupplier","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Supplier UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Supplier details"},"404":{"description":"Supplier not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Get supplier by ID","tags":["Commerce - Parties"]},"patch":{"operationId":"CommercePartiesController_updateSupplier","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Supplier UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSupplierDto"}}}},"responses":{"200":{"description":"Supplier successfully updated"},"404":{"description":"Supplier not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Update an existing supplier","tags":["Commerce - Parties"]}},"/companies/{companyId}/sales-documents":{"get":{"operationId":"SalesController_getSalesDocuments","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"kind","required":false,"in":"query","schema":{"enum":["invoice","quote","delivery_note","exit_note","order"],"type":"string"}},{"name":"status","required":false,"in":"query","description":"Filter by document status","schema":{"type":"string"}},{"name":"search","required":false,"in":"query","description":"Number or customer name","schema":{"type":"string"}},{"name":"open","required":false,"in":"query","description":"true: issued invoices with an amount still due","schema":{}},{"name":"maxAmount","required":false,"in":"query","schema":{}},{"name":"minAmount","required":false,"in":"query","schema":{}},{"name":"to","required":false,"in":"query","schema":{}},{"name":"from","required":false,"in":"query","schema":{}},{"name":"customerId","required":false,"in":"query","schema":{}},{"name":"displayStatus","required":false,"in":"query","description":"Comma list of displayed statuses (overdue / expired derived from the dates)","schema":{}},{"name":"offset","required":false,"in":"query","schema":{}},{"name":"limit","required":false,"in":"query","description":"SQL page size; total in X-Total-Count","schema":{}}],"responses":{"200":{"description":"List of sales documents"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List sales documents (invoices, quotes, orders)","tags":["Commerce - Sales"]},"post":{"operationId":"SalesController_createSalesDocument","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSalesDocumentDto"}}}},"responses":{"201":{"description":"Sales document created with assigned number"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Create a new sales document with line calculations","tags":["Commerce - Sales"]}},"/companies/{companyId}/sales-documents/summary":{"get":{"operationId":"SalesController_getSalesSummary","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"KPIs of the documents matching the list filters (counts per displayed status, totals)","tags":["Commerce - Sales"]}},"/companies/{companyId}/sales-documents/fiscal-config":{"get":{"operationId":"SalesController_getFiscalConfig","parameters":[{"name":"date","required":true,"in":"query","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Fiscal values used to compute documents (stamp duty, TVA rates)","tags":["Commerce - Sales"]}},"/companies/{companyId}/sales-documents/{id}":{"get":{"operationId":"SalesController_getSalesDocument","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Sales document UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Sales document details including lines"},"404":{"description":"Sales document not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Get sales document details by ID","tags":["Commerce - Sales"]}},"/companies/{companyId}/sales-documents/{id}/status":{"post":{"operationId":"SalesController_updateStatus","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Sales document UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSalesDocumentStatusDto"}}}},"responses":{"200":{"description":"Document status successfully updated"},"404":{"description":"Sales document not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Update sales document workflow status","tags":["Commerce - Sales"]}},"/companies/{companyId}/purchases":{"get":{"operationId":"PurchasesController_getPurchases","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","description":"Filter by invoice status","schema":{"type":"string"}},{"name":"search","required":false,"in":"query","description":"Number or supplier name","schema":{"type":"string"}},{"name":"sort","required":false,"in":"query","schema":{"enum":["date-desc","date-asc","amount-desc","amount-asc","ref-asc","due-asc"],"type":"string"}},{"name":"open","required":false,"in":"query","description":"true: validated invoices with an amount still due","schema":{}},{"name":"maxAmount","required":false,"in":"query","schema":{}},{"name":"minAmount","required":false,"in":"query","schema":{}},{"name":"to","required":false,"in":"query","schema":{}},{"name":"from","required":false,"in":"query","schema":{}},{"name":"supplierId","required":false,"in":"query","schema":{}},{"name":"payment","required":false,"in":"query","schema":{"enum":["paid","due","overdue","cancelled"],"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{}},{"name":"limit","required":false,"in":"query","description":"SQL page size; total in X-Total-Count","schema":{}}],"responses":{"200":{"description":"List of purchase invoices"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List purchase invoices","tags":["Commerce - Purchases"]},"post":{"operationId":"PurchasesController_createPurchase","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePurchaseInvoiceDto"}}}},"responses":{"201":{"description":"Purchase invoice successfully recorded"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Record a new purchase invoice","tags":["Commerce - Purchases"]}},"/companies/{companyId}/purchases/summary":{"get":{"operationId":"PurchasesController_getPurchasesSummary","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"KPIs of the purchase book","tags":["Commerce - Purchases"]}},"/companies/{companyId}/purchases/{id}":{"get":{"operationId":"PurchasesController_getPurchase","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Purchase invoice UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Purchase invoice details"},"404":{"description":"Purchase invoice not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Get purchase invoice details by ID","tags":["Commerce - Purchases"]},"patch":{"operationId":"PurchasesController_updatePurchase","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Purchase invoice UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePurchaseInvoiceDto"}}}},"responses":{"200":{"description":"Purchase invoice successfully updated"},"404":{"description":"Purchase invoice not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Update an existing purchase invoice","tags":["Commerce - Purchases"]},"delete":{"operationId":"PurchasesController_deletePurchase","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Purchase invoice UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Purchase invoice successfully voided"},"404":{"description":"Purchase invoice not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Void a purchase invoice (sets status to cancelled)","tags":["Commerce - Purchases"]}},"/companies/{companyId}/purchases/{id}/history":{"get":{"operationId":"PurchasesController_getPurchaseHistory","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Get purchase invoice audit history","tags":["Commerce - Purchases"]}},"/companies/{companyId}/purchases/extract":{"post":{"operationId":"PurchasesController_extractPurchaseDocument","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractPurchaseDocumentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Extract invoice fields from an uploaded document","tags":["Commerce - Purchases"]}},"/companies/{companyId}/purchases/{id}/duplicate":{"post":{"operationId":"PurchasesController_duplicatePurchase","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Duplicate a purchase invoice as a draft","tags":["Commerce - Purchases"]}},"/companies/{companyId}/articles":{"get":{"operationId":"InventoryController_getArticles","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"search","required":false,"in":"query","description":"Filter by SKU or article name","schema":{"type":"string"}}],"responses":{"200":{"description":"List of articles"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List all inventory articles","tags":["Commerce - Inventory"]},"post":{"operationId":"InventoryController_createArticle","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateArticleDto"}}}},"responses":{"201":{"description":"Article successfully created"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Create a new article","tags":["Commerce - Inventory"]}},"/companies/{companyId}/articles/{id}":{"get":{"operationId":"InventoryController_getArticle","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Article UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Article details"},"404":{"description":"Article not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Get article details by ID","tags":["Commerce - Inventory"]},"patch":{"operationId":"InventoryController_updateArticle","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateArticleDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Update article details (stock moves through stock movements)","tags":["Commerce - Inventory"]}},"/companies/{companyId}/accounting/accounts":{"get":{"operationId":"LedgerController_getAccounts","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"List of chart accounts"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List chart of accounts","tags":["Accounting - General Ledger"]},"post":{"operationId":"LedgerController_createAccount","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateChartAccountDto"}}}},"responses":{"201":{"description":"Chart account created"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Create a new chart account","tags":["Accounting - General Ledger"]}},"/companies/{companyId}/accounting/accounts/{id}":{"patch":{"operationId":"LedgerController_updateAccount","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Chart account UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateChartAccountDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Update or disable a company chart account (standard-plan accounts are read-only)","tags":["Accounting - General Ledger"]}},"/companies/{companyId}/accounting/journals":{"get":{"operationId":"LedgerController_getJournals","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"List of journals"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List accounting journals","tags":["Accounting - General Ledger"]},"post":{"operationId":"LedgerController_createJournal","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateJournalDto"}}}},"responses":{"201":{"description":"Journal created"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Create a new accounting journal","tags":["Accounting - General Ledger"]}},"/companies/{companyId}/accounting/journals/{id}":{"patch":{"operationId":"LedgerController_updateJournal","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Journal UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateJournalDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Update or disable a journal (system journals cannot be disabled)","tags":["Accounting - General Ledger"]}},"/companies/{companyId}/accounting/entries":{"get":{"operationId":"LedgerController_getEntries","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"journalId","required":false,"in":"query","description":"Filter by journal UUID","schema":{"type":"string"}},{"name":"periodId","required":false,"in":"query","description":"Filter by period UUID","schema":{"type":"string"}},{"name":"period","required":false,"in":"query","description":"Filter by period (YYYY-MM)","schema":{"type":"string"}},{"name":"accountId","required":false,"in":"query","description":"Only entries with a line on this account","schema":{"type":"string"}},{"name":"sourceEntityType","required":false,"in":"query","description":"Only automatic postings of this source (sales_document, purchase_invoice, receipt, disbursement)","schema":{"type":"string"}},{"name":"offset","required":false,"in":"query","schema":{}},{"name":"limit","required":false,"in":"query","schema":{}}],"responses":{"200":{"description":"Accounting entries (X-Total-Count when paged)"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List journal entries","tags":["Accounting - General Ledger"]},"post":{"operationId":"LedgerController_createEntry","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAccountingEntryDto"}}}},"responses":{"201":{"description":"Accounting entry posted successfully"},"400":{"description":"Unbalanced entry: debits do not equal credits"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Post balanced double-entry accounting entry (debit === credit)","tags":["Accounting - General Ledger"]}},"/companies/{companyId}/accounting/entries/{id}":{"get":{"operationId":"LedgerController_getEntry","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Accounting entry UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Accounting entry with lines"},"404":{"description":"Entry not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Get accounting entry details with lines","tags":["Accounting - General Ledger"]}},"/companies/{companyId}/accounting/trial-balance":{"get":{"operationId":"LedgerController_getTrialBalance","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Aggregated trial balance per account","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TrialBalanceRowDto"}}}}}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Calculate real-time trial balance (balance générale)","tags":["Accounting - General Ledger"]}},"/companies/{companyId}/accounting/post/sales/{id}":{"post":{"operationId":"LedgerController_postSalesDocument","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Sales document UUID","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Auto-post a sales invoice into the general ledger (Journal des Ventes VT)","tags":["Accounting - General Ledger"]}},"/companies/{companyId}/accounting/post/purchases/{id}":{"post":{"operationId":"LedgerController_postPurchaseInvoice","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Purchase invoice UUID","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Auto-post a purchase invoice into the general ledger (Journal des Achats AC)","tags":["Accounting - General Ledger"]}},"/companies/{companyId}/accounting/post/credit-notes/{id}":{"post":{"operationId":"LedgerController_postCreditNote","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Credit note UUID","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Auto-post a sales credit note (Journal des Ventes VT)","tags":["Accounting - General Ledger"]}},"/companies/{companyId}/accounting/post/purchase-credit-notes/{id}":{"post":{"operationId":"LedgerController_postPurchaseCreditNote","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Purchase credit note UUID","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Auto-post a supplier credit note (Journal des Achats AC)","tags":["Accounting - General Ledger"]}},"/companies/{companyId}/accounting/post/receipts/{id}":{"post":{"operationId":"LedgerController_postReceipt","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Receipt UUID","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Auto-post a customer payment receipt into the general ledger (Journal de Banque BQ)","tags":["Accounting - General Ledger"]}},"/companies/{companyId}/accounting/post/disbursements/{id}":{"post":{"operationId":"LedgerController_postDisbursement","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Disbursement UUID","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Auto-post a supplier disbursement into the general ledger (Journal de Banque BQ)","tags":["Accounting - General Ledger"]}},"/companies/{companyId}/declarations/recap-list":{"get":{"operationId":"DeclarationsExportController_recapList","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"year","required":false,"in":"query","schema":{"example":2026,"type":"number"}},{"name":"from","required":false,"in":"query","description":"First month (YYYY-MM)","schema":{"example":"2026-01","type":"string"}},{"name":"to","required":false,"in":"query","description":"Last month (YYYY-MM)","schema":{"example":"2026-12","type":"string"}},{"name":"type","required":false,"in":"query","schema":{"example":"monthly","type":"string"}},{"name":"status","required":false,"in":"query","description":"Raw or display statuses (to_prepare, to_file, late, to_pay, filed, paid, archived, cancelled…), comma separated","schema":{"type":"string"}},{"name":"periodicity","required":false,"in":"query","schema":{"type":"string","enum":["monthly","quarterly","annual"]}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Recap of every declaration of the company (filters: year, from/to, type, status, periodicity) with totals, for the PDF / CSV export","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations":{"get":{"operationId":"DeclarationsController_getDeclarations","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"type","required":false,"in":"query","description":"Declaration type (e.g. tva, cnss, is)","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","description":"Declaration status","schema":{"type":"string"}},{"name":"period","required":false,"in":"query","description":"Fiscal period (e.g. 2026-02)","schema":{"type":"string"}}],"responses":{"200":{"description":"List of declarations"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List tax declarations for company","tags":["Fiscal & Declarations"]},"post":{"operationId":"DeclarationsController_createDeclaration","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDeclarationDto"}}}},"responses":{"201":{"description":"Declaration successfully initialized"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Create a new tax declaration","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/paid-total":{"get":{"operationId":"DeclarationsController_paidTotal","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"year","required":true,"in":"query","schema":{"type":"string"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Total paid on declarations (TND), optional year and type","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/{id}/recap":{"get":{"operationId":"DeclarationsController_recap","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Recap of a declaration (type, period, data, amounts, status, payment) for CSV / PDF export","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/{id}":{"get":{"operationId":"DeclarationsController_getDeclaration","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Declaration UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Declaration details"},"404":{"description":"Declaration not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Get declaration details by ID","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/compute-vat":{"post":{"operationId":"DeclarationsController_computeVatDeclaration","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"period","required":true,"in":"query","description":"Period code e.g. 2026-01","schema":{"example":"2026-01","type":"string"}}],"responses":{"201":{"description":"Declaration computed and initialized"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Compute and generate monthly VAT return from commercial invoices","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/{id}/status":{"patch":{"operationId":"DeclarationsController_updateStatus","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Declaration UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDeclarationStatusDto"}}}},"responses":{"200":{"description":"Declaration status updated"},"404":{"description":"Declaration not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Advance declaration workflow status","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/monthly/cadres":{"get":{"operationId":"MonthlyDeclarationController_cadres","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Cadres of the DGI monthly form (rows, printed rates, columns, extras), served once to the portals","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/monthly/options":{"get":{"operationId":"MonthlyDeclarationController_options","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"What can be prepared for the company (forms, periodicity of its DGI return, taxes of its fiscal profile)","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/monthly/{period}":{"get":{"operationId":"MonthlyDeclarationController_state","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"period","required":true,"in":"path","schema":{"type":"string"}},{"name":"rect","required":true,"in":"query","schema":{"type":"number"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Monthly return of a period: header, sections, gate, recap. `rect` = Acte (0 Initiale, n-th Rectificative)","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/monthly/{period}/rectify":{"post":{"operationId":"MonthlyDeclarationController_rectify","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"period","required":true,"in":"path","schema":{"type":"string"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Open a Rectificative act (refused while the previous act of the period is unpaid)","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/monthly/{period}/file":{"post":{"operationId":"MonthlyDeclarationController_file","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"period","required":true,"in":"path","schema":{"type":"string"}},{"name":"rect","required":true,"in":"query","schema":{"type":"number"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileMonthlyDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Mark a prepared return as filed on the DGI site (filing date, receipt number): it becomes payable","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/monthly/{period}/filing":{"put":{"operationId":"MonthlyDeclarationController_setFiling","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"period","required":true,"in":"path","schema":{"type":"string"}},{"name":"rect","required":true,"in":"query","schema":{"type":"number"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMonthlyFilingDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Header boxes of the imprimé: code acte (0-4) and date de cessation, until the return is filed","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/monthly/{period}/cancel":{"post":{"operationId":"MonthlyDeclarationController_cancel","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"period","required":true,"in":"path","schema":{"type":"string"}},{"name":"rect","required":true,"in":"query","schema":{"type":"number"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelMonthlyDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Cancel a return that is not filed and not paid (soft: row and versions are kept); 409 otherwise","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/monthly/{period}/sections/{tax}":{"put":{"operationId":"MonthlyDeclarationController_save","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"period","required":true,"in":"path","schema":{"type":"string"}},{"name":"tax","required":true,"in":"path","schema":{"type":"string"}},{"name":"rect","required":true,"in":"query","schema":{"type":"number"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveMonthlySectionDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Save one tax section (applicability, values, completion)","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/monthly/{period}/sections/{tax}/preview":{"post":{"operationId":"MonthlyDeclarationController_preview","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"period","required":true,"in":"path","schema":{"type":"string"}},{"name":"tax","required":true,"in":"path","schema":{"type":"string"}},{"name":"rect","required":true,"in":"query","schema":{"type":"number"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveMonthlySectionDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Figures of a section for the values being typed (nothing saved)","tags":["Fiscal & Declarations"]}},"/companies/{companyId}/declarations/monthly/{period}/review":{"post":{"operationId":"MonthlyDeclarationController_review","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"period","required":true,"in":"path","schema":{"type":"string"}},{"name":"rect","required":true,"in":"query","schema":{"type":"number"}},{"name":"type","required":true,"in":"query","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewMonthlyDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Freeze the summary onto the declaration (needs every section complete, or `force` = the DGI warn-only override)","tags":["Fiscal & Declarations"]}},"/practice/cabinets/{cabinetId}/clients":{"get":{"operationId":"PortfolioController_list","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Client companies the caller may work on in this cabinet, with per-client overdue status. Without `limit`: the whole list (name order). With `limit`/`offset`: a SQL page + X-Total-Count. Filters: search, status, overdue (true|false), overduePayments, missingDocs, mine, accountantId, legalForm, taxRegime, activity, createdFrom, createdTo.","tags":["Practice - Portfolio"]},"post":{"operationId":"PortfolioController_createClient","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCabinetClientDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create and assign a client company in this cabinet, with its Pièces justificatives (ADR 0027)","tags":["Practice - Portfolio"]}},"/practice/cabinets/{cabinetId}/client-stats":{"get":{"operationId":"PortfolioController_clientStats","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Headline counts over all the caller's clients in this cabinet","tags":["Practice - Portfolio"]}},"/practice/cabinets/{cabinetId}/clients/import":{"post":{"operationId":"PortfolioController_importClients","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportPortfolioClientsDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Bulk-create clients from parsed CSV rows (admin only)","tags":["Practice - Portfolio"]}},"/practice/cabinets/{cabinetId}/clients/invitations":{"post":{"operationId":"PortfolioController_inviteClient","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitePortfolioClientDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Invite a client user and create its cabinet company","tags":["Practice - Portfolio"]}},"/practice/cabinets/{cabinetId}/clients/{companyId}/status":{"patch":{"operationId":"PortfolioController_updateClientStatus","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePortfolioClientStatusDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update a scoped client status in this cabinet","tags":["Practice - Portfolio"]}},"/practice/cabinets/{cabinetId}/documents-inbox":{"get":{"operationId":"PortfolioController_documentsInbox","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Documents needing action (to_classify / to_correct) across this cabinet's clients","tags":["Practice - Portfolio"]}},"/practice/cabinets/{cabinetId}/missions":{"get":{"operationId":"MissionsController_getMissions","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string"}},{"name":"archived","required":false,"in":"query","description":"true: the archived missions instead of the live ones","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List all cabinet missions","tags":["Practice - Missions"]},"post":{"operationId":"MissionsController_createMission","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMissionDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a new mission","tags":["Practice - Missions"]}},"/practice/cabinets/{cabinetId}/missions/{id}":{"get":{"operationId":"MissionsController_getMission","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get mission details","tags":["Practice - Missions"]},"patch":{"operationId":"MissionsController_patchMission","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMissionDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Partially update mission details","tags":["Practice - Missions"]},"delete":{"operationId":"MissionsController_deleteMission","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete (archive) a mission","tags":["Practice - Missions"]}},"/practice/cabinets/{cabinetId}/missions/{id}/unarchive":{"patch":{"operationId":"MissionsController_unarchiveMission","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Restore an archived mission","tags":["Practice - Missions"]}},"/practice/cabinets/{cabinetId}/missions/{id}/status":{"patch":{"operationId":"MissionsController_updateStatus","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMissionStatusDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update mission status","tags":["Practice - Missions"]}},"/practice/cabinets/{cabinetId}/missions/{id}/checklist":{"get":{"operationId":"MissionsController_getChecklist","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get mission checklist items","tags":["Practice - Missions"]},"post":{"operationId":"MissionsController_addChecklistItem","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddChecklistItemDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Add a checklist item to mission","tags":["Practice - Missions"]}},"/practice/cabinets/{cabinetId}/missions/{id}/checklist/{itemId}":{"patch":{"operationId":"MissionsController_toggleChecklistItem","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"itemId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToggleChecklistItemDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Toggle checklist item completion","tags":["Practice - Missions"]}},"/practice/cabinets/{cabinetId}/mission-templates":{"get":{"operationId":"MissionTemplatesController_list","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Mission templates"]},"post":{"operationId":"MissionTemplatesController_create","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MissionTemplateDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Mission templates"]}},"/practice/cabinets/{cabinetId}/mission-templates/{id}":{"get":{"operationId":"MissionTemplatesController_get","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Mission templates"]},"patch":{"operationId":"MissionTemplatesController_update","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMissionTemplateDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Mission templates"]},"delete":{"operationId":"MissionTemplatesController_remove","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Mission templates"]}},"/practice/cabinets/{cabinetId}/tasks":{"get":{"operationId":"TasksController_getTasks","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":false,"in":"query","schema":{"type":"string"}},{"name":"assignedToUserId","required":false,"in":"query","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List cabinet tasks","tags":["Practice - Tasks"]},"post":{"operationId":"TasksController_createTask","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTaskDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a new task","tags":["Practice - Tasks"]}},"/practice/cabinets/{cabinetId}/tasks/print":{"get":{"operationId":"TasksController_printTasks","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"ids","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Tasks"]}},"/practice/cabinets/{cabinetId}/tasks/export":{"get":{"operationId":"TasksController_exportTasks","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"ids","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Practice - Tasks"]}},"/practice/cabinets/{cabinetId}/tasks/{id}":{"get":{"operationId":"TasksController_getTask","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get task details","tags":["Practice - Tasks"]},"patch":{"operationId":"TasksController_updateTask","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTaskDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update a task","tags":["Practice - Tasks"]},"delete":{"operationId":"TasksController_deleteTask","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete (archive) a task","tags":["Practice - Tasks"]}},"/practice/cabinets/{cabinetId}/tasks/{id}/status":{"patch":{"operationId":"TasksController_updateStatus","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTaskStatusDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update task status","tags":["Practice - Tasks"]}},"/practice/cabinets/{cabinetId}/tasks/{id}/subtasks":{"get":{"operationId":"TasksController_getSubtasks","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get subtasks for a task","tags":["Practice - Tasks"]},"post":{"operationId":"TasksController_createSubtask","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSubtaskDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a subtask","tags":["Practice - Tasks"]}},"/practice/cabinets/{cabinetId}/tasks/{id}/comments":{"get":{"operationId":"TasksController_getComments","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get task comments","tags":["Practice - Tasks"]},"post":{"operationId":"TasksController_addComment","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTaskCommentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Add a comment to task","tags":["Practice - Tasks"]}},"/practice/cabinets/{cabinetId}/calendar/events":{"get":{"operationId":"CalendarController_getEvents","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"startDate","required":false,"in":"query","schema":{"type":"string"}},{"name":"endDate","required":false,"in":"query","schema":{"type":"string"}},{"name":"companyId","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get calendar events for cabinet","tags":["Practice - Calendar"]},"post":{"operationId":"CalendarController_createEvent","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCalendarEventDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a calendar event","tags":["Practice - Calendar"]}},"/practice/cabinets/{cabinetId}/calendar/events/{id}":{"get":{"operationId":"CalendarController_getEvent","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"One calendar event (or a declaration deadline by its declaration id) with its company and link","tags":["Practice - Calendar"]},"patch":{"operationId":"CalendarController_updateEvent","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCalendarEventDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Edit a manual calendar event","tags":["Practice - Calendar"]},"delete":{"operationId":"CalendarController_deleteEvent","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a calendar event","tags":["Practice - Calendar"]}},"/practice/cabinets/{cabinetId}/fees/pricing":{"post":{"operationId":"FeesController_setPricing","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetFeePricingDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create or update a client company's fee agreement (amount, periodicity, payment terms, auto generation)","tags":["Practice - Fees & Invoicing"]},"get":{"operationId":"FeesController_listPricing","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List fee pricing of every client company","tags":["Practice - Fees & Invoicing"]}},"/practice/cabinets/{cabinetId}/fees/fiscal-config":{"get":{"operationId":"FeesController_fiscalConfig","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Fiscal rules used by cabinet screens (default base fee, retenue rates)","tags":["Practice - Fees & Invoicing"]}},"/practice/cabinets/{cabinetId}/fees/pricing/{companyId}":{"get":{"operationId":"FeesController_getPricing","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get fee pricing for a client company","tags":["Practice - Fees & Invoicing"]},"delete":{"operationId":"FeesController_deletePricing","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a client company's fee agreement","tags":["Practice - Fees & Invoicing"]}},"/practice/cabinets/{cabinetId}/fees/pricing/{companyId}/generate":{"post":{"operationId":"FeesController_generateNow","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Issue now the agreement's next recurring fees invoice","tags":["Practice - Fees & Invoicing"]}},"/practice/cabinets/{cabinetId}/fees/calculate":{"post":{"operationId":"FeesController_calculateFee","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalculateFeeDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Calculate monthly accounting fee","tags":["Practice - Fees & Invoicing"]}},"/practice/cabinets/{cabinetId}/fees/invoices":{"get":{"operationId":"FeesController_getInvoices","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"kind","required":false,"in":"query","schema":{"type":"string","enum":["honoraires","mission"]}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["draft","pending_review","validated","sent","paid","overdue","cancelled","unpaid","partial"]}},{"name":"companyId","required":false,"in":"query","schema":{"type":"string"}},{"name":"from","required":false,"in":"query","description":"Issue date from (inclusive)","schema":{"type":"string"}},{"name":"to","required":false,"in":"query","description":"Issue date to (inclusive)","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List cabinet invoices (kind, status, company, issue period filters) with totals","tags":["Practice - Fees & Invoicing"]}},"/practice/cabinets/{cabinetId}/fees/invoices/{id}":{"get":{"operationId":"FeesController_getInvoice","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get cabinet invoice details, lines and payment history","tags":["Practice - Fees & Invoicing"]}},"/practice/cabinets/{cabinetId}/fees/invoices/honoraires":{"post":{"operationId":"FeesController_createHonorairesInvoice","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateHonorairesInvoiceDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a fees invoice (honoraires)","tags":["Practice - Fees & Invoicing"]}},"/practice/cabinets/{cabinetId}/fees/invoices/mission":{"post":{"operationId":"FeesController_createMissionInvoice","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMissionInvoiceDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a one-off mission invoice","tags":["Practice - Fees & Invoicing"]}},"/practice/cabinets/{cabinetId}/fees/invoices/{id}/status":{"patch":{"operationId":"FeesController_updateInvoiceStatus","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCabinetInvoiceStatusDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update cabinet invoice status","tags":["Practice - Fees & Invoicing"]}},"/practice/cabinets/{cabinetId}/fees/invoices/{id}/payments":{"get":{"operationId":"FeesController_listPayments","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Payment history of a cabinet invoice","tags":["Practice - Fees & Invoicing"]},"post":{"operationId":"FeesController_recordPayment","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordCabinetPaymentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Record a payment of a cabinet invoice","tags":["Practice - Fees & Invoicing"]}},"/practice/cabinets/{cabinetId}/fees/invoices/{id}/payments/{paymentId}":{"delete":{"operationId":"FeesController_deletePayment","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"paymentId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":""}},"security":[{"bearer":[]}],"summary":"Delete a recorded payment","tags":["Practice - Fees & Invoicing"]}},"/practice/cabinets/{cabinetId}/tickets":{"get":{"operationId":"PracticeSupportController_getTickets","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List support tickets raised by the caller, a page at a time","tags":["Practice - Support Tickets"]},"post":{"operationId":"PracticeSupportController_createTicket","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTicketDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Open a new support ticket with JCF","tags":["Practice - Support Tickets"]}},"/practice/cabinets/{cabinetId}/tickets/summary":{"get":{"operationId":"PracticeSupportController_getTicketSummary","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Count the caller’s support tickets, per status","tags":["Practice - Support Tickets"]}},"/practice/cabinets/{cabinetId}/tickets/availability":{"get":{"operationId":"PracticeSupportController_getAvailability","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"JCF support availability: agents on shift and typical first response time","tags":["Practice - Support Tickets"]}},"/practice/cabinets/{cabinetId}/tickets/{id}":{"get":{"operationId":"PracticeSupportController_getTicket","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get a support ticket raised by the caller, with its messages","tags":["Practice - Support Tickets"]}},"/practice/cabinets/{cabinetId}/tickets/{id}/messages":{"post":{"operationId":"PracticeSupportController_addMessage","parameters":[{"name":"cabinetId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTicketMessageDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Reply to a support ticket","tags":["Practice - Support Tickets"]}},"/companies/{companyId}/tickets":{"get":{"operationId":"SupportController_getTickets","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","description":"Ticket status","schema":{"type":"string"}},{"name":"withMessages","required":false,"in":"query","description":"true: each ticket comes with its messages","schema":{"type":"string"}}],"responses":{"200":{"description":"List of support tickets"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List customer support tickets","tags":["Communications - Support Tickets"]},"post":{"operationId":"SupportController_createTicket","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTicketDto"}}}},"responses":{"201":{"description":"Ticket created with generated reference (TCK-XXXXX)"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Open a new support ticket","tags":["Communications - Support Tickets"]}},"/companies/{companyId}/tickets/{id}":{"get":{"operationId":"SupportController_getTicket","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Ticket UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Ticket details and messages"},"404":{"description":"Ticket not found"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Get support ticket details with message history","tags":["Communications - Support Tickets"]}},"/companies/{companyId}/tickets/{id}/attachments/{documentId}":{"get":{"operationId":"SupportController_attachmentUrl","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"documentId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"A signed link to a file of the ticket, whoever attached it (the company or support)","tags":["Communications - Support Tickets"]}},"/companies/{companyId}/tickets/{id}/messages":{"post":{"operationId":"SupportController_addMessage","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Ticket UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTicketMessageDto"}}}},"responses":{"201":{"description":"Ticket message appended"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Append a reply message to support ticket","tags":["Communications - Support Tickets"]}},"/companies/{companyId}/tickets/{id}/close":{"post":{"operationId":"SupportController_closeTicket","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Ticket UUID","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Close a customer support ticket","tags":["Communications - Support Tickets"]}},"/me/tickets":{"get":{"operationId":"MyTicketsController_getTickets","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List the support tickets the caller raised","tags":["Communications - Support Tickets"]}},"/me/tickets/rejets":{"get":{"operationId":"MyTicketsController_getRejets","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List the caller’s rejected Demandes d’ouverture, from their Tickets de rejet","tags":["Communications - Support Tickets"]}},"/me/tickets/{id}":{"get":{"operationId":"MyTicketsController_getTicket","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get a support ticket the caller raised, with its messages","tags":["Communications - Support Tickets"]}},"/me/tickets/{id}/messages":{"post":{"operationId":"MyTicketsController_addMessage","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTicketMessageDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Reply to a support ticket the caller raised","tags":["Communications - Support Tickets"]}},"/me/tickets/{id}/attachments/presign-upload":{"post":{"operationId":"MyTicketsController_presignAttachment","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresignTicketAttachmentDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Sign the upload of a file to a Ticket de rejet the caller raised (no Cabinet needed)","tags":["Communications - Support Tickets"]}},"/me/tickets/{id}/attachments":{"post":{"operationId":"MyTicketsController_registerAttachment","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterTicketAttachmentDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Register a file uploaded to a Ticket de rejet the caller raised","tags":["Communications - Support Tickets"]}},"/me/tickets/{id}/attachments/{documentId}":{"get":{"operationId":"MyTicketsController_attachmentUrl","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"documentId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"A signed link to a file of a ticket the caller raised","tags":["Communications - Support Tickets"]}},"/companies/{companyId}/signatures":{"post":{"operationId":"SignatureController_create","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCompanySignatureDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Documents & Vault"]}},"/companies/{companyId}/shared-documents":{"get":{"operationId":"CompanySharedDocumentsController_list","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"parentId","required":false,"in":"query","description":"The folder to open; the root of the space when absent","schema":{"type":"string"}},{"name":"sort","required":false,"in":"query","description":"Name, last change (inside a folder too) or size; folders always come first","schema":{"type":"string","enum":["name","updated","size"]}},{"name":"order","required":false,"in":"query","schema":{"type":"string","enum":["asc","desc"]}},{"name":"page","required":false,"in":"query","description":"From 1; 10 items per page","schema":{"type":"number"}}],"responses":{"404":{"description":"No such folder in this space"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"One page (10) of a folder's folders and files (the root without parentId), folders first, with what the caller may do","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/tree":{"get":{"operationId":"CompanySharedDocumentsController_tree","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Every folder of the space with its parent and its file count, for the folder tree","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/search":{"get":{"operationId":"CompanySharedDocumentsController_search","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"parentId","required":false,"in":"query","description":"The folder to open; the root of the space when absent","schema":{"type":"string"}},{"name":"sort","required":false,"in":"query","description":"Name, last change (inside a folder too) or size; folders always come first","schema":{"type":"string","enum":["name","updated","size"]}},{"name":"order","required":false,"in":"query","schema":{"type":"string","enum":["asc","desc"]}},{"name":"page","required":false,"in":"query","description":"From 1; 10 items per page","schema":{"type":"number"}},{"name":"q","required":false,"in":"query","description":"Words in the name, regardless of case and accents; searches the folder `parentId` (the root without it) and every folder inside it","schema":{"type":"string"}},{"name":"type","required":false,"in":"query","schema":{"type":"string","enum":["folders","pdf","images","word","excel"]}},{"name":"addedBy","required":false,"in":"query","description":"Who added the item: `me`, or a member's user id","schema":{"type":"string"}},{"name":"modified","required":false,"in":"query","description":"Last changed (inside a folder too) in the last 7 or 30 days, or since 1 January (Tunis)","schema":{"type":"string","enum":["7d","30d","year"]}}],"responses":{"404":{"description":"No such folder in this space"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"One page (10) of the items found in a folder and every folder inside it (the whole space without parentId), by name regardless of case and accents, type, who added it and last change; each with where it sits","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/items/{id}":{"get":{"operationId":"CompanySharedDocumentsController_details","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Item UUID","schema":{"type":"string"}}],"responses":{"404":{"description":"No such item in this space"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"One item with its figures and the folders from the root to its parent, for the preview and the details panel","tags":["Documents partagés"]},"patch":{"operationId":"CompanySharedDocumentsController_rename","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Item UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenameItemDto"}}}},"responses":{"400":{"description":"BR3: the name is refused"},"404":{"description":"No such item in this space"},"409":{"description":"BR4: the name is taken in its folder"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Rename a folder or a file; a file's name is given without its extension, which is kept","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/items/{id}/content":{"get":{"operationId":"CompanySharedDocumentsController_content","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Item UUID","schema":{"type":"string"}}],"responses":{"404":{"description":"No such file in this space, or its bytes are gone"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"A file's bytes for the preview: inline for PDF, images and text, a download otherwise","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/items/{id}/download":{"get":{"operationId":"CompanySharedDocumentsController_download","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Item UUID","schema":{"type":"string"}}],"responses":{"404":{"description":"No such file in this space"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"A signed link to download one file, with its name","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/items/move":{"post":{"operationId":"CompanySharedDocumentsController_move","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoveItemsDto"}}}},"responses":{"400":{"description":"BR7: a folder into itself or one of its subfolders"},"404":{"description":"No such item or folder in this space"},"409":{"description":"BR7: a name taken at the destination"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Move folders and files into a folder (the root with parentId null), all of them or none","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/items/trash":{"post":{"operationId":"CompanySharedDocumentsController_trash","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrashItemsDto"}}}},"responses":{"404":{"description":"No such item in this space"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Send folders and files to the Corbeille, a folder with all it holds; all of them or none","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/trash":{"get":{"operationId":"CompanySharedDocumentsController_trashList","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"From 1; 10 items per page","schema":{"type":"number"}}],"responses":{"403":{"description":"Without « Annuler/Supprimer »"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"One page (10) of the Corbeille, the most recently deleted first, with where each item was and the days left","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/trash/{id}/restore":{"post":{"operationId":"CompanySharedDocumentsController_restore","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Item UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestoreItemDto"}}}},"responses":{"404":{"description":"Not in the Corbeille, or no such destination folder"},"409":{"description":"Its folder is gone: give a destination"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Restore an item of the Corbeille with what was deleted with it, into its folder or the one given; a taken name gets « (1) »","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/trash/{id}":{"delete":{"operationId":"CompanySharedDocumentsController_deleteForGood","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Item UUID","schema":{"type":"string"}}],"responses":{"404":{"description":"Not in the Corbeille"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Delete for good an item of the Corbeille, what it holds, and their stored files","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/folders":{"post":{"operationId":"CompanySharedDocumentsController_createFolder","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFolderDto"}}}},"responses":{"400":{"description":"BR3: the name is refused"},"409":{"description":"BR4: the name is taken in that folder"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Create a folder at the root or inside a folder","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/uploads":{"post":{"operationId":"CompanySharedDocumentsController_uploadSlot","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadSlotDto"}}}},"responses":{"400":{"description":"BR3: the name is refused; BR6: over 25 Mo"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"A signed slot to send one file to storage before filing it (POST files)","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/files":{"post":{"operationId":"CompanySharedDocumentsController_registerFile","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterFileDto"}}}},"responses":{"400":{"description":"BR3: the name is refused; BR6: over 25 Mo; a key outside the Entreprise"},"404":{"description":"No such folder in this space"},"409":{"description":"This upload is already filed"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"File an uploaded file in a folder (the root without parentId); a taken name gets « (1) »","tags":["Documents partagés"]}},"/companies/{companyId}/shared-documents/files/batch":{"post":{"operationId":"CompanySharedDocumentsController_registerFiles","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterFilesDto"}}}},"responses":{"400":{"description":"BR3: a name is refused; BR6: over 25 Mo; a key outside the Entreprise, or sent twice"},"404":{"description":"No such folder in this space"},"409":{"description":"An upload is already filed"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"File the uploaded files of one upload in a folder (the root without parentId), all of them or none; a taken name gets « (1) ». A Cabinet upload notifies the Client once.","tags":["Documents partagés"]}},"/companies/{companyId}/coffre-fort":{"get":{"operationId":"CompanyVaultController_list","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"parentId","required":false,"in":"query","description":"The folder to open; the root of the space when absent","schema":{"type":"string"}},{"name":"sort","required":false,"in":"query","description":"Name, last change (inside a folder too) or size; folders always come first","schema":{"type":"string","enum":["name","updated","size"]}},{"name":"order","required":false,"in":"query","schema":{"type":"string","enum":["asc","desc"]}},{"name":"page","required":false,"in":"query","description":"From 1; 10 items per page","schema":{"type":"number"}}],"responses":{"404":{"description":"No such folder in this space"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"One page (10) of a folder's folders and files (the root without parentId), folders first, with what the caller may do","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/tree":{"get":{"operationId":"CompanyVaultController_tree","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Every folder of the space with its parent and its file count, for the folder tree","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/search":{"get":{"operationId":"CompanyVaultController_search","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"parentId","required":false,"in":"query","description":"The folder to open; the root of the space when absent","schema":{"type":"string"}},{"name":"sort","required":false,"in":"query","description":"Name, last change (inside a folder too) or size; folders always come first","schema":{"type":"string","enum":["name","updated","size"]}},{"name":"order","required":false,"in":"query","schema":{"type":"string","enum":["asc","desc"]}},{"name":"page","required":false,"in":"query","description":"From 1; 10 items per page","schema":{"type":"number"}},{"name":"q","required":false,"in":"query","description":"Words in the name, regardless of case and accents; searches the folder `parentId` (the root without it) and every folder inside it","schema":{"type":"string"}},{"name":"type","required":false,"in":"query","schema":{"type":"string","enum":["folders","pdf","images","word","excel"]}},{"name":"addedBy","required":false,"in":"query","description":"Who added the item: `me`, or a member's user id","schema":{"type":"string"}},{"name":"modified","required":false,"in":"query","description":"Last changed (inside a folder too) in the last 7 or 30 days, or since 1 January (Tunis)","schema":{"type":"string","enum":["7d","30d","year"]}}],"responses":{"404":{"description":"No such folder in this space"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"One page (10) of the items found in a folder and every folder inside it (the whole space without parentId), by name regardless of case and accents, type, who added it and last change; each with where it sits","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/items/{id}":{"get":{"operationId":"CompanyVaultController_details","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Item UUID","schema":{"type":"string"}}],"responses":{"404":{"description":"No such item in this space"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"One item with its figures and the folders from the root to its parent, for the preview and the details panel","tags":["Coffre-fort numérique"]},"patch":{"operationId":"CompanyVaultController_rename","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Item UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenameItemDto"}}}},"responses":{"400":{"description":"BR3: the name is refused"},"404":{"description":"No such item in this space"},"409":{"description":"BR4: the name is taken in its folder"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Rename a folder or a file; a file's name is given without its extension, which is kept","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/items/{id}/content":{"get":{"operationId":"CompanyVaultController_content","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Item UUID","schema":{"type":"string"}}],"responses":{"404":{"description":"No such file in this space, or its bytes are gone"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"A file's bytes for the preview: inline for PDF, images and text, a download otherwise","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/items/{id}/download":{"get":{"operationId":"CompanyVaultController_download","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Item UUID","schema":{"type":"string"}}],"responses":{"404":{"description":"No such file in this space"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"A signed link to download one file, with its name","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/items/move":{"post":{"operationId":"CompanyVaultController_move","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoveItemsDto"}}}},"responses":{"400":{"description":"BR7: a folder into itself or one of its subfolders"},"404":{"description":"No such item or folder in this space"},"409":{"description":"BR7: a name taken at the destination"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Move folders and files into a folder (the root with parentId null), all of them or none","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/items/trash":{"post":{"operationId":"CompanyVaultController_trash","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrashItemsDto"}}}},"responses":{"404":{"description":"No such item in this space"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Send folders and files to the Corbeille, a folder with all it holds; all of them or none","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/trash":{"get":{"operationId":"CompanyVaultController_trashList","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"From 1; 10 items per page","schema":{"type":"number"}}],"responses":{"403":{"description":"Without « Annuler/Supprimer »"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"One page (10) of the Corbeille, the most recently deleted first, with where each item was and the days left","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/trash/{id}/restore":{"post":{"operationId":"CompanyVaultController_restore","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Item UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RestoreItemDto"}}}},"responses":{"404":{"description":"Not in the Corbeille, or no such destination folder"},"409":{"description":"Its folder is gone: give a destination"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Restore an item of the Corbeille with what was deleted with it, into its folder or the one given; a taken name gets « (1) »","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/trash/{id}":{"delete":{"operationId":"CompanyVaultController_deleteForGood","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","description":"Item UUID","schema":{"type":"string"}}],"responses":{"404":{"description":"Not in the Corbeille"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Delete for good an item of the Corbeille, what it holds, and their stored files","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/folders":{"post":{"operationId":"CompanyVaultController_createFolder","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFolderDto"}}}},"responses":{"400":{"description":"BR3: the name is refused"},"409":{"description":"BR4: the name is taken in that folder"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Create a folder at the root or inside a folder","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/uploads":{"post":{"operationId":"CompanyVaultController_uploadSlot","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadSlotDto"}}}},"responses":{"400":{"description":"BR3: the name is refused; BR6: over 25 Mo"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"A signed slot to send one file to storage before filing it (POST files)","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/files":{"post":{"operationId":"CompanyVaultController_registerFile","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterFileDto"}}}},"responses":{"400":{"description":"BR3: the name is refused; BR6: over 25 Mo; a key outside the Entreprise"},"404":{"description":"No such folder in this space"},"409":{"description":"This upload is already filed"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"File an uploaded file in a folder (the root without parentId); a taken name gets « (1) »","tags":["Coffre-fort numérique"]}},"/companies/{companyId}/coffre-fort/files/batch":{"post":{"operationId":"CompanyVaultController_registerFiles","parameters":[{"name":"companyId","required":true,"in":"path","description":"Company UUID","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterFilesDto"}}}},"responses":{"400":{"description":"BR3: a name is refused; BR6: over 25 Mo; a key outside the Entreprise, or sent twice"},"404":{"description":"No such folder in this space"},"409":{"description":"An upload is already filed"}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"File the uploaded files of one upload in a folder (the root without parentId), all of them or none; a taken name gets « (1) ». A Cabinet upload notifies the Client once.","tags":["Coffre-fort numérique"]}},"/me/notification-settings":{"get":{"operationId":"NotificationSettingsController_get","parameters":[{"name":"audience","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Notifications"]},"put":{"operationId":"NotificationSettingsController_save","parameters":[{"name":"audience","required":true,"in":"query","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveNotificationSettingsDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"tags":["Notifications"]}},"/billing/plans":{"get":{"operationId":"PlansController_getPlans","parameters":[{"name":"audience","required":false,"in":"query","schema":{"enum":["company","cabinet"],"type":"string"}},{"name":"includeInactive","required":false,"in":"query","description":"Admin-only: also return deactivated plans (default false).","schema":{"type":"boolean"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"List plans: company packs (usage tiers) and cabinet subscription plans","tags":["Billing - Plans"]},"post":{"operationId":"PlansController_createPlan","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePlanDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Create a plan or pack","tags":["Billing - Plans"]}},"/billing/plans/{id}":{"get":{"operationId":"PlansController_getPlan","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Get a plan or pack by ID","tags":["Billing - Plans"]},"patch":{"operationId":"PlansController_updatePlan","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePlanDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Update a plan or pack","tags":["Billing - Plans"]},"delete":{"operationId":"PlansController_deletePlan","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Deactivate a plan or pack","tags":["Billing - Plans"]}},"/companies/{companyId}/employees":{"get":{"operationId":"PayrollController_employees","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["archived"]}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List employees: without the archived ones, or only them (most recent first) with status=archived","tags":["Payroll"]},"post":{"operationId":"PayrollController_createEmployee","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEmployeeDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Payroll"]}},"/companies/{companyId}/employees/{id}":{"get":{"operationId":"PayrollController_employee","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Payroll"]},"patch":{"operationId":"PayrollController_updateEmployee","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateEmployeeDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Payroll"]},"delete":{"operationId":"PayrollController_deleteEmployee","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Delete an employee file that never entered payroll","tags":["Payroll"]}},"/companies/{companyId}/employees/{id}/pay-estimate":{"get":{"operationId":"PayrollController_payEstimate","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Monthly net pay and employer cost of the current contract (live payroll rules)","tags":["Payroll"]}},"/companies/{companyId}/employees/{id}/status":{"post":{"operationId":"PayrollController_changeEmployeeStatus","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeEmployeeStatusDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Change an employee status: suspend, reactivate, archive or restore (ADR 0036, « Salariés : Modifier »)","tags":["Payroll"]}},"/companies/{companyId}/employees/{id}/exit":{"post":{"operationId":"PayrollController_exitEmployee","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExitEmployeeDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Declare an employee exit","tags":["Payroll"]}},"/companies/{companyId}/payroll/settings":{"get":{"operationId":"PayrollController_settings","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Statutory rates used by the payroll computation","tags":["Payroll"]}},"/companies/{companyId}/payroll/items":{"get":{"operationId":"PayrollController_payrollItems","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"kind","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"List bonuses and in-kind benefits","tags":["Payroll"]},"post":{"operationId":"PayrollController_createPayrollItem","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePayrollItemDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Payroll"]}},"/companies/{companyId}/payroll/items/{id}":{"patch":{"operationId":"PayrollController_updatePayrollItem","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePayrollItemDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Payroll"]},"delete":{"operationId":"PayrollController_deletePayrollItem","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Payroll"]}},"/companies/{companyId}/payslips":{"get":{"operationId":"PayrollController_payslips","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"period","required":true,"in":"query","schema":{"type":"string"}},{"name":"employeeId","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Payroll"]}},"/companies/{companyId}/payslips/run":{"post":{"operationId":"PayrollController_run","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunPayrollDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Compute the payslips of a period","tags":["Payroll"]}},"/companies/{companyId}/payslips/{id}/pay":{"post":{"operationId":"PayrollController_pay","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Payroll"]}},"/companies/{companyId}/cnss/declarations":{"get":{"operationId":"PayrollController_declarations","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Payroll"]},"post":{"operationId":"PayrollController_createDeclaration","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCnssDeclarationDto"}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Build (or recalculate before approval) the quarterly CNSS declaration from the payslips","tags":["Payroll"]}},"/companies/{companyId}/cnss/declarations/{id}":{"get":{"operationId":"PayrollController_declaration","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Payroll"]},"patch":{"operationId":"PayrollController_updateDeclaration","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCnssDeclarationDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Move a declaration along draft, in_review, approved, submitted (filing reference), paid","tags":["Payroll"]}},"/companies/{companyId}/cnss/declarations/{id}/ds-file":{"get":{"operationId":"PayrollController_dsFile","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Fixed-width DS file (CNSS e-declaration layout) to upload on cnss.tn","tags":["Payroll"]}},"/companies/{companyId}/cnss/declarations/{id}/sheet":{"patch":{"operationId":"PayrollController_updateSheet","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCnssSheetDto"}}}},"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"summary":"Edit the fields of the CNSS sheet (BR, code d’exploitation, identity, N° chez l’Emp., category) before approval","tags":["Payroll"]}},"/companies/{companyId}/cnss/state":{"get":{"operationId":"PayrollController_state","parameters":[{"name":"companyId","required":true,"in":"path","schema":{"type":"string"}},{"name":"period","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]},{"api-key":[]}],"tags":["Payroll"]}}},"info":{"title":"JCF Platform API","description":"Tunisian Accounting, Fiscal, and Tenancy ERP API Specification","version":"1.0","contact":{}},"tags":[],"servers":[],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","name":"JWT","description":"Enter JWT token","in":"header"},"api-key":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Company API key (jcf_...): acts as the member who created it, on /companies/{companyId}/... only"}},"schemas":{"CreateAccountantDto":{"type":"object","properties":{}},"UpdateAccountantDto":{"type":"object","properties":{}},"AssignAccountantClientsDto":{"type":"object","properties":{}},"AddAccountantCabinetDto":{"type":"object","properties":{}},"CreateCabinetDto":{"type":"object","properties":{"name":{"type":"string","description":"Cabinet legal or trade name"},"matriculeFiscal":{"type":"string","description":"Matricule fiscal / tax id","example":"1234567A"},"addressLine":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"managerName":{"type":"string"},"status":{"type":"string","enum":["active","invited","suspended","pending","archived"]},"legalForm":{"type":"string","example":"SARL","enum":["SARL","SUARL","SA","SNC","SCS","GIE","Entreprise individuelle","Association"]}},"required":["name","matriculeFiscal","status","legalForm"]},"SaveCabinetDto":{"type":"object","properties":{"name":{"type":"string","description":"Cabinet legal or trade name"},"matriculeFiscal":{"type":"string","description":"Matricule fiscal / tax id","example":"1234567A"},"legalForm":{"type":"string","enum":["SARL","SUARL","SA","SNC","SCS","GIE","Entreprise individuelle","Association"]},"addressLine":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"managerName":{"type":"string"},"status":{"type":"string","enum":["active","invited","suspended","pending","archived"]}},"required":["name","matriculeFiscal","status"]},"UpdateCabinetStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["active","suspended"]}},"required":["status"]},"RejectCabinetDto":{"type":"object","properties":{"reason":{"type":"string","description":"The Motif: the first message of the Ticket de rejet, shown to the accountant who asked","maxLength":500}},"required":["reason"]},"AssignCabinetPlanDto":{"type":"object","properties":{}},"AssignCabinetAccountantsDto":{"type":"object","properties":{}},"CreateCompanyAdminDto":{"type":"object","properties":{"name":{"type":"string","example":"Atlas Conseil"},"matriculeFiscal":{"type":"string","example":"1234567A","description":"Short (1234567A) or full (1234567A/P/M/000)"},"legalForm":{"type":"string","example":"SARL"},"rneNumber":{"type":"string","example":"1234567A"},"sector":{"type":"string","description":"Catégorie","example":"Services"},"activityType":{"type":"string","example":"Prestation de services"},"phone":{"type":"string","example":"+21620123456"},"addressLine":{"type":"string","example":"12 rue de Marseille, Tunis"}},"required":["name","matriculeFiscal","legalForm","rneNumber","sector","activityType","phone","addressLine"]},"UpdateCompanyAdminDto":{"type":"object","properties":{"name":{"type":"string","description":"Company legal or trade name"},"matriculeFiscal":{"type":"string","description":"Matricule fiscal / tax id"},"cnssNumber":{"type":"string","description":"CNSS number / social registration number"},"legalForm":{"type":"string","description":"Legal form (SARL, SUARL, SA, etc.)"},"rneNumber":{"type":"string","description":"RNE registry number"},"phone":{"type":"string","description":"Phone number"},"sector":{"type":"string","description":"Catégorie"},"activityType":{"type":"string","description":"Type d'activité"},"addressLine":{"type":"string","description":"Adresse"}}},"AssignCompanyAccountantDto":{"type":"object","properties":{}},"AssignCompanyFirmDto":{"type":"object","properties":{"cabinetId":{"type":"object","description":"Accounting firm (cabinet) UUID - omit/null to unassign"}}},"UpdateCompanyAdminStatusDto":{"type":"object","properties":{"status":{"type":"string","description":"Tenant lifecycle status","enum":["onboarding","active","suspended","archived"],"example":"active"}},"required":["status"]},"RequestCompanyDocumentsDto":{"type":"object","properties":{"documents":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string"}},"note":{"type":"string","maxLength":1000}},"required":["documents"]},"CreateSelfServiceCabinetDto":{"type":"object","properties":{"name":{"type":"string","description":"Cabinet legal or trade name"},"matriculeFiscal":{"type":"string","example":"1234567A","description":"Short matricule fiscal (7 digits + key letter)"},"legalForm":{"type":"string","example":"SARL","description":"Forme juridique","enum":["SARL","SUARL","SA","SNC","SCS","GIE","Entreprise individuelle","Association"]},"addressLine":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"managerName":{"type":"string"}},"required":["name","matriculeFiscal","legalForm"]},"CreateThreadDto":{"type":"object","properties":{}},"SendMessageDto":{"type":"object","properties":{"id":{"type":"string","description":"Message id chosen by the portal (uuid v4), so the live Stream message and the stored one are the same"},"body":{"type":"string","description":"Message content","example":"Voici la quittance demandée en pièce jointe."},"documentIds":{"description":"Array of attached document UUIDs","example":["d3b07384-d113-4045-8f43-a6fe0b66b7bb"],"type":"array","items":{"type":"string"}}},"required":["body"]},"TtnInvoiceDto":{"type":"object","properties":{}},"TejCertificateDto":{"type":"object","properties":{}},"SendOtpDto":{"type":"object","properties":{}},"RegisterDto":{"type":"object","properties":{}},"VerifyEmailDto":{"type":"object","properties":{}},"VerifyEmailCodeDto":{"type":"object","properties":{}},"ForgotPasswordDto":{"type":"object","properties":{}},"ResetPasswordDto":{"type":"object","properties":{}},"LoginDto":{"type":"object","properties":{}},"RefreshDto":{"type":"object","properties":{}},"SetLocaleDto":{"type":"object","properties":{}},"ChangePasswordDto":{"type":"object","properties":{}},"DeleteAccountDto":{"type":"object","properties":{}},"ConfirmMfaDto":{"type":"object","properties":{}},"PresignUploadDto":{"type":"object","properties":{"fileName":{"type":"string","description":"Original file name","example":"facture_mars_2026.pdf"},"contentType":{"type":"string","description":"MIME type of the file","example":"application/pdf"},"zone":{"type":"string","description":"Destination storage zone","enum":["operational","vault"],"default":"operational"}},"required":["fileName","contentType"]},"AddDocumentVersionDto":{"type":"object","properties":{"fileName":{"type":"string","description":"File name of the new version"},"storageKey":{"type":"string","description":"Storage key returned by presign-upload"},"mimeType":{"type":"string","description":"MIME type"},"sizeBytes":{"type":"number","description":"File size in bytes"},"sha256Hex":{"type":"string","description":"SHA-256 of the file content (hex)"},"note":{"type":"string","description":"Why the file was replaced"}},"required":["fileName","storageKey"]},"CreateDocumentDto":{"type":"object","properties":{"fileName":{"type":"string","description":"Original file name","example":"contrat_bail_2026.pdf"},"storageKey":{"type":"string","description":"Storage object key (the Cloudinary public id, without the environment folder)","example":"vault/2026/03/contrat_bail_2026.pdf"},"mimeType":{"type":"string","description":"MIME type","example":"application/pdf","default":"application/octet-stream"},"sizeBytes":{"type":"number","description":"File size in bytes","example":1048576},"zone":{"type":"string","description":"Storage zone","enum":["operational","vault"],"example":"vault"},"category":{"type":"string","description":"Document category","example":"contracts"},"docType":{"type":"string","description":"Specific doc type (invoice, contract, id_card)","example":"contract"},"period":{"type":"string","description":"Fiscal period association (YYYY-MM)","example":"2026-03"},"sha256Hex":{"type":"string","description":"SHA-256 hexadecimal hash string for verification","example":"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"},"parentDocumentId":{"type":"string","description":"First page of a multi-page upload; this document is stored as one of its extra pages"}},"required":["fileName","storageKey","zone"]},"UpdateDocumentDto":{"type":"object","properties":{"fileName":{"type":"string","description":"Display file name","example":"facture_mars_2026.pdf"},"tags":{"description":"Free tags","example":["urgent","fournisseur"],"type":"array","items":{"type":"string"}},"category":{"type":"string","description":"Document category","example":"contracts"},"docType":{"type":"string","description":"Specific doc type","example":"contract"},"period":{"type":"string","description":"Fiscal period association","example":"2026-03"},"status":{"type":"string","description":"Document processing status","enum":["to_classify","processing","filed","to_correct"],"example":"filed"}}},"CreateClientRequestDto":{"type":"object","properties":{"companyId":{"type":"string","example":"a0000000-0000-0000-0000-000000000001"},"type":{"type":"string","example":"document_request"},"subject":{"type":"string","example":"Merci de fournir la facture fournisseur F-2026-0088"},"amount":{"type":"number"},"docDate":{"type":"string","example":"2026-01-20"},"period":{"type":"string","example":"2026-01"},"isDocumentRequest":{"type":"boolean","default":true},"priority":{"type":"string","example":"high"},"deadline":{"type":"string","example":"2026-02-10"},"assignedToUserId":{"type":"string"}},"required":["companyId","type","subject"]},"UpdateClientRequestDto":{"type":"object","properties":{"companyId":{"type":"string","example":"a0000000-0000-0000-0000-000000000001"},"type":{"type":"string","example":"document_request"},"subject":{"type":"string","example":"Merci de fournir la facture fournisseur F-2026-0088"},"amount":{"type":"number"},"docDate":{"type":"string","example":"2026-01-20"},"period":{"type":"string","example":"2026-01"},"isDocumentRequest":{"type":"boolean","default":true},"priority":{"type":"string","example":"high"},"deadline":{"type":"string","example":"2026-02-10"},"assignedToUserId":{"type":"string"},"status":{"type":"string","enum":["draft","sent","viewed","awaiting_response","response_received","to_verify","processed","closed","reminder","cancelled"]}}},"CreateClientRequestCommentDto":{"type":"object","properties":{"body":{"type":"string","maxLength":5000}},"required":["body"]},"AttachClientRequestDocumentDto":{"type":"object","properties":{"documentId":{"type":"string","description":"Company-owned document UUID"}},"required":["documentId"]},"FeedbackDto":{"type":"object","properties":{}},"ReviewDocumentDto":{"type":"object","properties":{}},"CreateSignatureDto":{"type":"object","properties":{}},"PostMessageDto":{"type":"object","properties":{}},"ConvertMessageDto":{"type":"object","properties":{}},"ReminderRuleDto":{"type":"object","properties":{}},"SetActiveDto":{"type":"object","properties":{}},"InviteTeamMemberDto":{"type":"object","properties":{}},"UpdateRolePermissionsDto":{"type":"object","properties":{}},"AbsenceDto":{"type":"object","properties":{}},"ChangeMemberRoleDto":{"type":"object","properties":{}},"AssignClientDto":{"type":"object","properties":{}},"UpdateCabinetDto":{"type":"object","properties":{}},"UpdateProfileDto":{"type":"object","properties":{}},"SetPreferencesDto":{"type":"object","properties":{}},"OperationalSettingsDto":{"type":"object","properties":{}},"PresignDto":{"type":"object","properties":{}},"CreateLibraryDocumentDto":{"type":"object","properties":{}},"UpdateLibraryDocumentDto":{"type":"object","properties":{}},"FavoriteDto":{"type":"object","properties":{}},"CommentDto":{"type":"object","properties":{}},"AddVersionDto":{"type":"object","properties":{}},"FolderDto":{"type":"object","properties":{}},"LeaveCabinetDto":{"type":"object","properties":{}},"SubscribeDto":{"type":"object","properties":{"subscriberType":{"type":"string","enum":["company","cabinet"],"default":"company"},"subscriberId":{"type":"string"},"planId":{"type":"string"},"billingCycle":{"type":"string","enum":["monthly","quarterly","yearly"],"default":"monthly"}},"required":["subscriberType","subscriberId","planId","billingCycle"]},"PresignTransferProofDto":{"type":"object","properties":{"fileName":{"type":"string"},"mimeType":{"type":"string","enum":["application/pdf","image/jpeg","image/png","image/webp"]},"sizeBytes":{"type":"number"}},"required":["fileName","mimeType","sizeBytes"]},"SubmitTransferProofDto":{"type":"object","properties":{"fileName":{"type":"string"},"mimeType":{"type":"string","enum":["application/pdf","image/jpeg","image/png","image/webp"]},"sizeBytes":{"type":"number"},"storageKey":{"type":"string"},"transferReference":{"type":"string","description":"Reference given by the bank"},"transferDate":{"type":"string","example":"2026-10-21"}},"required":["fileName","mimeType","sizeBytes","storageKey"]},"UsageRatesDto":{"type":"object","properties":{"document":{"type":"number","example":0.05,"description":"HT per invoice beyond the largest pack"}},"required":["document"]},"SubmitKycDto":{"type":"object","properties":{"riskLevel":{"type":"string","description":"Estimated risk level","enum":["low","medium","high"],"example":"low","default":"low"},"sector":{"type":"string","description":"Business sector classification","example":"Ingénierie & Informatique"},"notes":{"type":"string","description":"Submission notes for KYC officer","example":"Dossier complet CIN gérant + Statuts RNE."}}},"KycDecisionDto":{"type":"object","properties":{"status":{"type":"string","description":"Compliance decision status","enum":["compliant","to_complete","rejected","suspended"],"example":"compliant"},"reason":{"type":"string","description":"Review decision rationale","example":"Pièces d’identité et registre de commerce conformes."}},"required":["status","reason"]},"UpdateCompanyDto":{"type":"object","properties":{"name":{"type":"string","description":"Company legal or trade name","example":"Société JCF S.A."},"legalForm":{"type":"string","description":"Legal form (SARL, SUARL, SA, etc.)","example":"SARL"},"activityType":{"type":"string","description":"Activity type description","example":"Conseil en technologies"},"sector":{"type":"string","description":"Sector of activity","example":"IT & Software"},"governorate":{"type":"string","description":"Governorate / Province in Tunisia","example":"Tunis"},"addressLine":{"type":"string","description":"Street address","example":"Les Berges du Lac 2"},"postalCode":{"type":"string","description":"Postal code","example":"1053"},"city":{"type":"string","description":"City","example":"Tunis"},"country":{"type":"string","description":"Country","example":"Tunisie"},"phone":{"type":"string","description":"Phone number","example":"+216 71 123 456"},"email":{"type":"string","description":"Official email address","example":"contact@jcf.tn"},"website":{"type":"string","description":"Website URL","example":"https://jcf.tn"},"logoDocumentId":{"type":"string","description":"Uploaded document used as the company logo"},"signatureDocumentId":{"type":"object","description":"Uploaded document (signature or stamp image) printed on the documents the company issues; null removes it"}}},"CreateRepresentativeDto":{"type":"object","properties":{"firstName":{"type":"string","description":"First name","example":"Farid"},"lastName":{"type":"string","description":"Last name","example":"Mansour"},"quality":{"type":"string","description":"Title or quality (Gérant, PDG, etc.)","example":"Gérant"},"email":{"type":"string","description":"Representative email","example":"farid@jcf.tn"},"phone":{"type":"string","description":"Representative phone","example":"+216 98 123 456"},"birthDate":{"type":"string","description":"Date of birth (YYYY-MM-DD)","example":"1985-05-12"},"nationality":{"type":"string","description":"Nationality","example":"Tunisienne"},"isPrimary":{"type":"boolean","description":"Whether this is the primary legal representative","example":true,"default":false},"byMandate":{"type":"boolean","description":"Not the person creating the Entreprise: acts through a Mandat, which becomes a Pièce justificative, and is invited as Administrateur on submission (ADR 0016). Requires the email.","default":false},"cin":{"type":"string","description":"CIN or passport number (stored encrypted)"}},"required":["firstName","lastName"]},"CreateBankAccountDto":{"type":"object","properties":{"bankName":{"type":"string","description":"Bank institution name","example":"BIAT"},"holder":{"type":"string","description":"Account holder legal title","example":"Société JCF SARL"},"ribLast4":{"type":"string","description":"Last 4 digits of RIB","example":"7890"},"currency":{"type":"string","description":"Account currency","example":"TND","default":"TND"},"isPrimary":{"type":"boolean","description":"Whether this is the primary bank account","example":true,"default":false},"iban":{"type":"string","description":"IBAN (stored encrypted)"},"rib":{"type":"string","description":"RIB, 20 digits (stored encrypted)"}},"required":["bankName","holder"]},"UpsertFiscalProfileDto":{"type":"object","properties":{"situation":{"type":"string"},"regime":{"type":"string","enum":["forfaitaire","reel_simplifie","reel_normal"]},"tvaSubject":{"type":"boolean"},"tvaRate":{"type":"number"},"tvaPeriodicity":{"type":"string","enum":["monthly","quarterly","annual"]},"primaryActivity":{"type":"string"},"secondaryActivities":{"type":"array","items":{"type":"string"}},"activityCode":{"type":"string"},"taxOffice":{"type":"string","description":"Centre / recette des finances de rattachement"},"startDate":{"type":"string"},"taxNatures":{"type":"array","items":{"type":"string"}}}},"UpsertSocialProfileDto":{"type":"object","properties":{"isEmployer":{"type":"boolean"},"cnssNumber":{"type":"string"},"headcount":{"type":"number"},"fileStatus":{"type":"string","enum":["up_to_date","to_verify"]},"conventionCollective":{"type":"string"},"cnssActivity":{"type":"string","example":"COMMISSIONNAIRE"},"cnssAtRate":{"type":"object","example":0.5,"nullable":true}}},"UpdateRepresentativeDto":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"quality":{"type":"string"},"phone":{"type":"string"},"email":{"type":"string"},"birthDate":{"type":"string"},"nationality":{"type":"string"},"idDocumentId":{"type":"string","description":"Uploaded identity document; puts the ID back under verification"},"idDocExpiresAt":{"type":"string"},"cin":{"type":"string","description":"CIN or passport number (stored encrypted)"}}},"UpdateBankAccountDto":{"type":"object","properties":{"bankName":{"type":"string"},"holder":{"type":"string"},"ribLast4":{"type":"string"},"currency":{"type":"string"},"iban":{"type":"string","description":"IBAN (stored encrypted)"},"rib":{"type":"string","description":"RIB, 20 digits (stored encrypted)"}}},"UpdateLegalDocumentDto":{"type":"object","properties":{"documentId":{"type":"string"},"validUntil":{"type":"string"}},"required":["documentId"]},"CreateChangeRequestDto":{"type":"object","properties":{"scope":{"type":"string","enum":["general","fiscal"]},"field":{"type":"string"},"payload":{"description":"Fiscal scope: the fields to change","allOf":[{"$ref":"#/components/schemas/UpsertFiscalProfileDto"}]},"effectiveFrom":{"type":"string","description":"First period the change applies to"},"requestedValue":{"type":"string"},"note":{"type":"string"}},"required":["field"]},"InviteMemberDto":{"type":"object","properties":{}},"UpdateMemberDto":{"type":"object","properties":{}},"UpdateAccessPolicyDto":{"type":"object","properties":{"force2FA":{"type":"string","enum":["none","sensitive","all"]},"roleMatrix":{"type":"object","description":"role label -> module -> allowed actions (labels, modules and actions are validated by the service)"},"sessionTimeoutMinutes":{"type":"object","minimum":5,"maximum":1440,"nullable":true}}},"ReviewChangeRequestDto":{"type":"object","properties":{}},"CreateApiKeyDto":{"type":"object","properties":{"name":{"type":"string","description":"What the key is for, e.g. \"CRM Odoo\""},"access":{"type":"string","enum":["read","write"],"description":"read = GET only"},"expiresAt":{"type":"string","description":"ISO date; never expires when omitted"}},"required":["name","access"]},"CreateRoleDto":{"type":"object","properties":{}},"UpdateRoleDto":{"type":"object","properties":{}},"RoleMembersDto":{"type":"object","properties":{}},"TemplatePreviewDto":{"type":"object","properties":{}},"TemplateDto":{"type":"object","properties":{}},"UpdateTemplateDto":{"type":"object","properties":{}},"CreateFiscalRuleDto":{"type":"object","properties":{}},"NewVersionDto":{"type":"object","properties":{}},"VersionStatusDto":{"type":"object","properties":{}},"PresignFiscalAttachmentDto":{"type":"object","properties":{}},"ConfirmFiscalAttachmentDto":{"type":"object","properties":{}},"SettingsDto":{"type":"object","properties":{}},"BrandLogoUploadDto":{"type":"object","properties":{}},"BrandLogoConfirmDto":{"type":"object","properties":{}},"IntegrationDto":{"type":"object","properties":{}},"TaskEnabledDto":{"type":"object","properties":{}},"PreferencesDto":{"type":"object","properties":{}},"AdminPasswordDto":{"type":"object","properties":{}},"NotificationPrefsDto":{"type":"object","properties":{}},"AudienceDto":{"type":"object","properties":{}},"AnnouncementDto":{"type":"object","properties":{}},"CampaignDto":{"type":"object","properties":{}},"EmailTemplateDto":{"type":"object","properties":{}},"SendNotificationDto":{"type":"object","properties":{}},"OpenTicketDto":{"type":"object","properties":{}},"PresignTicketAttachmentDto":{"type":"object","properties":{}},"RegisterTicketAttachmentDto":{"type":"object","properties":{}},"TicketUpdateDto":{"type":"object","properties":{}},"TicketMessageDto":{"type":"object","properties":{}},"AgentDto":{"type":"object","properties":{}},"UpdateAgentDto":{"type":"object","properties":{}},"AgentStatusDto":{"type":"object","properties":{}},"RejectTransferDto":{"type":"object","properties":{"reason":{"type":"string"}},"required":["reason"]},"PresignAdminDocumentDto":{"type":"object","properties":{}},"CreateAdminDocumentDto":{"type":"object","properties":{}},"DocumentMetaDto":{"type":"object","properties":{}},"NoteDto":{"type":"object","properties":{}},"ExpenseDto":{"type":"object","properties":{}},"BulkActionDto":{"type":"object","properties":{}},"NotificationTemplatePreviewDto":{"type":"object","properties":{}},"NotificationTemplateDto":{"type":"object","properties":{}},"EnabledDto":{"type":"object","properties":{}},"CreateWarehouseDto":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]},"UpdateWarehouseDto":{"type":"object","properties":{"name":{"type":"string"},"active":{"type":"boolean"}}},"CreateStockMovementDto":{"type":"object","properties":{"articleId":{"type":"string"},"warehouseId":{"type":"string"},"type":{"type":"string","enum":["in","out","adjustment","transfer"]},"quantity":{"type":"number"},"toWarehouseId":{"type":"string","description":"Required for a transfer"}},"required":["articleId","warehouseId","type","quantity"]},"CreateCreditNoteDto":{"type":"object","properties":{"invoiceId":{"type":"string"},"reason":{"type":"string"},"type":{"type":"string","enum":["total","partial"]},"amountHt":{"type":"number","description":"HT amount, required for a partial credit note"},"date":{"type":"string"}},"required":["invoiceId","reason","type","date"]},"CreatePurchaseCreditNoteDto":{"type":"object","properties":{"purchaseInvoiceId":{"type":"string"},"amountTtc":{"type":"number"},"amountTva":{"type":"number","description":"Exact VAT share; defaults to the invoice VAT ratio"},"date":{"type":"string"}},"required":["purchaseInvoiceId","amountTtc","date"]},"CreateBankTransactionDto":{"type":"object","properties":{"treasuryAccountId":{"type":"string"},"date":{"type":"string"},"label":{"type":"string"},"type":{"type":"string","enum":["customer_receipt","supplier_payment","bank_movement","tax_payment","withholding","bank_fee","unidentified"]},"counterparty":{"type":"string"},"amountIn":{"type":"number"},"amountOut":{"type":"number"}},"required":["treasuryAccountId","date","label","type"]},"ImportBankStatementCsvDto":{"type":"object","properties":{"treasuryAccountId":{"type":"string"},"fileName":{"type":"string","maxLength":200},"content":{"type":"string","description":"UTF-8 CSV or OFX content; maximum 2 MB.","maxLength":2000000}},"required":["treasuryAccountId","fileName","content"]},"BankMatchLineDto":{"type":"object","properties":{"type":{"type":"string","enum":["sales_document","purchase_invoice","receipt","disbursement"]},"id":{"type":"string"},"amount":{"type":"number","description":"Amount allocated to this target (TND)"}},"required":["type","id","amount"]},"MatchBankTransactionDto":{"type":"object","properties":{"lines":{"type":"array","items":{"$ref":"#/components/schemas/BankMatchLineDto"}}},"required":["lines"]},"UpdateBankTransactionDto":{"type":"object","properties":{"status":{"type":"string","enum":["reconciled","to_identify","evidence_required","under_review"]},"documentId":{"type":"object","description":"Company-owned evidence document UUID","nullable":true},"note":{"type":"object","description":"Why the line is \"non justifiée\" / to verify","nullable":true,"maxLength":1000}}},"CreateCalendarEventDto":{"type":"object","properties":{"date":{"type":"string","example":"2026-02-15"},"time":{"type":"string","example":"10:00"},"title":{"type":"string","example":"Date limite dépôt déclaration mensuelle TVA janvier"},"description":{"type":"string"},"type":{"type":"string","example":"fiscal_deadline"},"companyId":{"type":"string"},"source":{"type":"string","enum":["auto","manual"],"default":"manual"},"linkedEntityType":{"type":"string"},"linkedEntityId":{"type":"string"},"collaboratorUserIds":{"type":"array","items":{"type":"string"}}},"required":["date","title"]},"InviteAccountantDto":{"type":"object","properties":{"matriculeFiscal":{"type":"string","description":"Cabinet's matricule fiscal, short (1234567A) or full (1234567A/P/M/000)"},"email":{"type":"string","description":"Email of the cabinet or of one of its accountants"},"external":{"type":"boolean","description":"The cabinet is unknown to JCF (« Autre »): allow creating an `invited` placeholder cabinet instead of rejecting the invite"}}},"RespondLinkDto":{"type":"object","properties":{"status":{"type":"string","enum":["accepted","rejected","revoked"]}},"required":["status"]},"GenerateTejDto":{"type":"object","properties":{"purchaseInvoiceId":{"type":"string"},"categoryCode":{"type":"string","enum":["01","02","03","04","05","06"]},"ratePercent":{"type":"number"},"issueDate":{"type":"string"}},"required":["purchaseInvoiceId","categoryCode","issueDate"]},"UpdateTejStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["validated","cancelled"]}},"required":["status"]},"ComputeDeclarationDto":{"type":"object","properties":{"type":{"type":"string","enum":["withholding","is","advance_payment","employer_declaration"]},"period":{"type":"string","example":"2026-07"}},"required":["type","period"]},"RequestCorrectionDto":{"type":"object","properties":{"topic":{"type":"string"}},"required":["topic"]},"UpdateTaskDto":{"type":"object","properties":{"title":{"type":"string","example":"Rapprochement bancaire janvier"},"description":{"type":"string"},"category":{"type":"string","example":"comptabilite"},"priority":{"type":"string","enum":["low","medium","high","urgent"],"default":"medium"},"companyId":{"type":"string"},"assignedToUserId":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"deadline":{"type":"string","example":"2026-02-15"},"missionId":{"type":"string"},"linkedEntityType":{"type":"string"},"linkedEntityId":{"type":"string"},"status":{"type":"string","enum":["new","waiting","in_progress","waiting_client","waiting_documents","in_review","ready_to_validate","approved","rejected","done","cancelled","overdue"]},"progress":{"type":"number","example":100},"validatedComment":{"type":"string"}}},"AnswerDocumentRequestDto":{"type":"object","properties":{"documentId":{"type":"string"}}},"ConvertSalesDto":{"type":"object","properties":{"kind":{"type":"string","enum":["invoice","order","delivery_note","exit_note"]}},"required":["kind"]},"OrderLineDto":{"type":"object","properties":{"label":{"type":"string"},"quantity":{"type":"number"},"unitPrice":{"type":"number"},"tvaRate":{"type":"number"}},"required":["label","quantity","unitPrice","tvaRate"]},"CreateSupplierOrderDto":{"type":"object","properties":{"supplierId":{"type":"string"},"issueDate":{"type":"string"},"reference":{"type":"string"},"projectRef":{"type":"string"},"priceMode":{"type":"string","enum":["ht","ttc"]},"discount":{"type":"number"},"lines":{"type":"array","items":{"$ref":"#/components/schemas/OrderLineDto"}}},"required":["supplierId","issueDate","priceMode","lines"]},"OrderStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["validated","sent","cancelled"]}},"required":["status"]},"CreateReceiptNoteDto":{"type":"object","properties":{"supplierOrderId":{"type":"string"},"date":{"type":"string"}},"required":["supplierOrderId","date"]},"UpdateSettingsDto":{"type":"object","properties":{"locale":{"type":"string","enum":["fr","en","ar"]},"dateFormat":{"type":"string","enum":["dmy","mdy","ymd"]},"density":{"type":"string","enum":["compact","comfortable"]},"phone":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"photoDocumentId":{"type":"object","nullable":true},"jobTitle":{"type":"string"},"companyId":{"type":"string"}}},"UpdateNotificationPreferenceDto":{"type":"object","properties":{"type":{"type":"string"},"channel":{"type":"string","enum":["in_app","email","sms","push"]},"enabled":{"type":"boolean"}},"required":["type","channel","enabled"]},"PresignAvatarUploadDto":{"type":"object","properties":{"fileName":{"type":"string"},"contentType":{"type":"string"}},"required":["fileName","contentType"]},"ConfirmAvatarUploadDto":{"type":"object","properties":{"storageKey":{"type":"string"},"fileName":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"type":"number"}},"required":["storageKey","fileName"]},"RespondCabinetInviteDto":{"type":"object","properties":{"status":{"type":"string","enum":["accepted","rejected"]}},"required":["status"]},"SaveBilanDto":{"type":"object","properties":{"from":{"type":"string","example":"2025-01-01"},"to":{"type":"string","example":"2025-12-31"},"overrides":{"type":"object","description":"Full line code -> year-N values (F6001: [brut, amort], others: [value])","example":{"F60010006":[1200,300]}}},"required":["from","to","overrides"]},"BilanCorrectionDto":{"type":"object","properties":{"note":{"type":"string"}},"required":["note"]},"CreateReceiptDto":{"type":"object","properties":{"reference":{"type":"string","description":"Receipt reference number. Required on a bank account; on a cash account it may be omitted and one is generated.","example":"ENC-2026-001"},"receiptDate":{"type":"string","description":"Receipt date (YYYY-MM-DD)","example":"2026-03-01"},"customerId":{"type":"string","description":"Paying customer UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"},"paymentMethod":{"type":"string","description":"Payment method","enum":["bank_transfer","cheque","cash","card","draft","direct_debit","other"],"example":"bank_transfer"},"amount":{"type":"number","description":"Received amount in TND","example":3571},"treasuryAccountId":{"type":"string","description":"Destination treasury account UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"},"paymentReference":{"type":"string","description":"External transaction or check number","example":"VIR-998811"},"notes":{"type":"string","description":"Internal notes","example":"Paiement intégral facture FAC-2026-0001"},"valueDate":{"type":"string","description":"Value date (YYYY-MM-DD)"},"invoiceId":{"type":"string","description":"Sales invoice to allocate the receipt to"},"documentId":{"type":"string","description":"Company-owned proof document UUID"}},"required":["receiptDate","customerId","paymentMethod","amount","treasuryAccountId"]},"CancelFinanceOperationDto":{"type":"object","properties":{"reason":{"type":"string"}},"required":["reason"]},"CreateDisbursementDto":{"type":"object","properties":{"reference":{"type":"string","description":"Disbursement reference number","example":"DEC-2026-001"},"date":{"type":"string","description":"Disbursement date (YYYY-MM-DD)","example":"2026-03-05"},"supplierId":{"type":"string","description":"Beneficiary supplier UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"},"kind":{"type":"string","description":"Kind of disbursement","enum":["invoiced","uninvoiced"],"example":"invoiced","default":"invoiced"},"purchaseInvoiceId":{"type":"string","description":"Linked purchase invoice UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"},"paymentMethod":{"type":"string","description":"Payment method","enum":["bank_transfer","cheque","cash","card","draft","direct_debit","other"],"example":"bank_transfer"},"amount":{"type":"number","description":"Disbursed amount in TND","example":952},"treasuryAccountId":{"type":"string","description":"Source treasury account UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"},"status":{"type":"string","enum":["paid","to_pay"],"default":"paid"}},"required":["reference","date","supplierId","paymentMethod","amount","treasuryAccountId"]},"CreateCashMovementDto":{"type":"object","properties":{"treasuryAccountId":{"type":"string"},"operation":{"type":"string","enum":["cash_in","cash_out","deposit_to_bank","withdraw_from_bank","correction"]},"amount":{"type":"number","description":"Positive amount; a correction may be negative"},"label":{"type":"string"},"date":{"type":"string"},"counterpartAccountId":{"type":"string","description":"Bank account on the other side of a deposit/withdrawal"}},"required":["treasuryAccountId","operation","amount"]},"CreateTreasuryAccountDto":{"type":"object","properties":{"kind":{"type":"string","description":"Account type","enum":["bank","cash"],"example":"bank"},"label":{"type":"string","description":"Account label","example":"Compte Courant Principal"},"bankName":{"type":"string","description":"Bank institution name","example":"BIAT"},"currency":{"type":"string","description":"Account currency","example":"TND","default":"TND"},"openingBalance":{"type":"number","description":"Initial or opening balance in TND","example":10000,"default":0},"ibanLast4":{"type":"string","description":"Last 4 characters of the IBAN/RIB"}},"required":["kind"]},"CreateCompanyDto":{"type":"object","properties":{}},"SubscribeNewsletterDto":{"type":"object","properties":{}},"CreateCustomerDto":{"type":"object","properties":{"code":{"type":"string","description":"Customer reference code - auto-generated when omitted","example":"CLI-0001"},"name":{"type":"string","description":"Customer company or person name","example":"Client Alpha SARL"},"email":{"type":"string","description":"Email address","example":"billing@alpha.tn"},"phone":{"type":"string","description":"Phone number","example":"+216 71 222 333"},"matriculeFiscal":{"type":"object","description":"Matricule Fiscal (required unless a CIN is given; \"/\" optional on input)","example":"1234567A/P/M/000"},"cin":{"type":"object","description":"CIN, 8 digits (required unless a matricule fiscal is given)","example":"12345678"},"rneNumber":{"type":"string","description":"RNE registration number","example":"1234567A"},"billingAddress":{"type":"string","description":"Billing address","example":"Avenue Habib Bourguiba, Tunis"},"shippingAddress":{"type":"string","description":"Shipping address","example":"Zone Industrielle Charguia"},"paymentTerms":{"type":"string","description":"Payment terms (e.g. 30 days)","example":"30_days"},"defaultDiscountRate":{"type":"number","description":"Default commercial discount percentage","example":5},"tvaSubject":{"type":"boolean","description":"Whether the customer is subject to TVA","example":true,"default":true},"withholdingSubject":{"type":"boolean","description":"Subject to withholding tax"},"tvaExempt":{"type":"boolean","description":"TVA exempt customer"}},"required":["name"]},"UpdateCustomerDto":{"type":"object","properties":{"name":{"type":"string","description":"Customer name (cannot be blanked)","example":"Client Alpha SARL"},"email":{"type":"string","description":"Email","example":"billing@alpha.tn"},"phone":{"type":"string","description":"Phone","example":"+216 71 222 333"},"matriculeFiscal":{"type":"object","description":"Matricule Fiscal (\"/\" optional on input)","example":"1234567A/P/M/000"},"cin":{"type":"object","description":"CIN, 8 digits","example":"12345678"},"billingAddress":{"type":"string","description":"Billing address","example":"Avenue Habib Bourguiba"},"paymentTerms":{"type":"string","description":"Payment terms","example":"60_days"},"defaultDiscountRate":{"type":"number","description":"Default discount rate","example":10},"rneNumber":{"type":"string","description":"RNE registration number"},"shippingAddress":{"type":"string","description":"Shipping address"},"tvaSubject":{"type":"boolean","description":"Whether the customer is subject to TVA"},"withholdingSubject":{"type":"boolean","description":"Subject to withholding tax"},"tvaExempt":{"type":"boolean","description":"TVA exempt customer"},"status":{"type":"string","description":"Status","enum":["active","inactive","archived"]}}},"CustomerNoteDto":{"type":"object","properties":{"body":{"type":"string","example":"Préfère être relancé par téléphone."}},"required":["body"]},"CreateSupplierDto":{"type":"object","properties":{"code":{"type":"string","description":"Supplier reference code","example":"FRS-0001"},"name":{"type":"string","description":"Supplier legal name","example":"Fournisseur Beta SA"},"email":{"type":"string","description":"Email","example":"orders@beta.tn"},"phone":{"type":"string","description":"Phone","example":"+216 71 888 999"},"matriculeFiscal":{"type":"string","description":"Matricule Fiscal","example":"9876543B/B/M/000"},"rib":{"type":"string","description":"RIB (20 digits, key checked); compared with the RIB read on scanned invoices","example":"10006035183598478831"},"rneNumber":{"type":"string","description":"RNE registration number"},"address":{"type":"string","description":"Postal address"},"paymentTerms":{"type":"string","description":"Payment terms","example":"cash"}},"required":["code","name"]},"UpdateSupplierDto":{"type":"object","properties":{"name":{"type":"string","description":"Supplier name","example":"Fournisseur Beta SA"},"email":{"type":"string","description":"Email","example":"contact@beta.tn"},"phone":{"type":"string","description":"Phone","example":"+216 71 888 999"},"matriculeFiscal":{"type":"string","description":"Matricule Fiscal","example":"9876543B/B/M/000"},"rib":{"type":"string","description":"RIB (20 digits, key checked); compared with the RIB read on scanned invoices","example":"10006035183598478831"},"addRib":{"type":"string","description":"RIB added as a further bank account (the main RIB is kept); becomes the main RIB when none is on file","example":"08008000067100029452"},"rneNumber":{"type":"string","description":"RNE registration number"},"address":{"type":"string","description":"Postal address"},"paymentTerms":{"type":"string","description":"Payment terms","example":"30_days"},"status":{"type":"string","description":"Status","enum":["active","inactive","archived"]}}},"CreateSalesDocumentLineDto":{"type":"object","properties":{"label":{"type":"string","description":"Line item description","example":"Prestation de conseil technique"},"quantity":{"type":"number","description":"Quantity sold","example":2},"unitPrice":{"type":"number","description":"Unit price HT in TND","example":1200},"tvaRate":{"type":"number","description":"TVA rate percentage","enum":[0,7,13,19],"example":19},"discountRate":{"type":"number","description":"Line discount rate percentage","example":5},"articleId":{"type":"string","description":"Linked article UUID if from catalog","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"}},"required":["label","quantity","unitPrice","tvaRate"]},"CreateSalesDocumentDto":{"type":"object","properties":{"kind":{"type":"string","description":"Document kind","enum":["invoice","quote","delivery_note","exit_note","order"],"example":"invoice"},"customerId":{"type":"string","description":"Target customer UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"},"issueDate":{"type":"string","description":"Document issue date (YYYY-MM-DD)","example":"2026-03-01"},"dueDate":{"type":"string","description":"Payment due date (YYYY-MM-DD)","example":"2026-03-31"},"validUntil":{"type":"string","description":"Validity date for quotes (YYYY-MM-DD)","example":"2026-04-01"},"paymentTerms":{"type":"string","description":"Payment terms description","example":"30 jours fin de mois"},"notes":{"type":"string","description":"Public document notes","example":"Merci pour votre confiance."},"withholdingRate":{"type":"number","description":"Withholding tax rate (%) applied to the TTC"},"discountAmount":{"type":"number","description":"Global discount amount (HT)"},"status":{"type":"string","enum":["draft","sent"],"description":"Save as draft or issue right away"},"billingAddress":{"type":"string","description":"Billing address printed on the document"},"documentId":{"type":"string","description":"Attached company document UUID (uploaded via presign)"},"lines":{"description":"Itemized document lines","type":"array","items":{"$ref":"#/components/schemas/CreateSalesDocumentLineDto"}}},"required":["kind","customerId","issueDate","lines"]},"UpdateSalesDocumentStatusDto":{"type":"object","properties":{"status":{"type":"string","description":"Updated document status","enum":["draft","sent","accepted","refused","expired","paid","partially_paid","overdue","cancelled"],"example":"sent"}},"required":["status"]},"ExtractPurchaseDocumentDto":{"type":"object","properties":{"documentId":{"type":"string","description":"Company-owned document UUID to extract"},"reuse":{"type":"boolean","description":"Map the fields already read on the document (no new reading) when it was analysed before"}},"required":["documentId"]},"PurchaseInvoiceLineDto":{"type":"object","properties":{}},"CreatePurchaseInvoiceDto":{"type":"object","properties":{"supplierId":{"type":"string","description":"Supplier UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"},"number":{"type":"string","description":"Supplier invoice reference number","example":"FAC-2026-089"},"issueDate":{"type":"string","description":"Issue date (YYYY-MM-DD)","example":"2026-02-15"},"dueDate":{"type":"string","description":"Payment due date (YYYY-MM-DD)","example":"2026-03-15"},"amountHt":{"type":"number","description":"Total amount HT in TND","example":1500},"amountTva":{"type":"number","description":"Total TVA amount in TND","example":285},"amountTtc":{"type":"number","description":"Total amount TTC in TND","example":1785},"status":{"type":"string","description":"Invoice status","example":"draft","default":"draft"},"lines":{"type":"array","items":{"$ref":"#/components/schemas/PurchaseInvoiceLineDto"}},"paymentTerms":{"type":"string","description":"Payment terms shown on the supplier invoice"},"documentId":{"type":"string","description":"Linked uploaded invoice document UUID"}},"required":["supplierId","number","issueDate","amountHt","amountTva","amountTtc"]},"UpdatePurchaseInvoiceDto":{"type":"object","properties":{"supplierId":{"type":"string","description":"Supplier UUID"},"number":{"type":"string","description":"Supplier invoice reference number"},"issueDate":{"type":"string","description":"Issue date (YYYY-MM-DD)"},"dueDate":{"type":"string","description":"Payment due date (YYYY-MM-DD)"},"amountHt":{"type":"number","description":"Total amount HT in TND"},"amountTva":{"type":"number","description":"Total TVA amount in TND"},"amountTtc":{"type":"number","description":"Total amount TTC in TND"},"status":{"type":"string","description":"Invoice status","example":"draft"},"lines":{"type":"array","items":{"$ref":"#/components/schemas/PurchaseInvoiceLineDto"}},"paymentTerms":{"type":"string"},"documentId":{"type":"string","description":"Linked uploaded invoice document UUID"}}},"CreateArticleDto":{"type":"object","properties":{"sku":{"type":"string","description":"Stock Keeping Unit / Code","example":"ART-001"},"name":{"type":"string","description":"Product or article description","example":"Ordinateur Portable Dell Latitude"},"unit":{"type":"string","description":"Measurement unit","example":"unité"},"unitPrice":{"type":"number","description":"Unit selling price HT in TND","example":2450},"tvaRate":{"type":"number","description":"TVA rate percentage","example":19},"stock":{"type":"number","description":"Initial stock quantity","example":15,"default":0},"warehouseId":{"type":"string","description":"Assigned warehouse UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"}},"required":["sku","name","unitPrice","tvaRate"]},"UpdateArticleDto":{"type":"object","properties":{"sku":{"type":"string","description":"Stock Keeping Unit / Code","example":"ART-001"},"name":{"type":"string","description":"Product or article description","example":"Ordinateur Portable Dell Latitude"},"unit":{"type":"string","description":"Measurement unit","example":"unité"},"unitPrice":{"type":"number","description":"Unit selling price HT in TND","example":2450},"tvaRate":{"type":"number","description":"TVA rate percentage","example":19},"warehouseId":{"type":"string","description":"Assigned warehouse UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"}}},"CreateChartAccountDto":{"type":"object","properties":{"code":{"type":"string","description":"Account code according to plan comptable","example":"411000"},"label":{"type":"string","description":"Account label","example":"Clients"},"class":{"type":"number","description":"Account class (1 to 7)","example":4},"type":{"type":"string","description":"Account nature/type","enum":["asset","liability","equity","revenue","expense"],"example":"asset"},"parentId":{"type":"string","description":"Parent account UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"},"isLettrable":{"type":"boolean","description":"Whether this account supports lettrage","example":true,"default":false},"defaultTvaRate":{"type":"number","description":"Default TVA rate percentage","example":19}},"required":["code","label","class","type"]},"UpdateChartAccountDto":{"type":"object","properties":{"label":{"type":"string","description":"Account label","example":"Clients"},"parentId":{"type":"object","description":"Parent account UUID (null to clear)"},"isLettrable":{"type":"boolean","description":"Whether this account supports lettrage"},"defaultTvaRate":{"type":"object","description":"Default TVA rate percentage (null to clear)"},"isActive":{"type":"boolean","description":"false disables the account for new entries"}}},"CreateJournalDto":{"type":"object","properties":{"code":{"type":"string","description":"Journal code","example":"VT"},"label":{"type":"string","description":"Journal label","example":"Journal des Ventes"},"type":{"type":"string","description":"Journal type","enum":["purchases","sales","bank","cash","misc"],"example":"sales"},"counterpartAccountId":{"type":"string","description":"Default counterpart account UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"}},"required":["code","label","type"]},"UpdateJournalDto":{"type":"object","properties":{"label":{"type":"string","description":"Journal label"},"counterpartAccountId":{"type":"object","description":"Default counterpart account UUID (null to clear)"},"isActive":{"type":"boolean","description":"false disables the journal for new entries"}}},"CreateEntryLineDto":{"type":"object","properties":{"accountId":{"type":"string","description":"Target chart account UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"},"label":{"type":"string","description":"Line label description","example":"Vente de services"},"debit":{"type":"number","description":"Debit amount in TND","example":1000,"default":0},"credit":{"type":"number","description":"Credit amount in TND","example":0,"default":0},"thirdPartyType":{"type":"string","description":"Auxiliary third party type (customer, supplier)","example":"customer"},"thirdPartyId":{"type":"string","description":"Auxiliary third party UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"}},"required":["accountId","debit","credit"]},"CreateAccountingEntryDto":{"type":"object","properties":{"journalId":{"type":"string","description":"Journal UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"},"periodId":{"type":"string","description":"Accounting period UUID. When omitted, the period covering `date` is resolved or created automatically.","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"},"date":{"type":"string","description":"Entry date (YYYY-MM-DD)","example":"2026-03-01"},"label":{"type":"string","description":"Entry piece label / description","example":"Facture client FAC-2026-0001"},"reference":{"type":"string","description":"Piece reference","example":"FAC-2026-0001"},"lines":{"description":"Balanced entry lines (sum debit must equal sum credit)","type":"array","items":{"$ref":"#/components/schemas/CreateEntryLineDto"}}},"required":["journalId","date","label","lines"]},"TrialBalanceRowDto":{"type":"object","properties":{"accountId":{"type":"string","description":"Account UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"},"accountCode":{"type":"string","description":"Account PGT code","example":"4111"},"accountLabel":{"type":"string","description":"Account label","example":"Clients"},"totalDebit":{"type":"number","description":"Total debit amount","example":1190},"totalCredit":{"type":"number","description":"Total credit amount","example":0},"balance":{"type":"number","description":"Net balance (debit - credit)","example":1190}},"required":["accountId","accountCode","accountLabel","totalDebit","totalCredit","balance"]},"CreateDeclarationDto":{"type":"object","properties":{"type":{"type":"string","description":"Fiscal declaration type","enum":["monthly","tva","cnss","is","irpp","withholding","tfp","foprolos","tcl","advance_payment","annual_return","employer_declaration","hydrocarbon_tax","annual_art43","liberatory_tax","online_gaming_tax","partnership_advance","flat_tax","wealth_tax"],"example":"tva"},"period":{"type":"string","description":"Fiscal period: YYYY-MM (monthly), YYYY-Qn (quarterly) or YYYY (annual)","example":"2026-02"},"periodicity":{"type":"string","description":"Periodicity","enum":["monthly","quarterly","annual"],"example":"monthly"},"dueDate":{"type":"string","description":"Official deadline date (YYYY-MM-DD)","example":"2026-03-28"},"amountDue":{"type":"number","description":"Net amount due in TND","example":570},"priorCredit":{"type":"number","description":"Prior tax credit reportable in TND","example":0},"data":{"type":"object","description":"Detailed fiscal calculation payload","example":{"caTotal":10000,"tvaCollectee":1900,"tvaDeductible":1330}},"assignedToUserId":{"type":"string","description":"Assigned accountant or user UUID","example":"d3b07384-d113-4045-8f43-a6fe0b66b7bb"}},"required":["type","period","periodicity","dueDate"]},"UpdateDeclarationStatusDto":{"type":"object","properties":{"status":{"type":"string","description":"Updated declaration workflow status","enum":["to_prepare","documents_required","in_preparation","ready_for_validation","client_approved","to_transmit","transmitting","submitted","rejected","correction_requested","to_pay","paid","archived"],"example":"submitted"},"receiptNumber":{"type":"string","description":"Official tax receipt or quittance number","example":"REC-TVA-202602-00123"},"paymentReference":{"type":"string","description":"Payment reference or bank receipt number","example":"PAY-BNK-9988"},"paidAt":{"type":"string","description":"Date the payment was made (YYYY-MM-DD); defaults to now","example":"2026-10-05"},"amountPaid":{"type":"number","description":"Amount paid in TND; defaults to the amount due","example":1250.5},"paymentDocumentId":{"type":"string","description":"Uploaded company document holding the payment receipt"},"paymentCode":{"type":"string","description":"Code paiement of the imprimé: 1 paiement total, 2 paiement différé","enum":["1","2"]},"recette":{"type":"string","description":"Recette des finances where the tax was paid"},"recetteCode":{"type":"string","description":"Code recette (3 digits)"}},"required":["status"]},"FileMonthlyDto":{"type":"object","properties":{"filedAt":{"type":"string","description":"Filing date on the DGI site (YYYY-MM-DD, default today)"},"receiptNumber":{"type":"string","description":"DGI receipt / declaration number (accusé de dépôt)"}}},"AuditFilingDto":{"type":"object","properties":{"notifiedOn":{"type":"string","description":"Notification of the audit results or reconnaissance de dette (YYYY-MM-DD): the delay stops there (CDPF art. 87)"},"acknowledged":{"type":"boolean","description":"Debt acknowledged before any taxation d’office and paid within 30 days: 1.25 % a month, fixed penalty halved"},"fraud":{"type":"boolean","description":"Turnover understated by 30 % or more, or fraud: fixed penalty 20 % on every tax"},"confirmedCredit":{"type":"number","description":"Tax credit confirmed by the same audit (TND): no penalty within its limit (CDPF art. 82, last paragraph)"}},"required":["notifiedOn"]},"UpdateMonthlyFilingDto":{"type":"object","properties":{"codeActe":{"type":"string","description":"Code acte of the imprimé: 0 spontané, 1 régularisation, 2 rectification (rectificative acts), 3 taxation d’office, 4 cessation d’activité","enum":["0","1","2","3","4"]},"cessationDate":{"type":"object","description":"Date de cessation d’activité (YYYY-MM-DD), code acte 4","nullable":true},"audit":{"description":"Filed after a tax-audit intervention (null = spontaneous): the penalty estimate uses CDPF art. 82","nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/AuditFilingDto"}]}}},"CancelMonthlyDto":{"type":"object","properties":{"reason":{"type":"string","description":"Why the return is withdrawn"}}},"SaveMonthlySectionDto":{"type":"object","properties":{"applicable":{"type":"object","description":"Accountant tick when the fiscal profile does not decide (null = follow the profile)","nullable":true},"values":{"type":"object","description":"Values entered for the section (shape depends on the tax)"},"completed":{"type":"boolean","description":"Mark the section complete / reopen it"}}},"ReviewMonthlyDto":{"type":"object","properties":{"force":{"type":"boolean","description":"Continue although taxes are undecided or incomplete (the DGI only warns); they are frozen as they stand"}}},"CreateCabinetClientDto":{"type":"object","properties":{"name":{"type":"string","example":"Atlas Conseil"},"matriculeFiscal":{"type":"string","example":"1234567A","description":"Short (1234567A) or full (1234567A/P/M/000)"},"legalForm":{"type":"string","example":"SARL"},"rneNumber":{"type":"string","example":"1234567A"},"sector":{"type":"string","description":"Catégorie","example":"Services"},"activityType":{"type":"string","example":"Prestation de services"},"phone":{"type":"string","example":"+21620123456"},"addressLine":{"type":"string","example":"12 rue de Marseille, Tunis"}},"required":["name","matriculeFiscal","legalForm","rneNumber","sector","activityType","phone","addressLine"]},"CreatePortfolioClientDto":{"type":"object","properties":{}},"ImportPortfolioClientsDto":{"type":"object","properties":{"clients":{"type":"array","items":{"$ref":"#/components/schemas/CreatePortfolioClientDto"}}},"required":["clients"]},"InvitePortfolioClientDto":{"type":"object","properties":{}},"UpdatePortfolioClientDto":{"type":"object","properties":{}},"UpdatePortfolioClientStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["active","archived"]}},"required":["status"]},"CreateMissionDto":{"type":"object","properties":{"title":{"type":"string","example":"Tenue comptable exercice 2026"},"type":{"type":"string","example":"comptabilite"},"description":{"type":"string"},"notes":{"type":"string"},"companyId":{"type":"string","example":"a0000000-0000-0000-0000-000000000001"},"leadUserId":{"type":"string"},"startDate":{"type":"string","example":"2026-01-01"},"deadline":{"type":"string","example":"2026-12-31"},"priority":{"type":"string","example":"medium"},"budget":{"type":"number","example":2500},"planning":{"type":"object","description":"Wizard planning: fiscalDeadline, estimatedDays, recurrence, reminderDays, autoNotify, urgencyLevel, periodMonth, periodYear"}},"required":["title"]},"UpdateMissionDto":{"type":"object","properties":{"title":{"type":"string","example":"Tenue comptable exercice 2026"},"type":{"type":"string","example":"comptabilite"},"description":{"type":"string"},"notes":{"type":"string"},"companyId":{"type":"string","example":"a0000000-0000-0000-0000-000000000001"},"leadUserId":{"type":"string"},"startDate":{"type":"string","example":"2026-01-01"},"deadline":{"type":"string","example":"2026-12-31"},"priority":{"type":"string","example":"medium"},"budget":{"type":"number","example":2500},"planning":{"type":"object","description":"Wizard planning: fiscalDeadline, estimatedDays, recurrence, reminderDays, autoNotify, urgencyLevel, periodMonth, periodYear"}}},"UpdateMissionStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["to_start","in_progress","waiting_client","to_review","to_validate","blocked","overdue","done"]},"blockingReason":{"type":"string"},"progress":{"type":"number","example":100},"closureDerogation":{"type":"string","description":"Justification required when forcing a mission to \"done\" with incomplete checklist items."}},"required":["status"]},"AddChecklistItemDto":{"type":"object","properties":{"label":{"type":"string","example":"Collecte des relevés bancaires"},"isRequired":{"type":"boolean","default":true}},"required":["label"]},"ToggleChecklistItemDto":{"type":"object","properties":{"done":{"type":"boolean","example":true}},"required":["done"]},"MissionTemplateDto":{"type":"object","properties":{}},"UpdateMissionTemplateDto":{"type":"object","properties":{}},"CreateTaskDto":{"type":"object","properties":{"title":{"type":"string","example":"Rapprochement bancaire janvier"},"description":{"type":"string"},"category":{"type":"string","example":"comptabilite"},"priority":{"type":"string","enum":["low","medium","high","urgent"],"default":"medium"},"companyId":{"type":"string"},"assignedToUserId":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"deadline":{"type":"string","example":"2026-02-15"},"missionId":{"type":"string"},"linkedEntityType":{"type":"string"},"linkedEntityId":{"type":"string"}},"required":["title"]},"UpdateTaskStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["new","waiting","in_progress","waiting_client","waiting_documents","in_review","ready_to_validate","approved","rejected","done","cancelled","overdue"]},"progress":{"type":"number","example":100},"validatedComment":{"type":"string"}},"required":["status"]},"CreateSubtaskDto":{"type":"object","properties":{"title":{"type":"string","example":"Vérifier ligne débit 411"},"status":{"type":"string","example":"todo"},"assignedTo":{"type":"string"},"deadline":{"type":"string"},"notes":{"type":"string"}},"required":["title"]},"CreateTaskCommentDto":{"type":"object","properties":{"body":{"type":"string","example":"Justificatif reçu du client par email."}},"required":["body"]},"UpdateCalendarEventDto":{"type":"object","properties":{"date":{"type":"string","example":"2026-02-15"},"time":{"type":"string","example":"10:00"},"title":{"type":"string","example":"Date limite dépôt déclaration mensuelle TVA janvier"},"description":{"type":"string"},"type":{"type":"string","example":"fiscal_deadline"},"companyId":{"type":"string"},"collaboratorUserIds":{"type":"array","items":{"type":"string"}}}},"SetFeePricingDto":{"type":"object","properties":{"companyId":{"type":"string","example":"a0000000-0000-0000-0000-000000000001"},"mode":{"type":"string","enum":["monthly_flat","hourly","per_mission"],"default":"monthly_flat"},"baseRate":{"type":"number","example":450},"periodicity":{"type":"string","enum":["monthly","quarterly","annual"],"default":"monthly"},"tvaRate":{"type":"number","example":19},"perEmployeeRate":{"type":"number","example":10},"perDocumentRate":{"type":"number","example":0.5},"designation":{"type":"string","example":"Honoraires de tenue comptable"},"paymentTermsKind":{"type":"string","enum":["on_receipt","net_days","end_of_month","net_days_end_of_month"],"default":"on_receipt"},"paymentTermsDays":{"type":"number","example":30,"description":"Days for net_days / net_days_end_of_month"},"startDate":{"type":"string","example":"2026-01-01"},"nextIssueDate":{"type":"string","example":"2026-02-01"},"autoGenerate":{"type":"boolean","description":"Relance automatique: issue the invoice of each period"},"active":{"type":"boolean","default":true}},"required":["companyId","mode","baseRate","tvaRate"]},"CalculateFeeDto":{"type":"object","properties":{"companyId":{"type":"string","example":"a0000000-0000-0000-0000-000000000001"},"period":{"type":"string","example":"2026-01"},"employeeCount":{"type":"number","example":5},"documentCount":{"type":"number","example":40}},"required":["companyId","period"]},"CabinetInvoiceLineDto":{"type":"object","properties":{"description":{"type":"string","example":"Honoraires comptables - Janvier 2026"},"quantity":{"type":"number","example":1},"unitPrice":{"type":"number","example":450},"tvaRate":{"type":"number","example":19}},"required":["description","quantity","unitPrice","tvaRate"]},"CreateHonorairesInvoiceDto":{"type":"object","properties":{"companyId":{"type":"string","example":"a0000000-0000-0000-0000-000000000001"},"issueDate":{"type":"string","example":"2026-01-31"},"dueDate":{"type":"string","example":"2026-02-28","description":"Overrides the due date computed from the company's terms"},"notes":{"type":"string"},"lines":{"type":"array","items":{"$ref":"#/components/schemas/CabinetInvoiceLineDto"}},"period":{"type":"string","example":"2026-01-01"}},"required":["companyId","issueDate","lines"]},"CreateMissionInvoiceDto":{"type":"object","properties":{"companyId":{"type":"string","example":"a0000000-0000-0000-0000-000000000001"},"issueDate":{"type":"string","example":"2026-01-31"},"dueDate":{"type":"string","example":"2026-02-28","description":"Overrides the due date computed from the company's terms"},"notes":{"type":"string"},"lines":{"type":"array","items":{"$ref":"#/components/schemas/CabinetInvoiceLineDto"}},"missionId":{"type":"string"}},"required":["companyId","issueDate","lines"]},"UpdateCabinetInvoiceStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["draft","pending_review","validated","sent","paid","overdue","cancelled"]}},"required":["status"]},"RecordCabinetPaymentDto":{"type":"object","properties":{"paidOn":{"type":"string","example":"2026-02-10"},"amount":{"type":"number","example":238},"method":{"type":"string","enum":["transfer","cheque","cash","card","direct_debit","other"]},"reference":{"type":"string","example":"VIR 0045"},"note":{"type":"string"}},"required":["paidOn","amount","method"]},"CreateTicketDto":{"type":"object","properties":{"subject":{"type":"string","description":"Support ticket subject","example":"Incident de connexion bancaire BIAT"},"priority":{"type":"string","description":"Ticket urgency priority","enum":["low","medium","high","urgent"],"example":"medium","default":"medium"},"category":{"type":"string","description":"Ticket category","example":"technical","default":"general"},"initialMessage":{"type":"string","description":"Detailed problem description","example":"Le flux bancaire affiche une erreur de token depuis ce matin."},"documentIds":{"description":"Documents attached to the message (uploaded to the company or cabinet first)","type":"array","items":{"type":"string"}}},"required":["subject","initialMessage"]},"CreateTicketMessageDto":{"type":"object","properties":{"body":{"type":"string","description":"Message content","example":"Le problème persiste malgré la réinitialisation du mot de passe."},"documentIds":{"description":"Documents attached to the message (uploaded to the company or cabinet first)","type":"array","items":{"type":"string"}}},"required":["body"]},"CreateCompanySignatureDto":{"type":"object","properties":{}},"RenameItemDto":{"type":"object","properties":{"name":{"type":"string","description":"The new name; for a file, the name before its extension, which is kept. BR3 applies to the whole name (checked by the service)"}},"required":["name"]},"MoveItemsDto":{"type":"object","properties":{"ids":{"description":"The folders and files to move, at most 100; all of them or none move","type":"array","items":{"type":"string"}},"parentId":{"type":"string","nullable":true,"description":"The folder to move them into; null for the root"}},"required":["ids","parentId"]},"TrashItemsDto":{"type":"object","properties":{"ids":{"description":"The folders and files to send to the Corbeille, at most 100; all of them or none","type":"array","items":{"type":"string"}}},"required":["ids"]},"RestoreItemDto":{"type":"object","properties":{"parentId":{"type":"string","nullable":true,"description":"Where to restore it: a folder, or null for the root. Left out: the folder it was deleted from, refused (409) when that folder is gone"}}},"CreateFolderDto":{"type":"object","properties":{"name":{"type":"string","description":"BR3: required, at most 120 characters, none of \\ / : * ? \" < > | (checked by the service)"},"parentId":{"type":"string","description":"The folder to create it in; the root when absent"}},"required":["name"]},"UploadSlotDto":{"type":"object","properties":{"fileName":{"type":"string","description":"The file name as picked: BR3 is checked now, so the portal learns before sending the bytes"},"contentType":{"type":"string","description":"MIME type; every format is accepted"},"sizeBytes":{"type":"number","description":"Size in bytes; BR6: at most 25 Mo"}},"required":["fileName","sizeBytes"]},"RegisterFileDto":{"type":"object","properties":{"storageKey":{"type":"string","description":"The key of the upload slot the file was sent to"},"fileName":{"type":"string","description":"BR3: required, at most 120 characters, none of \\ / : * ? \" < > |. BR5: « (1) » is added when taken"},"mimeType":{"type":"string","description":"MIME type; every format is accepted"},"sizeBytes":{"type":"number","description":"Size in bytes, checked against the stored object when storage can tell"},"sha256Hex":{"type":"string","description":"SHA-256 of the bytes (hex); the same content may be stored twice (ADR 0041)"},"parentId":{"type":"string","description":"The folder to file it in; the root when absent"}},"required":["storageKey","fileName","sizeBytes"]},"UploadedFileDto":{"type":"object","properties":{"storageKey":{"type":"string","description":"The key of the upload slot the file was sent to"},"fileName":{"type":"string","description":"BR3: required, at most 120 characters, none of \\ / : * ? \" < > |. BR5: « (1) » is added when taken"},"mimeType":{"type":"string","description":"MIME type; every format is accepted"},"sizeBytes":{"type":"number","description":"Size in bytes, checked against the stored object when storage can tell"},"sha256Hex":{"type":"string","description":"SHA-256 of the bytes (hex); the same content may be stored twice (ADR 0041)"}},"required":["storageKey","fileName","sizeBytes"]},"RegisterFilesDto":{"type":"object","properties":{"files":{"description":"The files of one upload, at most 100; all of them are filed or none","type":"array","items":{"$ref":"#/components/schemas/UploadedFileDto"}},"parentId":{"type":"string","description":"The folder to file them in; the root when absent"}},"required":["files"]},"SaveNotificationSettingsDto":{"type":"object","properties":{}},"CreatePlanDto":{"type":"object","properties":{"code":{"type":"string","example":"pro_company"},"label":{"type":"string","example":"Forfait Pro Entreprise"},"audience":{"type":"string","enum":["company","cabinet"],"default":"company"},"priceMonthly":{"type":"number","example":49},"priceYearly":{"type":"number","example":490,"description":"Cabinet plans only (company packs are monthly)"},"priceQuarterly":{"type":"number","example":20,"description":"Cabinet plans only (company packs are monthly)"},"limits":{"type":"object","description":"Company packs: { documents (invoices issued) } included per month (integer); priceIncludesTax for a TTC price"},"isActive":{"type":"boolean","default":true}},"required":["code","label","audience","priceMonthly"]},"UpdatePlanDto":{"type":"object","properties":{"code":{"type":"string","example":"pro_company"},"label":{"type":"string","example":"Forfait Pro Entreprise"},"audience":{"type":"string","enum":["company","cabinet"]},"priceMonthly":{"type":"number","example":49},"priceYearly":{"type":"number","example":490},"priceQuarterly":{"type":"number","example":20},"limits":{"type":"object"},"isActive":{"type":"boolean"}}},"EmployeeDocumentDto":{"type":"object","properties":{"type":{"type":"string"},"documentId":{"type":"string"},"fileName":{"type":"string"}},"required":["type","documentId","fileName"]},"EmployeeProfileDto":{"type":"object","properties":{"birthDate":{"type":"string"},"birthPlace":{"type":"string"},"cinIssueDate":{"type":"string"},"gender":{"type":"string","enum":["male","female"]},"nationality":{"type":"string"},"maritalStatus":{"type":"string"},"disabledDependents":{"type":"number"},"dependentParents":{"type":"number"},"address":{"type":"string"},"city":{"type":"string"},"postalCode":{"type":"string"},"internalId":{"type":"string"},"category":{"type":"string"},"weeklyHours":{"type":"string"},"trialPeriod":{"type":"string"},"paymentMode":{"type":"string"},"rib":{"type":"string"},"cnssAffiliationDate":{"type":"string"},"cnssRegime":{"type":"string"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/EmployeeDocumentDto"}}}},"CreateEmployeeDto":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"jobTitle":{"type":"string"},"department":{"type":"string"},"contractType":{"type":"string","enum":["cdi","cdd","sivp","civp","karama","apprenticeship"]},"hireDate":{"type":"string"},"contractEndDate":{"type":"string"},"cnssNumber":{"type":"string"},"cin":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"headOfFamily":{"type":"boolean"},"childrenCount":{"type":"number"},"grossSalary":{"type":"number"},"transportAllowance":{"type":"number"},"presenceAllowance":{"type":"number"},"cnssExempt":{"type":"boolean"},"profile":{"$ref":"#/components/schemas/EmployeeProfileDto"}},"required":["firstName","lastName","jobTitle","contractType","hireDate","grossSalary"]},"UpdateEmployeeDto":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"jobTitle":{"type":"string"},"department":{"type":"string"},"contractType":{"type":"string","enum":["cdi","cdd","sivp","civp","karama","apprenticeship"]},"hireDate":{"type":"string"},"contractEndDate":{"type":"string"},"cnssNumber":{"type":"string"},"cin":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"headOfFamily":{"type":"boolean"},"childrenCount":{"type":"number"},"grossSalary":{"type":"number"},"transportAllowance":{"type":"number"},"presenceAllowance":{"type":"number"},"cnssExempt":{"type":"boolean"},"profile":{"$ref":"#/components/schemas/EmployeeProfileDto"}}},"ChangeEmployeeStatusDto":{"type":"object","properties":{"change":{"type":"string","enum":["suspend","reactivate","archive","restore"]},"motif":{"type":"string","enum":["maladie","conge_maternite","conge_sans_solde","mise_a_pied","autre","fin_contrat","demission","licenciement","retraite","erreur_saisie"]},"precision":{"type":"string","description":"Required with the « autre » motif"},"startDate":{"type":"string","example":"2026-11-04"},"plannedEndDate":{"type":"string","example":"2026-12-04"},"comment":{"type":"string"}},"required":["change"]},"ExitEmployeeDto":{"type":"object","properties":{"exitDate":{"type":"string"},"reason":{"type":"string"}},"required":["exitDate","reason"]},"CreatePayrollItemDto":{"type":"object","properties":{"employeeId":{"type":"string"},"kind":{"type":"string","enum":["bonus","benefit","overtime","absence","thirteenth_month"]},"label":{"type":"string","description":"Item type, or the name typed for an \"Autre\" one"},"amount":{"type":"number","description":"Amount (bonus / benefit / thirteenth_month: defaults to the base salary). Ignored for overtime / absence, priced at payroll run."},"quantity":{"type":"number","description":"Overtime hours / unpaid absence calendar days"},"multiplier":{"type":"number","description":"Overtime coefficient: a preset of the overtime_multipliers rule or a typed majoration of 0-300 % (1 to 4)"},"period":{"type":"string","example":"2026-07","description":"First (or only) period"},"recurring":{"type":"boolean"},"contributory":{"type":"boolean","description":"Benefit subject to CNSS"}},"required":["employeeId","kind","label","period"]},"UpdatePayrollItemDto":{"type":"object","properties":{"employeeId":{"type":"string"},"kind":{"type":"string","enum":["bonus","benefit","overtime","absence","thirteenth_month"]},"label":{"type":"string","description":"Item type, or the name typed for an \"Autre\" one"},"amount":{"type":"number","description":"Amount (bonus / benefit / thirteenth_month: defaults to the base salary). Ignored for overtime / absence, priced at payroll run."},"quantity":{"type":"number","description":"Overtime hours / unpaid absence calendar days"},"multiplier":{"type":"number","description":"Overtime coefficient: a preset of the overtime_multipliers rule or a typed majoration of 0-300 % (1 to 4)"},"period":{"type":"string","example":"2026-07","description":"First (or only) period"},"recurring":{"type":"boolean"},"contributory":{"type":"boolean","description":"Benefit subject to CNSS"}}},"RunPayrollDto":{"type":"object","properties":{"period":{"type":"string","example":"2026-07"}},"required":["period"]},"CreateCnssDeclarationDto":{"type":"object","properties":{"period":{"type":"string","example":"2026-Q3","description":"Quarter: AAAA-T1..T4"},"dueDay":{"type":"number","enum":[15,20,25],"description":"15 (default), 20 (construction > 50 employees), 25 (full exporters)"},"exploitationCode":{"type":"string","example":"0000","description":"Code d'exploitation (CNSS)"}},"required":["period"]},"UpdateCnssDeclarationDto":{"type":"object","properties":{"status":{"type":"string","enum":["draft","in_review","approved","submitted","paid"]},"reference":{"type":"string","description":"submitted: accusé de réception of the e-service"},"paymentMethod":{"type":"string","enum":["prelevement","virement","cheque","especes"]},"paymentDate":{"type":"string","example":"2026-10-14"},"paidAmount":{"type":"number","description":"Amount paid (TND); default = amount due + penalty"},"paymentReference":{"type":"string"}},"required":["status"]},"CnssSheetLineDto":{"type":"object","properties":{"id":{"type":"string","description":"Absent = new line typed on the sheet"},"cin":{"type":"string","description":"CIN (8 digits), required by the DS file"},"month1":{"type":"number"},"month2":{"type":"number"},"month3":{"type":"number"},"fullName":{"type":"string"},"cnssNumber":{"type":"string","description":"10 digits or 8 digits-2 key; empty clears"},"employerRef":{"type":"string"},"category":{"type":"string"}}},"UpdateCnssSheetDto":{"type":"object","properties":{"regionalOffice":{"type":"string","example":"20-HAMMAMET"},"exploitationCode":{"type":"string","example":"0000"},"lines":{"type":"array","items":{"$ref":"#/components/schemas/CnssSheetLineDto"}},"removeLineIds":{"description":"Lines to remove","type":"array","items":{"type":"string"}}}}}}}