Request Information

Create new Received Invoice.

Example URL:
v2.0/ReceivedInvoices

None.

Received invoice entity for creation

ReceivedInvoiceApiModelInsert
NameDescriptionTypeAdditional information
AccountNumber

string

Length: between 0 and 50 inclusive

BankId

integer

None.

BankNumberCode

string

Length: between 0 and 4 inclusive

CurrencyId

integer

None.

DateOfIssue

date

None.

DateOfMaturity

date

None.

DateOfPayment

date

None.

DateOfReceiving

date

None.

DateOfTaxing

date

None.

DateOfVatApplication

Date of VAT application

date

Used in Sk legislation.

Description

string

None.

DocumentNumber

string

Readonly

DocumentSerialNumber

integer

None.

ExchangeRate

decimal number

None.

ExchangeRateAmount

decimal number

None.

Iban

string

Length: between 0 and 50 inclusive

IsIncomeTax

Include subject to income tax

boolean

Used in Cz legislation.

Note

string

None.

OrderNumber

string

Length: between 0 and 20 inclusive

PaymentOptionId

integer

None.

ReceivedDocumentNumber

Document number of the original document

string

Length: between 0 and 30 inclusive

ReceivedInvoiceItems

Collection of ReceivedInvoiceItemApiModelInsert

Required

SupplierId

integer

Required

Swift

string

Length: between 0 and 11 inclusive

VariableSymbol

string

Length: between 0 and 10 inclusive

VatOnPayStatus

Attribute for application of VAT based on payments

VatOnPayStatus

Used in Sk legislation.

VatReverseChargeCodeId

Vat reverse charge code id

integer

Used in Cz legislation.

Sample:
{
  "AccountNumber": "sample string 1",
  "BankId": 2,
  "BankNumberCode": "sample string 3",
  "CurrencyId": 4,
  "DateOfIssue": "2024-10-06T06:11:46.7251718+00:00",
  "DateOfMaturity": "2024-10-06T06:11:46.7251718+00:00",
  "DateOfPayment": "2024-10-06T06:11:46.7251718+00:00",
  "DateOfReceiving": "2024-10-06T06:11:46.7251718+00:00",
  "DateOfTaxing": "2024-10-06T06:11:46.7251718+00:00",
  "Description": "sample string 5",
  "DocumentSerialNumber": 6,
  "DocumentNumber": "sample string 7",
  "ExchangeRate": 8.0,
  "ExchangeRateAmount": 9.0,
  "Iban": "sample string 10",
  "Note": "sample string 11",
  "OrderNumber": "sample string 12",
  "PaymentOptionId": 13,
  "ReceivedDocumentNumber": "sample string 14",
  "ReceivedInvoiceItems": [
    {
      "Amount": 1.0,
      "CustomVatRate": 1.0,
      "Name": "sample string 2",
      "PriceListItemId": 1,
      "PriceType": 0,
      "Unit": "sample string 3",
      "UnitPrice": 4.0,
      "VatCodeId": 1,
      "VatRateType": 0,
      "Id": 5
    }
  ],
  "SupplierId": 15,
  "Swift": "sample string 16",
  "VariableSymbol": "sample string 17",
  "VatOnPayStatus": 0,
  "DateOfVatApplication": "2024-10-06T06:11:46.7251718+00:00",
  "VatReverseChargeCodeId": 1,
  "IsIncomeTax": true
}
Sample:
<ReceivedInvoiceApiModelInsert xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Doklad.Api.ApiModels.ReceivedInvoice">
  <AccountNumber>sample string 1</AccountNumber>
  <BankId>2</BankId>
  <BankNumberCode>sample string 3</BankNumberCode>
  <CurrencyId>4</CurrencyId>
  <DateOfIssue>2024-10-06T06:11:46.7251718+00:00</DateOfIssue>
  <DateOfMaturity>2024-10-06T06:11:46.7251718+00:00</DateOfMaturity>
  <DateOfPayment>2024-10-06T06:11:46.7251718+00:00</DateOfPayment>
  <DateOfReceiving>2024-10-06T06:11:46.7251718+00:00</DateOfReceiving>
  <DateOfTaxing>2024-10-06T06:11:46.7251718+00:00</DateOfTaxing>
  <DateOfVatApplication>2024-10-06T06:11:46.7251718+00:00</DateOfVatApplication>
  <Description>sample string 5</Description>
  <DocumentNumber>sample string 7</DocumentNumber>
  <DocumentSerialNumber>6</DocumentSerialNumber>
  <ExchangeRate>8</ExchangeRate>
  <ExchangeRateAmount>9</ExchangeRateAmount>
  <Iban>sample string 10</Iban>
  <IsIncomeTax>true</IsIncomeTax>
  <Note>sample string 11</Note>
  <OrderNumber>sample string 12</OrderNumber>
  <PaymentOptionId>13</PaymentOptionId>
  <ReceivedDocumentNumber>sample string 14</ReceivedDocumentNumber>
  <ReceivedInvoiceItems>
    <ReceivedInvoiceItemApiModelInsert>
      <Id xmlns="http://schemas.datacontract.org/2004/07/Doklad.Api.ApiModels.BaseModels">5</Id>
      <Links xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns="http://schemas.datacontract.org/2004/07/Doklad.Api.ApiModels.BaseModels">
        <d4p1:KeyValueOfstringstring>
          <d4p1:Key>sample string 1</d4p1:Key>
          <d4p1:Value>sample string 2</d4p1:Value>
        </d4p1:KeyValueOfstringstring>
      </Links>
      <Amount>1</Amount>
      <CustomVatRate>1</CustomVatRate>
      <Name>sample string 2</Name>
      <PriceListItemId>1</PriceListItemId>
      <PriceType>0</PriceType>
      <Unit>sample string 3</Unit>
      <UnitPrice>4</UnitPrice>
      <VatCodeId>1</VatCodeId>
      <VatRateType>0</VatRateType>
    </ReceivedInvoiceItemApiModelInsert>
  </ReceivedInvoiceItems>
  <SupplierId>15</SupplierId>
  <Swift>sample string 16</Swift>
  <VariableSymbol>sample string 17</VariableSymbol>
  <VatOnPayStatus>0</VatOnPayStatus>
  <VatReverseChargeCodeId>1</VatReverseChargeCodeId>
