Servicios de Manejo de Documentos Electrónicos para Receptor

Sumario

1 Servicios de Manejo de Documentos Electrónicos para Receptor

Método de Reporte con Estatus (ReporteStatus)

Muestra la lista de los 500 últimos documentos de Facturación Electrónica con el respectivo estado que se está buscando, que se han recibidos para un Receptor dado y que tienen asociado un consecutivo menor a un valor suministrado.

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	consecutivo	Número consecutivo de los documentos a revisa	número consecutivo del documento o en blanco
Int	status_code	Código de Estatus del documento	Requerido para la búsqueda*,se puede verificar en la siguiente Tabla 1
String	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
String	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

En la siguiente tabla se muestran los estados +(tabla 1) posibles del documento para ingresarlos y obtener un reporte solo con los documentos con el estado proporcionado.

Ejemplo de entrada


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:ReporteStatus>
            <tem:request>
                <wcf:consecutivo>500</wcf:consecutivo>
                <wcf:status_code>01</wcf:status_code>
                <wcf:tokenEmpresa>89………………………………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3…………………………43</wcf:tokenPassword>
            </tem:request>
        </tem:ReporteStatus>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de Salida


<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
  	<ReporteStatusResponse xmlns="http://tempuri.org/">
     	<ReporteStatusResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        	<a:codigo>200</a:codigo>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
  	<ReporteStatusResponse xmlns="http://tempuri.org/">
     	<ReporteStatusResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        	<a:codigo>200</a:codigo>
        	<a:documentoselectronicos>
           	<a:InfoDocumentoStatus>
              	<a:correlativoempresa>177</a:correlativoempresa>
            <a:cufe>90931e5e4e97f8d695326b2cd49328b1fcb0bf669bf9252b02acfaaab6bebe281c6adc846165e3b00a3cf23d00dfeb99</a:cufe>
              	<a:estatus>1</a:estatus>
              	<a:estatusDIANcodigo/>
              	<a:estatusDIANdescripcion
              	<a:estatusDIANfecha/>
              	<a:estatusnombre>Entregado</a:estatusnombre>
              	<a:fechaemision>2021-09-21</a:fechaemision>
              	<a:fecharecepcion>2021-11-17T19:24:07</a:fecharecepcion>
              	<a:horaemision>23:24:46</a:horaemision>
              	<a:montototal>21665472.08</a:montototal>
              	<a:numerodocumento>SUN64</a:numerodocumento>
              	<a:numeroidentificacion>595454595</a:numeroidentificacion>
              	<a:razonsocial>Ady.SA</a:razonsocial>
              	<a:tipodocumento>01</a:tipodocumento>
              	<a:tipoemisor>1</a:tipoemisor>
              	<a:tipoidentidad>31</a:tipoidentidad>
           	</a:InfoDocumentoStatus>

…………………
 </a:documentoselectronicos>
        	<a:mensaje>Procesado</a:mensaje>
        	<a:pendiente>false</a:pendiente>
        	<a:resultado>Procesado</a:resultado>
        	<a:ultimoEnviado>25</a:ultimoEnviado>
     	</ReporteStatusResult>
  	</ReporteStatusResponse>
   </s:Body>
</s:Envelope>

NOTA: El ultimoEnviado es el número consecutivo para ver los archivos anteriores a el último que se muestra. Si se tienen más documentos el reporte mostrará true en la etiqueta pendientes, de caso contrario si se tiene false indica que ya no se tienen documentos.

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
Int	Código	Código de retorno. Ver catálogo de respuesta del método
Int	CorrelativoEmpresa	Número correlativo de la empresa
String	estatus	Estatus del documento en el que se encuentra Tabla 1
String	cufe	Certificado Único de Facturación Electrónica.
Date	fechaemision	Fecha en el que fue emitido el documento
Date	fecharecepcion	Fecha en que anexado
Time	horaemisión	Hora de emisión
Int	montotal	Monto total de la factura electrónica
String	numerodocumento	Identificador del documento
Int	numeroidentificacion	NIT del Emisor o Identificador Tributario del Emisor de la Factura
String	razonsocial	Razón social del Emisor
String	tipodocumento	Identificador del documento
Int	tipoemisor Tabla 3
Int	tipoentidad	Identificador del Emisor Tabla 4
String	mensaje	Mensaje descriptivo del resultado de la operación
Boolean	pendiente	respuesta (False/True)
String	resultado	Contiene información adicional (Procesado/Error)
Int	ultimoenviado	Último número consecutivo

Método Reporte

Muestra la lista de los 500 últimos documentos de Facturación Electrónica, que se han recibidos para un Receptor dado y que tienen asociado un consecutivo menor a un valor suministrado.

El reporte mostrará la información del documento, sin importar que estatus tenga.

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	consecutivo	Número consecutivo de los documentos a revisa	número consecutivo del documento o en blanco
String	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
String	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:Reporte>
            <tem:request>
                <wcf:consecutivo>800</wcf:consecutivo>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3…………43</wcf:tokenPassword>
            </tem:request>
        </tem:Reporte>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida


<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <ReporteResponse xmlns="http://tempuri.org/">
            <ReporteResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:codigo>200</a:codigo>
                <a:documentoselectronicos>
                    <a:InfoDocumento>
                        <a:correlativoempresa>733</a:correlativoempresa>
                        <a:cufe>0e12f97ef32ed6c1b104bfb...ad96f36060039e2d5f2</a:cufe>
                        <a:estatusDIANcodigo/>
                        <a:estatusDIANdescripcion/>
  <a:estatusDIANfecha/>
                        <a:fechaemision>2021-08-31</a:fechaemision>
                        <a:fecharecepcion>2022-02-17T16:56:55</a:fecharecepcion>
                        <a:horaemision>01:01:45</a:horaemision>
                        <a:montototal>412423.87</a:montototal>
                        <a:numerodocumento>ABB12</a:numerodocumento>
                        <a:numeroidentificacion>45......34</a:numeroidentificacion>
                        <a:razonsocial>JD Proveedor 01</a:razonsocial>
                        <a:tipodocumento>01</a:tipodocumento>
                        <a:tipoemisor>1</a:tipoemisor>
                        <a:tipoidentidad>31</a:tipoidentidad>
                    </a:InfoDocumento>
                    <a:InfoDocumento>...</a:InfoDocumento>
                </a:documentoselectronicos>
                <a:mensaje>Procesado</a:mensaje>
                <a:pendiente>true</a:pendiente>
                <a:resultado>Procesado</a:resultado>
                <a:ultimoEnviado>234</a:ultimoEnviado>
            </ReporteResult>
        </ReporteResponse>
    </s:Body>
</s:Envelope>

NOTA: El ultimoEnviado es el número consecutivo para ver los archivos anteriores a el último que se muestra. Si se tienen más documentos el reporte mostrará true en la etiqueta pendientes, de caso contrario si se tiene false indica que ya no se tienen documentos.

