Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

FYLE-2hwr6bb #151

Open
wants to merge 15 commits into
base: main
Choose a base branch
from
Open

FYLE-2hwr6bb #151

wants to merge 15 commits into from

Conversation

Kulsekar4
Copy link
Contributor

@Kulsekar4 Kulsekar4 commented Apr 6, 2022

summary: Upload a statement
description: |
Upload a statement to Fyle for reconciliation.
operationId: statements_post
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

try to understand what and where this is used

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Got it, this is a unique string used to identify an operation.
Addl info: Some code generators use this value to name the corresponding methods in code.

has_statement_duplicate:
type: boolean
description: |
Determines whether the statement is duplicate or not.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Determines whether the statement is completely duplicate or not.

has_statement_line_items_duplicate:
type: boolean
description: |
Determines whether the transaction inside the statement is duplicate or not.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

instead of Determines can use
indicates whether there are any line items in this statement are duplicates.

type: number
description: |
Specifies the size of file uploaded by the user.
example: 21KB
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will have to mention what is the default size, is it bytes (or) MB (or) KB.

Also, it is a number so it cannot be 21KB, it just has to be 21.

Is this expected or do we need to take this as text @Kulsekar4 ?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Number is only expected here sir, will remove the KB

file_id:
type: string
description: |
Id of the uploaded statement.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

file id of the upload statement.

no_of_debit:
type: integer
description: |
Number of debit transactions in the document uploaded by the user.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we use statement everywhere instead of using document pls ?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Okay sir

type: integer
description: |
Number of transactions in the document uploaded by the user.
example: 3
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

example: 6

Because above examples of credit and debit are 3 each

has_statement_duplicate:
type: boolean
description: |
Determines whether the statement is completely duplicate or not.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Determines -> Indicates

type: string
description: |
Id of the uploaded statement.
is_ccc_created:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not added in doc, pls to update it. Need to check with the naming.

We can avoid using abbreviations like ccc pls ?

Maybe something like are_corporate_card_transactions_created_from_statement ?

Pls to discuss with Gokul / Adi on the naming here

- Statements
summary: Upload a statement
description: |
Upload a statement to Fyle for reconciliation.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

upload a corporate card statement(csv or excel)

description: |
End date of the statement period
nullable: true
has_statement_duplicate:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

rename to is_statement_duplicate

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

has_duplicate_statements

duplicate_statement_ids:
type: array
description:
Holds the list of statement_ids which are duplicate to the current statement

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Holds the list of statement_ids which are complete duplicate of the current statement

example:
- stmtge49ielgel
nullable: true
has_statement_line_items_duplicate:

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

rename to has_duplicate_statement_line_items

unique_id:
type: string
description: |
Unique key that is used to identify the statement.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unique hash value that is used to identify the statement.

- Statements
summary: Upload a statement
description: |
upload a corporate card statement(csv or excel) to Fyle for reconciliation.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

upload -> Upload

has_duplicate_statements:
type: boolean
description: |
Indicates whether the statement is completely duplicate or not.
Copy link
Contributor

@modernwarfareuplink modernwarfareuplink May 25, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

p2 | Pls check if you can rephrase this.

description: |
File id of the uploaded statement.
example: fiit3pX9gzzP
is_corporate_card_transactions_created:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

p2 | Pls check if we can change this from is_corporate_card_transactions_created to are_corporate_card_transactions_created as they are plural

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

proceeding with is_corporate_card_transactions_created only sir, as the transactions indicates the plural form here

- has_duplicate_statements
- has_duplicate_statement_line_items
- duplicate_statement_ids
- duplicate_statement_line_items
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pls add statement_mappings_id in the required

@@ -6539,6 +6539,163 @@ components:
description: >
Determines whether this organization has been verified by a
verifier.
statements_in:
Copy link
Contributor Author

@Kulsekar4 Kulsekar4 May 25, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Summary :
Have added not null constraint for -> also have added in doc and script @modernwarfareuplink sir
file_name
file_size
no_of_debit
no_of_credit
no_of_transactions

example: stmtwownwrng
org_id:
$ref: './fields.yaml#/org_id'
user_id:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

creator_user_id

example:
- account_number
- amount
nullable: true
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nullable: false

description: |
Unique hash value that is used to identify the statement.
example: 74175aadf22675aa59df28b96d351cfb
nullable: true
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nullable: false

fill existing with dummy values if you have to cc: @modernwarfareuplink

Copy link
Contributor

@modernwarfareuplink modernwarfareuplink left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants