@invoiceleaf/integration-datev
v1.1.1
Published
DATEV integration for InvoiceLeaf: sync documents to DATEV through the accounting:dxso-jobs API with scheduled and event-driven transfers
Maintainers
Readme
@invoiceleaf/integration-datev
DATEV integration for InvoiceLeaf focused on the accounting:dxso-jobs API.
Features
- OAuth2/OIDC-based DATEV connection support for:
datev-openid(production)datev-openid-sandbox(sandbox)datev-idp-next
- Full dxso endpoint lifecycle actions:
- list/get clients
- create dxso job
- upload job file (multipart)
- get job status
- finalize/cancel job
- read protocol entries
- Outbound document sync handlers:
- scheduled sync (
syncInvoices) - event sync on document create/update (
syncInvoiceEvent) - optional cancel-on-delete handler (
deleteDocumentEvent)
- scheduled sync (
- Auth discovery action for DATEV OIDC metadata
- Endpoint template action to inspect how to fill all path placeholders (
{client-id},{job-id}) - Generic custom endpoint action for advanced use cases
Required Setup
- Connect one DATEV OAuth provider from the manifest external auth section.
- Set
xDatevClientIdin integration config (recommended). - Optionally set
defaultClientIdto avoid passingclientIdon every action.
Config Highlights
environment:productionorsandboxauthProvider: optional explicit provider overrideapiBaseUrl: optional override (defaults to DATEV dxso platform endpoints)xDatevClientId: sent asX-DATEV-Client-Idon each requestdefaultImportType+defaultAccountingMonth: defaults for dxso job creationinitialSyncLookbackHours,maxDocumentsPerRun,pageSize: scheduled sync limitsenableEventSync: enables/disables create/update event-driven synccancelOnDeleteEvent: attempts to cancel mapped DATEV job on delete events
Development
npm install
npm run typecheck
npm run build