Ejemplos: tomando el ultimoenviado


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
   <soapenv:Header/>
   <soapenv:Body>
  	<tem:Reporte>
     	<!--Optional:-->
     	<tem:request>
        	<!--Optional:-->
        	<wcf:consecutivo>253</wcf:consecutivo>
                <wcf:tokenEmpresa>89………b52</wcf:tokenEmpresa>
        	<!--Optional:-->        	 
        	<!--Optional:-->
        	<wcf:tokenPassword>b3…………43</wcf:tokenPassword>
     	</tem:request>
  	</tem:Reporte>
   </soapenv:Body>
</soapenv:Envelope>

Ejemplo Respuesta:Tomando el ultimo enviado


<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
  	<ReporteResponse xmlns="http://tempuri.org/">
     	<ReporteResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        	<a:codigo>200</a:codigo>
        	<a:documentoselectronicos>
           	<a:InfoDocumento>
              	<a:correlativoempresa>252</a:correlativoempresa>
              	<a:cufe>cdb0097ff69b252d8c1dd27b57fa8d5637a661de7a30e0554c99babd295354506dbdb33c48ba3c6dfbd8fc474984a60c</a:cufe>
              	<a:estatusDIANcodigo/>
              	<a:estatusDIANdescripcion/>
              	<a:estatusDIANfecha/>
              	<a:fechaemision>2021-08-11</a:fechaemision>
              	<a:fecharecepcion>2021-11-26T12:19:30</a:fecharecepcion>
              	<a:horaemision>15:00:00</a:horaemision>
              	<a:montototal>1593558.75</a:montototal>
              	<a:numerodocumento>LAS40021</a:numerodocumento>
              	<a:numeroidentificacion>45671234</a:numeroidentificacion>
              	<a:razonsocial>Karmi</a:razonsocial>
              	<a:tipodocumento>01</a:tipodocumento>
              	<a:tipoemisor>1</a:tipoemisor>
              	<a:tipoidentidad>31</a:tipoidentidad>
           	</a:InfoDocumento>

..............
           	<a:InfoDocumento>
              	<a:correlativoempresa>1</a:correlativoempresa>
              	<a:cufe>e1307a9f41f427d2ce379a6b951b82fe3c0c2400468ed22bb3f571f50112c7c67ee551d865c50b95252f62b06043b14b</a:cufe>
              	<a:estatusDIANcodigo/>
              	<a:estatusDIANdescripcion/>
              	<a:estatusDIANfecha/>
              	<a:fechaemision>2021-08-11</a:fechaemision>
              	<a:fecharecepcion>2021-08-13T10:44:47</a:fecharecepcion>
              	<a:horaemision>15:00:00</a:horaemision>
              	<a:montototal>1593558.75</a:montototal>
              	<a:numerodocumento>LAS15143</a:numerodocumento>
              	<a:numeroidentificacion>45671234</a:numeroidentificacion>
              	<a:razonsocial>Karmi</a:razonsocial>
              	<a:tipodocumento>01</a:tipodocumento>
              	<a:tipoemisor>1</a:tipoemisor>
                <a:tipoidentidad>31</a:tipoidentidad>
           	</a:InfoDocumento>
        	</a:documentoselectronicos>
        	<a:mensaje>Procesado</a:mensaje>
        	<a:pendiente>false</a:pendiente>
        	<a:resultado>Procesado</a:resultado>
        	<a:ultimoEnviado>1</a:ultimoEnviado>
     	</ReporteResult>
  	</ReporteResponse>
   </s:Body>
</s:Envelope>

Apartado pendientes: False es indicativo que no hay más documentos por mostrar, True indica que hay más documentos anteriores.

NOTA: El ultimoEnviado es el número consecutivo para ver los archivos anteriores a el último que se muestra. Si se tienen más documentos el reporte mostrará true en la etiqueta pendientes, de caso contrario si se tiene false indica que ya no se tienen documentos.

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
Int	Código	Código de retorno. Ver catálogo de respuesta del método
Int	CorrelativoEmpresa	Número correlativo de la empresa
String	cufe	Certificado Único de Facturación Electrónica.
Date	fechaemision	Fecha en el que fue emitido el documento
Date	fecharecepcion	Fecha en que anexado
Time	horaemisión	Hora de emisión
Int	montotal	Monto total de la factura electrónica
String	numerodocumento	Identificador del documento
Int	numeroidentificacion	NIT del Emisor o Identificador Tributario del Emisor de la Factura
String	razonsocial	Razón social del Emisor
String	tipodocumento	Identificador del documento
Int	tipoemisor Tabla 3
Int	tipoentidad	Identificador del Emisor Tabla 4
String	mensaje	Mensaje descriptivo del resultado de la operación
Boolean	pendiente	respuesta (False/True)
String	resultado	Contiene información adicional (Procesado/Error)
Int	ultimoenviado	Último número consecutivo

Método de Descarga XML

Permite obtener el Archivo XML codificado en Base64, correspondiente al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es el Receptor que lo está solicitando.

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura	De 6 a 20 dígitos
	tipoIdentificacionemisor	Identificador del Emisor Tabla 4	2 caracteres
String	numeroDocumento	Identificador del documento	Hasta 20 caracteres
	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:DescargarXML>
            <tem:request>
                <wcf:TipoDocumento>?</wcf:TipoDocumento>
                <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
                <wcf:numeroDocumento>ABB10</wcf:numeroDocumento>
                <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
        </tem:DescargarXML>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <DescargarXMLResponse xmlns="http://tempuri.org/">
            <DescargarXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:archivo>PD94b………………….b2N1bWVudD4=</a:archivo>
                <a:codigo>200</a:codigo>
                <a:crc>4ecd4e588d71e689a32bb07d92c58b4e</a:crc>
                <a:cufe>0e12f97ef32ed6c1b104bfb13...f36060039e2d5f2</a:cufe>
                <a:mensaje>Se retorna el archivo solicitado</a:mensaje>
                <a:resultado>Procesado</a:resultado>
                <a:size>44864</a:size>
            </DescargarXMLResult>
        </DescargarXML
</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
-	archivo	Archivo en Base 64
Int	Código	Código de retorno. Ver catálogo de respuesta del método
String	crc	Chequeo de Redundancia Cíclica
String	cufe	Certificado Único de Facturación Electrónica.
String	mensaje	Mensaje descriptivo del resultado de la operación
String	resultado	Contiene información adicional (Procesado/Error)
Int	size	Tamaño del documento

Método de Descarga RepresentacionGrafica

Permite obtener el Archivo que contiene la Representación Gráfica codificado Base64, correspondiente al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es un Receptor que lo está solicitando

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
Int	tipoIdentificacionemisor	Identificador del Emisor Tabla 4	2 caracteres
String	numeroDocumento	Identificador del documento	Hasta 20 caracteres
	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:DescargarRepGrafica>
            <tem:request>
                <!--Optional:-->
        	<wcf:TipoDocumento>91</wcf:TipoDocumento>
                <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
                <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
                <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
        </tem:DescargarRepGrafica>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <DescargarRepGraficaResponse xmlns="http://tempuri.org/">
            <DescargarRepGraficaResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:archivo i:nil="true"/>
                <a:codigo>102</a:codigo>
                <a:crc i:nil="true"/>
                <a:cufe i:nil="true"/>
                <a:mensaje>Longitud No Válida para el Tipo de Identificador del Emisor</a:mensaje>
  <a:resultado>Error</a:resultado>
                <a:size i:nil="true"/>
            </DescargarRepGraficaResult>
        </DescargarRepGraficaResponse>
    </s:Body>
</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
Bas64	archivo	Archivo en Base 64
Int	codigo	Código de retorno. Tabla 2
string	mensaje	Mensaje descriptivo del resultado de la operación
String	resultado	Contiene información adicional (Procesado/Error)

Método de Descarga de Adjuntos/Anexos

Permite obtener el Archivo que contiene el Anexo cuya identificación interna fue indicada, correspondiente al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es el Receptor que lo está solicitando. El contenido del archivo es presentado codificado en base64.

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura	De 6 a 20 dígitos
	tipoIdentificacionemisor	Identificador del Emisor Tabla 4	2 caracteres
String	IdentificadorinternoAnexo	corresponde al identificador interno (NameFile) del anexo que se desea descargar.	El FileName se obtiene con el método ListaAnexo*
String	numeroDocumento	Identificador del documento	Hasta 20 caracteres
	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:DescargarRepGrafica>
            <tem:request>
                <!--Optional:-->
        	<wcf:TipoDocumento>91</wcf:TipoDocumento>
                <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
                <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
                <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
        </tem:DescargarRepGrafica>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida


<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <DescargarAnexoResponse xmlns="http://tempuri.org/">
            <DescargarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:archivo>JVB……………………….YK</a:archivo>
                <a:codigo>200</a:codigo>
                <a:crc>5e9b2925ae58b8f7c2c95ef8d748d864</a:crc>
                <a:cufe>6c406410fc912ca1...8da809c1517da5</a:cufe>
                <a:displayname>ad0000346585016210001271e</a:displayname>
                <a:extension>pdf</a:extension>
                <a:idfile>5984</a:idfile>
                <a:mensaje>Se retorna el archivo solicitado</a:mensaje>
                <a:resultado>Procesado</a:resultado>
                <a:sizefile>43203</a:sizefile>
                <a:type>2</a:type>
            </DescargarAnexoResult>
        </DescargarAnexoResponse>
    </s:Body>
</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
-	archivo	Archivo XML en Base64 que contiene el documento electrónico.
Int	codigo	Código de retorno. Tabla 2
String	crc	Chequeo de Redundancia Cíclica
String	cufe	Certificado Único de Facturación Electrónica.
String	displayname
String	extension	Tipo de documento que se tiene
Int	idfile

|string |mensaje |Mensaje descriptivo del resultado de la operación |- |String |resultado |Contiene información adicional (Procesado/Error) |- |Int |sizefile |Tamaño del documento |- |Int |Type |Tipo de documento, (Ver catálogo) |} |}

Método Consulta de Estado Documento

Permite conocer el estatus, así como la lista de estados por la que ha pasado un documento de Facturación Electrónica, que originalmente fue emitida por un Proveedor, cuyo adquiriente tiene como proveedor tecnológico de Facturación Electrónica a The Factory HKA Colombia

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura	De 6 a 20 dígitos
	tipoIdentificacionemisor	Identificador del Emisor Tabla 4	2 caracteres
String	numeroDocumento	Identificador del documento	Hasta 20 caracteres
	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:EstadoDocumento>
        <!--Optional:-->
     	  <tem:request>
        	<!--Optional:-->
        	<wcf:TipoDocumento></wcf:TipoDocumento>
        	<!--Optional:-->
        	<wcf:identificadorEmisor>25………1</wcf:identificadorEmisor>
        	<!--Optional:-->
        	<wcf:numeroDocumento>ERTYBNT017</wcf:numeroDocumento>
        	<!--Optional:-->
        	<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
        	<!--Optional:-->
        	<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>
        	<!--Optional:-->
        	<wcf:tokenPassword>b3…………43</wcf:tokenPassword>
     	</tem:request>
        </tem:EstadoDocumento>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida


<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <EstadoDocumentoResponse xmlns="http://tempuri.org/">
            <EstadoDocumentoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:ListEstatusHistory>
                    <a:HistorialEstatus>
                        <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Aceptación expresa (DIAN)</a:Comentarios>
    <a:Descripcion>Aceptación expresa (DIAN)</a:Descripcion>
                        <a:codigoEstatus>2</a:codigoEstatus>
                        <a:fecha>2022-03-07 13:37:47</a:fecha>
                    </a:HistorialEstatus>
                    <a:HistorialEstatus>
                        <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Recibo del bien y/o prestación del servicio</a:Comentarios>
                        <a:Descripcion>Recibo del bien y/o prestación del servicio</a:Descripcion>
                        <a:codigoEstatus>12</a:codigoEstatus>
                        <a:fecha>2022-03-07 13:37:46</a:fecha>
                    </a:HistorialEstatus>
                    <a:HistorialEstatus>
                        <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Acuse de recibo (DIAN)</a:Comentarios>
                        <a:Descripcion>Acuse de recibo (DIAN)</a:Descripcion>
                        <a:codigoEstatus>10</a:codigoEstatus>
                        <a:fecha>2022-03-07 13:32:19</a:fecha>
                    </a:HistorialEstatus>
                    <a:HistorialEstatus>
                        <a:Comentarios>Cambio de Estado a Entregado por Descarga de Documento Electrónico</a:Comentarios>
                        <a:Descripcion>Entregado</a:Descripcion>
                        <a:codigoEstatus>1</a:codigoEstatus>
                        <a:fecha>2022-02-11 12:38:25</a:fecha>
                    </a:HistorialEstatus>
                    <a:HistorialEstatus>
                        <a:Comentarios>Cargado</a:Comentarios>
                        <a:Descripcion>Cargado</a:Descripcion>
                        <a:codigoEstatus>0</a:codigoEstatus>
                        <a:fecha>2022-02-11 12:23:02</a:fecha>
                    </a:HistorialEstatus>
                </a:ListEstatusHistory>
                <a:codigo>200</a:codigo>
                <a:estatusDIANDescripcion/>
                <a:estatusDIANcodigo/>
                <a:estatusDIANfecha/>
                <a:estatusDocumento>Aceptación expresa (DIAN)</a:estatusDocumento>
                <a:fechaDocumento>2022-02-11T12:23:01</a:fechaDocumento>
                <a:mensaje>Se retorna los datos del estado del documento</a:mensaje>
                <a:resultado>Procesado</a:resultado>
                <a:tipoDocumento>01</a:tipoDocumento>
                <a:uuid>0e12f97ef3...060039e2d5f2</a:uuid>
            </EstadoDocumentoResult>
        </EstadoDocumentoResponse>
    </s:Body>
</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
String	comentarios	Status del documento . Tabla 1
String	descripcion	Descripción del status relacionado
Int	codigoEStatus	Código del estatus. Tabla 1
Date	fecha	fecha en formato “s” ”( yyyy'-'MM'-'dd'T'HH':'mm':'ss ) del estatus actual
String	uuid	Identificador Universal Único

Método Cambio de Status

Permite cambiar el estatus de un documento de Facturación Electrónica, que originalmente fue emitida por un Emisor, del cual el adquiriente tiene como proveedor tecnológico de Facturación Electrónica a The Factory HKA Colombia.

