Alkimia/Usecases/payment

From KDE Community Wiki

PAYMENT DETECTION

INTRODUCTION

As soon KMyMoney or Skrooge becomes aware of an incoming payment, either through online banking or manual entry, it should

  1. try to detect an unique identifier
  2. validate if there is an expected payment filed with this unique identifier
  3. if so, let the user validate if the detection is correct (optional)
  4. mark the payment to be received

Example: Elena issues an invoice with Kraft over 364 Euro, due in 10 days. She marks the invoice to be sent in Kraft. In KMyMoney and Skrooge the amount of 364 Euro shows up as expected money together with the document id number, date and addressee of the invoice. Four days later, Elena checks the accounts via online banking. One transaction record contains the document id and the finance manager asks Elena if she can confirm that this is the money paying the invoice. She confirms that.\\Next time she starts Kraft she sees that the invoice is marked as payed.

ACTORS

  1. USER
  2. Finance Manager

PRECONDITIONS

  1. must have an installed financial manager.
  2. law requirements must met for document identifier of the incoming voice.
  3. The coming invoice must have a unique identifier attached to it.

BASIC FLOW

  1. open the list of unchecked invoices.
  2. check the unique identifier any of the invoice and see which document type it is.
    • The data which is used for detection should come as Key-Value pairs from the client, for example kraft would send this for a document:
      Document-ID:4711
      Name: Strawinsky
      First Name: Elena
      Document Type: Invoice
    • The Alkimia Service in turn would associate the strings with the created transaction.When a payment comes in, it searches for the strings "4711", "Strawinsky", "Elena" and "Invoice". If it finds for example "Elena", it would ask the user something like: "The online banking record XY contains the word Elena which is associated as First Name with the transaction Z.
      This transaction expects a payment.
      Is that online record representing the payment for the transaction?"
  3. Ask user if the expected payment is filed with the unique identifier.
  4. If the user validates it then mark the payment to be received.
  5. update the changes.

ALTERNATE FLOW

  1. If the user says the unique identifier is invalid, then send the invoice to a “ invalid invoices" folder



USE CASE DIAGRAM

[usecase diagram]



DATA MODEL

ER Diagram

[ER Diagram]

Entities

USER

Attributes

  1. No. Of Pending Invoices : No. of invoices the user hasnt marked yet or haven't declared yet if they are valid or invalid

INVOICE

Attributes

  1. mark: If the invoice is marked or not.If the invoice is marked it means the user has validated it(marked it as valid or invalid).
  2. valid: If the invoice received is valid or invalid
  3. payment: The amount of payment related with the invoice.
  4. Unique Identifier: The unique identifier related to each invoice. It would be different for each and every invoice.It will also tell us about the type of invoice.