Book manuel voucher

Books a manuel voucher

Query parameters

NameDescription
guid globally unique identifier

Guid of the voucher to book

Required

organizationId string

Request model

Data used for the booking transaction
NameDescription
Number integer

Optional. If specified, the voucher will be created with this number. If the number is already taken the booking of the voucher will fail.

Timestamp string

Timestamp to validate against. This is a safety measure to ensure that an API partner is only making changes to the latest version of the entity. The timestamp is generated on Dinero's server every time the entity is updated, and is returned as a part of CreatedResponse and UpdatedResponse. It's also available on the entity itself. If you get a timestamp outdated exception (error code 58), you will need to get the latest version of the enity and use its timestamp.

Returns

NameDescription
VoucherNumber integer

The vouchers number

VoucherDate string

Date of the voucher

TotalInclVat decimal number

Total amount of money in the voucher, including vat

TotalExclVat decimal number

Total amount of money in the voucher, excluding vat

FileGuid string

Guid of the file associated with the voucher

Guid globally unique identifier

Guid of the voucher

Status string

Voucher status: Draft, Editing or Booked

Lines ManuelVoucherLineReadModel[] Show model
NameDescription
Description string

Description of the line

AmountExclVatValue decimal number

Amount on the line excluding VAT

AmountInclVatValue decimal number

Amount on the line including VAT

VatAmountValue decimal number

Amount in VAT on the line

AccountNumber integer

The account number the line books on

BalancingAccountNumber integer

The account number the line balances on

AccountVatCode string

Vat code for the selected account number. The value should be an existing VAT code e.g. I25, UVC, KUNS etc. The account VAT type can be suppressed by providing the value "none". If set to NULL it defaults to the accounts default vat code, if the account has any.

BalancingAccountVatCode string

Vat code for the selected balancing account number. The value should be an existing VAT code e.g. I25, UVC, KUNS etc. The balancing account VAT type can be suppressed by providing the value "none". If set to NULL it defaults to the accounts default vat code, if the account has any.

List of the lines on the voucher

Timestamp string

Timestamp used to validate version in case of updating

ExternalReference string

Your external id This can be used for ID'ing in external apps/services e.g. a web shop. The maximum length is 128 characters

v1/{organizationId}/vouchers/manuel/{guid}/book

Requests Formats

{
  "Number": null,
  "Timestamp": "00000000020A5EA8"
}

Response Formats

{
  "VoucherNumber": null,
  "VoucherDate": "2018-09-02",
  "TotalInclVat": 100.0,
  "TotalExclVat": 80.0,
  "FileGuid": "687f0b3b-7de5-4a4c-b2bd-7b4b761bbf60s",
  "Guid": "00000000-0000-0000-0000-000000000000",
  "Status": "Draft",
  "Lines": [
    {
      "Description": "Sale of things",
      "AmountExclVatValue": 80.0,
      "AmountInclVatValue": 100.0,
      "VatAmountValue": 20.0,
      "AccountNumber": 55000,
      "BalancingAccountNumber": 1000,
      "AccountVatCode": "I25",
      "BalancingAccountVatCode": "I25"
    },
    {
      "Description": "Sale of things",
      "AmountExclVatValue": 80.0,
      "AmountInclVatValue": 100.0,
      "VatAmountValue": 20.0,
      "AccountNumber": 55000,
      "BalancingAccountNumber": 1000,
      "AccountVatCode": "I25",
      "BalancingAccountVatCode": "I25"
    }
  ],
  "Timestamp": "00000000000017B7",
  "ExternalReference": "e.g. WebShopID:42"
}