Ejemplo en lenguaje PHP

Tiene como objetivo ejemplificar el proceso de conexión, acceso y uso de las propiedades y métodos ofrecidos por el Servicio Web de Integración de TFHKA a través del lenguaje de programación PHP

Lo más importante es establecer los pasos necesarios para realizar una integración exitosa.

Criterios a tomar en cuenta:

• Establecer ruta y Tokens para conectarnos y utilizar los métodos expuestos por el Servicio Web de Integración de TFHKA.
• Construir / Armar el objeto Documento Electrónico (Factura) que se desea enviar al Servicio Web de Integración de TFHKA.
• Enviar el documento al Servicio Web de Integración de TFHKA para su procesamiento.
• Recibir y procesar la respuesta del Servicio Web de TFHKA en nuestro proyecto, según sea requerido.

Pasos para realizar la integración:

PASO 1: Definir variables con la ruta y los tokens requeridos por el Servicio Web de Integración de TFHKA.

PASO 2: Construir el Documento Electrónico a enviar al Servicio Web de Integración de TFHKA.

PASO 3: Enviar el Documento Electrónico construido en el paso 3 al Servicio Web de Integración de TFHKA.

PASO 4: Recibir y procesar la Respuesta del Servicio Web de Integración de TFHKA.

IMPORTANTE: El Documento procesado será almacenado en la NUBE para que pueda ser consultado en cualquier momento.

Para mayor información y detalles sobre el proceso, puede consultar el Manual de Integración de TFHKA

A continuación definiremos la ruta y los TOKENS requeridos por el Servicio Web de Integración de TFHKA para enviar documentos electrónicos, así como para utilizar otros métodos públicos expuestos $ruta = “http://demoemision.thefactoryhka.com.pa/ws/obj/v1.0/Service.svc?singleWsdl”; url del servicio

$tokenEmpresa = “SOLICITAR”;

$tokenPassword = “SOLICITAR”;

En este ejemplo utilizaremos Clases, Atributos y Métodos creados con la finalidad de organizar mejor la estructura del archivo y del cuerpo de código fuente en general.

Sin embargo, esta estructura no es obligatoria. El desarrollador puede utilizar su propio estilo, siempre y cuando logre establecer los valores requeridos para los diferentes objetos que sub-componen al objeto DocumentoElectrónico a enviar al Servicio Web.

A continuación se define una variable para establecer el Número de Documento Electrónico a enviar

$numeroDocFiscal = “0000000000”;

Mensajero::InfoNumero($numeroDocFiscal);

$factura = new DocumentoElectronico();

$cliente = new Cliente();

$datos = new DatosTransaccion();

$datos→cliente = $cliente;

- Debe establecerse el formato solicitado para la fecha de emisión “yyyy-MM-ddTHH:mm:ss-05:00”

$datos→fechaEmision = (new \DateTime('America/Panama'))→format('Y-m-d\TH:i:s-05:00');

$datos→numeroDocumentoFiscal = $numeroDocFiscal;

$factura→datosTransaccion = $datos;

$item = new Item();

$factura→listaItems = array($item);

$totales = new Totales();

$formaPago = new FormaPago();

$totales→listaFormaPago = array($formaPago);

$factura→totalesSubTotales = $totales;

- Ya teniendo listo el documento, es posible enviarlo al Servicio Web de Integración de TFHKA

A continuación definiremos la ruta y los TOKENS requeridos por el Servicio Web de Integración de TFHKA para enviar documentos electrónicos, así como para utilizar otros métodos públicos expuestos.

try {
  $wsPa = new SoapClient($ruta);
  $parametros = array(
    'tokenEmpresa' => $tokenEmpresa,
    'tokenPassword' => $tokenPassword,
    'documento' => $factura,
  );

- A continuación, enviamos el documento al método "Enviar" del Servicio Web de Integración de TFHKA

  $respWsPa = json_decode(json_encode($wsPa->__soapCall('Enviar', array($parametros))), true);
} catch (\Exception $e) {
  die($e);
}