Skip to content

Date Check Input in Number Recycling Conflicting with Tenure #39

Description

@luislopezcorpas

Problem description
The current implementation of the Number Recycle API has a discrepancy that affects its functionality. The API, as proposed by KDDI and approved in CAMARA, allows a customer to submit a recycle date check and receive a true/false response. However, the implementation should respond with true/false if the number has ever been recycled and provide the date if true. This difference causes a conflict with the tenure use case, making tenure almost redundant.

The Tenure use case would become almost redundant due to the discrepancy in the Number Recycle API response. Currently, the API should respond with "true/false" if the number has been recycled and provide the date if true. However, the current implementation only responds with "true/false" without providing the date. This causes a conflict with the Tenure use case, which also relies on the number recycling information.

If the Number Recycle API provided the recycling date along with the "true/false" response, it would eliminate the need for the Tenure use case to handle this information separately. This way, the Tenure functionality would be simplified, and there would be no redundancy in managing the number recycling information.

Expected behavior
The API should respond with true/false if the number has ever been recycled and provide the date if true.

Alternative solution

Response example
{
reuse* boolean
example: true
true indicates if MSISDN is recycled

is_recycled     string
                example: 2014-08-31

                Returns timestamp of the last time the MSISDN was recycled 

}

Additional context
This discrepancy affects the tenure use case and complicates the API's functionality, making it less reliable for customers.
The response would be true if it has ever been recycled. If true, then the recycling date is provided.
The only proposed change is that the customer doesn't submit a date as an input parameter

Activity

  1. Masa8106 commented on Feb 25, 2025

    @Masa8106
    Contributor

    @luislopezcorpas Can we converting this to a discussion, as I think it needs discussion and is not yet an "issue"? If a conclusion is reached in the discussion that there is a issue here, then an new issue can be created accordingly.

  2. hdamker commented on Mar 10, 2025

    @hdamker
    Contributor

    @luislopezcorpas I also see the that this need more discussion and is maybe not an issue at all. E.g. I don't agree that NumberRecycling should return the date of the "last time the MSISDN was recycled". That is an internal information of the operator which is not needed for the purpose of the API (to check that the MSISDN is NOT recycled after a certain date). It's not the intention of the NumberRecycling API to make Tenure use case obsolete. Tenure provides information about the customer (how long is their tenure with the operator) and will most likely require even consent to expose this information, while NumberRecycling just provides the information that the phoneNumber the API consumer has on record was not recycled by the operator.

    You could argue that NumberRecycling does not fit into the KYC Sub Project, as its purpose isn't to reveal information about the customer.

  3. Masa8106 commented on Mar 19, 2025

    @Masa8106
    Contributor

    @luislopezcorpas, please let me convert this to discussion, as we discussed in the meeting yesterday.

  4. locked and limited conversation to collaborators on Mar 19, 2025
  5. converted this issue into a discussion #42 on Mar 19, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions