esdk 0.0.3

Etecsa sdk

ETECSA SDK

SDK para integraciones de aplicaciones de ETECSA, el paquete es llamado esdk.

Table de contenidos

• Estructura de modulos
• Instalacion del paquete
• Modulo commercial
• Modulo payment
• Modulo util

Estructura de modulos

• Los modulos estan conformados de la siguiente manera:

  -esdk
   --commercial
      ---ecrm
   --payment
      ---transfermovil
   --util
      ---apidevice
  

Instalacion del paquete

Debe instalarse ejecutando en el ambiente virtual o con la version de python deseada utilizando el gestor de paquetes pip de la siguiente manera: pip install esdk

Modulo commercial

El modulo comercial esta conformado por las aplicaciones comerciales de la empresa, hasta el momento se cuenta solamente con la integracion con ecrm.

Ejemplo de validacion de servicios en ecrm

from esdk.commercial.ecrm import APICredentials,APIOperations,APIConstants,ServiceToValidate,ServiceToPay

credential = APICredentials("username", "password")

service = ServiceToValidate("nauta", APIConstants.SERVICE_TYPE_IDENTIFICATOR_NAUTA)
service1 = ServiceToValidate("number", APIConstants.SERVICE_TYPE_IDENTIFICATOR_INVOICE)
service2 = ServiceToValidate("propia", APIConstants.SERVICE_TYPE_IDENTIFICATOR_PROPIA)

lst_services = [service.get_service(),service1.get_service(),service2.get_service()]

operation = APIOperations(credential)

operation.servicesvalidate(lst_services)

Ejemplo de pago de servicios

from esdk.commercial.ecrm import APICredentials,APIOperations,APIConstants,ServiceToValidate,ServiceToPay

credential = APICredentials("username", "password")

service = ServiceToPay("acc1",APIConstants.SERVICE_TYPE_IDENTIFICATOR_INVOICE,"number", 10)
service1 = ServiceToPay("acc2",APIConstants.SERVICE_TYPE_IDENTIFICATOR_INVOICE,"number", 10)
service2 = ServiceToPay("acc3",APIConstants.SERVICE_TYPE_IDENTIFICATOR_INVOICE,"number", 10)


lst_services = [service.get_service(),service1.get_service(),service2.get_service()]

operation = APIOperations(credential)

operation.servicespayment(lst_services, "id","source","pm","cup")

Modulo payment

El modulo payment esta conformado por las pasarelas de pago empleadas en el pais, hasta el momento se cuenta solamente con la integracion con transfermovil.

from esdk.payment.transfer_movil import APICredentials,APIPayload,APIPayment

credential = APICredentials("username", "source","seed")
payload = APIPayload(10,'currency','id','source','url')

payment = APIPayment()
payment.charge(credential,payload)

Modulo util

El modulo util esta conformado por conjunto de funciones, hasta el momento se cuenta solamente con obtener los datos del agente de usuario de la peticion http.

from esdk.util.api_device import APIDevice

api_device = APIDevice('user-agent')
device = api_device.getdevice()