# Ucrania
> Documentos ucranianos: рахунок, акт y податкова накладна por tipo, ЄДРПОУ, РНОКПП e ІПН con sus dígitos de control, ПДВ, fechas y UAH.
>
> Antes: [El documento](https://ocost.io/docs/es/document.md)

Lo que Ocost lee en un documento ucraniano y dónde lo escribe en [`ocost.document.v1`](https://ocost.io/docs/es/document.md). No hace falta ninguna plantilla. Los documentos en ruso se leen igual.

## Documentos

| Impreso como | `kind` | `kind_detail` |
| --- | --- | --- |
| рахунок, рахунок на оплату, рахунок-фактура | `invoice` | `invoice` |
| акт виконаних робіт, акт наданих послуг, акт приймання-передачі | `other` | `acceptance_protocol` |
| видаткова накладна, товарна накладна | `delivery_note` | `delivery_note` |
| податкова накладна | `tax_invoice` | `tax_invoice` |
| квитанція | `receipt` | `receipt` |
| договір | `contract` | `contract` |

Un акт lleva precios como una factura: importes, IVA, líneas, el periodo del servicio y el contrato en `contract_reference`. Prueba que el trabajo se hizo. El рахунок es lo que pagas, así que Ocost nunca contabiliza el акт como una segunda factura.

Una податкова накладна es la prueba de IVA del vendedor y nunca se paga. `tax_registration` contiene su número y su fecha en el ЄРПН, donde estén impresos. `preceding_invoice` nombra el рахунок o el акт al que corresponde.

Una видаткова накладна lleva precios, IVA y totales donde estén impresos. Ocost los comprueba como las sumas de una factura. Una товарно-транспортна накладна aún no tiene regla propia.

## Identificadores

Ocost escribe cada número en los `identifiers` de la parte según su `scheme`:

| Impreso como | `scheme` | `valid` |
| --- | --- | --- |
| код ЄДРПОУ | `UA_EDRPOU` | 8 dígitos y su dígito de control |
| РНОКПП, de una persona o de un ФОП | `UA_RNOKPP` | 10 dígitos y su dígito de control |
| ІПН платника ПДВ | `UA_IPN` | 12 dígitos. No hay dígito de control, así que una longitud correcta da `null`. |

Un número que falla se guarda con `valid: false`, y la comprobación `identifier` falla con `at` igual a su esquema. Ocost nunca encuentra una empresa por él. `tax_registration_id` puede repetir uno de estos números, así que lee `identifiers`.

Un IBAN que empieza por `UA` se comprueba por sus dígitos de control, en `iban`.

## IVA

Ocost lee los tipos de ПДВ que imprime un documento, como 20 %, 14 %, 7 % o 0 %. Cada tipo es un grupo de `vat_breakdown`. La comprobación `vat` se cumple cuando el IVA de un grupo es su neto por su tipo.

Un vendedor que no paga IVA imprime "Без ПДВ". Ocost no lee entonces ningún IVA, y la comprobación `gross` compara el neto con el bruto.

`tax_check` se rellena para tu empresa ucraniana cuando el registro de Ucrania dice que el proveedor no es contribuyente de ПДВ, pero la factura o el recibo lo cobra. `missing` contiene entonces `vat_non_payer` con `law` п. 198.6 ст. 198 ПКУ: ese ПДВ no da crédito fiscal. `at_stake` es `true` cuando tu empresa deduce el IVA soportado. Si no, `tax_check` es `null`. Ocost no comprueba ninguna otra regla de facturación ucraniana, pero comprueba las sumas, las líneas, las fechas, el IBAN y los identificadores.

## Facturas electrónicas

Ocost aún no lee ningún formato XML ucraniano. Envía el PDF o un escaneo, y `read_with` es `reader`.

## Fechas, importes e idioma

Los documentos ucranianos imprimen `03.11.2026` y `1 200,00`. Ocost escribe `2026-11-03` y `1200`. `sources` guarda la cita tal como está impresa.

`currency` es `UAH` donde el documento imprime `UAH`, `₴` o `грн`. Donde no imprime ninguna moneda, Ocost toma la habitual del proveedor, o si no la de tu empresa.

Las unidades pasan a códigos UNECE: шт. es `C62`, кг `KGM`, год. `HUR`, послуга `E48`. [Unidades y códigos](https://ocost.io/docs/es/units.md) los lista. Los nombres y las líneas se quedan en las palabras del documento.

## Tu empresa

Ocost distingue lo entrante de lo saliente por tus datos en [Ajustes › Empresa](https://app.ocost.io/settings/company). Una empresa ucraniana necesita su ЄДРПОУ, un ФОП su РНОКПП, y su dirección. Añade el ІПН solo cuando seas contribuyente del IVA.

Ocost rellena un ЄДРПОУ, un ІПН o una dirección vacíos a partir de tus documentos y los del grupo, donde un identificador exacto te nombra. Nunca sobrescribe un valor.

El correo a `belege@<name>.ocost.io` llega a Ocost. El nombre es el tuyo sin ТОВ ni ФОП, en letras latinas según la transliteración oficial de Ucrania (КМУ № 55, 2010): ТОВ «Охорона-Київ» da `okhorona-kyiv`.

## Ejemplo

Un extracto de 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"
}
```

## Véase también

- [El documento](https://ocost.io/docs/es/document.md): El esquema ocost.document.v1 en términos de EN 16931 (se corresponde con UBL y CII): un ejemplo, tipo y dirección, fuentes, comprobaciones, versiones, y cada campo y valor.
- [Unidades y códigos](https://ocost.io/docs/es/units.md): Las listas de códigos del documento: unidades UNECE con sus palabras impresas, monedas y países ISO, categorías de IVA, medios de pago, tipos de documento, identificadores, ECLASS.
- [Grupos de empresas](https://ocost.io/docs/es/groups.md): Grupos de empresas: a qué sociedades llega una clave, la cabecera Ocost-Business, el enrutado por los identificadores del documento, needs_company y los archivos del grupo.
- En ocost.io: [Invoice processing](https://ocost.io/en/product/invoice-processing)
