# Status Change C/N Request

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v0/cd-note/req-status-change:
    post:
      summary: Status Change C/N Request
      deprecated: false
      description: >-

        :::highlight purple 💡

        Use this API to update the status of an existing Credit Note or Debit
        Note (C/N) request in your EnKash account.

        This allows you to mark a C/N as approved, rejected, settled, or any
        other supported status, keeping your financial records accurate and your
        workflows aligned.

        Additionally, any status updates are synchronized with Bharat Connect,
        ensuring all parties have real-time visibility into the current state of
        the C/N.

        :::
      tags:
        - Bharat Connect (BBPS)/APIs - BBPS/Vendor Payment/Credit Note
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StatusChangeCdNoteRequest'
            examples: {}
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  payload:
                    type: string
                  response_code:
                    type: integer
                  response_message:
                    type: string
                required:
                  - payload
                  - response_code
                  - response_message
                x-apidog-orders:
                  - payload
                  - response_code
                  - response_message
                x--orders:
                  - payload
                  - response_code
                  - response_message
                x--ignore-properties: []
              example:
                payload: SUCCESS
                response_code: 0
                response_message: SUCCESS
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Bharat Connect (BBPS)/APIs - BBPS/Vendor Payment/Credit Note
      x-apidog-status: developing
      x-run-in-apidog: https://app.apidog.com/web/project/616243/apis/api-10668182-run
components:
  schemas:
    StatusChangeCdNoteRequest:
      type: object
      properties:
        device:
          type: object
          properties:
            tag:
              type: object
              properties:
                name:
                  type: string
                  enum:
                    - GEOCODE
                    - IP
                    - AGENTID
                  x-apidog-enum:
                    - value: GEOCODE
                      name: ''
                      description: ''
                    - value: IP
                      name: ''
                      description: ''
                    - value: AGENTID
                      name: ''
                      description: ''
                value:
                  type: string
              required:
                - name
                - value
              x-apidog-orders:
                - name
                - value
              x--orders:
                - name
                - value
              x--ignore-properties: []
          required:
            - tag
          x-apidog-orders:
            - tag
          x--orders:
            - tag
          x--ignore-properties: []
        b2bIds:
          type: object
          properties:
            buyerB2BId:
              type: string
            supplierB2BId:
              type: string
          required:
            - buyerB2BId
            - supplierB2BId
          x-apidog-orders:
            - buyerB2BId
            - supplierB2BId
          x--orders:
            - buyerB2BId
            - supplierB2BId
          x--ignore-properties: []
        cdNoteStatus:
          type: object
          properties:
            objectId:
              type: string
            noteType:
              type: string
            supplierCDNoteNumber:
              type: string
            objectVersion:
              type: object
              properties:
                currentVersion:
                  type: integer
                newVersion:
                  type: integer
              required:
                - currentVersion
                - newVersion
              x-apidog-orders:
                - currentVersion
                - newVersion
              x--orders:
                - currentVersion
                - newVersion
              x--ignore-properties: []
            supplierAction:
              type: string
            supplierRemarks:
              type: string
            cdNoteStatusTransition:
              type: object
              properties:
                currentStatus:
                  type: string
                  enum:
                    - CREATED
                    - SENT TO BUYER
                    - ACCEPTED
                    - REJECTED
                    - UNDER REVIEW
                    - CANCELLED
                    - DELETED
                    - PARTIALLY PAID
                    - FULLY PAID
                    - CLOSED
                    - ABANDONED
                    - PAYMENT INITIATED
                    - PARTIALLY PAID AND PAYMENT INITIATED
                  x-apidog-enum:
                    - value: CREATED
                      name: ''
                      description: ''
                    - value: SENT TO BUYER
                      name: ''
                      description: ''
                    - value: ACCEPTED
                      name: ''
                      description: ''
                    - value: REJECTED
                      name: ''
                      description: ''
                    - value: UNDER REVIEW
                      name: ''
                      description: ''
                    - value: CANCELLED
                      name: ''
                      description: ''
                    - value: DELETED
                      name: ''
                      description: ''
                    - value: PARTIALLY PAID
                      name: ''
                      description: ''
                    - value: FULLY PAID
                      name: ''
                      description: ''
                    - value: CLOSED
                      name: ''
                      description: ''
                    - value: ABANDONED
                      name: ''
                      description: ''
                    - value: PAYMENT INITIATED
                      name: ''
                      description: ''
                    - value: PARTIALLY PAID AND PAYMENT INITIATED
                      name: ''
                      description: ''
                newStatus:
                  type: string
                  enum:
                    - CREATED
                    - SENT TO BUYER
                    - ACCEPTED
                    - REJECTED
                    - UNDER REVIEW
                    - CANCELLED
                    - DELETED
                    - PARTIALLY PAID
                    - FULLY PAID
                    - CLOSED
                    - ABANDONED
                    - PAYMENT INITIATED
                    - PARTIALLY PAID AND PAYMENT INITIATED
                  x-apidog-enum:
                    - value: CREATED
                      name: ''
                      description: ''
                    - value: SENT TO BUYER
                      name: ''
                      description: ''
                    - value: ACCEPTED
                      name: ''
                      description: ''
                    - value: REJECTED
                      name: ''
                      description: ''
                    - value: UNDER REVIEW
                      name: ''
                      description: ''
                    - value: CANCELLED
                      name: ''
                      description: ''
                    - value: DELETED
                      name: ''
                      description: ''
                    - value: PARTIALLY PAID
                      name: ''
                      description: ''
                    - value: FULLY PAID
                      name: ''
                      description: ''
                    - value: CLOSED
                      name: ''
                      description: ''
                    - value: ABANDONED
                      name: ''
                      description: ''
                    - value: PAYMENT INITIATED
                      name: ''
                      description: ''
                    - value: PARTIALLY PAID AND PAYMENT INITIATED
                      name: ''
                      description: ''
              required:
                - currentStatus
                - newStatus
              x-apidog-orders:
                - currentStatus
                - newStatus
              x--orders:
                - currentStatus
                - newStatus
              x--ignore-properties: []
          required:
            - objectId
            - noteType
            - supplierCDNoteNumber
            - objectVersion
            - supplierAction
            - supplierRemarks
            - cdNoteStatusTransition
          x-apidog-orders:
            - objectId
            - noteType
            - supplierCDNoteNumber
            - objectVersion
            - supplierAction
            - supplierRemarks
            - cdNoteStatusTransition
          x--orders:
            - objectId
            - noteType
            - supplierCDNoteNumber
            - objectVersion
            - supplierAction
            - supplierRemarks
            - cdNoteStatusTransition
          x--ignore-properties: []
        additionalInfos:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              value:
                type: string
            x-apidog-orders:
              - name
              - value
            x--orders:
              - name
              - value
            x--ignore-properties: []
      required:
        - device
        - b2bIds
        - cdNoteStatus
        - additionalInfos
      x-apidog-orders:
        - device
        - b2bIds
        - cdNoteStatus
        - additionalInfos
      x--orders:
        - device
        - b2bIds
        - cdNoteStatus
        - additionalInfos
      x--ignore-properties: []
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```