Nota:Si el documento está en un estado DIAN y se requiere cambiar a otro estado y es imposible hacerlo, puede que esté en espera para recibir respuesta de la DIAN, por lo cual se debe de esperar 5 minutos para realizar el cambio

REQUEST: Parámetros a Enviar

Tipo	Identificador	Atributo	Descripción
String	EjecutadorPor	Apellido	Apellido de la persona encargada de enviar evento.
		Cargo	Función de la cual una persona tiene la responsabilidad en una organización, un organismo o una empresa.(opcional).
		Departamento.	Área en la que se encuentra la persona encargada de envío de eventos (opcional).
		DV	Digito verificador del nit de la empresa.
		NumeroIdentificacion	Nit de la empresa.
		TipoIdentificacion	Tipo de identifiación según la Tabla 4
		Nombre	Nombre de la persona encargada a enviar eventos hacia la DIAN.
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
	identificadorEmisor		NIT del Emisor o Identificador Tributario del Emisor de la Factura, de 6 a 20 dígitos
	numeroDocumento		Identificador del documento hasta 20 caracteres
	status		Código de Estatus del documento,requerido para la búsqueda*,se puede verificar en la siguiente Tabla 1
	tipoIdentificacionemisor		Identificador del Emisor Tabla 4
String	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
String	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

El código de Rechazo es requerido para realizar cualquier cambio de estado.

CodigoRechazo

Código	Descripción
01	Documento con inconsistencias
02	Mercancía no entregada totalmente
03	Mercancía no entregada parcialmente
04	Servicio no prestado

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:CambioEstatus>
     	   <!--Optional:-->
     	   <tem:request>
        	<!--Optional:-->
        	<wcf:EjecutadoPor>
           	<!--Optional:-->
           	<wcf:Apellido>López</wcf:Apellido>
           	<!--Optional:-->
           	<wcf:Cargo>Pruebas</wcf:Cargo>
           	<!--Optional:-->
           	<wcf:Departamento>Calidad</wcf:Departamento>
           	<!--Optional:-->
           	<wcf:Identificacion>
              	<!--Optional:-->
              	<wcf:Dv></wcf:Dv>
              	<!--Optional:-->
              	<wcf:NumeroIdentificacion>14…………51</wcf:NumeroIdentificacion>
              	<!--Optional:-->
              	<wcf:TipoIdentificacion>11</wcf:TipoIdentificacion>
           	</wcf:Identificacion>
           	<!--Optional:-->
           	<wcf:Nombre>Adriana</wcf:Nombre>
        	</wcf:EjecutadoPor>
        	<!--Optional:-->
        	<wcf:TipoDocumento>91</wcf:TipoDocumento>
        	<!--Optional:-->
        	<wcf:codigoRechazo>02</wcf:codigoRechazo>
        	<!--Optional:-->
        	<wcf:identificadorEmisor>90………26</wcf:identificadorEmisor>
        	<!--Optional:-->
        	<wcf:numeroDocumento>AKLAA16</wcf:numeroDocumento>
        	<!--Optional:-->
        	<wcf:status>10</wcf:status>
        	<!--Optional:-->
        	<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
        	<!--Optional:-->
        	<wcf:tokenEmpresa>89………52</wcf:tokenEmpresa>
        	<!--Optional:-->
        	<wcf:tokenPassword>b3……………43</wcf:tokenPassword>
        </tem:CambioEstatus>
    </soapenv:Body>
</soapenv:Envelope>

</p>

====<font color="Blue">Ejemplo de salida</font>====
<pre>

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <CambioEstatusResponse xmlns="http://tempuri.org/">
            <CambioEstatusResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:codigo>103</a:codigo>
                <a:mensaje>Se produjo un error en el servicio...{"Codigo":"108","Mensaje":"No se pudo cambiar el status del Documento ABB01 emitido por NIT 45......34 a NIT 12.....9. Estatus no válido. No está permitido el status Precargado cuando se está en el estatus Acuse de recibo (DIAN)","Resultado":"Error"} por favor inténtelo más tarde</a:mensaje>
                <a:resultado>Error</a:resultado>
            </CambioEstatusResult>
        </CambioEstatusResponse>
    </s:Body>
</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
Int	Código	Código de retorno. Ver catálogo de respuesta del método
String	mensaje	Mensaje descriptivo del resultado de la operación
String	resultado	Contiene información adicional (Procesado/Error)

Método Consulta de Metadata (infodatos) (a los documentos) ConsultaDocumentosMetadata

(Infodatos) Permite a un Receptor consultar el o los metadato(s) (infodatos) correspondientes a un documento de Facturación Electrónica, identificado con el numero documento, emitido por un proveedor de bienes y servicios identificado al Receptor ya mencionado

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura	De 6 a 20 dígitos
	tipoIdentificacionemisor	Identificador del EmisorTabla 4	2 caracteres
	numeroDocumento	Identificador del documento	Hasta 20 caracteres
String	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
String	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:CosultaDocumentoMetadata>
            <tem:request>
                <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
                <wcf:numeroDocumento>ABB09</wcf:numeroDocumento>
                <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
        </tem:CosultaDocumentoMetadata>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
        <CosultaDocumentoMetadataResponse xmlns="http://tempuri.org/">
            <CosultaDocumentoMetadataResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:ListMetadata>
                    <a:SPPostMetadata>
                        <a:createdat>2022-02-17T12:08:47</a:createdat>
                        <a:createdby>Customer</a:createdby>
                        <a:label>Nueva Categoría 2</a:label>
                        <a:updatedat>2022-02-17T12:08:47</a:updatedat>
                        <a:updatedby>Customer</a:updatedby>
                        <a:value>A</a:value>
                    </a:SPPostMetadata>
                    <a:SPPostMetadata>
                        <a:createdat>2022-02-17T12:08:47</a:createdat>
                        <a:createdby>Customer</a:createdby>
                        <a:label>Nueva Categoría</a:label>
                        <a:updatedat>2022-02-17T12:08:47</a:updatedat>
                        <a:updatedby>Customer</a:updatedby>
                        <a:value>Calle Carrera</a:value>
                    </a:SPPostMetadata>
                    <a:SPPostMetadata>
                        <a:createdat>2022-02-17T12:08:47</a:createdat>
                        <a:createdby>Customer</a:createdby>
                        <a:label>Regiones 1</a:label>
                        <a:updatedat>2022-02-17T12:08:47</a:updatedat>
                        <a:updatedby>Customer</a:updatedby>
                        <a:value>J&J</a:value>
                    </a:SPPostMetadata>
                </a:ListMetadata>
                <a:codigo>200</a:codigo>
                <a:estatusDIANDescripcion/>
                <a:estatusDIANcodigo/>
                <a:estatusDIANfecha/>
                <a:estatusDocumento>Aceptación expresa (DIAN)</a:estatusDocumento>
                <a:fechaDocumento>2022-02-11T12:23:01</a:fechaDocumento>
                <a:mensaje>Se retorna los datos sobre metadatos del documento</a:mensaje>
                <a:resultado>Procesado</a:resultado>
                <a:tipoDocumento>01</a:tipoDocumento>
                <a:uuid>0e12f97ef32ed6...11ad96f36060039e2d5f2</a:uuid>
            </CosultaDocumentoMetadataResult>
        </CosultaDocumentoMetadataResponse>
    </s:Body>
