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.
| Allemagne | Ukraine | |
|---|---|---|
| Documents | Rechnung, Gutschrift, Lieferschein, Auftragsbestätigung | рахунок, акт, видаткова накладна, податкова накладна |
| Identifiants | USt-IdNr., Steuernummer, HRB | ЄДРПОУ, РНОКПП, ІПН |
| Taux de TVA | 19 %, 7 % | 20 %, 14 %, 7 %, 0 % |
| Factures électroniques | XRechnung, ZUGFeRD, Factur-X, sans modèle | Pas encore de format XML : envoyez le PDF ou un scan |
| Export pour le comptable | DATEV | 1С / BAS |
Documents
| Imprimé comme | kind | kind_detail |
|---|---|---|
| рахунок, рахунок на оплату, рахунок-фактура | invoice | invoice |
| акт виконаних робіт, акт наданих послуг, акт приймання-передачі | other | acceptance_protocol |
| видаткова накладна, товарна накладна | delivery_note | delivery_note |
| податкова накладна | tax_invoice | tax_invoice |
| квитанція | receipt | receipt |
| договір | contract | contract |
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é comme | scheme | valid |
|---|---|---|
| код ЄДРПОУ | UA_EDRPOU | 8 chiffres et son chiffre de contrôle |
| РНОКПП, d'une personne ou d'un ФОП | UA_RNOKPP | 10 chiffres et son chiffre de contrôle |
| ІПН платника ПДВ | UA_IPN | 12 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 акт наданих послуг :
{
"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"
}