# Ukraine
> Les documents ukrainiens : рахунок, акт et податкова накладна par type, ЄДРПОУ, РНОКПП et ІПН avec leurs chiffres de contrôle, ПДВ, dates et UAH.
>
> Avant: [Le document](https://ocost.io/docs/fr/document.md)

Ce qu'Ocost lit sur un document ukrainien et où il l'écrit dans [`ocost.document.v1`](https://ocost.io/docs/fr/document.md). Aucun modèle de document n'est nécessaire. Les documents en russe sont lus de la même façon.

## 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](https://ocost.io/docs/fr/units.md) 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](https://app.ocost.io/settings/company). 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

- [Le document](https://ocost.io/docs/fr/document.md): Le schéma ocost.document.v1 dans les termes de l'EN 16931 (transposable en UBL et CII) : un exemple, type et sens, sources, contrôles, versions, et chaque champ et chaque valeur.
- [Unités et codes](https://ocost.io/docs/fr/units.md): Les listes de codes du document : unités UNECE avec leurs mots imprimés, devises et pays ISO, catégories de TVA, moyens de paiement, types de documents, identifiants, ECLASS.
- [Groupes de sociétés](https://ocost.io/docs/fr/groups.md): Groupes de sociétés : les sociétés qu’une clé atteint, l’en-tête Ocost-Business, l’orientation par les identifiants du document, needs_company et les fichiers du groupe.
- Sur ocost.io: [Invoice processing](https://ocost.io/en/product/invoice-processing)
