Información de las organizaciones

Obtener Organizaciones

La función getOrganizations de checkServices se utiliza para recuperar una lista de organizaciones, incluyendo detalles como su identificador, nombre, categoría y logo. Esta información es esencial para operaciones donde se necesita mostrar o utilizar datos de múltiples organizaciones.

Uso de la Función getOrganizations

Esta función no toma parámetros directos y utiliza un callback, GetOrganizationsCallback, para manejar la respuesta.

Callback: GetOrganizationsCallback

• Descripción: Callback utilizado para recibir los resultados de la solicitud de organizaciones.
• Métodos:
  • onSuccessful: Este método se invoca cuando se recuperan exitosamente las organizaciones.
    • Valores:
      • response (GetOrganizationsResponse): Contiene la lista de organizaciones y sus detalles.
    • Descripción: Se llama cuando se obtienen exitosamente las organizaciones.
  • onError: Este método se invoca cuando ocurre un error durante la solicitud de las organizaciones.
    • Valores:
      • error (ErrorResponse): Un código y mensaje de error opcional que describe el fallo.
        • code código de error
        • message mensaje de error
    • Descripción: Se llama cuando hay un error en el proceso de obtener las organizaciones.
    • Retorno: Registra un mensaje de error con el código proporcionado.

Datos de la Respuesta (GetOrganizationsResponse)

La respuesta GetOrganizationsResponse incluye listas de detalles para cada organización:

• id (List<String>): Identificadores únicos de las organizaciones.
• name (List<String>): Nombres de las organizaciones.
• category (List<String>): Categorías a las que pertenecen las organizaciones.
• logo (List<String>): URLs o datos de los logos de las organizaciones.

checkServices.getOrganizations(object: GetOrganizationsCallback.Stub() {
    override fun onSuccessful(response: GetOrganizationsResponse) {
        Log.d("SUCCESS", "Organizaciones obtenidas")
        // Actualiza el estado con la lista de organizaciones
	  }
     override fun onError(error: ErrorResponse) {
          Log.e("getOrganizations", error.code)
      }
})

        CheckServices checkServices = CheckServices.getInstance(this);
            checkServices.getOrganizations(new GetOrganizationsCallback.Stub() {
                @Override
                public void onSuccessful(GetOrganizationsResponse GetOrganizationsResponse) {
										// Success
                }

                @Override
 		            public void onError(ErrorResponse error) {
	                Log.d("getOrganizations", error.code );
		            }
            });

Cambiar de organización

La función changeOrganization Permite a los usuarios de Pagando Check acceder a sus distintas organizaciones y poder cambiar la terminal a alguna de ellas.

Parámetros

• profile: String
  • Descripción: identificador unico de organización

Callback: ChangeOrganizationCallback

• Descripción: Callback utilizado para recibir los resultados del intento de inicio de sesión.
• Métodos:
  • onSuccessful: Este método se invoca cuando el cambio de organización es exitoso.
    • Descripción: Se llama cuando el cambio de organización se completa exitosamente.
    • Retorno: No retorna un valor, pero indica que el proceso de cambio de organización fue exitoso.
  • onError: Este método se invoca cuando ocurre un error durante el intento de cambio de organización.
    • Parámetros:
      • error (ErrorResponse): Un código y mensaje de error opcional que describe el fallo.
        • code código de error
        • message mensaje de error
    • Descripción: Se llama cuando hay un error en el proceso de cambio de organización.
    • Retorno: No retorna un valor, pero proporciona información sobre el error ocurrido.

checkServices.changeOrganization(profile = profile, object: ChangeOrganizationCallback.Stub(){
          override fun onSuccessful() {
							// Cambio de organización exitoso
          }

			    override fun onError(error: ErrorResponse) {
			          Log.e("changeOrganization", error.code)
			      }
      })

        CheckServices checkServices = CheckServices.getInstance(this);
            checkServices.changeOrganization(profile, new ChangeOrganizationCallback.Stub() {
                @Override
                public void onSuccessful() {
										// Success
                }

                @Override
		            public void onError(ErrorResponse error) {
	                Log.d("changeOrganization", error.code );
		            }
            });

