Conector Conector CA4XML -
HTTP
DESCRIPCIÓN DE NORMAS HTTP-POST PARA PROYECTOS DE
INTERCONEXIÓN ELECTRÓNICA
[Link] | SOLUCIONES DIGITALES
AV. PROVIDENCIA 1760, PISO 5. PROVIDENCIA, SANTIAGO, CHILE.
La impresión o descarga de este documento constituye una COPIA NO CONTROLADA. Este documento contiene información de propiedad de
[Link] S.A. Antes de utilizar alguna copia de este documento (digital / física), verifique que la versión sea igual a la última publicada en el Google
Drive de ACEPTA SGC. De no ser válido, destruya la copia física o elimine la copia digital para asegurar que no se haga de ésta un uso no previsto.
Conector CA4XML - HTTP
UPDATE HISTORY
VERSION DATE UPDATE DESCRIPTION MADE BY
1.1 2018-03-16 Primera Versión Equipo Acepta
[Link] / SOLUCIONES DIGITALES
Av. Providencia N° 1760 – Providencia – Santiago – Chile
Conector CA4XML - HTTP
INDICE DE CONTENIDOS
1 INTRODUCCIÓN .......................................................................................................... 4
1.1 OBJETIVOS................................................................................................................................. 4
2 CONECTOR CA4XML – HTTP ....................................................................................... 5
2.1 ESTRUCTURADE LA DIRECCIÓN URL........................................................................................... 5
2.2 UTILIZANDO LOS METODOS GET Y POST ................................................................................... 6
2.2.1 METODO GET ................................................................................................................................. 6
2.2.2 METODO POST ............................................................................................................................... 6
2.3 CAMPOS DEL FORMULARIO ...................................................................................................... 7
3 POST-PROCESSING RESPONSE .................................................................................... 8
[Link] / SOLUCIONES DIGITALES
Av. Providencia N° 1760 – Providencia – Santiago – Chile
Conector CA4XML - HTTP
INDICE DE IMÁGENES Y TABLAS
IMAGEN 1–ESTRUCTURA DEL FORMULARIO PARA HTTP POST ................................................................... 5
IMAGEN 2–FORMULARIO DESPLEGADO EN NAVEGADOR WEB .................................................................. 6
TABLA 3–DESCRIPCIÓN DE CAMPOS PARA HTTP POST ................................................................................ 7
[Link] / SOLUCIONES DIGITALES
Av. Providencia N° 1760 – Providencia – Santiago – Chile
Conector CA4XML - HTTP
1 INTRODUCCIÓN
1.1 OBJETIVOS
El propósito de este documento es el de proveer al usuario con los detalles necesarios
para realizar una interconexión HTTP – POST así como definir su estructura,
parámetros para el formulario y tipos de respuestas.
[Link] / SOLUCIONES DIGITALES
Av. Providencia N° 1760 – Providencia – Santiago – Chile
Conector CA4XML - HTTP
2 Conector CA4XML – HTTP
2.1 ESTRUCTURADE LA DIRECCIÓN URL
El conector CA4XML-HTTP está preparado para leer y aceptar una dirección URL escrita
en minúsculas y con la siguiente estructura:
[Link]
En donde “IP” es la dirección IP del servidor (o PC) destinado para el funcionamiento
de la aplicación de facture electrónica y “PORT” es el puerto TCP establecido de
acuerdo a la configuración realizada en el archivo ca4xml_http.ini ubicado en la
aplicación de Acepta.
A continuación, se indica un ejemplo de la URL estructurada correctamente:
[Link]
Dado que el conector utiliza los métodos GET – POST para enviar la información, un
formulario HTTP es requerido para poder realizar la transmisión de los datos. El
conector ca4xml acepta la siguiente estructura para el formulario:
<form action=”ca4xml” method=”POST”>
<input type=”text” name=”docid”/>
<input type=”text” name=”commando”/>
<input type=”text” name=”parametros”/>
<textarea name=”datos”></textarea>
</form>
Imagen 1–Estructura del Formulario para HTTP POST
[Link] / SOLUCIONES DIGITALES
Av. Providencia N° 1760 – Providencia – Santiago – Chile
Conector CA4XML - HTTP
2.2 UTILIZANDO LOS METODOS GET Y POST
2.2.1 METODO GET
Para utilizar el método GET, se debe concatenar la URL más los parámetros
establecidos en el formulario POST de la siguiente forma:
[Link]
s=SomeText
Con el simple hecho de pegar la URL generada en cualquier navegador Web, se podrá
realizar el envío por método GET.
2.2.2 METODO POST
Para realizar el método POST, se llama a la URL definida previamente en este
documento ([Link] utilizando su sistema ERP o vía
navegador Web y rellenando el formulario con los datos necesarios según se
muestra:
Imagen 2–Formulario desplegado en navegador Web
Los datos mostrados en la imagen arriba reflejan los mismo que se indica en la
siguiente línea de comandos:
docid = TestDetails & comando = emitir & parametros = & Datos = XML File
Nota: El envío de cabeceras http serán necesarias según la especificación del protocolo
http.
[Link] / SOLUCIONES DIGITALES
Av. Providencia N° 1760 – Providencia – Santiago – Chile
Conector CA4XML - HTTP
2.3 CAMPOS DEL FORMULARIO
En la siguiente tabla se definen los parámetros de entrada para el formulario:
Campo Detalles
Identificación del documento, debe ser único, por ejemplo:
DocID
33-10 - Documento de Tipo 33 con un número de serie de 10
El comando indica que acciones se realizarán con el
documento. Estos comandos son:
emitir: Prueba, Procesa XML, Genera PDF, Publica Documentos.
Comando
generar: Prueba, Procesa XML, Publica documentos
imprimir: Solo Generación de PDF.
parámetros adicionales para el comando (nombre de la
Parametros impresora y el número de copias que desea imprimir (por
ejemplo: HP3050, 2).
Esta es la información real para el documento que se está
Datos procesando, el formato de éste puede ser texto plano con
separadores o XML.
Tabla 3–Descripción de Campos para HTTP POST
[Link] / SOLUCIONES DIGITALES
Av. Providencia N° 1760 – Providencia – Santiago – Chile
Conector CA4XML - HTTP
3 Post-processing response
Esta sección del documento detalla los tipos de respuestas post-procesamiento que
son desplegadas por el conector CA4XML – HTTP cuando se realiza un post de datos.
Luego de que un documento ha llegado a la aplicación Ca4XML, éste devuelve en línea
la respuesta al procesamiento. El mensaje de respuesta son mensajes de sólo texto con
una estructura establecida y el formato del mensaje de salida es texto, con el fin de
facilitar su lectura por los sistemas de facturación de la empresa.
En estos mensajes de salida, se utiliza el carácter “|” como separador de campos y el
carácter “}” para representar el fin del mensaje.
El mensaje de respuesta posee la siguiente estructura:
OK / ERROR | Rut Emisor | Tipo Documento | Folio | Fecha Emisión | Rut Receptor |
URL |}
Donde:
OK /ERROR – Estatus del procesamiento.
Rut Emisor – RUT de la empresa.
Tipo Documento – Tipo de documento electrónico procesado.
Folio – Número de serie del documento.
Fecha Emisión – Fecha en la que el documento fue emitido
Rut Receptor – Rut del receptor del documento.
URL – La URL para la consulta del documento en el portal de Acepta.
Ejemplo de mensaje exitoso:
OK | 96919050-8 | 33 | 100 | 2018-03-16 | 1-9 | URI |}
Ejemplo de mensaje con error:
ERROR | Rut Emisor | Tipo Documento | Folio | Fecha Emisión | Rut Receptor |
Mensaje error 1; Mensaje de error 2; |}
[Link] / SOLUCIONES DIGITALES
Av. Providencia N° 1760 – Providencia – Santiago – Chile