</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
String	createdat	Creación del Infodato
String	createdby	Quien lo creo
String	label	Nombre del Infodato
Time	updatedat	Tiempo de relación
String	value	Nombre de la subcategoría o valor que está relacionado del Infodato

Método ListaAnexo

Permite obtener la lista de anexos asociados al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es el Receptor que lo está solicitando

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura	De 6 a 20 dígitos
	tipoIdentificacionemisor	Identificador del Emisor Tabla 4	2 caracteres
String	numeroDocumento	Identificador del documento	Hasta 20 caracteres
	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
<tem:ListaAnexo>
            <tem:request>
                <wcf:TipoDocumento>91</wcf:TipoDocumento>
                <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
                <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
                <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
                <wcf:tokenEmpresa>89………………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
        </tem:ListaAnexo>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <ListaAnexoResponse xmlns="http://tempuri.org/">
            <ListaAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:ListArchivoDocumento>
                    <a:ArchivoDocumento>
                        <a:CreatedAt>2022-02-01T10:14:09.223</a:CreatedAt>
                        <a:Format>.pdf</a:Format>
                        <a:InvoiceFileId>5782</a:InvoiceFileId>
                        <a:InvoiceId>19981</a:InvoiceId>
                        <a:NameDisplay>LAS40588</a:NameDisplay>
                        <a:NameFile>LAS40588</a:NameFile>
                        <a:PathFile>Recepcion/542/31/45......34/2021/8/11/LAS40588/</a:PathFile>
                        <a:ProviderVisible>true</a:ProviderVisible>
                        <a:Type>Representacion Gráfica</a:Type>
                        <a:TypeCode>1</a:TypeCode>
                        <a:UpdatedAt>2022-02-01T10:14:09.223</a:UpdatedAt>
                        <a:size>43282</a:size>
                    </a:ArchivoDocumento>
                    <a:ArchivoDocumento>
                        <a:CreatedAt>2022-03-09T12:16:47.597</a:CreatedAt>
                        <a:Format>.pdf</a:Format>
                        <a:InvoiceFileId>5984</a:InvoiceFileId>
                        <a:InvoiceId>19981</a:InvoiceId>
                        <a:NameDisplay>ad0000346585016210001271e</a:NameDisplay>
                        <a:NameFile>32168992-676A-44C8-862D-F5E5EBC762DB</a:NameFile>
<a:PathFile>Recepcion/542/31/45......34/2021/8/11/LAS40588/</a:PathFile>
                        <a:ProviderVisible>true</a:ProviderVisible>
                        <a:Type>Anexo</a:Type>
                        <a:TypeCode>2</a:TypeCode>
                        <a:UpdatedAt>2022-03-09T12:16:47.597</a:UpdatedAt>
                        <a:size>43203</a:size>
                    </a:ArchivoDocumento>
                </a:ListArchivoDocumento>
                <a:codigo>200</a:codigo>
                <a:mensaje>Se retorna los datos del Archivos asociados al documento LAS40588 emitido por el NIT 45......34 al solicitante con NIT 12.....9</a:mensaje>
                <a:resultado>Procesado</a:resultado>
            </ListaAnexoResult>
        </ListaAnexoResponse>
    </s:Body>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
Int	InvoiceFileId	Campo de control de identificación del archivo
	InvoiceId	Campo de control de identificación del documento
	TypeCode	Entero que indica el código de tipo de anexo; a saber admite los siguientes valores Tabla 5
	size	tamaño del documento
String	Format	Extensión del Archivo
	NameDisplay	Nombre Archivo dado por el Proveedor Tecnológico, hasta 100 caracteres
	PathFile	Campo de control de identificación del documento
	Type	Indica el tipo de adjunto; a saber : Representación Gráfica, Anexo, Acuse de Recibido, Acuse de Aceptado, Acuse de Rechazado y Acuse de Aceptación Tácita
	NameFile	Nombre interno del archivo. Este valor es usado tanto para la solicitud de recuperación, como la solicitud de eliminación del archivo
Time	UpdatedAt	fecha de la última actualización del archivo
Time	CreatedAt	Fecha en la que fue incorporado el archivo
Boolean	ProviderVisible	Indicador que señala si el archivo puede ser descargado por el emisor

NameFile : Este es indispensable para el método DercargaAnexo este debe de coincidir Type: Anexo. Para la descarga del Anexo que es el siguiente método

Método DescargaAnexo

Permite la descarga del Anexo o adjunto del documento que se encuentra vinculado al documento de factura. Que originalmente fue anexada al documento.

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
Int	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura	De 6 a 20 dígitos
String	identificadorinternoanexo	Identificador del Anexo el cual debe de consultarse en el Método de ListaAnexo
	tipoIdentificacionemisor	Identificador del Emisor Tabla 4	2 caracteres
	numeroDocumento	Identificador del documento	Hasta 20 caracteres
	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:DescargarAnexo>
            <tem:request>
                <wcf:TipoDocumento>91</wcf:TipoDocumento>
                <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
                <wcf:identificadorInternoAnexo>32168992-0000-44C8-862D-F5E5EBC762DB</wcf:identificadorInternoAnexo>
                <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
                <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
        </tem:DescargarAnexo>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <DescargarAnexoResponse xmlns="http://tempuri.org/">
            <DescargarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:archivo>JVBERi0xLjQKM……</a:archivo>
                <a:codigo>200</a:codigo>
                <a:crc>5e9b2925ae58b8f7c2c95ef8d748d864</a:crc>
                <a:cufe>6c406410fc912ca1a937d1b...e08ad3c91fa8da809c1517da5</a:cufe>
                <a:displayname>ad0000346585016210001271e</a:displayname>
                <a:extension>pdf</a:extension>
                <a:idfile>5984</a:idfile>
                <a:mensaje>Se retorna el archivo solicitado</a:mensaje>
                <a:resultado>Procesado</a:resultado>
                <a:sizefile>43203</a:sizefile>
                <a:type>2</a:type>
            </DescargarAnexoResult>
        </DescargarAnexoResponse>
    </s:Body>
</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
-	archivo	Archivo en Base 64 del documento
Int	codigo	Código de retorno, Tabla 4
	Id	Id del documento.
	Type	Tipo de documento, Tabla 3
	sizeFile	tamaño del documento
String	crc	Chequeo de Redundancia Cíclica
	cufe	Certificado Único de Facturación Electrónica.
	displayname
	extension	Tipo de documento que se tiene
	mensaje	Mensaje descriptivo del resultado de la operación
	resultado	Contiene información adicional (Procesado/Error)

Método Envío de Representación Gráfica (EnviarRepGrafica)

Permite a un Receptor enviar el archivo que corresponde a la representación gráfica de un documento de Facturación Electrónica, identificado con el número documento, emitido por un proveedor de bienes y servicios identificado al Receptor ya mencionado; el archivo está codificado en Base64.

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
	visible	Indica si el archivo posteriormente puede ser o no descargado por el Emisor	Visible = 1, No visible = 0, 1 dígito
	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura
