> ## Documentation Index > Fetch the complete documentation index at: https://andcze.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Walidacja kodu rabatowego dla koszyka > Wycena serwerowa tą samą funkcją co kasa (cena wariantu/metody → rabat → VAT). Dla kilku pozycji rabat liczy się raz na koszyk i rozkłada proporcjonalnie na pozycje objęte kodem (`lines[].discountShare`, suma do grosza). Niepoprawny kod to `valid: false`, nie błąd. Nie rezerwuje użycia kodu. ## OpenAPI ````yaml /openapi.pl.json post /api/v2/storefront/v1/shops/{shopId}/discounts/validate openapi: 3.0.0 info: title: ItemShop v2 API description: >- REST API platformy ItemShop v2 (NestJS + Fastify). Wszystkie ścieżki mają prefiks /api/v2. version: 2.0.0 contact: {} servers: - url: https://itemshop.dev description: Produkcja (API pod /api/v2, ten sam origin co panel) - url: http://localhost:3000 description: Lokalnie security: [] tags: [] paths: /api/v2/storefront/v1/shops/{shopId}/discounts/validate: post: tags: - Storefront v1 summary: Walidacja kodu rabatowego dla koszyka description: >- Wycena serwerowa tą samą funkcją co kasa (cena wariantu/metody → rabat → VAT). Dla kilku pozycji rabat liczy się raz na koszyk i rozkłada proporcjonalnie na pozycje objęte kodem (`lines[].discountShare`, suma do grosza). Niepoprawny kod to `valid: false`, nie błąd. Nie rezerwuje użycia kodu. operationId: validateDiscount parameters: - name: shopId required: true in: path description: >- ID sklepu (ObjectId). Przyjmuje też `uniqueName`, aktywną własną domenę albo `.`. schema: type: string example: 664f1a2b3c4d5e6f7a8b9c0d requestBody: content: application/json: schema: $ref: '#/components/schemas/StorefrontValidateDiscountDto' responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/StorefrontDiscountQuoteResponseDto' '400': description: >- `VALIDATION_FAILED`, `CART_EMPTY`, `CART_TOO_LARGE`, `INVALID_QUANTITY`, `PRODUCT_VARIANT_REQUIRED`… content: application/json: schema: $ref: '#/components/schemas/StorefrontErrorDto' '403': description: Pochodzenie (Origin) spoza domen sklepu (`ORIGIN_NOT_ALLOWED`) content: application/json: schema: $ref: '#/components/schemas/StorefrontErrorDto' '404': description: >- Sklep/zasób nie istnieje albo sklep jest zablokowany (`SHOP_NOT_FOUND`, `PRODUCT_NOT_FOUND`, `ORDER_NOT_FOUND`) content: application/json: schema: $ref: '#/components/schemas/StorefrontErrorDto' '429': description: Przekroczony limit żądań (`RATE_LIMITED`) content: application/json: schema: $ref: '#/components/schemas/StorefrontErrorDto' components: schemas: StorefrontValidateDiscountDto: type: object properties: code: type: string minLength: 1 maxLength: 50 pattern: ^[A-Za-z0-9_-]+$ example: LATO10 items: minItems: 1 maxItems: 20 description: >- Pozycje koszyka (1–20). Kilka pozycji = grupa płatności: jedno zamówienie na pozycję i jedna płatność na sumę (adr/0002) type: array items: $ref: '#/components/schemas/StorefrontCartItemDto' paymentMethodCode: type: string minLength: 1 maxLength: 100 description: Metoda płatności — produkt może mieć dla niej inną cenę example: imoje required: - code - items StorefrontDiscountQuoteResponseDto: type: object properties: success: type: boolean example: true data: $ref: '#/components/schemas/StorefrontDiscountQuoteDto' required: - success - data StorefrontErrorDto: type: object properties: success: type: boolean example: false statusCode: type: number example: 404 code: enum: - VALIDATION_FAILED - BAD_REQUEST - NOT_FOUND - SHOP_NOT_FOUND - PRODUCT_NOT_FOUND - ORDER_NOT_FOUND - PRODUCT_UNAVAILABLE - PRODUCT_VARIANT_REQUIRED - INVALID_PRODUCT_VARIANT - INVALID_QUANTITY - OUT_OF_STOCK - CART_EMPTY - NICK_REQUIRED - EMAIL_REQUIRED - CART_TOO_LARGE - DISCOUNT_INVALID - LEGAL_CONSENT_REQUIRED - LEGAL_DOCUMENTS_CHANGED - SHOP_PAYMENT_NOT_READY - PAYMENT_INIT_FAILED - ORDER_BLOCKED - RETURN_URL_NOT_ALLOWED - VOUCHER_NOT_FOUND - VOUCHER_USED - VOUCHER_EXPIRED - IDEMPOTENCY_KEY_REQUIRED - IDEMPOTENCY_KEY_REUSED - CHECKOUT_ATTEMPT_CLOSED - CHECKOUT_IN_PROGRESS - CAPTCHA_REQUIRED - ORIGIN_NOT_ALLOWED - FORBIDDEN - UNAUTHORIZED - PAYLOAD_TOO_LARGE - CONFLICT - RATE_LIMITED - SERVICE_UNAVAILABLE - INTERNAL_ERROR type: string description: Maszynowy kod błędu — tłumacz po nim komunikat w UI example: SHOP_NOT_FOUND message: type: string description: >- Komunikat dla dewelopera (język nieustalony, nie pokazuj go kupującemu) example: Shop not found error: type: string description: To samo co `message` (zgodność z resztą API) example: Shop not found deprecated: true details: type: object description: Szczegóły walidacji timestamp: type: string format: date-time example: '2026-10-27T12:00:00.000Z' path: type: string example: /api/v2/storefront/v1/shops/moj-sklep required: - success - statusCode - code - message - error - timestamp - path StorefrontCartItemDto: type: object properties: productId: type: string example: 664f1a2b3c4d5e6f7a8b9c0d quantity: type: number minimum: 1 maximum: 100000 example: 1 default: 1 variantId: type: string description: >- `variants[].id` (wymagany jeden z variantId/variant dla pricingMode = variants) example: 664f1a2b3c4d5e6f7a8b9c11 variant: type: string minLength: 1 maxLength: 80 description: Nazwa wariantu (zamiast variantId) example: 30 dni required: - productId StorefrontDiscountQuoteDto: type: object properties: valid: type: boolean example: true code: type: string nullable: true example: LATO10 reason: type: string nullable: true description: Powód odrzucenia (dla dewelopera) example: null subtotal: type: number description: Suma przed rabatem example: 39.98 discountAmount: type: number example: 4 total: type: number description: Do zapłaty (po rabacie i VAT) — tyle policzy kasa example: 35.98 currency: type: string example: PLN lines: description: >- Wycena pozycji w kolejności `items[]`; suma `total` pozycji = `total` type: array items: $ref: '#/components/schemas/StorefrontQuoteLineDto' required: - valid - code - reason - subtotal - discountAmount - total - currency - lines StorefrontQuoteLineDto: type: object properties: productId: type: string example: 664f1a2b3c4d5e6f7a8b9c0d subtotal: type: number description: Przed rabatem example: 19.99 discountShare: type: number description: >- Część rabatu koszyka przypadająca na pozycję (proporcjonalnie do wartości, do grosza) example: 2 total: type: number description: Do zapłaty za pozycję (po rabacie i VAT) example: 17.99 required: - productId - subtotal - discountShare - total ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.