billing.costs.accounting-export

A month or a range of days as a DATEV Buchungsstapel (EXTF) for the tax advisor

GET /billing/api/cost-explorer/accounting-exportIAM billing:GetCostAndUsageRead

DATEV-Format Buchungsstapel: the EXTF header record (version 700, category 21, format 13; Berater- and Mandantennummer, fiscal year start and account length from the cost-report settings, empty until set; Datum vom/bis = the range; not fixed), then the 125 standard columns. Windows-1252, semicolons, decimal comma, CRLF. Give month (YYYY-MM) or start and end (YYYY-MM-DD, inclusive, UTC); a range across two fiscal years is refused (400). One row per month × cost centre × project × service, net of discounts and before VAT; each credit an H row; KOST1 is the cost-centre tag (default cost-center), KOST2 the project, a resource in two projects split evenly. Belegdatum and Leistungsdatum are the last day of service in that month inside the range, never a future day; a month not over yet says "vorläufig" in the Buchungstext. Cents are allocated by largest remainder so the rows sum exactly to the net. Konto and Gegenkonto come from the report settings unless given here.

Request syntax

GET /billing/api/cost-explorer/accounting-export

Query parameters

  • monthOptional

    string

    The billing month, YYYY-MM; or give start and end

    Constraints: /^\d{4}-(0[1-9]|1[0-2])$/

  • startOptional

    string

    First day of the range, YYYY-MM-DD (UTC), with end; instead of month

    Constraints: /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/

  • endOptional

    string

    Last day of the range, YYYY-MM-DD (UTC), inclusive

    Constraints: /^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/

  • kost1TagKeyOptional

    string

    Override the cost-centre tag for this export

    Constraints: max 64 chars, /^[a-z][a-z0-9_.-]*$/

  • kontoOptional

    string

    Override the expense account

    Constraints: max 20 chars, /^[0-9A-Za-z]*$/

  • gegenkontoOptional

    string

    Override the creditor account

    Constraints: max 20 chars, /^[0-9A-Za-z]*$/

Response

200 with the Buchungsstapel file (text/csv, Windows-1252) as an attachment. 400 without month or both start and end, when end is before start, or when the range crosses into another fiscal year.

The response is the raw content with its own content type, not JSON.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow billing:GetCostAndUsage on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud billing costs accounting-export

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_billing_costs_accounting-export.