String	archivo	Archivo XML en Base64 que contiene el documento electrónico que se desea enviar
	nombre	Nombre del documento de la Representación Gráfica	Hasta 100 caracteres
	extension	Indica el formato del archivo remitido; los valores admitidos son	bmp\|jpg\|pdf\|doc\|docx\|xls\|xlsx\|ppt\|pptx\|rar\|zip
	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura	De 6 a 9 digitos
	numeroDocumento	Identificador del documento	Hasta 20 caracteres
	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:EnviarRepGrafica>
            <tem:request>
                <wcf:TipoDocumento>91</wcf:TipoDocumento>
                <wcf:archivo>JVB……FT0YK</wcf:archivo>
                <wcf:extension>ppt</wcf:extension>
                <wcf:identificadorEmisor>45…34</wcf:identificadorEmisor>
                <wcf:nombre>SOAP01-2</wcf:nombre>
                <wcf:numeroDocumento>SOAP019</wcf:numeroDocumento>
                <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
                <wcf:visible>1</wcf:visible>
            </tem:request>
        </tem:EnviarRepGrafica>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <EnviarRepGraficaResponse xmlns="http://tempuri.org/">
            <EnviarRepGraficaResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:codigo>102</a:codigo>
                <a:mensaje>Token Password es Requerido</a:mensaje>
                <a:resultado>Error</a:resultado>
            </EnviarRepGraficaResult>
        </EnviarRepGraficaResponse>
    </s:Body>
</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
Int	codigo	Código de retorno, (Ver catálogo de respuesta del método)
String	mensaje	Mensaje descriptivo del resultado de la operación
String	String	resultado, contiene información adicional (Procesado/Error)

Método Envío de XML Método de “EnviarXML”

Permite enviar el archivo XML que representa Documento Fiscal Electrónico, el cual fue emitido por un proveedor* de bienes y servicios a un cliente The Factory HKA Colombia, el archivo XML está representado en Base64. Opcionalmente se puede remitir los llamados Metadatos

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	metadata	Lista Optativa de cuarteto, que permite especificar atributos adicionales referentes al Documento Fiscal Electrónico; los cuartetos son de la forma (code, value, internal1 (optativo), internal2 (optativo)); estableciendo una asociación entre el elemento code (que representa el código de metadata ) y el resto de los “atributos” del cuarteto en cuestión.
String	archivo	Archivo XML en Base64 que contiene el documento electrónico que se desea enviar
	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:EnviarXML>
            <tem:request>
                <wcf:archivo>PD94b…………..bnQ+</wcf:archivo>
                <wcf:metadata>
                    <wcf:metadata>
                        <wcf:Metadata>
                            <wcf:code>01</wcf:code>
                            <wcf:internal1/>
 <wcf:internal2/>
                            <wcf:value/>
                        </wcf:Metadata>
                    </wcf:metadata>
                </wcf:metadata>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
        </tem:EnviarXML>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <EnviarXMLResponse xmlns="http://tempuri.org/">
            <EnviarXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:codigo>203</a:codigo>
                <a:documentoId>AHJ07</a:documentoId>
                <a:estatusDocumento>Cargado</a:estatusDocumento>
                <a:mensaje>Documento Enviado Satisfactoriamente - Problema(s) con Metadato(s) : Valor(es) suministrado(s) para Metadato(s) no corresponde(n) a la(s) lista(s) definida(s)</a:mensaje>
<a:numeroIdentificacion>45......34</a:numeroIdentificacion>
                <a:resultado>Procesado</a:resultado>
                <a:tipoIdentificacion>31</a:tipoIdentificacion>
            </EnviarXMLResult>
        </EnviarXMLResponse>
    </s:Body>
</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
-	archivo	Archivo en Base 64 del documento
Int	codigo	Código de retorno, Tabla 2
	numeroIdentificacion	Id del documento.
	tipoIdentificacion	Tipo de identificación del documento
String	Identificador del documento
	estatusDocumento	Estatus del Documento
	mensaje	Mensaje descriptivo del resultado de la operación
	String	resultado	Contiene información adicional (Procesado/Error)

Método Envío de Anexo (EnvioAnexo)

Permite a un Receptor enviar un archivo que archivo que se “adjunta” a un documento de Facturación Electrónica , identificado con el numero documento, emitido por un proveedor de bienes y servicios también identificado; al Receptor ya mencionado; el archivo está codificado en Base64.

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
-	archivo	Archivo en Base64 que representa un anexo de factura identificada por número de documento
Byte	Indica si el archivo posteriormente puede ser o no descargado por el Emisor.	Visible = 1, No visible = 0, 1 dígito
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
	tipoidentificadoremisor	Identificador del Emisor Tabla 4
	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura
String	nombre	Nombre del documento de la Representación Gráfica	Hasta 100 caracteres
	extension	Indica el formato del archivo remitido; los valores admitidos son	bmp\|jpg\|pdf\|doc\|docx\|xls\|xlsx\|ppt\|pptx\|rar\|zip
	numeroDocumento	Identificador del documento	Hasta 20 caracteres
	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:EnviarAnexo>
            <tem:request>
                <wcf:archivo>JVB…….</wcf:archivo>
                <wcf:extension>pdf</wcf:extension>
                <wcf:TipoDocumento>91</wcf:TipoDocumento>
                <wcf:identificadorEmisor>456…34</wcf:identificadorEmisor>
                <wcf:nombre>AHJ07-7</wcf:nombre>
                <wcf:numeroDocumento>AHJ07</wcf:numeroDocumento>
                <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
                <wcf:visible>1</wcf:visible>
            </tem:request>
        </tem:EnviarAnexo>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<?xml version="1.0" encoding="UTF-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <EnviarAnexoResponse xmlns="http://tempuri.org/">
            <EnviarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:codigo>200</a:codigo>
                <a:mensaje>Archivo enviado satisfactoriamente</a:mensaje>
                <a:resultado>Procesado</a:resultado>
            </EnviarAnexoResult>
        </EnviarAnexoResponse>
    </s:Body>
</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
Int	codigo	Código de retorno, Tabla 2
String	mensaje	Mensaje descriptivo del resultado de la operación
String	String	resultado	Contiene información adicional (Procesado/Error)

Método EliminarRepGrafica

Método que permite a un Receptor eliminar la Representación Gráfica de un documento de Facturación Electrónica que esté vinculado.

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura	De 6 a 20 dígitos
	tipoIdentificacionemisor	Identificador del Emisor Tabla 4	2 caracteres
String	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:EliminarRepGrafica>
     	<!--Optional:-->
     	<tem:request>
        	<!--Optional:-->
        	<wcf:TipoDocumento>91</wcf:TipoDocumento>
        	<!--Optional:-->
        	<wcf:identificadorEmisor>25…………08</wcf:identificadorEmisor>
        	<!--Optional:-->
        	<wcf:numeroDocumento>ERTYBNT017</wcf:numeroDocumento>
        	<!--Optional:-->
        	<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
        	<!--Optional:-->
        	<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>
        	<!--Optional:-->
        	<wcf:tokenPassword>b3……..43</wcf:tokenPassword>
     	</tem:request>
  	</tem:EliminarRepGrafica>


    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

   <s:Body>
      <EliminarRepGraficaResponse xmlns="http://tempuri.org/">
          <EliminarRepGraficaResponse xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
               <a:codigo>103</a:codigo>
               <a:mensaje>Se produjo un error en el servicio...{"Codigo":"104","Mensaje":"No se tiene registrado como válido el anexo ERTYBNT017 en el documento ERTYBNT017 emitido por NIT 25………08 a NIT 90………98","Resultado":"Error"} por favor inténtelo más tarde</a:mensaje>
               <a:resultado>Error</a:resultado>
           </EliminarRepGraficaResult>
       </EliminarRepGraficaResponse>
   </s:Body>

