Ukraine

Was Ocost auf einem ukrainischen Beleg liest und wo es das in ocost.document.v1 schreibt. Eine Vorlage braucht es nicht. Belege auf Russisch liest Ocost genauso.

Was Ocost in Deutschland und in der Ukraine liest
DeutschlandUkraine
BelegeRechnung, Gutschrift, Lieferschein, Auftragsbestätigungрахунок, акт, видаткова накладна, податкова накладна
KennungenUSt-IdNr., Steuernummer, HRBЄДРПОУ, РНОКПП, ІПН
Steuersätze19 %, 7 %20 %, 14 %, 7 %, 0 %
E-RechnungenXRechnung, ZUGFeRD, Factur-X, ohne ModellNoch kein XML-Format: PDF oder Scan schicken
Export für die BuchhaltungDATEV1С / BAS

Belege

Gedruckt alskindkind_detail
рахунок, рахунок на оплату, рахунок-фактураinvoiceinvoice
акт виконаних робіт, акт наданих послуг, акт приймання-передачіotheracceptance_protocol
видаткова накладна, товарна накладнаdelivery_notedelivery_note
податкова накладнаtax_invoicetax_invoice
квитанціяreceiptreceipt
договірcontractcontract

Ein акт hat Preise wie eine Rechnung: Beträge, Steuer, Positionen, den Leistungszeitraum und den Vertrag in contract_reference. Er belegt, dass die Arbeit getan ist. Bezahlt wird der рахунок, also bucht Ocost den акт nie als zweite Rechnung.

Eine податкова накладна ist der Steuernachweis des Verkäufers und wird nie bezahlt. tax_registration enthält ihre Nummer und ihr Datum im ЄРПН, wo gedruckt. preceding_invoice nennt den рахунок oder акт, zu dem sie gehört.

Eine видаткова накладна trägt Preise, Steuer und Summen, wo gedruckt. Ocost prüft sie wie die Summen einer Rechnung. Für eine товарно-транспортна накладна gibt es noch keine eigene Regel.

Kennungen

Ocost schreibt jede Nummer nach scheme in die identifiers der Partei:

Gedruckt alsschemevalid
код ЄДРПОУUA_EDRPOU8 Ziffern und ihre Prüfziffer
РНОКПП, einer Person oder eines ФОПUA_RNOKPP10 Ziffern und ihre Prüfziffer
ІПН платника ПДВUA_IPN12 Ziffern. Eine Prüfziffer gibt es nicht, die richtige Länge ist also null.

Eine Nummer, die durchfällt, bleibt mit valid: false, und die Prüfung identifier schlägt fehl, at ihr Schema. Ocost findet nie eine Firma an ihr. tax_registration_id kann eine dieser Nummern wiederholen, lesen Sie also identifiers.

Eine IBAN mit UA prüft Ocost an ihren Prüfziffern, in iban.

Umsatzsteuer

Ocost liest die Sätze der ПДВ, die ein Beleg druckt, etwa 20 %, 14 %, 7 % oder 0 %. Jeder Satz ist eine Gruppe in vat_breakdown. Die Prüfung vat hält, wenn die Steuer einer Gruppe ihr Netto mal ihr Satz ist.

Ein Verkäufer, der kein Steuerzahler der ПДВ ist, druckt „Без ПДВ“. Ocost liest dann keine Steuer, und die Prüfung gross vergleicht Netto und Brutto.

tax_check ist für Ihr ukrainisches Unternehmen gefüllt, wenn Ukraines Register den Lieferanten als keinen ПДВ-Zahler führt, die Rechnung oder Quittung aber ПДВ berechnet. missing enthält dann vat_non_payer mit law п. 198.6 ст. 198 ПКУ: Diese ПДВ ist kein Steuerkredit. at_stake ist true, wenn Ihr Unternehmen Vorsteuer abzieht. Sonst ist tax_check null. Andere ukrainische Rechnungsregeln prüft Ocost nicht, wohl aber die Summen, die Positionen, die Daten, die IBAN und die Kennungen.

E-Rechnungen

Ein ukrainisches XML-Format liest Ocost noch nicht. Schicken Sie das PDF oder einen Scan, read_with ist dann reader.

Datum, Beträge und Sprache

Ukrainische Belege drucken 03.11.2026 und 1 200,00. Ocost schreibt 2026-11-03 und 1200. sources behält das Zitat wie gedruckt.

currency ist UAH, wo der Beleg UAH, ₴ oder грн druckt. Wo er gar keine Währung druckt, nimmt Ocost die übliche des Lieferanten, sonst die Ihres Unternehmens.

Einheiten werden UNECE-Codes: шт. ist C62, кг KGM, год. HUR, послуга E48. Einheiten und Codes listet sie. Namen und Positionen bleiben in den Worten des Belegs.

Ihr Unternehmen

Ocost unterscheidet Eingang und Ausgang an Ihren Angaben in Einstellungen › Unternehmen. Ein ukrainisches Unternehmen braucht seinen ЄДРПОУ, ein ФОП seinen РНОКПП, und seine Anschrift. Die ІПН tragen Sie erst ein, wenn Sie Steuerzahler der ПДВ sind.

Ocost füllt einen leeren ЄДРПОУ, eine leere ІПН oder Anschrift aus Ihren Belegen und denen der Gruppe, wo eine exakte Kennung Sie nennt. Einen Wert überschreibt es nie.

Post an belege@<name>.ocost.io erreicht Ocost. Der Name ist Ihrer ohne ТОВ oder ФОП, in lateinischen Buchstaben nach der amtlichen ukrainischen Transliteration (КМУ № 55, 2010): ТОВ «Охорона-Київ» erhält okhorona-kyiv.

Beispiel

Ein Auszug eines акт наданих послуг:

JSON
{
  "kind": "other",
  "kind_detail": "acceptance_protocol",
  "number": "А-7",
  "issue_date": "2026-10-31",
  "invoicing_period_start": "2026-10-01",
  "invoicing_period_end": "2026-10-31",
  "currency": "UAH",
  "contract_reference": "Д-2026/3",
  "seller": {
    "name": "ТОВ «Приклад Сервіс»",
    "identifiers": [
      { "scheme": "UA_EDRPOU", "value": "42135797", "valid": true },
      { "scheme": "UA_IPN", "value": "421357926541", "valid": null }
    ],
    "vat_id": null
  },
  "buyer": {
    "name": "ФОП Зразок Олена",
    "identifiers": [
      { "scheme": "UA_RNOKPP", "value": "3141592650", "valid": true }
    ],
    "vat_id": null
  },
  "totals": { "net": 10000, "tax": 2000, "gross": 12000, "payable": null, "prices_include_vat": false },
  "vat_breakdown": [
    { "category": "S", "rate": 20, "taxable_amount": 10000, "tax_amount": 2000, "exemption_reason": null }
  ],
  "lines": [
    { "id": "1", "name": "Консультаційні послуги", "quantity": 40, "unit": "HUR", "price": 250, "net_amount": 10000, "vat_rate": 20 }
  ],
  "checks": [
    { "name": "vat", "passed": true, "sums": true, "fields": ["totals.net", "totals.tax"], "at": "20" },
    { "name": "identifier", "passed": true, "sums": false, "fields": [], "at": "UA_EDRPOU" },
    { "name": "identifier", "passed": true, "sums": false, "fields": [], "at": "UA_RNOKPP" }
  ],
  "tax_check": null,
  "read_with": "reader"
}

Siehe auch