--- title: "Get receipts as list of JSON objects" method: GET path: "/v3/receipts" tags: ["Receipts V3"] --- # Get receipts as list of JSON objects `GET /v3/receipts` Retrieve receips sorted by creation date, latest ones first. The number of receipts is limited to 128 results; cursor based pagination is supported. ## Query parameters - `limit` integer - `page` integer - `receiptTypes` string[] - `from` string, date - `to` string, date - `salesOrderId` string - `next` string ## Response `200` Successfully retrieved list of receipts - ReceiptsListReceiptsV3 - `resources` ReceiptReceiptsV3[] — The list of queried resources. In this case partner receipts. - `receiptType` 'PURCHASE' | 'REFUND' | 'PARTIAL_REFUND', required — Categorisation that classifies the receipts according to the main characteristics ATTENTION: In previous version the information was called type - `isRealReceipt` boolean, required — Counterpart to the sentence "Dies ist kein Beleg/keine Rechnung im Sinne des Umsatzsteuergesetzes und berechtigt nicht zum Vorsteuerabzug." on pdf document. * Is set to **true** by default. Sentence is not printed. * Is set to **false** for technical receipts or if partner has to report VAT via the OSS procedure. The Sentence is printed. - `isDeemedSupplierModel` boolean, required — Counterpart to the sentence "Die Umsatzsteuer wird von der OTTO GmbH & Co. KGaA abgeführt." on PDF document. * Is set to **true** if this receipt is subject to the deemed supplier regime; OTTO Market is liable for VAT. The sentence is printed. * Is set to **false** if this receipt is not subject to the deemed supplier regime; the partner is liable for VAT. - `receiptNumber` string, required — Human readable identifier of a receipt known by customer.
Guaranteed to be unique per partner - `creationDate` string, date-time, required — Date when receipt is created by system (UTC in ISO-8601 format) - `fulfillmentDate` string, date-time — Date when service fulfilled. - `salesOrderId` string, required — Technical identifier of corresponding sales order - `orderNumber` string, required — Order number of corresponding sales order - `orderDate` string, date-time, required — Order date of corresponding sales order (UTC in ISO-8601 format) - `shipmentDate` string, date-time — Date when physical items of this receipt were handed over to the carrier to be delivered to the customer (UTC in ISO-8601 format).
Only available on receipts of receiptType PURCHASE. - `shipment` ShipmentReceiptsV3 — Shipment details.
Only provided on receipts of receiptType PURCHASE containing items.
This information is not reliably provided for receipts before 01.03.2024. - `shipFromAddress` AddressInformationReceiptsV3, required — Place of departure from shipment notification send to OTTO market for items.
ATTENTION: If data in shipment notification is not unique per item, it is taken by default. - `zipCode` string, required — Zip code of shipFromAddress - `countryCode` string, required — Country of shipFromAddress represented as country code (ISO 3166-1 alpha-3) - `linkedReceiptNumber` string — Human-readable identifier of linked receipt.
In case of receiptType PARTIAL_REFUND or REFUND it is the receiptINumber of purchase receipt. ATTENTION: In previous version the information was called originalReceiptNumber - `linkedCreationDate` string, date-time — Creation date of linked receipt (UTC in ISO-8601 format).
Only available if there is a linked receipt. ATTENTION: In previous version the information was called originalCreatedDate - `payment` PaymentReceiptsV3, required — Payment details - `paymentProvider` 'PLAZA' | 'OTTOPAYMENTS', required — Payment Provider chosen for the order.
Possible values: * **PLAZA** - Ratepay * **OTTOPAYMENTS** - OTTO Payments - `paymentMethod` 'CREDIT_CARD_ONLINE' | 'INVOICE_SINGLE' | 'INVOICE_INSTALLMENTS' | 'DIRECT_DEBIT_INSTALLMENTS' | 'PREPAYMENT' | 'PAYPAL' | 'DIRECT_DEBIT' | 'CREDIT_CARD', required — Payment method chosen by the customer to pay for this order. Possible values: * **INVOICE_SINGLE / INVOICE_INSTALLMENT** - payment on invoice (with or without installments) * **DIRECT_DEBIT / DIRECT_DEBIT_INSTALLMENTS** - payment by direct debit (with or without installments) * **PREPAYMENT** - payment by prepayment * **PAYPAL** - payment by PayPal * **CREDIT_CARD** - payment by credit or debit card (only applicable for paymentProvider = OTTOPAYMENTS) * **CREDIT_CARD_ONLINE** - payment by credit card (only applicable for old paymentProvider = PLAZA) - `installmentCount` integer — For payment methods with installments, this attribute indicates how many installments the customer has chosen when placing the order.
Only available on receipts of receiptType PURCHASE.
This information is not reliably provided for older receipts - `paymentBreak` boolean — The field indicates whether customer has chosen paymentBreak - `partner` PartnerReceiptsV3, required — Partner for whom the receipt is created - `partnerName` string, required — Name of the selling partner/company. ATTENTION: In previous version the information was called name - `street` string, required — Street and house number of company address - `zipCode` string, required — Zip code of company address - `city` string, required — City of company address - `countryCode` string, required — Country of company address represented as country code (ISO 3166-1 alpha-3) - `vatId` string, required — Value added tax identification number of partner - `representedBy` string, required — The partner's representative(s). ATTENTION: In previous version the information was called legalRepresentatives - `registerCourt` string — Court where the company is registered.
Information exists if it's maintained in partner core data. ATTENTION: In previous version the information was called districtCourt - `commercialRegisterNumber` string — Commercial register number. Unique in context of register court.
Information exists if it's maintained in partner core data. ATTENTION: In previous version the information was called registerNumber - `headOfSupervisoryBoard` string — The partner's head of supervisory board.
Information exists if it's maintained in partner core data - `shopName` string — Alias name of partner.
Information exists if it's maintained in partner core data - `weeeRegistrationNumber` string — WEEE registration number of partner.
Information exists if it's maintained in partner core data - `customer` CustomerReceiptsV3, required — Customer details - `invoiceAddress` AddressReceiptsV3, required — There are different definitions of Address objects in Receipt structure: * **invoiceAddress** - Address of the customer to be billed * **deliveryAddress** - Address of the recipient entered by the customer when placing the order. Recipient can be a person or a pickup point.
Only available on receipts of receiptType PURCHASE. - `firstName` string, required — First name of person or name of a pick point - `lastName` string, required — Last name of a person or a pick point id - `street` string, required — Street of address.
For sales orders were placed before 23rd Sep. 2021 street and house number are both parts of this field - `houseNumber` string — House number of address
Available for sales orders placed after 23rd Sep. 2021. For older sales orders the house number is part of the field street and this field is not shown at all - `addition` string — Additional information of the address
Can be used to provide additional information of address - `zipCode` string, required — Zip code of address - `city` string, required — City of address - `countryCode` string, required — Country of address represented as country code (ISO 3166-1 alpha-3) - `deliveryAddress` AddressReceiptsV3 — There are different definitions of Address objects in Receipt structure: * **invoiceAddress** - Address of the customer to be billed * **deliveryAddress** - Address of the recipient entered by the customer when placing the order. Recipient can be a person or a pickup point.
Only available on receipts of receiptType PURCHASE. - `firstName` string, required — First name of person or name of a pick point - `lastName` string, required — Last name of a person or a pick point id - `street` string, required — Street of address.
For sales orders were placed before 23rd Sep. 2021 street and house number are both parts of this field - `houseNumber` string — House number of address
Available for sales orders placed after 23rd Sep. 2021. For older sales orders the house number is part of the field street and this field is not shown at all - `addition` string — Additional information of the address
Can be used to provide additional information of address - `zipCode` string, required — Zip code of address - `city` string, required — City of address - `countryCode` string, required — Country of address represented as country code (ISO 3166-1 alpha-3) - `lineItems` LineItemsReceiptsV3, required — Line items for which settlement is made. ATTENTION: * In previous version this name was used for itemPositions only. Now there is a substructure that cares about all billing object of a receipt * The object is currently define by mistake as required, we will change it in future as it’s possible that we introduce new receiptTypes without lineItems. For current receiptTypes PURCHASE, PARTIAL_REFUND and REFUND lineItems will always exists. - `itemPositions` ItemPositionReceiptsV3[], required — List of billed items, if exists.
This list is only used in context of receiptType PURCHASE or REFUND.
If there are no entries the lists is displayed as empty - `lineNumber` integer — Number of line item in which the information is printed on the pdf document.
This information is not reliably provided for older receipts - `sku` string — Stock keeping unit of item. Unique item identifier on partner side.
This information is not reliably provided for older receipts - `expectedPerformancePeriod` string — Vague performance date. As the exact date is not known when generating the receipt, this information gives an indication when the item will be shipped - `articleNumber` string, required — Unique Identifier of item the customer knows from order process. ATTENTION: Different from the previous version, the field also contains the promotion. In last version the promotion was provided separately - `productTitle` string, required — Product description of item the customer knows from the order process - `variationAttributes` string — Additional attributes for unique description of an item, if different variants of the item are possible. (String of comma seperated dimensions) ATTENTION: In previous version the information was called dimensions - `positionItemIds` string[], required — List of unique identifiers of specific instances of ordered items. A (salesOrder)PositionItem is the smallest unit of an item that can be ordered.
If quantity of the specific LineItem object is bigger than one the list contains more than one entry - `quantity` integer, required — Quantity - `unitPrice` PriceReceiptsV3, required — Costs of an object There are different definitions of Price objects in Receipt structure: * **unitPrice** - Original price for quantity a line item object * **positionSum** - Price for quantity x unitPrice of a line item object minus reductions of all sub priceModification objects, if exist * **partialRefundAmount** - Granted reduction by the partner on line item object * **priceModificationAmount** - Total reduction for the super ordinated line item object. If the line item object has a quantity, this is already been taken into account in this amount. * **priceToPay** - Price for quantity one minus all instant reductions like partner discount ... when selling (excl. earlier partial refunds).
Only available on receipts of receiptType PURCHASE. - `taxType` 'VAT' | 'INSURANCE', required — The fields indicates what kind of tax the price object includes.
Currently prices of the following taxTypes are possible. * **VAT** - vat rate * **INSURANCE** - insurance tax - `taxRate` string, required — Applied tax rate, if there is any.
Currently the entry can only be a decimal number. - `gross` object, required — Calculated gross value - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `net` object — Calculated net value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `tax` object — Calculated tax value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `priceToPayPerPositionItems` PriceToPayPerPositionItemReceiptsV3[] — Price of each unit of the item i.e., price of each positionItemId.
It will be available only for PURCHASE receipt - `positionItemIds` string[], required — List of unique identifiers of specific instances of ordered items.
A (salesOrder)PositionItem is the smallest unit of an item that can be ordered. - `priceToPay` PriceReceiptsV3, required — Costs of an object There are different definitions of Price objects in Receipt structure: * **unitPrice** - Original price for quantity a line item object * **positionSum** - Price for quantity x unitPrice of a line item object minus reductions of all sub priceModification objects, if exist * **partialRefundAmount** - Granted reduction by the partner on line item object * **priceModificationAmount** - Total reduction for the super ordinated line item object. If the line item object has a quantity, this is already been taken into account in this amount. * **priceToPay** - Price for quantity one minus all instant reductions like partner discount ... when selling (excl. earlier partial refunds).
Only available on receipts of receiptType PURCHASE. - `taxType` 'VAT' | 'INSURANCE', required — The fields indicates what kind of tax the price object includes.
Currently prices of the following taxTypes are possible. * **VAT** - vat rate * **INSURANCE** - insurance tax - `taxRate` string, required — Applied tax rate, if there is any.
Currently the entry can only be a decimal number. - `gross` object, required — Calculated gross value - … - `net` object — Calculated net value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - … - `tax` object — Calculated tax value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - … - `positionSum` PriceReceiptsV3, required — Costs of an object There are different definitions of Price objects in Receipt structure: * **unitPrice** - Original price for quantity a line item object * **positionSum** - Price for quantity x unitPrice of a line item object minus reductions of all sub priceModification objects, if exist * **partialRefundAmount** - Granted reduction by the partner on line item object * **priceModificationAmount** - Total reduction for the super ordinated line item object. If the line item object has a quantity, this is already been taken into account in this amount. * **priceToPay** - Price for quantity one minus all instant reductions like partner discount ... when selling (excl. earlier partial refunds).
Only available on receipts of receiptType PURCHASE. - `taxType` 'VAT' | 'INSURANCE', required — The fields indicates what kind of tax the price object includes.
Currently prices of the following taxTypes are possible. * **VAT** - vat rate * **INSURANCE** - insurance tax - `taxRate` string, required — Applied tax rate, if there is any.
Currently the entry can only be a decimal number. - `gross` object, required — Calculated gross value - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `net` object — Calculated net value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `tax` object — Calculated tax value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `priceModifications` PriceModificationReceiptsV3[], required — List of additional fees and reductions represented as price modifications.
Currently we only know reductions.
If there are no entries the list is displayed as empty - `lineNumber` integer — Number of line item in which the information is printed on the pdf document of the receipt.
On the pdf documents increases and decreases do not necessarily have to be shown on the same line. If there is a discrepancy, it is visible by different line numbers of this object and the parent line item object
This information is not reliably provided for older receipts - `priceModificationType` 'PARTNER_DISCOUNT' | 'DEFECT_COMPENSATION' | 'REFUND_COMPLAINT_ITEM' | 'REFUND_PAYPAL_DISPUTE' | 'REFUND_ESCALATION' | 'REFUND_PARTIAL_AMOUNT_AFTER_SERVICE_CANCELLATION' | 'REFUND_CREDIT_CARD_DISPUTE', required — This type describes the special increases or decreases in detail and how to deal with it. The following priceModificationTypes are possible: * **PARTNER_DISCOUNT** - Partner-financed immediate discount granted to the customer at the time of purchase.
Reduction of parent object item position on PURCHASE and REFUND receipt * **DEFECT_COMPENSATION** / **REFUND_COMPLAINT_ITEM** - Partial refund already refunded by a partial refund receipt to compensate a defect.
Reduction of parent object item position on REFUND receipt * **REFUND_PAYPAL_DISPUTE** - Partial or full amount of item price was refunded due to a dispute in Paypal payment.
Reduction of parent object item or service position on REFUND receipt * **REFUND_ESCALATION** - Refund already refunded by a partial refund receipt due to an escalation.
Reduction of parent object item position on REFUND receipt * **REFUND_PARTIAL_AMOUNT_AFTER_SERVICE_CANCELLATION** - A partial refund already refunded after service could not fulfilled completely.
Reduction of parent object item and service position on REFUND receipt * **REFUND_CREDIT_CARD_DISPUTE** - Refund already refunded by a partial refund receipt due to dispute in CREDIT_CARD payment. Reduction of parent object item or service position on REFUND receipt - `details` DetailsReceiptsV3, required — Additional information of increase or decrease of the line item described by this PriceModification object - `description` string, required — Additional info often printed on the pdf for a PriceModification object (on German receipts always in German)
If PriceModification object is of type: * **PARTNER_DISCOUNT** - discount name, provided with sales order event as part of positionGroupPrice: (What we print on the pdf ): e.g. "1 € Rabatt" * **DEFECT_COMPENSATION** - ( German translation of defect compensation) "**Mängelausgleich**" * **REFUND_COMPLAINT_ITEM** - hard coded "Preisnachlass Reklamation Artikel" * **REFUND_PAYPAL_DISPUTE** - hard coded “Preisnachlass PayPal Disput“ * **REFUND_ESCALATION** - hard coded “Preisnachlass Escalation“ * **REFUND_CREDIT_CARD_DISPUTE** - hard coded "Preisnachlass CREDIT_CARD Disput" - `id` string — Discount code applied to the order to get a reduction. Available when reduction is of type PARTNER_DISCOUNT - `linkedReceiptNumber` string — Allows to link an earlier purchase or (partial)refund receipt by human-readable identifier.
If PriceModification object is of type: * **DEFECT_COMPENSATION**: In case of previous (partial) refunds this field contains the human-readable identifier of the partial refund with which the previous refund was made - `linkedReceiptCreationDate` string, date-time — Allows to show creation date of linked earlier purchase or (partial)refund receipt.
If PriceModification object is of type: * **DEFECT_COMPENSATION**: In case of previous (partial) refunds this field contains the creation date of linked receipt with which the previous refund was made. (ISO-8601 format) - `type` 'PARTNER_DISCOUNT' | 'PLATFORM_DISCOUNT' — The specific types of discounts provided for Marketplace. This field is only applicable when the priceModificationType for the item is PARTNER_DISCOUNT
Possible values: * **PARTNER_DISCOUNT** - a Partner Discount provided because of a booked service "Rabattaktion" by the partner * **PLATFORM_DISCOUNT** - a Discount for a platform frame provided because of a booked service "Marktplatz Rabattaktion" by the partner - `reason` 'GOODWILL_ITEM_FOR_FREE' | 'GOODWILL_ITEM_RETURN_REJECTED' | 'GOODWILL_ITEM_DISCOUNT_EXPIRED' | 'GOODWILL_OTHER' — Detailed reason of priceModifications of priceModificationType REFUND_GOODWILL_ITEM. Possible values: * **GOODWILL_ITEM_FOR_FREE** - Refund item price as goodwill * **GOODWILL_ITEM_RETURN_REJECTED** - Price reduction after return rejection as goodwill * **GOODWILL_ITEM_DISCOUNT_EXPIRED** - Price reduction after using old discount code as goodwill * **GOODWILL_OTHER** - Individual price reduction as goodwill - `linkedPositionItemId` string — Allows to show the unique identifier (salesOrder)PositionItem of an earlier (partial)refund receipt of items.
A (salesOrder)PositionItem is the smallest unit of an item that can be ordered. It will be present in refund receipts for those _“priceModificationType” which are applicable after purchase receipts are generated_. - `priceModificationAmount` PriceReceiptsV3, required — Costs of an object There are different definitions of Price objects in Receipt structure: * **unitPrice** - Original price for quantity a line item object * **positionSum** - Price for quantity x unitPrice of a line item object minus reductions of all sub priceModification objects, if exist * **partialRefundAmount** - Granted reduction by the partner on line item object * **priceModificationAmount** - Total reduction for the super ordinated line item object. If the line item object has a quantity, this is already been taken into account in this amount. * **priceToPay** - Price for quantity one minus all instant reductions like partner discount ... when selling (excl. earlier partial refunds).
Only available on receipts of receiptType PURCHASE. - `taxType` 'VAT' | 'INSURANCE', required — The fields indicates what kind of tax the price object includes.
Currently prices of the following taxTypes are possible. * **VAT** - vat rate * **INSURANCE** - insurance tax - `taxRate` string, required — Applied tax rate, if there is any.
Currently the entry can only be a decimal number. - `gross` object, required — Calculated gross value - … - `net` object — Calculated net value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - … - `tax` object — Calculated tax value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - … - `itemPartialRefundPositions` ItemPartialRefundPositionReceiptsV3[], required — List of billed partial refunds of items.
This list is only used in context of receiptType PARTIAL_REFUND.
If there are no entries the lists is displayed as empty - `partialRefundDetails` PartialRefundDetailsReceiptsV3 — Additional information about the granted partial refund to this item. - `benefit` BenefitReceiptsV3 — Additional information about the applied customer benefit. - `id` string — Discount code applied to the order to get a reduction. Available when reduction is of type PARTNER_DISCOUNT - `description` string — Additional info often printed on the pdf for a PriceModification object (on German receipts always in German)If PriceModification object is of type: * **PARTNER_DISCOUNT**- discount name, provided with sales order event as part of positionGroupPrice-
(What we print on the pdf )- e.g. "1 € Rabatt" - `lineNumber` integer — Number of line item in which the information is printed on the pdf document of the receipt.
This information is not reliably provided for older receipts - `sku` string — Stock keeping unit of item. Unique item identifier on partner side - `articleNumber` string, required — Unique Identifier of item the customer knows from order process - `productTitle` string, required — Product description of item the customer knows from the order process - `variationAttributes` string — Additional attributes for unique description of item, if different variants of the item are possible. (String of comma seperated dimensions) ATTENTION: In previous version, the information exists as dimensions - `positionItemIds` string[], required — List of unique identifiers of specific instances of ordered items.
A (salesOrder)PositionItem is the smallest unit of an item that can be ordered - `partialRefundAmount` PriceReceiptsV3, required — Costs of an object There are different definitions of Price objects in Receipt structure: * **unitPrice** - Original price for quantity a line item object * **positionSum** - Price for quantity x unitPrice of a line item object minus reductions of all sub priceModification objects, if exist * **partialRefundAmount** - Granted reduction by the partner on line item object * **priceModificationAmount** - Total reduction for the super ordinated line item object. If the line item object has a quantity, this is already been taken into account in this amount. * **priceToPay** - Price for quantity one minus all instant reductions like partner discount ... when selling (excl. earlier partial refunds).
Only available on receipts of receiptType PURCHASE. - `taxType` 'VAT' | 'INSURANCE', required — The fields indicates what kind of tax the price object includes.
Currently prices of the following taxTypes are possible. * **VAT** - vat rate * **INSURANCE** - insurance tax - `taxRate` string, required — Applied tax rate, if there is any.
Currently the entry can only be a decimal number. - `gross` object, required — Calculated gross value - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `net` object — Calculated net value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `tax` object — Calculated tax value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `servicePositions` ServicePositionReceiptsV3[], required — List of billed B2C services, if exists for this receipt.
This list is only used in context of receiptType PURCHASE or REFUND.
If there are no entries the lists is displayed as empty - `lineNumber` integer — Number of line item in which the information is printed on the pdf document of the receipt.
This information is not reliably provided for older receipts - `serviceType` 'DISPOSAL' | 'INSURANCE' | 'WARRANTY_EXTERNAL' — Categorization that classifies services according to their main characteristics. Services of the same type are often treated in the same way. Currently, the processing of the following types are possible: * **DISPOSAL** - Free take away of old technical devices required by law * **INSURANCE** - Product insurance * **WARRANTY_EXTERNAL** - Long term warranty sold by partners != OTTO - `expectedPerformancePeriod` string — Vague performance date.
As the exact date is not known when generating the receipt, this information gives an indication when the service is expected to be fulfilled - `serviceName` string, required — Service name the customer knows from the order process - `servicePositionItemIds` string[], required — List of unique identifiers of specific instances of services.
A servicePositionItem is the smallest unit of a service that can be ordered.
If quantity of this object is bigger than one, the list contains more than one entry - `linkedItemDetails` LinkedItemDetailsReceiptsV3 — Additional information to an item directly related to the service.
Object exists only if the service was sold together with an item - `itemReceiptNumber` string — Human-readable identifier refers to the receipt the linked item was billed.
Displayed only if item is billed with another receipt.
In case of receiptType * **PURCHASE** - **receiptNumber of purchase receipt**.
If this field is not present, you will find information in receipt.receiptNumber * **REFUND** - **receiptNumber of purchase receipt**.
If this field is not present ,you will find information in receipt.linkedReceiptNumber - `itemPartnerName` string — Name of the partner who sold the linked item.
Displayed only if the partner is different from partner of the receipt - `sku` string — Stock keeping unit of the linked item. Unique item identifier on partner side
This information is not reliably provided for older receipts. - `articleNumber` string, required — Unique Identifier of linked item the customer knows from order process. ATTENTION: Different from the previous version, the field also contains the promotion. In last version the promotion was provided separately - `productTitle` string, required — Product description of linked item the customer knows from the order process - `serviceRelations` ServiceRelationReceiptsV3[], required — List of ServiceRelation objects.
Contains entries if services were sold together with items otherwise list is empty - `servicePositionItemId` string, required — Unique identifier of a specific instance of a service. ServicePositionItem is the smallest unit of service that can be ordered - `positionItemId` string, required — Unique identifier of a specific instance of an ordered item (salesOrder)PositionItem is the smallest unit of an item that can be ordered - `quantity` integer, required — Quantity - `unitPrice` PriceReceiptsV3, required — Costs of an object There are different definitions of Price objects in Receipt structure: * **unitPrice** - Original price for quantity a line item object * **positionSum** - Price for quantity x unitPrice of a line item object minus reductions of all sub priceModification objects, if exist * **partialRefundAmount** - Granted reduction by the partner on line item object * **priceModificationAmount** - Total reduction for the super ordinated line item object. If the line item object has a quantity, this is already been taken into account in this amount. * **priceToPay** - Price for quantity one minus all instant reductions like partner discount ... when selling (excl. earlier partial refunds).
Only available on receipts of receiptType PURCHASE. - `taxType` 'VAT' | 'INSURANCE', required — The fields indicates what kind of tax the price object includes.
Currently prices of the following taxTypes are possible. * **VAT** - vat rate * **INSURANCE** - insurance tax - `taxRate` string, required — Applied tax rate, if there is any.
Currently the entry can only be a decimal number. - `gross` object, required — Calculated gross value - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `net` object — Calculated net value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `tax` object — Calculated tax value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `positionSum` PriceReceiptsV3, required — Costs of an object There are different definitions of Price objects in Receipt structure: * **unitPrice** - Original price for quantity a line item object * **positionSum** - Price for quantity x unitPrice of a line item object minus reductions of all sub priceModification objects, if exist * **partialRefundAmount** - Granted reduction by the partner on line item object * **priceModificationAmount** - Total reduction for the super ordinated line item object. If the line item object has a quantity, this is already been taken into account in this amount. * **priceToPay** - Price for quantity one minus all instant reductions like partner discount ... when selling (excl. earlier partial refunds).
Only available on receipts of receiptType PURCHASE. - `taxType` 'VAT' | 'INSURANCE', required — The fields indicates what kind of tax the price object includes.
Currently prices of the following taxTypes are possible. * **VAT** - vat rate * **INSURANCE** - insurance tax - `taxRate` string, required — Applied tax rate, if there is any.
Currently the entry can only be a decimal number. - `gross` object, required — Calculated gross value - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `net` object — Calculated net value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `tax` object — Calculated tax value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `priceModifications` PriceModificationReceiptsV3[], required — List of additional fees and reductions represented as price modifications.
Currently we only know reductions.
If there are no entries the list is displayed as empty - `lineNumber` integer — Number of line item in which the information is printed on the pdf document of the receipt.
On the pdf documents increases and decreases do not necessarily have to be shown on the same line. If there is a discrepancy, it is visible by different line numbers of this object and the parent line item object
This information is not reliably provided for older receipts - `priceModificationType` 'PARTNER_DISCOUNT' | 'DEFECT_COMPENSATION' | 'REFUND_COMPLAINT_ITEM' | 'REFUND_PAYPAL_DISPUTE' | 'REFUND_ESCALATION' | 'REFUND_PARTIAL_AMOUNT_AFTER_SERVICE_CANCELLATION' | 'REFUND_CREDIT_CARD_DISPUTE', required — This type describes the special increases or decreases in detail and how to deal with it. The following priceModificationTypes are possible: * **PARTNER_DISCOUNT** - Partner-financed immediate discount granted to the customer at the time of purchase.
Reduction of parent object item position on PURCHASE and REFUND receipt * **DEFECT_COMPENSATION** / **REFUND_COMPLAINT_ITEM** - Partial refund already refunded by a partial refund receipt to compensate a defect.
Reduction of parent object item position on REFUND receipt * **REFUND_PAYPAL_DISPUTE** - Partial or full amount of item price was refunded due to a dispute in Paypal payment.
Reduction of parent object item or service position on REFUND receipt * **REFUND_ESCALATION** - Refund already refunded by a partial refund receipt due to an escalation.
Reduction of parent object item position on REFUND receipt * **REFUND_PARTIAL_AMOUNT_AFTER_SERVICE_CANCELLATION** - A partial refund already refunded after service could not fulfilled completely.
Reduction of parent object item and service position on REFUND receipt * **REFUND_CREDIT_CARD_DISPUTE** - Refund already refunded by a partial refund receipt due to dispute in CREDIT_CARD payment. Reduction of parent object item or service position on REFUND receipt - `details` DetailsReceiptsV3, required — Additional information of increase or decrease of the line item described by this PriceModification object - `description` string, required — Additional info often printed on the pdf for a PriceModification object (on German receipts always in German)
If PriceModification object is of type: * **PARTNER_DISCOUNT** - discount name, provided with sales order event as part of positionGroupPrice: (What we print on the pdf ): e.g. "1 € Rabatt" * **DEFECT_COMPENSATION** - ( German translation of defect compensation) "**Mängelausgleich**" * **REFUND_COMPLAINT_ITEM** - hard coded "Preisnachlass Reklamation Artikel" * **REFUND_PAYPAL_DISPUTE** - hard coded “Preisnachlass PayPal Disput“ * **REFUND_ESCALATION** - hard coded “Preisnachlass Escalation“ * **REFUND_CREDIT_CARD_DISPUTE** - hard coded "Preisnachlass CREDIT_CARD Disput" - `id` string — Discount code applied to the order to get a reduction. Available when reduction is of type PARTNER_DISCOUNT - `linkedReceiptNumber` string — Allows to link an earlier purchase or (partial)refund receipt by human-readable identifier.
If PriceModification object is of type: * **DEFECT_COMPENSATION**: In case of previous (partial) refunds this field contains the human-readable identifier of the partial refund with which the previous refund was made - `linkedReceiptCreationDate` string, date-time — Allows to show creation date of linked earlier purchase or (partial)refund receipt.
If PriceModification object is of type: * **DEFECT_COMPENSATION**: In case of previous (partial) refunds this field contains the creation date of linked receipt with which the previous refund was made. (ISO-8601 format) - `type` 'PARTNER_DISCOUNT' | 'PLATFORM_DISCOUNT' — The specific types of discounts provided for Marketplace. This field is only applicable when the priceModificationType for the item is PARTNER_DISCOUNT
Possible values: * **PARTNER_DISCOUNT** - a Partner Discount provided because of a booked service "Rabattaktion" by the partner * **PLATFORM_DISCOUNT** - a Discount for a platform frame provided because of a booked service "Marktplatz Rabattaktion" by the partner - `reason` 'GOODWILL_ITEM_FOR_FREE' | 'GOODWILL_ITEM_RETURN_REJECTED' | 'GOODWILL_ITEM_DISCOUNT_EXPIRED' | 'GOODWILL_OTHER' — Detailed reason of priceModifications of priceModificationType REFUND_GOODWILL_ITEM. Possible values: * **GOODWILL_ITEM_FOR_FREE** - Refund item price as goodwill * **GOODWILL_ITEM_RETURN_REJECTED** - Price reduction after return rejection as goodwill * **GOODWILL_ITEM_DISCOUNT_EXPIRED** - Price reduction after using old discount code as goodwill * **GOODWILL_OTHER** - Individual price reduction as goodwill - `linkedPositionItemId` string — Allows to show the unique identifier (salesOrder)PositionItem of an earlier (partial)refund receipt of items.
A (salesOrder)PositionItem is the smallest unit of an item that can be ordered. It will be present in refund receipts for those _“priceModificationType” which are applicable after purchase receipts are generated_. - `priceModificationAmount` PriceReceiptsV3, required — Costs of an object There are different definitions of Price objects in Receipt structure: * **unitPrice** - Original price for quantity a line item object * **positionSum** - Price for quantity x unitPrice of a line item object minus reductions of all sub priceModification objects, if exist * **partialRefundAmount** - Granted reduction by the partner on line item object * **priceModificationAmount** - Total reduction for the super ordinated line item object. If the line item object has a quantity, this is already been taken into account in this amount. * **priceToPay** - Price for quantity one minus all instant reductions like partner discount ... when selling (excl. earlier partial refunds).
Only available on receipts of receiptType PURCHASE. - `taxType` 'VAT' | 'INSURANCE', required — The fields indicates what kind of tax the price object includes.
Currently prices of the following taxTypes are possible. * **VAT** - vat rate * **INSURANCE** - insurance tax - `taxRate` string, required — Applied tax rate, if there is any.
Currently the entry can only be a decimal number. - `gross` object, required — Calculated gross value - … - `net` object — Calculated net value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - … - `tax` object — Calculated tax value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - … - `insurancePeriod` integer — Services of serviceType WARRANTY or INSURANCE could be offered with different durations. This field will show the duration as month. - `servicePartialRefundPositions` ServicePartialRefundPositionReceiptsV3[], required — List of billed partial refunds of services. - `lineNumber` integer — Number of line item in which the information is printed on the pdf document of the receipt.
This information is not reliably provided for older receipts - `serviceType` 'DISPOSAL' | 'INSURANCE' | 'WARRANTY_EXTERNAL' — Categorization that classifies services according to their main characteristics. Services of the same type are often treated in the same way. Currently, the processing of the following types are possible: * **DISPOSAL** - Free take away of old technical devices required by law * **INSURANCE** - Product insurance * **WARRANTY_EXTERNAL** - Long term warranty sold by partners != OTTO - `serviceName` string — Service name of a special specification of a service type that the customer has seen in the ordering process. - `servicePositionItemIds` string[] — List of unique identifiers of specific instances of services. A servicePositionItem is the smallest unit of a service that can be ordered. If quantity of this object is bigger than one the list contains more than one entry. - `partialRefundAmount` PriceReceiptsV3 — Costs of an object There are different definitions of Price objects in Receipt structure: * **unitPrice** - Original price for quantity a line item object * **positionSum** - Price for quantity x unitPrice of a line item object minus reductions of all sub priceModification objects, if exist * **partialRefundAmount** - Granted reduction by the partner on line item object * **priceModificationAmount** - Total reduction for the super ordinated line item object. If the line item object has a quantity, this is already been taken into account in this amount. * **priceToPay** - Price for quantity one minus all instant reductions like partner discount ... when selling (excl. earlier partial refunds).
Only available on receipts of receiptType PURCHASE. - `taxType` 'VAT' | 'INSURANCE', required — The fields indicates what kind of tax the price object includes.
Currently prices of the following taxTypes are possible. * **VAT** - vat rate * **INSURANCE** - insurance tax - `taxRate` string, required — Applied tax rate, if there is any.
Currently the entry can only be a decimal number. - `gross` object, required — Calculated gross value - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `net` object — Calculated net value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `tax` object — Calculated tax value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `insurancePeriod` integer — Services of serviceType WARRANTY or INSURANCE could be offered with different durations. This field will show the duration as month. - `deliveryCosts` DeliveryCostReceiptsV3[], required — List of billed logistic costs, if exists for this receipt.
This list is only used in context of receiptType PURCHASE or REFUND.
If there are no entries the lists is displayed as empty - `lineNumber` integer — Number of line item in which the information is printed on the pdf document of the receipt.
This information is not reliably provided for older receipts - `deliveryCostType` 'DELIVERY_FEE_STANDARD' | 'DELIVERY_FEE_FREIGHT_SURCHARGE', required — Type of delivery costs for the shipment of physical goods.
Possible values: * **DELIVERY_FEE_STANDARD** - basic shipping costs * **DELIVERY_FEE_FREIGHT_SURCHARGE** - additional freight surcharge for bulky goods - `unitPrice` PriceReceiptsV3, required — Costs of an object There are different definitions of Price objects in Receipt structure: * **unitPrice** - Original price for quantity a line item object * **positionSum** - Price for quantity x unitPrice of a line item object minus reductions of all sub priceModification objects, if exist * **partialRefundAmount** - Granted reduction by the partner on line item object * **priceModificationAmount** - Total reduction for the super ordinated line item object. If the line item object has a quantity, this is already been taken into account in this amount. * **priceToPay** - Price for quantity one minus all instant reductions like partner discount ... when selling (excl. earlier partial refunds).
Only available on receipts of receiptType PURCHASE. - `taxType` 'VAT' | 'INSURANCE', required — The fields indicates what kind of tax the price object includes.
Currently prices of the following taxTypes are possible. * **VAT** - vat rate * **INSURANCE** - insurance tax - `taxRate` string, required — Applied tax rate, if there is any.
Currently the entry can only be a decimal number. - `gross` object, required — Calculated gross value - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `net` object — Calculated net value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `tax` object — Calculated tax value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `positionSum` PriceReceiptsV3, required — Costs of an object There are different definitions of Price objects in Receipt structure: * **unitPrice** - Original price for quantity a line item object * **positionSum** - Price for quantity x unitPrice of a line item object minus reductions of all sub priceModification objects, if exist * **partialRefundAmount** - Granted reduction by the partner on line item object * **priceModificationAmount** - Total reduction for the super ordinated line item object. If the line item object has a quantity, this is already been taken into account in this amount. * **priceToPay** - Price for quantity one minus all instant reductions like partner discount ... when selling (excl. earlier partial refunds).
Only available on receipts of receiptType PURCHASE. - `taxType` 'VAT' | 'INSURANCE', required — The fields indicates what kind of tax the price object includes.
Currently prices of the following taxTypes are possible. * **VAT** - vat rate * **INSURANCE** - insurance tax - `taxRate` string, required — Applied tax rate, if there is any.
Currently the entry can only be a decimal number. - `gross` object, required — Calculated gross value - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `net` object — Calculated net value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `tax` object — Calculated tax value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `priceModifications` PriceModificationReceiptsV3[], required — List of additional fees and reductions represented as price modifications.
If there are no price modifications, an empty list is displayed - `lineNumber` integer — Number of line item in which the information is printed on the pdf document of the receipt.
On the pdf documents increases and decreases do not necessarily have to be shown on the same line. If there is a discrepancy, it is visible by different line numbers of this object and the parent line item object
This information is not reliably provided for older receipts - `priceModificationType` 'PARTNER_DISCOUNT' | 'DEFECT_COMPENSATION' | 'REFUND_COMPLAINT_ITEM' | 'REFUND_PAYPAL_DISPUTE' | 'REFUND_ESCALATION' | 'REFUND_PARTIAL_AMOUNT_AFTER_SERVICE_CANCELLATION' | 'REFUND_CREDIT_CARD_DISPUTE', required — This type describes the special increases or decreases in detail and how to deal with it. The following priceModificationTypes are possible: * **PARTNER_DISCOUNT** - Partner-financed immediate discount granted to the customer at the time of purchase.
Reduction of parent object item position on PURCHASE and REFUND receipt * **DEFECT_COMPENSATION** / **REFUND_COMPLAINT_ITEM** - Partial refund already refunded by a partial refund receipt to compensate a defect.
Reduction of parent object item position on REFUND receipt * **REFUND_PAYPAL_DISPUTE** - Partial or full amount of item price was refunded due to a dispute in Paypal payment.
Reduction of parent object item or service position on REFUND receipt * **REFUND_ESCALATION** - Refund already refunded by a partial refund receipt due to an escalation.
Reduction of parent object item position on REFUND receipt * **REFUND_PARTIAL_AMOUNT_AFTER_SERVICE_CANCELLATION** - A partial refund already refunded after service could not fulfilled completely.
Reduction of parent object item and service position on REFUND receipt * **REFUND_CREDIT_CARD_DISPUTE** - Refund already refunded by a partial refund receipt due to dispute in CREDIT_CARD payment. Reduction of parent object item or service position on REFUND receipt - `details` DetailsReceiptsV3, required — Additional information of increase or decrease of the line item described by this PriceModification object - `description` string, required — Additional info often printed on the pdf for a PriceModification object (on German receipts always in German)
If PriceModification object is of type: * **PARTNER_DISCOUNT** - discount name, provided with sales order event as part of positionGroupPrice: (What we print on the pdf ): e.g. "1 € Rabatt" * **DEFECT_COMPENSATION** - ( German translation of defect compensation) "**Mängelausgleich**" * **REFUND_COMPLAINT_ITEM** - hard coded "Preisnachlass Reklamation Artikel" * **REFUND_PAYPAL_DISPUTE** - hard coded “Preisnachlass PayPal Disput“ * **REFUND_ESCALATION** - hard coded “Preisnachlass Escalation“ * **REFUND_CREDIT_CARD_DISPUTE** - hard coded "Preisnachlass CREDIT_CARD Disput" - `id` string — Discount code applied to the order to get a reduction. Available when reduction is of type PARTNER_DISCOUNT - `linkedReceiptNumber` string — Allows to link an earlier purchase or (partial)refund receipt by human-readable identifier.
If PriceModification object is of type: * **DEFECT_COMPENSATION**: In case of previous (partial) refunds this field contains the human-readable identifier of the partial refund with which the previous refund was made - `linkedReceiptCreationDate` string, date-time — Allows to show creation date of linked earlier purchase or (partial)refund receipt.
If PriceModification object is of type: * **DEFECT_COMPENSATION**: In case of previous (partial) refunds this field contains the creation date of linked receipt with which the previous refund was made. (ISO-8601 format) - `type` 'PARTNER_DISCOUNT' | 'PLATFORM_DISCOUNT' — The specific types of discounts provided for Marketplace. This field is only applicable when the priceModificationType for the item is PARTNER_DISCOUNT
Possible values: * **PARTNER_DISCOUNT** - a Partner Discount provided because of a booked service "Rabattaktion" by the partner * **PLATFORM_DISCOUNT** - a Discount for a platform frame provided because of a booked service "Marktplatz Rabattaktion" by the partner - `reason` 'GOODWILL_ITEM_FOR_FREE' | 'GOODWILL_ITEM_RETURN_REJECTED' | 'GOODWILL_ITEM_DISCOUNT_EXPIRED' | 'GOODWILL_OTHER' — Detailed reason of priceModifications of priceModificationType REFUND_GOODWILL_ITEM. Possible values: * **GOODWILL_ITEM_FOR_FREE** - Refund item price as goodwill * **GOODWILL_ITEM_RETURN_REJECTED** - Price reduction after return rejection as goodwill * **GOODWILL_ITEM_DISCOUNT_EXPIRED** - Price reduction after using old discount code as goodwill * **GOODWILL_OTHER** - Individual price reduction as goodwill - `linkedPositionItemId` string — Allows to show the unique identifier (salesOrder)PositionItem of an earlier (partial)refund receipt of items.
A (salesOrder)PositionItem is the smallest unit of an item that can be ordered. It will be present in refund receipts for those _“priceModificationType” which are applicable after purchase receipts are generated_. - `priceModificationAmount` PriceReceiptsV3, required — Costs of an object There are different definitions of Price objects in Receipt structure: * **unitPrice** - Original price for quantity a line item object * **positionSum** - Price for quantity x unitPrice of a line item object minus reductions of all sub priceModification objects, if exist * **partialRefundAmount** - Granted reduction by the partner on line item object * **priceModificationAmount** - Total reduction for the super ordinated line item object. If the line item object has a quantity, this is already been taken into account in this amount. * **priceToPay** - Price for quantity one minus all instant reductions like partner discount ... when selling (excl. earlier partial refunds).
Only available on receipts of receiptType PURCHASE. - `taxType` 'VAT' | 'INSURANCE', required — The fields indicates what kind of tax the price object includes.
Currently prices of the following taxTypes are possible. * **VAT** - vat rate * **INSURANCE** - insurance tax - `taxRate` string, required — Applied tax rate, if there is any.
Currently the entry can only be a decimal number. - `gross` object, required — Calculated gross value - … - `net` object — Calculated net value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - … - `tax` object — Calculated tax value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - … - `deliveryFeePartialRefundPositions` DeliveryCostPartialRefundPositionReceiptsV3[], required — This information is currently not available, will be an empty array. - `totals` PriceReceiptsV3[], required — Total amounts of receipt per tax type and tax rate - `taxType` 'VAT' | 'INSURANCE', required — The fields indicates what kind of tax the price object includes.
Currently prices of the following taxTypes are possible. * **VAT** - vat rate * **INSURANCE** - insurance tax - `taxRate` string, required — Applied tax rate, if there is any.
Currently the entry can only be a decimal number. - `gross` object, required — Calculated gross value - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `net` object — Calculated net value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `tax` object — Calculated tax value
This information is not reliably provided for older receipts.This information is not reliably provided for older receipts for all Price objects.. In the beginning we only provides this value for receipt.totals.
In receipts generated after the 01-01-2023 data should always be set in all Price objects. - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `refundType` 'RETURN' | 'CANCELLATION' | 'SERVICE_FULL_REFUND_CANCELLED_BY_SDU' | 'SERVICE_FULL_REFUND_CANCELLED_BY_CUSTOMER' | 'SERVICE_FULL_REFUND_PRODUCT_RETURNED' — Field describes the business case of a refund in more detail.
Only available on receipts of receiptType REFUND and not reliable provided on older partial refund receipts. The following refundTypes are possible: * **RETURN** - Refund due to a return of an item * **CANCELLATION** - Refund of delivery fees due to a cancellation * **SERVICE_FULL_REFUND_CANCELLED_BY_SDU** - Refund for service only, following service partner (SDU) cancellation * **SERVICE_FULL_REFUND_CANCELLED_BY_CUSTOMER**- Refund for service only, following customer cancellation * **SERVICE_FULL_REFUND_PRODUCT_RETURNED** - Refund for service only, following product return - `partialRefundType` 'REFUND_COMPLAINT_ITEM' | 'REFUND_PAYPAL_DISPUTE' | 'REFUND_ESCALATION' | 'REFUND_PARTIAL_AMOUNT_AFTER_SERVICE_CANCELLATION' | 'REFUND_CREDIT_CARD_DISPUTE' — Business case of partial refund chosen by partner. Has an impact on the business flow and the PDF.
Only available on receipts of receiptType PARTIAL_REFUND and not reliable provides on older partial refunds receipts. Possible values: * **REFUND_COMPLAINT_ITEM** - Refund because of justified customer complaint on item * **REFUND_PAYPAL_DISPUTE** - Partial or full amount of item price was refunded due to a dispute in Paypal payment * **REFUND_ESCALATION** - Partial amount of item price was refunded due to an escalation * **REFUND_PARTIAL_AMOUNT_AFTER_SERVICE_CANCELLATION** - Lowering of service price after service was not fulfilled completely * **REFUND_CREDIT_CARD_DISPUTE** - Partial or full amount of item price was refunded due to a dispute in CREDIT_CARD payment - `amountDue` object, required — The amountDue documents the gross amount a customer still has to pay or will be refunded respectively owes less (the latter decision depends on the chosen payment method) with this receipt.
As in case of receiptType PURCHASE and a prepaid payment method we know for sure that the customer has already paid in advance, so the amount is 0 € otherwise the content is identically with totalsGrossAmount - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `totalsGrossAmount` object — Gross amounts of totals summed up over all prices. Only available on receipts of receiptType PURCHASE - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `totalsReductions` TotalsReductionReceiptsV3[] — Reduction amounts on total value of receipts (currently it includes voucher reduction) - `type` 'VOUCHER', required — Type of reductions applied on total value of receipts. Possible types: * **VOUCHER** - voucher used to pay the receipt - `details` TotalsReductionDetailsReceiptsV3 — Additional information of reductions - `voucherCode` string — The code of voucher associated with the receipt (contains only last 4 digits of code) - `gross` object, required — Gross value of reductions. This will lower the amountDue - `amount` number, required — Value of the monetary amount expressed in currency.
The number format expects a decimal point, like 10.99. Numbers without a decimal point are taken as a unit of the given currency, E.g. 10.05 EUR = 10 Euro and 5 Cent - `currency` string, required — Currency of monetary amount (ISO-4217) - `links` LinkReceiptsV3[] — Links related to the list. E.g. the link to the successive list used during paging. - `href` string — The url of the link - `rel` string — The relation type of the link. See also https://www.iana.org/assignments/link-relations/link-relations.xhtml. The relation type 'next' is used for paging. The relation type 'self' refers to the url of the resource ## Other responses - `401` — Unauthorized Access - `403` — Forbidden Access - `404` — Receipts Not Found --- [API](https://skmtc.dev/otto/apis/otto-market-api.md) · [All operations](https://skmtc.dev/otto/apis/otto-market-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/otto/otto-market-api/revisions/b1bc133112bd/schema)