</s:Envelope>

RESPONSE: Parámetros a Recibir

Código	Descripción
200	Representación Gráfica enviada satisfactoriamente
102	El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango./ Dato que es erróneo
103	Error Interno en el Servicio	Código de retorno. Ver catálogo de respuesta del método

Método EliminarAnexo/font>

Método que permite al Receptor eliminar anexos que estén vinculados a un documento de Facturación Electrónica.

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura	De 6 a 20 dígitos
	tipoIdentificacionemisor	Identificador del Emisor Tabla 4	2 caracteres
String	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:EliminarAnexo>
     	<!--Optional:-->
     	<tem:request>
        	<!--Optional:-->
        	<wcf:TipoDocumento>91</wcf:TipoDocumento>
        	<!--Optional:-->
        	<wcf:identificadorEmisor>25……08</wcf:identificadorEmisor>
        	<!--Optional:-->
        	<wcf:identificadorInternoAnexo>A177CFD9-695C-4E0A-BC36-0A8DC187A4C9</wcf:identificadorInternoAnexo>
        	<!--Optional:-->
        	<wcf:numeroDocumento>ERTYBNT017</wcf:numeroDocumento>
        	<!--Optional:-->
        	<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
        	<!--Optional:-->
        	<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>
        	<!--Optional:-->
        	<wcf:tokenPassword>b3…………………43</wcf:tokenPassword>
     	</tem:request>
  	</tem:EliminarAnexo>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

   <s:Body>
        <EliminarAnexoResponse xmlns="http://tempuri.org/">
    	<EliminarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
       	<a:codigo>103</a:codigo>
       	<a:mensaje>Se produjo un error en el servicio...{"Codigo":"104","Mensaje":"No se tiene registrado como válido el anexo A177CFD9-695C-4E0A-BC36-0A8DC187A4C9 en el documento ERTYBNT017 emitido por NIT 25………08 a NIT 90………98","Resultado":"Error"} por favor inténtelo más tarde</a:mensaje>
       	<a:resultado>Error</a:resultado>
    	</EliminarAnexoResult>
 	</EliminarAnexoResponse>
   </s:Body>

</s:Envelope>

RESPONSE: Parámetros a Recibir

Identificador	Descripción
Identificador	Código de retorno.
mensaje	Mensaje descriptivo del resultado de la operación
resultado	Contiene información adicional (Procesado/Error)

Método DescargarRecepcionBienServicioXML

Método que permite a un Receptor, descargar el Response del evento de Recibo del bien y/o Prestación de servicio, el cual está asociado a un documento que se en encuentra en el sistema

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
	nombreFileApplicationResponse	Nombre del documento que se encuentra en Lista de Anexo	-
	tipoDescarga	Tipo de Descarga del documento
	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura	De 6 a 20 dígitos
	tipoIdentificacionemisor	Identificador del Emisor Tabla 4	2 caracteres
	nmeroDocumento	Identificador del documento	2 caracteres
String	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:DescargarRecepcionBienServicioXML>
     	<!--Optional:-->
     	<tem:request>
        	<!--Optional:-->
        	<wcf:TipoDocumento>01</wcf:TipoDocumento>
        	<!--Optional:-->
        	<wcf:identificadorEmisor>90……26</wcf:identificadorEmisor>
        	<!--Optional:-->
        	<wcf:nombreFileApplicationResponse>f2c7b462-297a-4347-8a35-f63d8a947912.xml</wcf:nombreFileApplicationResponse>
        	<!--Optional:-->
        	<wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento>
        	<!--Optional:-->
        	<wcf:tipoDescarga>1</wcf:tipoDescarga>
        	<!--Optional:-->
        	<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
        	<!--Optional:-->
        	<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>
        	<!--Optional:-->
        	<wcf:tokenPassword>b3…………43</wcf:tokenPassword>
     	</tem:request>
  	</tem:DescargarRecepcionBienServicioXML>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

   <s:Body>
       <DescargarRecepcionBienServicioXMLResponse xmlns="http://tempuri.org/">
           <DescargarRecepcionBienServicioXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
               <a:archivo>PD94bW…………………</a:archivo>
               <a:codigo>200</a:codigo>
               <a:crc>dcdc43fb31588b396ccd3ff322fbeda7</a:crc>
               <a:cufe>f2c7b462-297a-4347-8a35-f63d8a947912.xml</a:cufe>
               <a:mensaje>Se retorna el archivo solicitado</a:mensaje>
               <a:resultado>Procesado</a:resultado>
               <a:size>15096</a:size>
           </DescargarRecepcionBienServicioXMLResult>
 	</DescargarRecepcionBienServicioXMLResponse>
   </s:Body>

</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
-	archivo	Archivo en Base 64 del documento
Int	codigo	Código de retorno, Tabla 4
Int	sizeFile	tamaño del documento
String	crc	Chequeo de Redundancia Cíclica
	cufe	Certificado Único de Facturación Electrónica.
	mensaje	Mensaje descriptivo del resultado de la operación
	resultado	Contiene información adicional (Procesado/Error)

Método DescargarAcuseReclamo

Método que permite a un Receptor, descargar el Response del evento de Recibo del bien y/o Prestación de servicio, el cual está asociado a un documento que se en encuentra en el sistema

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
	nombreFileApplicationResponse	Nombre del documento que se encuentra en Lista de Anexo	-
	tipoDescarga	Tipo de Descarga del documento
	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura	De 6 a 20 dígitos
	tipoIdentificacionemisor	Identificador del Emisor Tabla 4	2 caracteres
	nmeroDocumento	Identificador del documento	2 caracteres
String	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:DescargarAcuseReclamoXML>
     	<!--Optional:-->
     	<tem:request>
        	<!--Optional:-->
        	<wcf:TipoDocumento>01</wcf:TipoDocumento>
        	<!--Optional:-->
        	<wcf:identificadorEmisor>90……26</wcf:identificadorEmisor>
        	<!--Optional:-->
        	<wcf:nombreFileApplicationResponse></wcf:nombreFileApplicationResponse>
        	<!--Optional:-->
        	<wcf:numeroDocumento>SETP990441828</wcf:numeroDocumento>
        	<!--Optional:-->
        	<wcf:tipoDescarga>2</wcf:tipoDescarga>
        	<!--Optional:-->
        	<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
        	<!--Optional:-->
         	<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>
        	<!--Optional:-->
        	<wcf:tokenPassword>b3………43</wcf:tokenPassword>
     	</tem:request>
  	</tem:DescargarAcuseReclamoXML>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

   <s:Body>
       <DescargarAcuseReclamoXMLResponse xmlns="http://tempuri.org/">
           <DescargarAcuseReclamoXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
              <a:archivo>PD94bWwgdmVyc…………………</a:archivo>
               <a:codigo>200</a:codigo>
               <a:crc>0e6751bef6bf2815685fc4203efa9ba1</a:crc>
               <a:cufe>62229467-75a3-4d3f-97b3-923798c52431.xml</a:cufe>
               <a:mensaje>Se retorna el archivo solicitado</a:mensaje>
               <a:resultado>Procesado</a:resultado>
               <a:size>14792</a:size>
           </DescargarAcuseReclamoXMLResult>
 	</DescargarAcuseReclamoXMLResponse>
   </s:Body>

