Ukraine

Ce qu'Ocost lit sur un document ukrainien et où il l'écrit dans ocost.document.v1. Aucun modèle de document n'est nécessaire. Les documents en russe sont lus de la même façon.

Ce qu’Ocost lit en Allemagne et en Ukraine
AllemagneUkraine
DocumentsRechnung, Gutschrift, Lieferschein, Auftragsbestätigungрахунок, акт, видаткова накладна, податкова накладна
IdentifiantsUSt-IdNr., Steuernummer, HRBЄДРПОУ, РНОКПП, ІПН
Taux de TVA19 %, 7 %20 %, 14 %, 7 %, 0 %
Factures électroniquesXRechnung, ZUGFeRD, Factur-X, sans modèlePas encore de format XML : envoyez le PDF ou un scan
Export pour le comptableDATEV1С / BAS

Documents

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

Un акт porte des prix comme une facture : montants, TVA, lignes, la période de prestation et le contrat dans contract_reference. Il prouve que le travail a été fait. Le рахунок est ce que vous payez, donc Ocost ne comptabilise jamais l'акт comme une seconde facture.

Une податкова накладна est la preuve de TVA du vendeur, jamais payée. tax_registration contient son numéro et sa date dans l'ЄРПН, là où ils sont imprimés. preceding_invoice nomme le рахунок ou l'акт auquel elle se rapporte.

Une видаткова накладна porte les prix, la TVA et les totaux là où ils sont imprimés. Ocost les contrôle comme les sommes d'une facture. Une товарно-транспортна накладна n'a pas encore de règle propre.

Identifiants

Ocost écrit chaque numéro dans les identifiers de la partie, par scheme :

Imprimé commeschemevalid
код ЄДРПОУUA_EDRPOU8 chiffres et son chiffre de contrôle
РНОКПП, d'une personne ou d'un ФОПUA_RNOKPP10 chiffres et son chiffre de contrôle
ІПН платника ПДВUA_IPN12 chiffres. Il n'y a pas de chiffre de contrôle, donc une longueur correcte donne null.

Un numéro qui échoue est gardé avec valid: false, et le contrôle identifier échoue avec at égal à son schéma. Ocost ne trouve jamais une entreprise par ce numéro. tax_registration_id peut répéter l'un de ces numéros, lisez donc identifiers.

Un IBAN commençant par UA est contrôlé par ses chiffres de contrôle, dans iban.

TVA

Ocost lit les taux de ПДВ qu'un document imprime, comme 20 %, 14 %, 7 % ou 0 %. Chaque taux forme un groupe de vat_breakdown. Le contrôle vat tient quand la TVA d'un groupe est égale à son montant HT multiplié par son taux.

Un vendeur qui n'est pas assujetti à la TVA imprime « Без ПДВ ». Ocost ne lit alors aucune TVA, et le contrôle gross compare le montant HT au montant TTC.

tax_check est rempli pour votre entreprise ukrainienne quand le registre ukrainien dit que le fournisseur n'est pas assujetti au ПДВ, alors que la facture ou le reçu en facture. missing contient alors vat_non_payer avec law п. 198.6 ст. 198 ПКУ : ce ПДВ n'ouvre aucun crédit d'impôt. at_stake vaut true quand votre entreprise déduit la TVA. Sinon tax_check vaut null. Ocost ne contrôle aucune autre règle ukrainienne de facturation, mais il contrôle les sommes, les lignes, les dates, l'IBAN et les identifiants.

Factures électroniques

Ocost ne lit encore aucun format XML ukrainien. Envoyez le PDF ou un scan, et read_with vaut reader.

Dates, montants et langue

Les documents ukrainiens impriment 03.11.2026 et 1 200,00. Ocost écrit 2026-11-03 et 1200. sources garde la citation telle qu'imprimée.

currency vaut UAH là où le document imprime UAH, ₴ ou грн. Là où il n'imprime aucune devise, Ocost prend la devise habituelle du fournisseur, sinon celle de votre entreprise.

Les unités deviennent des codes UNECE : шт. donne C62, кг KGM, год. HUR, послуга E48. Unités et codes les liste. Les noms et les lignes restent dans les mots du document.

Votre entreprise

Ocost distingue l'entrant du sortant grâce à vos données dans Paramètres › Données de l'entreprise. Une entreprise ukrainienne a besoin de son ЄДРПОУ, un ФОП de son РНОКПП, et de son adresse. Ajoutez l'ІПН seulement une fois que vous êtes assujetti à la TVA.

Ocost remplit un ЄДРПОУ, un ІПН ou une adresse vide à partir de vos documents et de ceux du groupe, là où un identifiant exact vous nomme. Il n'écrase jamais une valeur.

Le courrier à belege@<name>.ocost.io arrive chez Ocost. Le nom est le vôtre sans ТОВ ni ФОП, en lettres latines selon la translittération officielle de l'Ukraine (КМУ № 55, 2010) : ТОВ «Охорона-Київ» donne okhorona-kyiv.

Exemple

Un extrait d'un акт наданих послуг :

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"
}

Voir aussi