Guía para Instanciar Servicios Web FEL en Postman - SoapUi v.1.0

Guía para Instanciar Servicios Web FEL en
Postman_SoapUI v.1.0
Factura Electrónica en Línea
Contenido
1. Versión de Documento ................................................................................................................................................... 3
2. Revisiones y Aprobaciones.............................................................................................................................................. 3
2.1 Aprobación del Documento .................................................................................................................................... 3
2.2 Revisión del Documento ......................................................................................................................................... 3
3. Contexto del Proyecto .................................................................................................................................................... 4
4. Alcance ............................................................................................................................................................................ 4
5. Objetivos ......................................................................................................................................................................... 4
6. Ejemplos para instanciar servicios web expuestos por Megaprint, S.A. ........................................................................ 5
6.1 Postman .................................................................................................................................................................. 5
6.2 SoapUI ................................................................................................................................................................... 10
COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 2

ESTA GUÍA ES CONFIDENCIAL PARA USO EXCLUSIVO DEL CLIENTE DESTINATARIO Y ES PROPIEDAD DE MEGAPRINT, S.A., ESTÁ PROHIBIDA SU
REPRODUCCIÓN Y DISTRIBUCIÓN SIN AUTORIZACIÓN.
1. Versión de Documento
En la siguiente sección se encuentra el registro de los cambios significativos al documento
Fecha Versión Descripción Autor

Elaboración de guía técnica para instanciar lo servicios
Equipo de Desarrollo
09/10/2018 1.0 de Factura Electrónica en Línea FEL con los programas
Megaprint, S.A.
Postman y SoapUI
2. Revisiones y Aprobaciones
2.1 Aprobación del Documento
Fecha Nombre
09/10/2018 Comité Operativo FEL
2.2 Revisión del Documento
Fecha Nombre
09/10/2018 Edgar Santos
09/10/2018 Comité Operativo FEL

3. Contexto del Proyecto

El proceso de Factura Electrónica en Línea se conforma de una serie de procedimientos, para la emisión, transmisión,
certificación y conservación, por medios electrónicos de facturas, notas de crédito y débito, recibos, y otros documentos
autorizados por la Superintendencia de Administración Tributaria para el Régimen FEL, que se denominaran Documentos
Tributarios Electrónicos, definiendo sus características y su funcionamiento.
Las disposiciones administrativas que regulan la Factura Electrónica en Línea fueron emitidas por medio del Acuerdo del
Directorio de la SAT 13-2018 y faculta al Superintendente a establecer por medio de las dependencias competentes, los
procedimientos, especificaciones generales y técnicas que permitan implementar el proceso.
4. Alcance
Este manual está dirigido al personal técnico, encargado del desarrollo del proyecto Factura Electrónica en Línea -FEL-,
solicitado por la Superintendencia de Administración Tributaria -SAT-. Con el fin de poder instancias los servicios
expuestos por Megaprint, S.A. como certificador para las operaciones del proyecto antes mencionado con las
herramientas Postman y SoapUI.
5. Objetivos
✓ Generación de ejemplo de la forma correcta de realizar la instancia de los servicios web expuestos por Megaprint,
S.A.

6. Ejemplos para instanciar servicios web expuestos por Megaprint, S.A.

6.1 Postman
Es una herramienta con utilidades gratuitas que surgió de una extensión del navegador Google Chrome. Está formado por
distintas herramientas que permite realizar distintas tareas en el mundo de los servicios API REST, interfaces que utilizan
el protocolo HTTP para la comunicación a métodos expuestos por medio de sus distintas operaciones: POST, GET, PUT y
DELETE.
Postman ofrece la creación de peticiones a APIs internas o de terceros, elaboración de ambientes de prueba para validar
el comportamiento de API´s. Permite crear entornos de trabajo diferentes y la posibilidad de compartir los proyectos en
archivos JSON de manera gratuita.
A continuación, se muestran los pasos para consumir los servicios de FEL con el uso de esta herramienta.
I. Descargar Postman
Descargar del siguiente enlace la aplicación, ofreciendo para los distintos sistemas operativos y sus arquitecturas:
https://www.getpostman.com/apps
Al descargar el instalador, ejecutarlo y seguir los pasos indicados para su instalación.
II. Uso de la aplicación