</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
-	archivo	Archivo en Base 64 del documento
Int	codigo	Código de retorno, Tabla 4
Int	sizeFile	tamaño del documento
String	crc	Chequeo de Redundancia Cíclica
	cufe	Certificado Único de Facturación Electrónica.
	mensaje	Mensaje descriptivo del resultado de la operación
	resultado	Contiene información adicional (Procesado/Error)

Método DescargarAcuseRecibido

Método que permite a un Receptor, descargar el Response del evento del Acuse de Recibido, el cual está asociado a un documento que se en encuentra en el sistema Método

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
	nombreFileApplicationResponse	Nombre del documento que se encuentra en Lista de Anexo	-
	tipoDescarga	Tipo de Descarga del documento
	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura	De 6 a 20 dígitos
	tipoIdentificacionemisor	Identificador del Emisor Tabla 4	2 caracteres
	nmeroDocumento	Identificador del documento	2 caracteres
String	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
        <tem:DescargarAcuseRecibidoXML>
     	<!--Optional:-->
     	<tem:request>
        	<!--Optional:-->
        	<wcf:TipoDocumento></wcf:TipoDocumento>
        	<!--Optional:-->
        	<wcf:identificadorEmisor>90……26</wcf:identificadorEmisor>
        	<!--Optional:-->
        	<wcf:nombreFileApplicationResponse>226a6537-fdc5-4224-84cd-bd31fbe39af5.xml</wcf:nombreFileApplicationResponse>
        	<!--Optional:-->
        	<wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento>
        	<!--Optional:-->
        	<wcf:tipoDescarga>1</wcf:tipoDescarga>
        	<!--Optional:-->
        	<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
        	<!--Optional:-->
        	<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>
        	<!--Optional:-->
        	<wcf:tokenPassword>b3………43</wcf:tokenPassword>
     	</tem:request>
  	</tem:DescargarAcuseRecibidoXML>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

   <s:Body>
       <DescargarAcuseRecibidoXMLResponse xmlns="http://tempuri.org/">
           <DescargarAcuseRecibidoXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
              <a:archivo>PD94bWwgdm…………………</a:archivo>
               <a:codigo>200</a:codigo>
               <a:crc>a26ecb9330992ac9ab4479f457fbdaeb</a:crc>
               <a:cufe>226a6537-fdc5-4224-84cd-bd31fbe39af5.xml</a:cufe>
               <a:mensaje>Se retorna el archivo solicitado</a:mensaje>
               <a:resultado>Procesado</a:resultado>
               <a:size>15100</a:size>
           </DescargarAcuseRecibidoXMLResult>
 	</DescargarAcuseRecibidoXMLResponse>
   </s:Body>

</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
-	archivo	Archivo en Base 64 del documento
Int	codigo	Código de retorno, Tabla 4
Int	sizeFile	tamaño del documento
String	crc	Chequeo de Redundancia Cíclica
	cufe	Certificado Único de Facturación Electrónica.
	mensaje	Mensaje descriptivo del resultado de la operación
	resultado	Contiene información adicional (Procesado/Error)

Método DescargarAcuseAceptacion

Método que permite a un Receptor, descargar el Response del evento de Aceptación, el cual está asociado a un documento que se en encuentra en el sistema

REQUEST: Parámetros a Enviar

Tipo	Identificador	Descripción	Valor numérico
Int	TipoDocumento	Es el tipo de documento que se va a manejar.	2 caracteres
	nombreFileApplicationResponse	Nombre del documento que se encuentra en Lista de Anexo	-
	tipoDescarga	Tipo de Descarga del documento
	identificadorEmisor	NIT del Emisor o Identificador Tributario del Emisor de la Factura	De 6 a 20 dígitos
	tipoIdentificacionemisor	Identificador del Emisor Tabla 4	2 caracteres
	nmeroDocumento	Identificador del documento	2 caracteres
String	tokenEmpresa	Dato suministrado por The Factory HKA Colombia	40 caracteres
	tokenPassword	Dato suministrado por The Factory HKA Colombia	40 caracteres

Ejemplo de entrada

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
    <soapenv:Header/>
    <soapenv:Body>
         <tem:DescargarAcuseAceptacionXML>
     	<!--Optional:-->
     	<tem:request>
        	<!--Optional:-->
        	<wcf:TipoDocumento></wcf:TipoDocumento>
        	<!--Optional:-->
        	<wcf:identificadorEmisor>90……26</wcf:identificadorEmisor>
        	<!--Optional:-->
        	<wcf:nombreFileApplicationResponse>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</wcf:nombreFileApplicationResponse>
        	<!--Optional:-->
        	<wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento>
        	<!--Optional:-->
        	<wcf:tipoDescarga>1</wcf:tipoDescarga>
        	<!--Optional:-->
        	<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
        	<!--Optional:-->
        	<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>
        	<!--Optional:-->
        	<wcf:tokenPassword>b3…………43</wcf:tokenPassword>
     	</tem:request>
  	</tem:DescargarAcuseAceptacionXML>
    </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

   <s:Body>
        <DescargarAcuseAceptacionXMLResponse xmlns="http://tempuri.org/">
           <DescargarAcuseAceptacionXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
              <a:archivo>PD94bWwgd…………………</a:archivo>
               <a:codigo>200</a:codigo>
               <a:crc>022770951408403f9442f9d09e52be15</a:crc>
               <a:cufe>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</a:cufe>
               <a:mensaje>Se retorna el archivo solicitado</a:mensaje>
               <a:resultado>Procesado</a:resultado>
               <a:size>14688</a:size>
           </DescargarAcuseRecibidoXMLResult>
 	</DescargarAcuseRecibidoXMLResponse>
   </s:Body>

</s:Envelope>

RESPONSE: Parámetros a Recibir

Tipo	Identificador	Descripción
-	archivo	Archivo en Base 64 del documento
Int	codigo	Código de retorno, Tabla 4
Int	sizeFile	tamaño del documento
String	crc	Chequeo de Redundancia Cíclica
	cufe	Certificado Único de Facturación Electrónica.
	mensaje	Mensaje descriptivo del resultado de la operación
	resultado	Contiene información adicional (Procesado/Error)

Mensaje: String que contiene mensaje descriptivo del resultado de la operación resultado: String que contiene información adicional (Uso futuro)

Servicios de Manejo de Documentos Electrónicos para Receptor - Índice Manual Integración Recepción Electrónica

Sumario