Skip to content

Credit note

codestringrequired

variant code (product) (can be null)

Example:"00000008"
isValidbooleanrequired

is the credit note valid?

Example:true
invoiceCodestring or nullrequired

invoice number (can be null). Caution! This does not have to be just a number, it can also contain letters, a dash, etc.

Example:"2017200011"
orderCodestring or nullrequired

purchase order number (can be null). Caution! This does not have to be just a number, it can also contain letters, a dash, etc.

Example:"2017000017"
proofPaymentCodestring or nullrequired

proof payment code (can be null). Caution! This does not have to be just a number, it can also contain letters, a dash, etc.

Example:"P--2017200011-1"
creationTimestring or null(typeDateTimeNullable)^[0-9]{4}-[01][0-9]-[0123][0-9]T[012][0-9]:[0...required

date of issue, in ISO 8601 format

Example:"2018-05-29T09:02:27+0200"
changeTimestring or null(typeDateTimeNullable)^[0-9]{4}-[01][0-9]-[0123][0-9]T[012][0-9]:[0...required

date of change, in ISO 8601 format

Example:"2018-05-29T09:02:27+0200"
dueDatestring or null, (date)(typeDateNullable)^[0-9]{4}-[0-9]{2}-[0-9]{2}$required

due date in ISO 8601 format (can be null)

Example:"2017-04-04"
taxDatestring or null, (date)(typeDateNullable)^[0-9]{4}-[0-9]{2}-[0-9]{2}$required

taxation date in ISO 8601 format (can be null)

Example:"2017-04-04"
varSymbolinteger, [ 0 .. 9999999999 ](typeVarSymbol)required

variable symbol

Example:2021000021
constSymbolinteger or nullrequired

constant symbol (can be null)

Example:6583
specSymbolinteger or null, [ 0 .. 9999999999 ](typeSpecSymbolNullable)required

specific symbol (can be null)

Example:201323134
restockedboolean

Items in credit note were restocked?

Example:true
stockAmountChangeTypestring or nullrequired

type of change in stock quantity (can be null)

Example:"load"
weightstring or null(typeWeightUnlimited)^[0-9]+\.[0-9]{3}$required

weight in kg, unpacked, 3 decimal places. Maximum value 999999.

Example:"1.234"
completePackageWeightstring or null(typeWeightUnlimited)^[0-9]+\.[0-9]{3}$required

weight in kg, unpacked, 3 decimal places. Maximum value 999999.

Example:"1.234"
billingMethodbillingMethod (object) or nullrequired
One of:

information about the method of payment

billingAddressobject(billingAddress)required

invoicing address

deliveryAddressobject or null(address)required

delivery address (can be null)

addressesEqualbooleanrequired

Are delivery and invoicing address the same?

Example:true
priceobject(price)required
customerobject(documentCustomer)required
eshopobject(eshop)required
itemsArray of objects(documentItemsWithPrice)required
documentRemarkstring or nullrequired

remark on the document (can be null)

Example:"This is a remark"
vatPayerbooleanrequired

is the tradesman a VAT payer? (can be null)

Example:true
vatModestring or null

VAT mode, can be null, possible values: Normal, One Stop Shop, Mini One Stop Shop, Reverse charge, Outside the EU

Example:"Normal"
reasonRemarkstring or null

Reason for credit note; default reason can be applied if not send.

Example:"Order cancellation"
{ "code": "00000008", "isValid": true, "invoiceCode": "2017200011", "orderCode": "2017000017", "proofPaymentCode": "P--2017200011-1", "creationTime": "2018-05-29T09:02:27+0200", "changeTime": "2018-05-29T09:02:27+0200", "dueDate": "2017-04-04", "taxDate": "2017-04-04", "varSymbol": 2021000021, "constSymbol": 6583, "specSymbol": 201323134, "restocked": true, "stockAmountChangeType": "load", "weight": "1.234", "completePackageWeight": "1.234", "billingMethod": { "id": 3, "name": "Cash" }, "billingAddress": { "company": "Shoptet s.r.o.", "fullName": "John Doe", "street": "French", "houseNumber": "123", "city": "Praha 2", "district": "Praha 2", "additional": "4. floor", "zip": "120 00", "countryCode": "CZ", "regionName": "Capital city", "regionShortcut": "CC", "companyId": "12345678", "vatId": "CZ289324675", "vatIdValidationStatus": "verified", "taxId": "CZ289324675" }, "deliveryAddress": { "company": "Shoptet s.r.o.", "fullName": "John Doe", "street": "French", "houseNumber": "123", "city": "Praha 2", "district": "Praha 2", "additional": "4. floor", "zip": "120 00", "countryCode": "CZ", "regionName": "Capital city", "regionShortcut": "CC" }, "addressesEqual": true, "price": { "vat": "42.00", "toPay": "242.00", "currencyCode": "CZK", "withoutVat": "200.00", "withVat": "242.00", "exchangeRate": "1.04568087", "invoicingExchangeRate": "1.04568087", "partialPaymentAmount": "100.00", "partialPaymentType": "percents" }, "customer": { "guid": "1b02cb8e-d7b5-11e0-9a5c-feab5ed617ed", "phone": "603481066", "email": "example@example.com", "remark": "This is a remark" }, "eshop": { "bankAccount": "123456789/1234", "iban": "CZ6508000000192000145399", "bic": "CNBACZPPXXX", "vatPayer": true }, "items": [ { … } ], "documentRemark": "This is a remark", "vatPayer": true, "vatMode": "Normal", "reasonRemark": "Order cancellation" }