Al ser instalado el programa será representado por el siguiente icono y su correspondiente nombre “Postman”.
Al iniciar la aplicación se mostrará la siguiente pantalla:

III. Colección
Las colecciones permiten guardar varios consumos en un solo proyecto y ser exportados para ser importado
posteriormente o por otro usuario que tenga instalado Postman en su ordenador.
Para crear una colección se selecciona la opción:
Luego en:
IV. Consumo de Método Solicita Token
Para consumir el servicio que devuelve el token se ingresa la siguiente URL en el cuadro que indica la entrada del Request
URL: https://dev.api.ifacere-fel.com/fel-dte-services/api/solicitarToken
Los servicios FEL utilizan el método POST para enviar los datos, por lo que se debe cambiar el método en la pestaña donde
se indica GET por POST
En los parámetros del Header se especifica el tipo de dato a enviar de la siguiente forma:
Key: Content-Type
Value: Application/xml

En el Body se selecciona la opción Raw para ingresar un texto personalizado y se especifica el tipo de contenido XML
Dentro del cuadro se ingresa la estructura XML utilizada para solicitar token con sus datos correspondientes:
<?xml version='1.0' encoding='UTF-8'?>

<SolicitaTokenRequest>
<usuario>USUARIO</usuario>
<apikey>CONTRASEÑA</apikey>
</SolicitaTokenRequest>
Por último, se presiona el botón de envío Send y en la parte inferior se mostrará el resultado de la petición en formato
XML.

V. Consumo de Método Registra Documento XML
Para consumir el servicio que registra documento se ingresa la siguiente URL en el cuadro que indica la entrada del Request
URL: https://dev.api.ifacere-fel.com/fel-dte-services/api/registrarDocumentoXML
A continuación, en la opción del Header se ingresa el tipo de contenido a enviar y adicional el token recibido del método
anterior, la manera de enviar el token es colocando como llave la palabra Authorization y como valor ingresar la palabra
Bearer, un espacio y por último el token como se muestra en la siguiente imagen:
En el Body del documento siempre seleccionado la opción Raw y especificando el tipo de documento XML.
Dentro del cuadro se utiliza la siguiente estructura XML donde los datos a enviar es el documento XML y un identificador
único en formato UUID:

<RegistraDocumentoXMLRequest id="ID">
<xml_dte><![CDATA[ DOCUMENTO_XML ]]></xml_dte>
</RegistraDocumentoXMLRequest>
XML.

VI. Almacenamiento de Colección
Para almacenar los proyectos se presiona el botón Save :
El cual solicitara darle un nombre al proyecto y seleccionar la colección correspondiente.

6.2 SoapUI
SoapUI es una herramienta, desarrollada en java, para la realización de pruebas a aplicaciones con arquitectura orientada
a servicio y transferencia de estado representacional. Soporta múltiples protocolos como SOAP, REST, HTTP, JMS, AMF y
JDBC.
A continuación, se muestran los pasos para consumir los servicios de FEL con el uso de esta herramienta.
I. Descargar SoapUI
Descargar SoapUI, la versión que se está utilizando es 5.4.0 pero se puede utilizar cualquier otra versión que este más
actualizada. Esto se puede hacer en el siguiente enlace:
https://www.soapui.org/downloads/soapui.html
Al descargar el instalador, ejecutarlo y seguir los pasos indicados para su instalación.
II. Uso de la aplicación
Abrimos la aplicación y nos mostrara la siguiente pantalla en la cual podemos visualizar una serie de opciones donde se
debe de elegir qué tipo de consumo queremos realizar.