</ReceivedInvoiceApiModelInsert>

Response Information

ReceivedInvoiceApiModel
NameDescriptionTypeAdditional information
AttachmentFileName

Name of the attached file. If no attachment is included, this will be empty.

string

None.

CurrencyId

integer

None.

DateCreated

date

None.

DateLastChange

date

None.

DateOfAccountingEvent

date

None.

DateOfIssue

date

None.

DateOfMaturity

date

None.

DateOfPayment

date

None.

DateOfReceiving

date

None.

DateOfTaxing

date

None.

DateOfVatApplication

Date of VAT application

date

Used in Sk legislation.

Description

string

None.

DocumentNumber

string

Length: between 0 and 10 inclusive

DocumentSerialNumber

integer

None.

ExchangeRate

decimal number

None.

ExchangeRateAmount

decimal number

None.

Exported

Export to another accounting software indication. (It is recommended to use only one external accounting software beside iDoklad.)

ExportedState

None.

Id

Resource identifier

integer

Readonly

IsIncomeTax

Include subject to income tax

boolean

Used in Cz legislation.

IsSentToAccountant

boolean

None.

Items

Collection of ReceivedInvoiceItemApiModel

None.

MyCompanyDocumentAddressId

integer

None.

Note

string

None.

OrderNumber

string

Length: between 0 and 20 inclusive

PaymentOptionId

integer

None.

PaymentStatus

PaymentStatus

None.

ReceivedDocumentNumber

Document number of the original document

string

Length: between 0 and 30 inclusive

RecountVersion

Recount Version

RecountVersion

None.

SupplierDocumentAddressId

integer

None.

SupplierId

integer

None.

TotalPaid

decimal number

None.

TotalPaidHc

decimal number

None.

TotalVat

decimal number

None.

TotalVatHc

decimal number

None.

TotalWithoutVat

decimal number

None.

TotalWithoutVatHc

decimal number

None.

TotalWithVat

decimal number

None.

TotalWithVatHc

decimal number

None.

VariableSymbol

string

Length: between 0 and 10 inclusive

VatOnPayStatus

Attribute for application of VAT based on payments

