Přeskočit na hlavní obsah

InvoiceReceivedParams

Tělo požadavku pro vytvoření nebo editaci faktury přijaté.

Není to tvar detailu. Odpověď z GET /invoice_received/{id} nejde poslat zpět na PUT beze změny — vnořené objekty se při zápisu posílají jako ID a dopočtené částky se neposílají vůbec:

PoleGET (odpověď)POST / PUT (požadavek)
dodavatelsupplier — objektsupplier_id — ID
bankovní účetbank_account — objektbank_account — ID
zálohové fakturyproforma_invoice — pole objektůproforma_invoice — pole ID
price, price_czk, price_inc_vat, price_inc_vat_czk, to_be_paiddopočítanéneposílají se

Pole jen pro čtení (id, deleted, accounted a dopočtené částky) server ignoruje.

Chování společné všem dokladům popisuje průvodce doklady: neplátci DPH a zaúčtování položek.

sequence_codestringmax. délka 45

Číslo dokladu. Když se nevyplní, přidělí ho číselná řada nastavená ve firmě.

např. FP20190001
external_codestringmax. délka 45

Číslo dokladu u dodavatele.

např. 20190001
variable_symbolstringmax. délka 10

Variabilní symbol.

např. 20190001
datestring<date>povinné

Datum vystavení.

např. 2019-07-12
date_vatstring<date>

Datum zdanitelného plnění. U neplátce DPH se nevyplňuje.

např. 2019-07-12
maturity_datestring<date>povinné

Datum splatnosti.

např. 2019-08-12
currencyCurrencyCodepovinné

Měna dokladu.

např. CZK
order_idinteger

ID objednávky vydané, ze které faktura vznikla.

payment_typePaymentTypepovinnétransfercashcashondeliveryreciprocitycreditcard

Způsob úhrady dokladu. Popisy hodnot vrací Metody plateb.

Pro transfer a creditcard je na dokladu povinný bank_account, pro cash, cashondelivery a reciprocity může být null.

date_vat_prevstring<date>

Datum předchozí sazby DPH. Vyplňuje se u dokladů, které spadají do období se změnou sazby.

např. 2019-05-05
descriptionstring

Poznámka na dokladu.

např. Popis
rounding_typeRoundingTypenoneroundupdown

Způsob zaokrouhlení. Když se nevyplní, použije se nastavení firmy.

items object[]povinné

Položky dokladu. Doklad musí mít alespoň jednu.

  • Array [
  • textstringpovinnémax. délka 255

    Popis položky.

    např. Položka A
    amountnumberpovinné

    Počet jednotek.

    např. 1
    pricenumber<double>povinné

    Cena za jednotku.

    např. 50
    unit_price_inc_vatboolean

    Cena za jednotku je uvedená včetně DPH.

    unitstringmax. délka 10

    Jednotka.

    např. ks
    vatnumberpovinné

    Sazba DPH v procentech. Platné sazby vrací Sazby DPH.

    např. 21
    vat_totalnumber<double>

    DPH celkem za položku.

    např. 0
    department_idinteger
    contract_idinteger
    accountentrytype_idinteger | nullmůže být null

    ID typu účetní položky. Přepisuje chart_account_id.

    vattype_idinteger | nullmůže být null

    ID typu DPH. Přepisuje vat_chart_id.

    chart_account_idinteger | nullmůže být null
    vat_chart_idinteger | nullmůže být null
  • ]
  • supplier_idintegerpovinné
    proforma_invoiceinteger[]

    ID zálohových faktur přijatých, které se mají z faktury odečíst (od verze API 1.2).

    bank_accountinteger | nullmůže být null

    ID bankovního účtu, ze kterého se má platit.

    Povinný pro payment_type transfer a creditcard; pro cash, cashondelivery a reciprocity může být null.

    InvoiceReceivedParams
    {
    "sequence_code": "FP20190001",
    "external_code": "20190001",
    "variable_symbol": "20190001",
    "date": "2019-07-12",
    "date_vat": "2019-07-12",
    "maturity_date": "2019-08-12",
    "currency": "CZK",
    "order_id": 12343,
    "payment_type": "transfer",
    "date_vat_prev": "2019-05-05",
    "description": "Popis",
    "rounding_type": "round",
    "items": [
    {
    "text": "Položka A",
    "amount": 1,
    "price": 50,
    "unit_price_inc_vat": false,
    "unit": "ks",
    "vat": 21,
    "vat_total": 0,
    "department_id": 1,
    "contract_id": 1,
    "accountentrytype_id": 532,
    "vattype_id": 1,
    "chart_account_id": 46,
    "vat_chart_id": 52
    }
    ],
    "supplier_id": 785,
    "proforma_invoice": [
    123456
    ],
    "bank_account": 456
    }