UctoGo — Účetní Asistent

Create a reusable invoice line-item template (e.g., "IT consulting 1000 CZK/hour").

{
  "type": "object",
  "required": [
    "company_id",
    "name",
    "description",
    "unit_price"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "unit": {
      "type": "string",
      "default": "hod"
    },
    "vat_rate": {
      "type": "number",
      "default": 0
    },
    "company_id": {
      "type": "string"
    },
    "unit_price": {
      "type": "number"
    },
    "description": {
      "type": "string"
    },
    "default_quantity": {
      "type": "number",
      "default": 1
    }
  }
}

Exportuje všechny vydané faktury (sent/paid/overdue) daného roku do českého účetního XML přes uctogo.cz bridge. ISDOC 6.0.2 je importovatelný Pohodou, Money S3, Abra Flexi, Helios, Premier. save_to uloží na disk; jinak vrátí XML inline (cap 200 KB).

{
  "type": "object",
  "required": [
    "company_id"
  ],
  "properties": {
    "year": {
      "type": "string",
      "description": "Rok exportu (YYYY), default aktuální rok"
    },
    "format": {
      "enum": [
        "isdoc",
        "pohoda"
      ],
      "type": "string",
      "description": "Cílový formát, default isdoc"
    },
    "save_to": {
      "type": "string",
      "description": "Absolutní cesta k uložení XML (doporučeno pro velké exporty)"
    },
    "company_id": {
      "type": "string",
      "description": "ID firmy, jejíž vystavené faktury se exportují"
    }
  }
}

Regenerate the PDF for an existing invoice.

{
  "type": "object",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "invoice_id": {
      "type": "string"
    }
  }
}

Get current cash register balance for a company (or all companies).

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string"
    }
  }
}

Get accounting dashboard: balances, unpaid invoices, recent activity, overdue items.

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string"
    }
  }
}

Retrieve a single invoice by ID or invoice number.

{
  "type": "object",
  "properties": {
    "invoice_id": {
      "type": "string"
    },
    "invoice_number": {
      "type": "string"
    }
  }
}

Import bank transactions from Fio Banka API for the given date range.

{
  "type": "object",
  "required": [
    "company_id"
  ],
  "properties": {
    "date_to": {
      "type": "string"
    },
    "date_from": {
      "type": "string"
    },
    "company_id": {
      "type": "string"
    }
  }
}

Vystaví opravný účetní doklad (dobropis) k existující faktuře. Automaticky naklonuje položky originálu s negativními cenami (nebo přijme vlastní items), cross-linkne obě faktury v internal_notes, vygeneruje PDF a vrátí číslo dobropisu. S mark_paid=true rovnou označí jako uhrazený (po vrácení peněz na účet).

{
  "type": "object",
  "required": [
    "reason"
  ],
  "properties": {
    "items": {
      "type": "array",
      "description": "Položky dobropisu (volitelné; když chybí, zkopíruje všechny položky originálu). unit_price zadávej POZITIVNĚ, tool sám otočí znaménka."
    },
    "reason": {
      "type": "string",
      "description": "Důvod dobropisu — tiskne se na dokladu i uloží do internal_notes"
    },
    "mark_paid": {
      "type": "boolean",
      "description": "Po vrácení peněz rovnou paid. Default false."
    },
    "issue_date": {
      "type": "string",
      "description": "Datum vystavení (YYYY-MM-DD), default dnes"
    },
    "original_invoice_id": {
      "type": "string",
      "description": "ID původní faktury"
    },
    "original_invoice_number": {
      "type": "string",
      "description": "Alternativně: číslo faktury (např. FV2026005)"
    }
  }
}

List cash register transactions (income or expense).

{
  "type": "object",
  "properties": {
    "type": {
      "enum": [
        "income",
        "expense"
      ],
      "type": "string"
    },
    "limit": {
      "type": "number",
      "default": 50
    },
    "company_id": {
      "type": "string"
    }
  }
}

List all companies in the account (holding structure).

{
  "type": "object",
  "properties": {}
}

List customers with optional name search.

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string"
    },
    "company_id": {
      "type": "string"
    }
  }
}

List invoices with filters (company, status, customer, date range).

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "default": 50
    },
    "status": {
      "enum": [
        "draft",
        "sent",
        "paid",
        "cancelled"
      ],
      "type": "string"
    },
    "date_to": {
      "type": "string"
    },
    "date_from": {
      "type": "string"
    },
    "company_id": {
      "type": "string"
    },
    "customer_id": {
      "type": "string"
    }
  }
}

List supplier (received) invoices with status filter.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "default": 50
    },
    "status": {
      "enum": [
        "pending",
        "approved",
        "paid",
        "rejected"
      ],
      "type": "string"
    },
    "company_id": {
      "type": "string"
    }
  }
}

List reusable invoice line-item templates.

{
  "type": "object",
  "properties": {
    "company_id": {
      "type": "string"
    }
  }
}

List bank transactions with filters (company, date range, matched status).

{
  "type": "object",
  "properties": {
    "date_to": {
      "type": "string"
    },
    "date_from": {
      "type": "string"
    },
    "company_id": {
      "type": "string"
    },
    "unmatched_only": {
      "type": "boolean"
    }
  }
}

Look up Czech company data from ARES registry by ICO.

{
  "type": "object",
  "required": [
    "ico"
  ],
  "properties": {
    "ico": {
      "type": "string",
      "description": "Czech company ICO (8 digits)"
    }
  }
}

Auto-match bank transactions to unpaid invoices by variable symbol (VS).

{
  "type": "object",
  "required": [
    "company_id"
  ],
  "properties": {
    "company_id": {
      "type": "string"
    }
  }
}

Send an invoice via email (PDF attached). Uses customer email unless overridden.

{
  "type": "object",
  "required": [
    "invoice_id"
  ],
  "properties": {
    "to_email": {
      "type": "string"
    },
    "invoice_id": {
      "type": "string"
    }
  }
}

Update invoice status (sent, paid, cancelled) with optional paid date.

{
  "type": "object",
  "required": [
    "invoice_id",
    "status"
  ],
  "properties": {
    "status": {
      "enum": [
        "sent",
        "paid",
        "cancelled"
      ],
      "type": "string"
    },
    "paid_date": {
      "type": "string"
    },
    "invoice_id": {
      "type": "string"
    }
  }
}

Update status of a received invoice (approved, paid, rejected).

{
  "type": "object",
  "required": [
    "id",
    "status"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "status": {
      "enum": [
        "approved",
        "paid",
        "rejected"
      ],
      "type": "string"
    },
    "paid_date": {
      "type": "string"
    }
  }
}

Register a received supplier invoice (optionally attach PDF).

{
  "type": "object",
  "required": [
    "company_id",
    "supplier_name",
    "total"
  ],
  "properties": {
    "notes": {
      "type": "string"
    },
    "total": {
      "type": "number"
    },
    "category": {
      "enum": [
        "material",
        "services",
        "rent",
        "software",
        "other"
      ],
      "type": "string"
    },
    "due_date": {
      "type": "string"
    },
    "file_path": {
      "type": "string"
    },
    "company_id": {
      "type": "string"
    },
    "issue_date": {
      "type": "string"
    },
    "vat_amount": {
      "type": "number"
    },
    "supplier_dic": {
      "type": "string"
    },
    "supplier_ico": {
      "type": "string"
    },
    "supplier_name": {
      "type": "string"
    },
    "invoice_number": {
      "type": "string"
    },
    "variable_symbol": {
      "type": "string"
    }
  }
}