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.
| Alemania | Ucrania | |
|---|---|---|
| Documentos | Rechnung, Gutschrift, Lieferschein, Auftragsbestätigung | рахунок, акт, видаткова накладна, податкова накладна |
| Identificadores | USt-IdNr., Steuernummer, HRB | ЄДРПОУ, РНОКПП, ІПН |
| Tipos de IVA | 19 %, 7 % | 20 %, 14 %, 7 %, 0 % |
| Facturas electrónicas | XRechnung, ZUGFeRD, Factur-X, sin modelo | Aún sin formato XML: envía el PDF o un escaneo |
| Exportación para el contable | DATEV | 1С / BAS |
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 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 акт наданих послуг:
{
"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"
}