Movimientos o transacciones

La función organizationTransaction se utiliza para obtener un historial de transacciones basado en ciertos criterios de búsqueda y filtros. La función luego utiliza un callback para manejar las respuestas recibidas del servicio.

Parámetros

• currentPage: La página actual que se está consultando en el paginado de resultados.
• perPage: La cantidad de resultados por página.
• search: Un término de búsqueda para filtrar las transacciones.
• filters: Criterios adicionales de filtrado para aplicar a la consulta de transacciones.

Callback: OrganizationTransactionCallBack

Descripción: Callback utilizado para recibir los resultados de la solicitud de transacciones por organización

• Métodos:
  • onError: Se invoca cuando ocurre un error en la solicitud de transacción.
    • Parámetros:
      • error (ErrorResponse): Un código y mensaje de error opcional que describe el fallo.
        • code código de error
        • message mensaje de error
    • Descripción: Se llama cuando hay un error en el proceso de obtener transacciones por organización
    • Retorno: Se debe implementar el manejo del error.
  • onSuccessful: Este método se invoca cuando se obtiene exitosamente el listado de transacciones por organización
    • Parámetros:
      • transactionList (PaymentHistoryResponse?): Contiene la lista paginada de cortes y la información de paginación.
    • Descripción: Se llama cuando se obtienen exitosamente los cortes de terminal.
    • Retorno: Actualiza el estado con la lista de cortes y la información de paginación.

Datos de la Respuesta (PaymentHistoryResponse)

La respuesta PaymentHistoryResponse incluye:

• status: List<String>Indica el estado de cada pago (aprobado, rechazado, etc.).
• statusDescription: List<String> Descripciones detalladas de los estados de los pagos.
• folio: List<String> Identificadores únicos para cada transacción.
• operationDevice: List<String> Dispositivos utilizados para realizar las transacciones.
• operationType: List<String>Tipos de operaciones realizadas (compra, reembolso, etc.).
• transactionAmount: List<String> Montos involucrados en cada transacción.
• cardType: List<String> Tipos de tarjetas utilizadas (débito, crédito, etc.).
• lastFour: List<String> Últimos cuatro dígitos de las tarjetas utilizadas.
• transactionTime: List<String> Fecha y hora de cada transacción.
• paymentType: List<String> Indica si la transacción fue con crédito o débito.
• subtotal: List<String> Subtotal de la compra antes de impuestos o propinas.
• tipAmount: List<String> Monto de la propina agregada a la transacción.
• hasNext: boolean
• nextPage: String

fun transactions(currentPage: String, perPage: String, search: String, filters: String) {
    val checkServices: CheckServices = CheckServices.getInstance(context)

    viewModelScope.launch {
        checkServices.organizationTransaction(currentPage,perPage, search, filters, object : OrganizationTransactionCallBack.Stub() {

            override fun onSuccessful(PaymentHistoryResponse: PaymentHistoryResponse?) {
                Log.d("SUCCESS", "Transacciones obtenidas")
                // Actualiza el estado con la lista de transacciones obtenidas
                _transaction.value = PaymentHistoryResponse
            }

				    override fun onError(error: ErrorResponse) {
			          Log.e("organizationTransaction", error.code)
			      }
			      
        })
    }
}

        CheckServices checkServices = CheckServices.getInstance(this);
           checkServices.organizationTransaction(currentPage, perPage, search, filters, new OrganizationTransactionCallBack.Stub() {
                @Override
                public void onSuccessful(PaymentHistoryResponse response) {
										// Success
                }

                @Override
			          public void onError(ErrorResponse error) {
	                Log.d("organizationTransaction", error.code );
		            }
            });