--- title: "View credit note V3" method: GET path: "/api/v3/creditNotes/{id}" tags: ["CreditNote"] --- # View credit note V3 `GET /api/v3/creditNotes/{id}` This endpoint requires the following scopes: `creditNote:read`. View a single credit note. **Content Negotiation:** This endpoint supports additional response formats: `application/pdf`. Use the `Accept` header to request a specific format. ## Path parameters - `id` string, required ## Query parameters - `include` string[] ## Response `200` View a single credit note. - object - `data` object — Credit note document - `id` string — ID of the document - `documentNumber` string — Document number. For drafts, this will be null. - `documentDate` string, date — Main date of the document. - `writeProtection` boolean — Indicates if the document is write protected. - `customerNumber` string — Customer number of the document. - `address` union — Address entity of the document. By default, only the ID is returned. To get the full Address object, use the `include` parameter. - object - `id` string, required - `isDeleted` boolean — Flagged if the entry was deleted. - `createdAt` string, date-time, required — Creation timestamp - `updatedAt` string, date-time, required — Last update timestamp - object - `id` string - `project` union — Project entity of the document. By default, only the ID is returned. To get the full Project object, use the `include` parameter. - object - `id` string, required - `name` string, required - `abbreviation` string, required - object - `id` string - `tags` object[] — Tags assigned to the document. This property is only returned if the `tags` include is used. - `id` string — ID of the tag - `title` string — Title of the tag - `documentAddress` object — The recipients postal address of the document. This is is usually the postal address of the document's address entitiy, (e.g. customer), or is populated based on the preceding document. As this address is persisted on the document level, it can however be modified independently, and does not reflect changes that occurred since the document was created. - `name` string, required — Represents an address consisting of a physical address and contact information. It is used in various documents, such as invoices, delivery notes, etc. - `type` 'mrs' | 'mr' | 'company' | 'other' - `title` string - `contactPerson` string - `department` string - `subDepartment` string - `addressSupplement` string - `street` string - `zipCode` string - `city` string - `state` string - `country` string - `salutation` string - `gln` string - `email` string - `phone` string - `fax` string - `mobile` string - `internalDesignation` string — Internal designation, might be displayed in the letterhead. - `isDocumentSent` boolean — Indicates if the document has been sent to the recipient. - `language` string — ISO 639-1 Language of the document. - `bodyIntroduction` string — Text displayed on the document before the line items. - `bodyOutroduction` string — Text displayed on the document after the line items. - `vatId` string — VAT ID of the document. - `deliveryTerms` string — Delivery terms of the document. - `internalComment` string — Internal comment, does not show up on the document. Intended to be used for company-internal notes. - `editor` object - `id` string — ID of the user who is responsible for the document. - `printSettings` object - `withoutLetterhead` boolean — For PDFs or physical documents, hide the letterhead - `withoutProductText` boolean — For PDFs or physical documents, hide the product text - `activity` object[] — Activity log entries associated with the document. To get activity object, use the `include` parameter. - `message` string, required - `causer` string, required - `causedAt` string, date-time, required - `customFields` object[] — Custom fields with their values and metadata - `key` string - `value` string - `label` string - `updatedAt` string, date-time - `createdAt` string, date-time - `financials` object — Financials properties of the document - `paymentMethod` object — Payment method of the document. This is a reference to the payment method used for the document. - `id` string - `paymentTerms` object — Payment terms of the document - `paymentTargetDays` integer - `paymentTargetDiscount` number, float - `paymentTargetDiscountDays` integer - `tax` object — Tax properties of the document - `taxation` 'domestic' | 'eu' | 'export' | 'exempt' — Taxation of the document, e.g. "domestic" or "eu". - `disableTaxNotice` boolean — Indicates if the tax notice should be disabled for this document. - `taxRates` object — Tax rates of the document. These values cannot be edited directly via the Xentral UI, and are set based on the tax settings and the delivery or billing region. - `standard` number, float - `reduced` number, float - `currency` string — Currency of the document as an ISO 4217 code, e.g. "EUR" or "USD". - `exchangeRate` unknown - `totals` object — Totals of the document. These values cannot be set directly, but are calculated based on the line items - `net` object — Money - `amount` union - string - number - `currency` string — Currency - `gross` object — Money - `amount` union - string - number - `currency` string — Currency - `contributionMargin` number, float — Contribution margin of the document. - `invoice` object — invoice reference. - `id` string — ID of the invoice - `sales` object — Sales person responsible for the document. - `id` string - `customerOrderNumber` string — Customer order number of the credit note, e.g. the customer's order number. - `deviatingDebtorAccountNumber` string — Deviating debtor account number for the credit note. Used for accounting export. - `deliveryDate` string, date — Delivery date of the credit note. - `isCancellationInvoice` boolean — Credit note is marked as cancellation invoice. - `paymentStatus` 'pending' | 'paid' | 'partiallyPaid' | 'cancelled' | 'partiallyCancelled' | 'badDebt' | 'debited' — Payment status of the credit note. - `debtStatus` object — debt status of the credit note. - `doneAt` string, date — Date of debt done at. - `comment` string — Internal comment regarding debt. - `lineItems` union[] - union - object — Credit Note Line Item - `type` 'product' - `id` string — ID of the line item. - `number` string — The Number of the line item. Usually the product SKU, but can be adjusted if required. - `name` string — The name of the line item. Usually the product name, but can be adjusted if required. - `description` string — The description of the line item. Usually the product description, but can be adjusted if required. - `quantity` number, float — The quantity of the line item. - `product` union — The product of the line item. - object - … - object - … - `countryOfOrigin` unknown - `hsCode` unknown - `customFields` object[] — Custom fields with their values and metadata. - `key` string - `value` string - `label` string - `unit` string — The unit of the line item. - `deliveryDate` string, date — The delivery date of the line item. - `deliveryDateAsCalendarWeek` boolean — Whether to show the delivery date as calendar week or explicit. - `packagingUnit` string — The unit of packaging for the line item. - `internalComment` string — Internal comment, does not show up on the document. Intended to be used for company-internal notes. - `customerProductNumber` string — Customer product number for the line item. - `order` integer — The ordering sequence of the line item. - `updatedAt` string, date-time — The date and time when the line item was last updated. - `createdAt` string, date-time — The date and time when the line item was created. - `taxRate` union — Tax rate type applied to this line item - 'standard' | 'reduced' | 'exempt' - number, float - `effectiveTaxRate` number, float — Effective tax rate for this line item - `price` object — Price information for this line item - `net` object — Money - … - `gross` object — Money - … - `discount` number, float — Discount percentage applied to this line item - `itemRevenue` object — Total revenue for all quantities of this line item - `net` object — Money - … - `gross` object — Money - … - `lineItemRevenue` object — Revenue for a single unit of this line item - `net` object — Money - … - `gross` object — Money - … - `purchasePrice` object — Purchase price information for this line item - `net` object — Money - … - `contributionMargin` number, float — Contribution margin for this line item - `taxLegalNotice` string — Legal notice regarding tax for this line item - `printSettings` object — Print settings for this line item. - `withoutPrice` boolean — Hide the prices for this line item when printing. - `hidden` boolean — Hide this line item when printing. - `salesOrderLineItem` object — sales order line item reference. - `id` string — ID of the line item - object - `id` string, required - `order` integer — The ordering sequence of the line item - `type` 'heading', required - `name` string - `description` string - object - `id` string, required - `order` integer — The ordering sequence of the line item - `type` 'subtotal', required - `name` string - `description` string - object - `id` string, required - `order` integer — The ordering sequence of the line item - `type` 'group_total', required - `name` string - `description` string - object - `id` string, required - `order` integer — The ordering sequence of the line item - `type` 'image', required - `name` string - `description` string - `image` object - `id` string - `imageHeight` unknown - `imageWidth` unknown - object - `id` string, required - `order` integer — The ordering sequence of the line item - `type` 'page_break', required - `costCenter` string — Cost center of the document. ## Other responses - `401` — Unauthorized - `403` — Forbidden - `404` — Not Found - `429` — Too Many Requests --- [API](https://skmtc.net/xentral/apis/xentral-api.md) · [All operations](https://skmtc.net/xentral/apis/xentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xentral/xentral-api/versions/8a27ba392442/schema)