VatOnPayStatus

Used in Sk legislation.

VatRegime

VAT regime

VatRegime

None.

VatReverseChargeCodeId

Vat reverse charge code id

integer

Used in Cz legislation.

Sample:
{
  "AttachmentFileName": "sample string 1",
  "CurrencyId": 2,
  "DateCreated": "2024-10-06T06:11:46.7251718+00:00",
  "DateLastChange": "2024-10-06T06:11:46.7251718+00:00",
  "DateOfAccountingEvent": "2024-10-06T06:11:46.7251718+00:00",
  "DateOfIssue": "2024-10-06T06:11:46.7251718+00:00",
  "DateOfMaturity": "2024-10-06T06:11:46.7251718+00:00",
  "DateOfPayment": "2024-10-06T06:11:46.7251718+00:00",
  "DateOfReceiving": "2024-10-06T06:11:46.7251718+00:00",
  "DateOfTaxing": "2024-10-06T06:11:46.7251718+00:00",
  "DateOfVatApplication": "2024-10-06T06:11:46.7251718+00:00",
  "Description": "sample string 12",
  "DocumentNumber": "sample string 13",
  "DocumentSerialNumber": 14,
  "ExchangeRate": 15.0,
  "ExchangeRateAmount": 16.0,
  "Exported": 0,
  "IsSentToAccountant": true,
  "Items": [
    {
      "DateCreated": "2024-10-06T06:11:46.7251718+00:00",
      "DateLastChange": "2024-10-06T06:11:46.7251718+00:00",
      "IsCustomVat": true,
      "ItemType": 0,
      "Price": 4.0,
      "PriceTotalWithoutVat": 5.0,
      "PriceTotalWithoutVatHc": 6.0,
      "PriceTotalWithVat": 7.0,
      "PriceTotalWithVatHc": 8.0,
      "PriceUnitHc": 9.0,
      "VatRate": 10.0,
      "VatTotal": 11.0,
      "VatTotalHc": 12.0,
      "Amount": 1.0,
      "CustomVatRate": 1.0,
      "Name": "sample string 13",
      "PriceListItemId": 1,
      "PriceType": 0,
      "Unit": "sample string 14",
      "UnitPrice": 1.0,
      "VatCodeId": 1,
      "VatRateType": 0,
      "Id": 15
    }
  ],
  "MyCompanyDocumentAddressId": 18,
  "Note": "sample string 19",
  "OrderNumber": "sample string 20",
  "PaymentOptionId": 1,
  "PaymentStatus": 0,
  "ReceivedDocumentNumber": "sample string 21",
  "SupplierDocumentAddressId": 22,
  "SupplierId": 23,
  "TotalPaid": 24.0,
  "TotalPaidHc": 25.0,
  "TotalVat": 26.0,
  "TotalVatHc": 27.0,
  "TotalWithoutVat": 28.0,
  "TotalWithoutVatHc": 29.0,
  "TotalWithVat": 30.0,
  "TotalWithVatHc": 31.0,
  "VariableSymbol": "sample string 32",
  "VatOnPayStatus": 0,
  "VatReverseChargeCodeId": 1,
  "IsIncomeTax": true,
  "RecountVersion": 0,
  "VatRegime": 0,
  "Id": 34
}
Sample:
<ReceivedInvoiceApiModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Doklad.Api.ApiModels.ReceivedInvoice">
  <Id xmlns="http://schemas.datacontract.org/2004/07/Doklad.Api.ApiModels.BaseModels">34</Id>
  <Links xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns="http://schemas.datacontract.org/2004/07/Doklad.Api.ApiModels.BaseModels">
    <d2p1:KeyValueOfstringstring>
      <d2p1:Key>sample string 1</d2p1:Key>
      <d2p1:Value>sample string 2</d2p1:Value>
    </d2p1:KeyValueOfstringstring>
  </Links>
  <AttachmentFileName>sample string 1</AttachmentFileName>
  <CurrencyId>2</CurrencyId>
  <DateCreated>2024-10-06T06:11:46.7251718+00:00</DateCreated>
  <DateLastChange>2024-10-06T06:11:46.7251718+00:00</DateLastChange>
  <DateOfAccountingEvent>2024-10-06T06:11:46.7251718+00:00</DateOfAccountingEvent>
  <DateOfIssue>2024-10-06T06:11:46.7251718+00:00</DateOfIssue>
  <DateOfMaturity>2024-10-06T06:11:46.7251718+00:00</DateOfMaturity>
  <DateOfPayment>2024-10-06T06:11:46.7251718+00:00</DateOfPayment>
  <DateOfReceiving>2024-10-06T06:11:46.7251718+00:00</DateOfReceiving>
  <DateOfTaxing>2024-10-06T06:11:46.7251718+00:00</DateOfTaxing>
  <DateOfVatApplication>2024-10-06T06:11:46.7251718+00:00</DateOfVatApplication>
  <Description>sample string 12</Description>
  <DocumentNumber>sample string 13</DocumentNumber>
  <DocumentSerialNumber>14</DocumentSerialNumber>
  <ExchangeRate>15</ExchangeRate>
  <ExchangeRateAmount>16</ExchangeRateAmount>
  <Exported>0</Exported>
  <IsIncomeTax>true</IsIncomeTax>
  <IsSentToAccountant>true</IsSentToAccountant>
  <Items>
    <ReceivedInvoiceItemApiModel>
      <Id xmlns="http://schemas.datacontract.org/2004/07/Doklad.Api.ApiModels.BaseModels">15</Id>
      <Links xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns="http://schemas.datacontract.org/2004/07/Doklad.Api.ApiModels.BaseModels">
        <d4p1:KeyValueOfstringstring>
          <d4p1:Key>sample string 1</d4p1:Key>
          <d4p1:Value>sample string 2</d4p1:Value>
        </d4p1:KeyValueOfstringstring>
      </Links>
      <Amount>1</Amount>
      <CustomVatRate>1</CustomVatRate>
      <Name>sample string 13</Name>
      <PriceListItemId>1</PriceListItemId>
      <PriceType>0</PriceType>
      <Unit>sample string 14</Unit>
      <UnitPrice>1</UnitPrice>
      <VatCodeId>1</VatCodeId>
      <VatRateType>0</VatRateType>
      <DateCreated>2024-10-06T06:11:46.7251718+00:00</DateCreated>
      <DateLastChange>2024-10-06T06:11:46.7251718+00:00</DateLastChange>
      <IsCustomVat>true</IsCustomVat>
      <ItemType>0</ItemType>
      <Price>4</Price>
      <PriceTotalWithVat>7</PriceTotalWithVat>
      <PriceTotalWithVatHc>8</PriceTotalWithVatHc>
      <PriceTotalWithoutVat>5</PriceTotalWithoutVat>
      <PriceTotalWithoutVatHc>6</PriceTotalWithoutVatHc>
      <PriceUnitHc>9</PriceUnitHc>
      <VatRate>10</VatRate>
      <VatTotal>11</VatTotal>
      <VatTotalHc>12</VatTotalHc>
    </ReceivedInvoiceItemApiModel>
  </Items>
  <MyCompanyDocumentAddressId>18</MyCompanyDocumentAddressId>
  <Note>sample string 19</Note>
  <OrderNumber>sample string 20</OrderNumber>
  <PaymentOptionId>1</PaymentOptionId>
  <PaymentStatus>0</PaymentStatus>
  <ReceivedDocumentNumber>sample string 21</ReceivedDocumentNumber>
  <RecountVersion>None</RecountVersion>
  <SupplierDocumentAddressId>22</SupplierDocumentAddressId>
  <SupplierId>23</SupplierId>
  <TotalPaid>24</TotalPaid>
  <TotalPaidHc>25</TotalPaidHc>
  <TotalVat>26</TotalVat>
  <TotalVatHc>27</TotalVatHc>
  <TotalWithVat>30</TotalWithVat>
  <TotalWithVatHc>31</TotalWithVatHc>
  <TotalWithoutVat>28</TotalWithoutVat>
  <TotalWithoutVatHc>29</TotalWithoutVatHc>
  <VariableSymbol>sample string 32</VariableSymbol>
  <VatOnPayStatus>0</VatOnPayStatus>
  <VatRegime>NonVatRegime</VatRegime>
  <VatReverseChargeCodeId>1</VatReverseChargeCodeId>
</ReceivedInvoiceApiModel>