Para consumir los servicios expuestos por Megaprint para FEL debe de ser tipo REST por lo que presionamos el botón
que contiene dicha opción:
Se debe de agregar la URL a consumir

III. Consumo de Método Solicita Token
Colocamos la URL: https://dev.api.ifacere-fel.com/fel-dte-services/api/solicitarToken pura sin ningún tipo de

complemento como se logra ver en la imagen y presionamos OK.

Cambiamos el método a POST y colocamos el XML correspondiente para consumir el método de Token.
Dentro del cuadro se ingresa la estructura XML utilizada para solicitar token con sus datos correspondientes:

<SolicitaTokenRequest>
<usuario>USUARIO</usuario>
<apikey>CONTRASEÑA</apikey>
</SolicitaTokenRequest>
Al completar los parámetros requeridos presionamos el botón Play de color verde, el cual ejecutara el consumo del WS y
nos mostrara la respuesta del lado derecho en el cuadro que anteriormente se encontraba vacío.

IV. Consumo de Método Registra Documento XML
Colocamos la URL: https://dev.api.ifacere-fel.com/fel-dte-services/api/registrarDocumentoXML pura sin ningún tipo

de complemento como se logra ver en la imagen y presionamos OK.

A continuación, en la opción del Header se ingresa el tipo de contenido a enviar y adicional el token recibido del método
anterior, la manera de enviar el token es colocando como llave la palabra Authorization y como valor ingresar la palabra
Bearer, un espacio y por último el token como se muestra en la siguiente imagen:
Dentro del cuadro se utiliza la siguiente estructura XML donde los datos a enviar es el documento XML y un identificador
único en formato UUID:

<RegistraDocumentoXMLRequest id="ID">
<xml_dte><![CDATA[ DOCUMENTO_XML ]]></xml_dte>
</RegistraDocumentoXMLRequest>
XML.


Guía para Instanciar Servicios Web FEL en Postman - SoapUi v.1.0

Încărcat de

Informații document

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Guía para Instanciar Servicios Web FEL en Postman - SoapUi v.1.0

Încărcat de

Drepturi de autor:

Formate disponibile

Guía para Instanciar Servicios Web FEL en

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 2

Fecha Versión Descripción Autor

2.1 Aprobación del Documento

2.2 Revisión del Documento

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 3

3. Contexto del Proyecto

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 4

6. Ejemplos para instanciar servicios web expuestos por Megaprint, S.A.

Al descargar el instalador, ejecutarlo y seguir los pasos indicados para su instalación.

II. Uso de la aplicación

Al iniciar la aplicación se mostrará la siguiente pantalla:

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 5

Para crear una colección se selecciona la opción:

IV. Consumo de Método Solicita Token

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 6

<?xml version='1.0' encoding='UTF-8'?>

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 7

V. Consumo de Método Registra Documento XML

<?xml version='1.0' encoding='UTF-8'?>

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 8

VI. Almacenamiento de Colección

Para almacenar los proyectos se presiona el botón Save :

El cual solicitara darle un nombre al proyecto y seleccionar la colección correspondiente.

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 9

Al descargar el instalador, ejecutarlo y seguir los pasos indicados para su instalación.

II. Uso de la aplicación

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 10

Se debe de agregar la URL a consumir

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 11

III. Consumo de Método Solicita Token

Colocamos la URL: https://dev.api.ifacere-fel.com/fel-dte-services/api/solicitarToken pura sin ningún tipo de

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 12

<?xml version='1.0' encoding='UTF-8'?>

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 13

IV. Consumo de Método Registra Documento XML

Colocamos la URL: https://dev.api.ifacere-fel.com/fel-dte-services/api/registrarDocumentoXML pura sin ningún tipo

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 14

<?xml version='1.0' encoding='UTF-8'?>

COMITÉ OPERATIVO FEL MEGAPRINT, S.A. 15

S-ar putea să vă placă și