> ## Documentation Index
> Fetch the complete documentation index at: https://docs.smartbills.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Put v1businesses receipts



## OpenAPI

````yaml /api-reference/openapi.json put /v1/businesses/{businessId}/receipts/{receiptId}
openapi: 3.0.4
info:
  title: Smartbills.API
  version: v1
servers:
  - url: https://api.smartbills.io
    description: Production
security: []
paths:
  /v1/businesses/{businessId}/receipts/{receiptId}:
    put:
      tags:
        - BusinessReceipts
      parameters:
        - name: businessId
          in: path
          required: true
          schema:
            type: integer
            format: int64
        - name: receiptId
          in: path
          required: true
          schema:
            type: integer
            format: int64
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DTOReceiptUpdateRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/DTOReceiptUpdateRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/DTOReceiptUpdateRequest'
      responses:
        '200':
          description: OK
components:
  schemas:
    DTOReceiptUpdateRequest:
      type: object
      properties:
        businessId:
          type: integer
          format: int64
          nullable: true
        employeeId:
          type: integer
          format: int64
          nullable: true
        customer:
          $ref: '#/components/schemas/DTOCustomerUpdateRequest'
        billingAddress:
          $ref: '#/components/schemas/DTOBillingAddress'
        shippingAddress:
          $ref: '#/components/schemas/DTOBillingAddress'
        items:
          type: array
          items:
            $ref: >-
              #/components/schemas/ReceiptsReceiptItemsTransactionLineItemUpdateRequest
          nullable: true
        itemGroups:
          type: array
          items:
            $ref: >-
              #/components/schemas/ReceiptsReceiptItemsTransactionLineItemGroupUpdateRequest
          nullable: true
        currency:
          type: string
          nullable: true
        updatedAt:
          type: string
          format: date-time
        cancelledAt:
          type: string
          format: date-time
          nullable: true
        cancelReason:
          type: string
          nullable: true
        paymentStatus:
          type: string
          nullable: true
        totalDiscounts:
          type: number
          format: double
        taxes:
          type: array
          items:
            $ref: '#/components/schemas/TransactionsTaxesTransactionTaxUpdateRequest'
          nullable: true
        taxesIncluded:
          type: boolean
        totalTip:
          type: number
          format: double
        totalDuties:
          type: number
          format: double
        totalShipping:
          type: number
          format: double
        totalWeight:
          type: number
          format: double
        totalTaxes:
          type: number
          format: double
        total:
          type: number
          format: double
        subTotal:
          type: number
          format: double
        receiptMetadata:
          $ref: >-
            #/components/schemas/ReceiptsReceiptMetadataUpdateReceiptMetadataRequest
        locationId:
          type: integer
          format: int64
          nullable: true
        transactions:
          type: array
          items:
            $ref: >-
              #/components/schemas/ReceiptsReceiptPaymentsReceiptPaymentUpdateRequest
          nullable: true
        barcode:
          $ref: '#/components/schemas/DTOUpdateBarcodeDTO'
      additionalProperties: false
    DTOCustomerUpdateRequest:
      type: object
      properties:
        firstName:
          type: string
          nullable: true
        lastName:
          type: string
          nullable: true
        email:
          type: string
          nullable: true
        taxExempt:
          type: boolean
        tags:
          type: array
          items:
            type: string
          nullable: true
        currency:
          type: string
          nullable: true
        acceptsMarketing:
          type: boolean
        phoneNumber:
          type: string
          nullable: true
      additionalProperties: false
    DTOBillingAddress:
      type: object
      properties:
        firstName:
          type: string
          nullable: true
        lastName:
          type: string
          nullable: true
        name:
          type: string
          nullable: true
        address:
          $ref: '#/components/schemas/DTOAddress'
        company:
          type: string
          nullable: true
        phoneNumber:
          type: string
          nullable: true
        email:
          type: string
          nullable: true
      additionalProperties: false
    ReceiptsReceiptItemsTransactionLineItemUpdateRequest:
      type: object
      properties:
        productId:
          type: integer
          format: int64
          nullable: true
        groupId:
          type: integer
          format: int64
          nullable: true
        price:
          type: number
          format: double
        variantId:
          type: integer
          format: int64
          nullable: true
        quantity:
          type: number
          format: double
        totalDiscount:
          type: number
          format: double
        totalDuties:
          type: number
          format: double
        total:
          type: number
          format: double
        totalTaxes:
          type: number
          format: double
        subTotal:
          type: number
          format: double
        discounts:
          type: array
          items:
            $ref: >-
              #/components/schemas/TransactionsLineItemsTransactionLineItemDiscountRequest
          nullable: true
        taxes:
          type: array
          items:
            $ref: '#/components/schemas/TransactionsTaxesTransactionTaxUpdateRequest'
          nullable: true
        taxable:
          type: boolean
      additionalProperties: false
    ReceiptsReceiptItemsTransactionLineItemGroupUpdateRequest:
      type: object
      properties:
        id:
          type: integer
          format: int64
          nullable: true
        name:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
        displayOrder:
          type: integer
          format: int32
        lineItems:
          type: array
          items:
            $ref: >-
              #/components/schemas/ReceiptsReceiptItemsTransactionLineItemUpdateRequest
          nullable: true
      additionalProperties: false
    TransactionsTaxesTransactionTaxUpdateRequest:
      type: object
      properties:
        taxId:
          type: integer
          format: int64
          nullable: true
        name:
          type: string
          nullable: true
        totalAmount:
          $ref: '#/components/schemas/DTOMoney'
        percentage:
          type: number
          format: double
          nullable: true
      additionalProperties: false
    ReceiptsReceiptMetadataUpdateReceiptMetadataRequest:
      type: object
      properties:
        landingSite:
          type: string
          nullable: true
        customerLocale:
          type: string
          nullable: true
        refferingSite:
          type: string
          nullable: true
        sourcePOS:
          type: string
          nullable: true
        sourceName:
          type: string
          nullable: true
        tags:
          type: string
          nullable: true
        url:
          type: string
          nullable: true
        browserMetadata:
          $ref: '#/components/schemas/ReceiptsReceiptMetadataUpdateBrowserMetadataDTO'
      additionalProperties: false
    ReceiptsReceiptPaymentsReceiptPaymentUpdateRequest:
      type: object
      additionalProperties: false
    DTOUpdateBarcodeDTO:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/ModelsSBBarcodeType'
        text:
          type: string
          nullable: true
      additionalProperties: false
    DTOAddress:
      type: object
      properties:
        line1:
          type: string
          nullable: true
        line2:
          type: string
          nullable: true
        city:
          type: string
          nullable: true
        state:
          type: string
          nullable: true
        stateCode:
          type: string
          nullable: true
        country:
          type: string
          nullable: true
        countryCode:
          type: string
          nullable: true
        postalCode:
          type: string
          nullable: true
        location:
          $ref: '#/components/schemas/AddressesCoordinates'
        googlePlaceId:
          type: string
          nullable: true
        formattedAddress:
          type: string
          nullable: true
      additionalProperties: false
    TransactionsLineItemsTransactionLineItemDiscountRequest:
      type: object
      properties:
        promoCodeId:
          type: integer
          format: int64
        amount:
          $ref: '#/components/schemas/DTOMoney'
        percentage:
          type: number
          format: double
        type:
          $ref: '#/components/schemas/ModelsPromoCodesSBPromoCodeType'
        name:
          type: string
          nullable: true
      additionalProperties: false
    DTOMoney:
      type: object
      properties:
        amount:
          type: number
          format: double
        currency:
          type: string
          nullable: true
        conversion:
          $ref: '#/components/schemas/DTOMoneyConversion'
      additionalProperties: false
    ReceiptsReceiptMetadataUpdateBrowserMetadataDTO:
      type: object
      properties:
        acceptLanguage:
          type: string
          nullable: true
        browserHeight:
          type: integer
          format: int64
        browserIp:
          type: string
          nullable: true
        browserWidth:
          type: integer
          format: int64
        sessionHash:
          type: string
          nullable: true
        userAgent:
          type: string
          nullable: true
      additionalProperties: false
    ModelsSBBarcodeType:
      enum:
        - AZTEC
        - CODABAR
        - CODE_39
        - CODE_93
        - CODE_128
        - DATA_MATRIX
        - EAN_8
        - EAN_13
        - ITF
        - MAXICODE
        - PDF_417
        - QR_CODE
        - RSS_14
        - RSS_EXPANDED
        - UPC_A
        - UPC_E
        - ALL_1_D
        - UPC_EAN_EXTENSION
        - MSI
        - PLESSEY
        - IMB
        - PHARMA_CODE
      type: string
    AddressesCoordinates:
      type: object
      properties:
        longitude:
          type: number
          format: double
        latitude:
          type: number
          format: double
      additionalProperties: false
    ModelsPromoCodesSBPromoCodeType:
      enum:
        - PERCENTAGE
        - AMOUNT
      type: string
    DTOMoneyConversion:
      type: object
      properties:
        originalAmount:
          type: number
          format: double
        originalCurrency:
          type: string
          nullable: true
        exchangeRate:
          type: number
          format: double
        convertedAt:
          type: string
          format: date-time
      additionalProperties: false

````