FYLE-2hwr6bb

reference/admin.yaml

@@ -6539,6 +6539,157 @@ components:
           description: >
             Determines whether this organization has been verified by a
             verifier.
+    statements_in:
+      type: object
+      properties:
+        file_id:
+          allOf:
+            - $ref: '#/components/schemas/id_string'
+          example: fidftadfdsdf
+      required:
+        - file_id
+    statements_out:
+      type: object
+      additionalProperties: false
+      properties:
+        id:
+          allOf:
+            - $ref: '#/components/schemas/id_string'
+          example: stmtwownwrng
+        org_id:
+          $ref: '#/components/schemas/org_id'
+        user_id:
+          $ref: '#/components/schemas/user_id'
+        created_at:
+          $ref: '#/components/schemas/created_at'
+        updated_at:
+          $ref: '#/components/schemas/updated_at'
+        file_name:
+          type: string
+          description: |
+            Specifies the name of file uploaded by the user.
+          example: amex.csv
+        file_size:
+          type: number
+          description: >
+            Specifies the size of file uploaded by the user. (The size is
+            represented in bytes)
+          example: 21
+        no_of_debit:
+          type: integer
+          description: |
+            Number of debit transactions in the statement uploaded by the user.
+          example: 3
+        no_of_credit:
+          type: integer
+          description: |
+            Number of credit transactions in the statement uploaded by the user.
+          example: 3
+        no_of_transactions:
+          type: integer
+          description: |
+            Number of transactions in the statement uploaded by the user.
+          example: 6
+        all_statement_columns:
+          type: array
+          items:
+            type: string
+          description: |
+            This specifies headers of the statement uploaded by the user.
+          example:
+            - account_number
+            - amount
+        start_date:
+          $ref: '#/components/schemas/timestamptz_utc'
+          description: |
+            Start date of the statement period
+          nullable: true
+        end_date:
+          $ref: '#/components/schemas/timestamptz_utc'
+          description: |
+            End date of the statement period
+          nullable: true
+        has_duplicate_statements:
+          type: boolean
+          description: |
+            Indicates whether the statement is completely duplicate or not.
+        duplicate_statement_ids:
+          type: array
+          description: >-
+            Holds the list of statement_ids which are complete duplicate of the
+            current statement
+          items:
+            $ref: '#/components/schemas/id_string'
+          example:
+            - stmtge49ielgel
+          nullable: true
+        has_duplicate_statement_line_items:
+          type: boolean
+          description: >
+            Indicates whether there are any line items in this statement are
+            duplicates.
+        duplicate_statement_line_items:
+          type: array
+          items:
+            type: object
+            properties:
+              ids:
+                type: array
+                items:
+                  $ref: '#/components/schemas/id_string'
+                example:
+                  - stlige49ielgel
+                description: Ids of the current statement line items which are duplicates
+                nullable: true
+              duplicate_line_item_statement_id:
+                type: string
+                description: |
+                  Id of the existing duplicate statement
+                example:
+                  - stmpge49ielgel
+                nullable: true
+        unique_id:
+          type: string
+          description: |
+            Unique hash value that is used to identify the statement.
+          example: 74175aadf22675aa59df28b96d351cfb
+        file_id:
+          type: string
+          description: |
+            File id of the uploaded statement.
+          example: fiit3pX9gzzP
+        is_corporate_card_transactions_created:
+          type: boolean
+          description: >
+            Indicates whether the corporate card transactions are created out of
+            the statement.
+        statement_mappings_id:
+          type: string
+          example: stmpdfddfd
+          description: |
+            Id of the mapping used to extract transaction from the statement.
+          nullable: true
+      required:
+        - id
+        - org_id
+        - user_id
+        - created_at
+        - updated_at
+        - file_name
+        - file_size
+        - no_of_debit
+        - no_of_credit
+        - no_of_transactions
+        - all_statement_columns
+        - start_date
+        - end_date
+        - has_duplicate_statements
+        - has_duplicate_statement_line_items
+        - duplicate_statement_ids
+        - duplicate_statement_line_items
+        - unique_id
+        - file_id
+        - is_corporate_card_transactions_created
   parameters:
     created_at:
       in: query
@@ -6614,6 +6765,10 @@ tags:
     description: >
       This API gives you access to manage your organisation's Corporate Card
       Transaction data.
+  - name: Statements
+    description: >
+      These APIs gives you access to add / view a bank statement for
+      reconciliation.
   - name: Cost Centers
     description: >
       These APIs gives you access to manage your organisation's Cost Centers
@@ -9883,3 +10038,57 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/401'
+  /admin/statements/upload:
+    post:
+      tags:
+        - Statements
+      summary: Upload a statement
+      description: >
+        upload a corporate card statement(csv or excel) to Fyle for
+        reconciliation.
+      operationId: statements_post
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                data:
+                  $ref: '#/components/schemas/statements_in'
+              required:
+                - data
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data:
+                    $ref: '#/components/schemas/statements_out'
+        '400':
+          description: Bad request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/400'
+        '401':
+          description: Unauthorized request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/401'
+        '403':
+          description: Forbidden
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/403'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/404'

src/admin/openapi.yaml

@@ -48,6 +48,9 @@ tags:
   - name: Corporate Card Transactions
     description: |
       This API gives you access to manage your organisation's Corporate Card Transaction data.
+  - name: Statements
+    description: >
+      These APIs gives you access to add / view a bank statement for reconciliation.
   - name: Cost Centers
     description: >
       These APIs gives you access to manage your organisation's Cost Centers
@@ -236,3 +239,5 @@ paths:
     $ref: paths/admin@budget_usages.yaml
   /admin/orgs:
     $ref: paths/admin@orgs.yaml
+  /admin/statements/upload:
+    $ref: paths/admin@statements@upload.yaml

src/admin/paths/admin@statements@upload.yaml

@@ -0,0 +1,52 @@
+post:
+  tags:
+    - Statements
+  summary: Upload a statement
+  description: |
+    upload a corporate card statement(csv or excel) to Fyle for reconciliation.
+  operationId: statements_post
+  requestBody:
+    required: true
+    content:
+      application/json:
+        schema:
+          type: object
+          properties:
+            data:
+              $ref: '../../components/schemas/statements.yaml#/statements_in'
+          required:
+            - data
+  responses:
+    '200':
+      description: OK
+      content:
+        application/json:
+          schema:
+            type: object
+            properties:
+              data:
+                $ref: '../../components/schemas/statements.yaml#/statements_out'
+    '400':
+      description: Bad request
+      content:
+        application/json:
+          schema:
+            $ref: '../../components/schemas/400.yaml'
+    '401':
+      description: Unauthorized request
+      content:
+        application/json:
+          schema:
+            $ref: '../../components/schemas/401.yaml'
+    '403':
+      description: Forbidden
+      content:
+        application/json:
+          schema:
+            $ref: '../../components/schemas/403.yaml'
+    '404':
+      description: Not Found
+      content:
+        application/json:
+          schema:
+            $ref: '../../components/schemas/404.yaml'