Ucrania

Lo que Ocost lee en un documento ucraniano y dónde lo escribe en ocost.document.v1. No hace falta ninguna plantilla. Los documentos en ruso se leen igual.

Lo que Ocost lee en Alemania y en Ucrania
AlemaniaUcrania
DocumentosRechnung, Gutschrift, Lieferschein, Auftragsbestätigungрахунок, акт, видаткова накладна, податкова накладна
IdentificadoresUSt-IdNr., Steuernummer, HRBЄДРПОУ, РНОКПП, ІПН
Tipos de IVA19 %, 7 %20 %, 14 %, 7 %, 0 %
Facturas electrónicasXRechnung, ZUGFeRD, Factur-X, sin modeloAún sin formato XML: envía el PDF o un escaneo
Exportación para el contableDATEV1С / BAS

Documentos

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

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 comoschemevalid
код ЄДРПОУUA_EDRPOU8 dígitos y su dígito de control
РНОКПП, de una persona o de un ФОПUA_RNOKPP10 dígitos y su dígito de control
ІПН платника ПДВUA_IPN12 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 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. 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