Diferencia entre revisiones de «Servicios de Manejo de Documentos Electrónicos para Receptor - Índice Manual Integración Recepción Electrónica»

De tfhkacolwiki
Ir a la navegación Ir a la búsqueda
Sin resumen de edición
Se ha deshecho la revisión 9393 de Paguirre (disc.)
Etiqueta: Reversión manual
 
Línea 1: Línea 1:


<includeonly>=</includeonly>==<font color="blue" strong>Métodos del Servicio Web HKA Recepción </font>==<includeonly>=</includeonly>
<includeonly>=</includeonly>==<font color="blue">Servicios de Manejo de Documentos Electrónicos para Receptor</font>==<includeonly>=</includeonly>
 
El Servicio de Recepción maneja un conjunto de funcionalidades que soportan la gestión de las
facturas emitidas por proveedores de bienes y servicios a clientes de The Factory HKA Colombia,
cuando estos proveedores no tienen a The Factory HKA Colombia como Proveedor Tecnológico de
Facturación Electrónica.
 
El servicio de HKA Recepción se encuentra dispuesto para realizar dos conjuntos de acciones:
 
<ul>
    <li>Recepción de Documentos Electrónicos</li>
    <li>Gestión de Documentos Electrónicos</li>
</ul>
 
===<font color="blue">Recepción de Documentos Electrónicos</font>===
Contempla las funcionalidades que permiten remitir los documentos que soportan el documento electrónico, entre ellas se encuentran los métodos disponibles:
 
====<font color="blue">Método Envío de XML AttachedDocument “EnviarXML” </font>====
 
Permite enviar el archivo XML AttachedDocument 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 se debe remitir en Base64. Opcionalmente se puede remitir los llamados Metadatos
 


===<font color="blue">Método de Reporte con Estatus (ReporteStatus)</font>===
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
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
Línea 28: Línea 12:
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|- valign="center"
|-
|-
|Class
|rowspan="2"|Int
|metadata
|consecutivo
|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.
|Número consecutivo de los documentos a revisa
|número consecutivo del documento o en blanco
|-
|-
|rowspan="3"|String
|status_code
|archivo
|Código de Estatus del documento
|Archivo XML en Base64 que contiene el documento electrónico que se desea enviar
|Requerido para la búsqueda*,se puede verificar en la siguiente [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]]
|-
|-
|rowspan="2"|String
|tokenEmpresa
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|-
|tokenPassword
|tokenPassword
|}
|}
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.
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
</pre>
====<font color="Blue">Ejemplo de Salida</font>====
<pre>
<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>
</pre>
'''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.




Línea 53: Línea 113:
|- valign="center"
|- valign="center"
|-
|-
|rowspan="7"|String
|Int
|codigo
|Código
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]]
|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 [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|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
|-
|-
|documentoId
|Int
|Consecutivo del documento remitido.
|tipoemisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 3|Tabla 3]]
|
|-
|-
|estatusDocumento
|Int
|Estatus final del documento del Documento.
|tipoentidad
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|-
|String
|mensaje
|mensaje
|Mensaje descriptivo del resultado de la operación.
|Mensaje descriptivo del resultado de la operación
|-
|-
|numeroIdentificacion
|Boolean
|Número de identificación del emisor del documento remitido.
|pendiente
|respuesta (<span style="color:#F1142F; background:#FFFFFF"><b>False</b></span>/<span style="color:#15C71D; background:#FFFFFF"><b>True</b></span>)
|-
|-
|String
|resultado
|resultado
|Contiene información adicional (Procesado/Error)
|Contiene información adicional (<span style="color:#15C71D; background:#FFFFFF"><b>Procesado</b></span>/<span style="color:#F1142F; background:#FFFFFF"><b>Error</b></span>)
|-
|Int
|ultimoenviado
|Último número consecutivo
|}
 
===<font color="blue">Método Reporte</font>===
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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|Int
|consecutivo
|Número consecutivo de los documentos a revisa
|número consecutivo del documento o en blanco
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|-
|tipoIdentificacion
|tokenPassword
|Tipo de identificación del emisor del documento remitido.
|}
|}


<font color="Blue">Ejemplo de entrada</font>
 
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<pre>
<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: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:Header/>
     <soapenv:Body>
     <soapenv:Body>
         <tem:EnviarXML>
         <tem:Reporte>
             <tem:request>
             <tem:request>
                 <wcf:archivo>PD94b…………..bnQ+</wcf:archivo>
                 <wcf:consecutivo>800</wcf:consecutivo>
                <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:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                 <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
                 <wcf:tokenPassword>b3…………43</wcf:tokenPassword>
             </tem:request>
             </tem:request>
         </tem:EnviarXML>
         </tem:Reporte>
     </soapenv:Body>
     </soapenv:Body>
</soapenv:Envelope>
</soapenv:Envelope>


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


<font color="Blue">Ejemplo de salida</font>
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
     <s:Body>
     <s:Body>
         <EnviarXMLResponse xmlns="http://tempuri.org/">
         <ReporteResponse xmlns="http://tempuri.org/">
             <EnviarXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
             <ReporteResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                 <a:codigo>203</a:codigo>
                 <a:codigo>200</a:codigo>
                 <a:documentoId>AHJ07</a:documentoId>
                 <a:documentoselectronicos>
                <a:estatusDocumento>Cargado</a:estatusDocumento>
                    <a:InfoDocumento>
                <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:correlativoempresa>733</a:correlativoempresa>
<a:numeroIdentificacion>45......34</a:numeroIdentificacion>
                        <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:resultado>Procesado</a:resultado>
                 <a:tipoIdentificacion>31</a:tipoIdentificacion>
                 <a:ultimoEnviado>234</a:ultimoEnviado>
             </EnviarXMLResult>
             </ReporteResult>
         </EnviarXMLResponse>
         </ReporteResponse>
     </s:Body>
     </s:Body>
</s:Envelope>
</s:Envelope>
</pre>
</pre>


'''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.


====<font color="blue">Método Envío de Representación Gráfica (EnviarRepGrafica) </font>====


Permite a un Receptor enviar el archivo que corresponde a la representación gráfica de una fatura electrónica,  identificado  con el  número documento, emitido por un proveedor de bienes y servicios identificado al Receptor ya mencionado; el archivo debe remitirse codificado  en Base64.
====<font color="Blue">Ejemplos: tomando el ultimoenviado</font>====
<pre>


<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>


</pre>


; REQUEST: Parámetros a Enviar
====<font color="Blue">Ejemplo Respuesta:Tomando el ultimo enviado</font>====
<pre>
 
<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>
 
</pre>
'''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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
|-
Línea 139: Línea 368:
|- valign="center"
|- valign="center"
|-
|-
|rowspan="1"|Bytes
|Int
|archivo
|Código
|Archivo PDF en Base64 que contiene la representación gráfica del documento electrónico que se desea enviar
|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
|-
|-
|rowspan="9"|String
|Int
|TipoDocumento
|montotal
|Es el tipo de documento al cual se le va a remitir la representación gráfica.
|Monto total de la factura electrónica
|-
|-
|extension
|String
|Indica el formato del archivo remitido; los valores admitidos son: png, bmp, jpg, pdf, doc, docx, xls, xlsx, ppt, pptx, rar, zip
|numerodocumento
|Identificador del documento
|-
|-
|identificadorEmisor
|Int
|numeroidentificacion
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|-
|-
|nombre
|String
|Nombre del archivo de la Representación Gráfica
|razonsocial
|Razón social del Emisor
|-
|String
|tipodocumento
|Identificador del documento
|-
|Int
|tipoemisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 3|Tabla 3]]
|
|-
|Int
|tipoentidad
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|String
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|Boolean
|pendiente
|respuesta (<span style="color:#F1142F; background:#FFFFFF"><b>False</b></span>/<span style="color:#15C71D; background:#FFFFFF"><b>True</b></span>)
|-
|String
|resultado
|Contiene información adicional (<span style="color:#15C71D; background:#FFFFFF"><b>Procesado</b></span>/<span style="color:#F1142F; background:#FFFFFF"><b>Error</b></span>)
|-
|Int
|ultimoenviado
|Último número consecutivo
|}
 
 
===<font color="blue">Método de Descarga XML</font>===
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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|-
|numeroDocumento
|rowspan="3"|Int
|Consecutivo del documento al cual se le remite la representación gráfica.
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|-
|tipoIdentificadoremisor
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|-
|visible
|rowspan="3"|String
|Indica si el archivo posteriormente puede ser o no descargado por el Emisor (Visible = 1, No visible = 0)
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|-
|tokenEmpresa
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|-
|tokenPassword
|tokenPassword
|}
|}
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
</pre>
====<font color="Blue">Ejemplo de salida</font>====
<pre>
<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>
</pre>




Línea 180: Línea 526:
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|- valign="center"
|-
|  -
|archivo
|Archivo en Base 64
|-
|-
|Int
|Int
|codigo
|Código
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]]
|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.
|-
|-
|rowspan="2"|String
|String
|mensaje
|mensaje
|Mensaje descriptivo del resultado de la operación
|Mensaje descriptivo del resultado de la operación
|-
|-
|String
|String
|resultado, contiene información adicional (Procesado/Error)
|resultado
|Contiene información adicional (<span style="color:#15C71D; background:#FFFFFF"><b>Procesado</b></span>/<span style="color:#F1142F; background:#FFFFFF"><b>Error</b></span>)
|-
|Int
|size
|Tamaño del documento
|}
 
===<font color="blue">Método de Descarga RepresentacionGrafica</font>===
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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="2"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|tipoIdentificacionemisor
|Identificador del Emisor  [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|rowspan="3"|String
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
|}


<font color="Blue">Ejemplo de entrada</font>
 
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<pre>
<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: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:Header/>
     <soapenv:Body>
     <soapenv:Body>
         <tem:EnviarRepGrafica>
         <tem:DescargarRepGrafica>
             <tem:request>
             <tem:request>
                 <wcf:TipoDocumento>91</wcf:TipoDocumento>
                 <!--Optional:-->
                <wcf:archivo>JVB……FT0YK</wcf:archivo>
        <wcf:TipoDocumento>91</wcf:TipoDocumento>
                <wcf:extension>ppt</wcf:extension>
                 <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
                 <wcf:identificadorEmisor>45…34</wcf:identificadorEmisor>
                 <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
                <wcf:nombre>SOAP01-2</wcf:nombre>
                 <wcf:numeroDocumento>SOAP019</wcf:numeroDocumento>
                 <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
                 <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
                 <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                 <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                 <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
                 <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
                <wcf:visible>1</wcf:visible>
             </tem:request>
             </tem:request>
         </tem:EnviarRepGrafica>
         </tem:DescargarRepGrafica>
     </soapenv:Body>
     </soapenv:Body>
</soapenv:Envelope>
</soapenv:Envelope>
</pre>
</pre>




 
====<font color="Blue">Ejemplo de salida</font>====
<font color="Blue">Ejemplo de salida</font>
<pre>
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
     <s:Body>
     <s:Body>
         <EnviarRepGraficaResponse xmlns="http://tempuri.org/">
         <DescargarRepGraficaResponse xmlns="http://tempuri.org/">
             <EnviarRepGraficaResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
             <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:codigo>102</a:codigo>
                 <a:mensaje>Token Password es Requerido</a:mensaje>
                <a:crc i:nil="true"/>
                <a:resultado>Error</a:resultado>
                <a:cufe i:nil="true"/>
             </EnviarRepGraficaResult>
                 <a:mensaje>Longitud No Válida para el Tipo de Identificador del Emisor</a:mensaje>
         </EnviarRepGraficaResponse>
  <a:resultado>Error</a:resultado>
                <a:size i:nil="true"/>
             </DescargarRepGraficaResult>
         </DescargarRepGraficaResponse>
     </s:Body>
     </s:Body>
</s:Envelope>
</s:Envelope>
</pre>
</pre>




====<font color="blue">Método Envío de Anexo "EnvioAnexo" </font>====
; RESPONSE: Parámetros a Recibir
Permite remitir un archivo adicional de una factura, diferente a la representación gráfica,  identificando el numero documento al cual se encuentra asociado. El archivo a remitir debe estar codificado en Base64.
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Bas64
|archivo
|Archivo en Base 64
|-
|Int
|codigo
|Código de retorno. [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]]
|-
|string
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|String
|resultado
|Contiene información adicional (<span style="color:#15C71D; background:#FFFFFF"><b>Procesado</b></span>/<span style="color:#F1142F; background:#FFFFFF"><b>Error</b></span>)
|}
 
===<font color="blue">Método de Descarga de Adjuntos/Anexos</font>===
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.




Línea 244: Línea 670:
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|- valign="center"
|-
|-
|Bytes
|rowspan="3"|Int
|archivo
|Archivo en Base64 que representa  un anexo de factura identificada por número de documento
|-
|rowspan="9"|String
|TipoDocumento
|TipoDocumento
|Es el tipo de documento al cual se le remite el anexo.
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|-
|extension
|identificadorEmisor
|Indica el formato del archivo remitido; los valores admitidos son: png, bmp, jpg, pdf, doc, docx, xls, xlsx, ppt, pptx, rar, zip
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|-
|identificadorEmisor
|tipoIdentificacionemisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|Identificador del Emisor   [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|-
|nombre
|String
|Nombre del documento de la Representación Gráfica (Hasta 100 caracteres)
|IdentificadorinternoAnexo
|corresponde al identificador interno (NameFile) del anexo que se desea descargar.
|El FileName se obtiene con el método  ListaAnexo*
|-
|-
|rowspan="3"|String
|numeroDocumento
|numeroDocumento
|Consecutivo del documento al cual se le remite el anexo. (Hasta 20 caracteres)
|Identificador del documento
|-
|Hasta 20 caracteres
|tipoidentificadoremisor
|Tipo de documento del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|visible
|Indica si el archivo posteriormente puede ser o no descargado por el Emisor. (Visible = 1, No visible = 0)
|-
|-
|tokenEmpresa
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|-
|tokenPassword
|tokenPassword
|}
|}
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
</pre>
====<font color="Blue">Ejemplo de salida</font>====
<pre>
<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>
</pre>




Línea 286: Línea 763:
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|- valign="center"
|-
| -
|archivo
|Archivo XML en Base64 que contiene el documento electrónico.
|-
|-
|Int
|Int
|codigo
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]]
|Código de retorno. [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|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
|-
|-
|rowspan="2"|String
|Int
|idfile
|
|}
|string
|mensaje
|mensaje
|Mensaje descriptivo del resultado de la operación
|Mensaje descriptivo del resultado de la operación
|-
|-
|String
|resultado
|resultado
|Contiene información adicional (Procesado/Error)
|Contiene información adicional (Procesado/Error)
|-
|Int
|sizefile
|Tamaño del documento
|-
|Int
|Type
|Tipo de documento, (Ver catálogo)
|}
|}
|}
===<font color="blue">Método Consulta de Estado Documento</font>===
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




<font color="Blue">Ejemplo de entrada</font>
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="3"|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  [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|rowspan="3"|String
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
 
 
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<pre>
<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: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:Header/>
     <soapenv:Body>
     <soapenv:Body>
         <tem:EnviarAnexo>
         <tem:EstadoDocumento>
            <tem:request>
        <!--Optional:-->
                <wcf:archivo>JVB…….</wcf:archivo>
      <tem:request>
                <wcf:extension>pdf</wcf:extension>
        <!--Optional:-->
                <wcf:TipoDocumento>91</wcf:TipoDocumento>
        <wcf:TipoDocumento></wcf:TipoDocumento>
                <wcf:identificadorEmisor>456…34</wcf:identificadorEmisor>
        <!--Optional:-->
                <wcf:nombre>AHJ07-7</wcf:nombre>
        <wcf:identificadorEmisor>25………1</wcf:identificadorEmisor>
                <wcf:numeroDocumento>AHJ07</wcf:numeroDocumento>
        <!--Optional:-->
                <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
        <wcf:numeroDocumento>ERTYBNT017</wcf:numeroDocumento>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
        <!--Optional:-->
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
        <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
                <wcf:visible>1</wcf:visible>
        <!--Optional:-->
            </tem:request>
        <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>
         </tem:EnviarAnexo>
        <!--Optional:-->
        <wcf:tokenPassword>b3…………43</wcf:tokenPassword>
    </tem:request>
         </tem:EstadoDocumento>
     </soapenv:Body>
     </soapenv:Body>
</soapenv:Envelope>
</soapenv:Envelope>
</pre>
</pre>




<font color="Blue">Ejemplo de salida</font>
====<font color="Blue">Ejemplo de salida</font>====
<pre>
<pre>
<?xml version="1.0" encoding="UTF-8"?>
 
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
     <s:Body>
     <s:Body>
         <EnviarAnexoResponse xmlns="http://tempuri.org/">
         <EstadoDocumentoResponse xmlns="http://tempuri.org/">
             <EnviarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
             <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:codigo>200</a:codigo>
                 <a:mensaje>Archivo enviado satisfactoriamente</a:mensaje>
                <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:resultado>Procesado</a:resultado>
             </EnviarAnexoResult>
                <a:tipoDocumento>01</a:tipoDocumento>
         </EnviarAnexoResponse>
                <a:uuid>0e12f97ef3...060039e2d5f2</a:uuid>
             </EstadoDocumentoResult>
         </EstadoDocumentoResponse>
     </s:Body>
     </s:Body>
</s:Envelope>
</s:Envelope>
</pre>
</pre>






===<font color="blue">Gestión de Documentos Electrónicos</font>===
Engloba las funcionalidades inherentes a la gestión propia de los documentos ya radicados, para ello se cuenta con los métodos:


====<font color="blue">Método Cambio de Estatus "CambioEstatus"</font>====
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|comentarios
|Status del documento . [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]]
|-
|String
|descripcion
|Descripción del status relacionado
|-
|Int
|codigoEStatus
|Código del estatus. [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]]
|-
|Date
|fecha
|fecha en formato “s” ”( yyyy'-'MM'-'dd'T'HH':'mm':'ss )  del estatus actual
|-
|String
|uuid
|Identificador Universal Único
|}
 
===<font color="blue">Método Cambio de Status</font>===
Este método permite la actualización del estado (o generación de eventos) de un Documento de Facturación Electrónica previamente emitido. Solo cuando el Adquiriente (Receptor de la factura electrónica) tiene a The Factory HKA Colombia como su Proveedor Tecnológico de Facturación Electrónica.
Este método permite la actualización del estado (o generación de eventos) de un Documento de Facturación Electrónica previamente emitido. Solo cuando el Adquiriente (Receptor de la factura electrónica) tiene a The Factory HKA Colombia como su Proveedor Tecnológico de Facturación Electrónica.


Línea 409: Línea 1033:
|-
|-
|tokenEmpresa
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|
|Dato suministrado por The Factory HKA Colombia (40 caracteres).
|-
|-
|tokenPassword
|tokenPassword
|}
|
 
|Dato suministrado por The Factory HKA Colombia (40 caracteres).
 
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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)
|}
|}


 
====<font color="Blue">Ejemplo de entrada</font>====
<font color="Blue">Ejemplo de entrada</font>
<pre>
<pre>
<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:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
Línea 470: Línea 1075:
</pre>
</pre>


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


Línea 487: Línea 1092:




====<font color="blue">Método DescargarAcuseAceptacionXML</font>====
 
Permite obtener el archivo XML ApplicationResponse en Base64,correspondiente  al evento de aceptación de la Factura Electrónica.
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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)
|}
 
===<font color="blue">Método Consulta de Metadata (infodatos) (a los documentos) ConsultaDocumentosMetadata</font>===
(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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="3"|Int
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor[[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
 
 
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
 
</pre>
 
 
====<font color="Blue">Ejemplo de salida</font>====
<pre>
<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&amp;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>
 
</pre>
 
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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
|}
 
 
</pre>
 
 
 
 
 
 
 
===<font color="blue">Método ListaAnexo </font>===
 
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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="3"|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 [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|rowspan="3"|String
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
 
 
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
 
</pre>
 
 
 
====<font color="Blue">Ejemplo de salida</font>====
<pre>
<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>
 
</pre>
 
 
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="4"|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 [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 5|Tabla 5]]
|-
|size
|tamaño del documento
|-
|rowspan="5"|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
|-
|rowspan="2"|Time
|UpdatedAt
|fecha de la última actualización del archivo
|-
|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
 
</pre>
 
===<font color="blue">Método DescargaAnexo</font>===
 
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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="2"|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
|-
|rowspan="5"|String
|identificadorinternoanexo
|Identificador del Anexo el cual debe de consultarse en el '''Método de ListaAnexo'''
|
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
 
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
</pre>
 
 
====<font color="Blue">Ejemplo de salida</font>====
<pre>
<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>
 
 
</pre>
 
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| -
|archivo
|Archivo en Base 64 del documento
|-
|rowspan="4"|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|Id
|Id del documento.
|-
|Type
|Tipo de documento, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 3|Tabla 3]]
|-
|sizeFile
|tamaño del documento
|-
|rowspan="6"|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)
|}
 
</pre>
 
===<font color="blue">Método Envío de Representación Gráfica (EnviarRepGrafica) </font>===
 
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
; REQUEST: Parámetros a Enviar
Línea 496: Línea 1569:
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|- valign="center"
|-
|-
|rowspan="8"|String
|rowspan="3"|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
|
|-
|rowspan="7"|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
|png|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
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
 
 
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
 
 
</pre>
 
 
 
====<font color="Blue">Ejemplo de salida</font>====
<pre>
<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>
 
 
</pre>
 
 
 
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Int
|codigo
|Código de retorno, (Ver catálogo de respuesta del método)
|-
|rowspan="2"|String
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|String
|resultado, contiene información adicional (Procesado/Error)
|}
 
 
</pre>
 
===<font color="blue">Método Envío de XML Método de “EnviarXML” </font>===
 
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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|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.
|
|-
|rowspan="3"|String
|archivo
|Archivo XML en Base64 que contiene el documento electrónico que se desea enviar
|
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
 
 
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
 
</pre>
 
 
 
====<font color="Blue">Ejemplo de salida</font>====
<pre>
<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>
 
</pre>
 
 
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| -
|archivo
|Archivo en Base 64 del documento
|-
|rowspan="3"|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]]
|-
|numeroIdentificacion
|Id del documento.
|-
|tipoIdentificacion
|Tipo de identificación del documento
|-
|rowspan="4"|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)
|}
 
 
</pre>
 
 
 
===<font color="blue">Método Envío de Anexo (EnvioAnexo) </font>===
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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|  -
|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
|-
|rowspan="3"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|tipoidentificadoremisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|
|-
|rowspan="5"|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
|png|bmp|jpg|pdf|doc|docx|xls|xlsx|ppt|pptx|rar|zip
|-
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
 
 
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
 
 
 
</pre>
 
 
 
====<font color="Blue">Ejemplo de salida</font>====
<pre>
<?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>
 
</pre>
 
 
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]]
|-
|rowspan="2"|String
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|String
|resultado
|Contiene información adicional (Procesado/Error)
|}
 
</pre>
===<font color="blue">Método EliminarRepGrafica</font>===
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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="3"|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 [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
 
 
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
 
 
 
</pre>
 
 
====<font color="Blue">Ejemplo de salida</font>====
<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>
 
</pre>
 
 
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Código
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| 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
|}
 
 
===<font color="blue">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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="3"|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 [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
 
 
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
 
 
 
 
</pre>
 
 
====<font color="Blue">Ejemplo de salida</font>====
<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>
 
 
</pre>
 
 
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| Identificador
| Código de retorno.
|-
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|resultado
|Contiene información adicional (Procesado/Error)
|}
 
 
 
 
 
===<font color="blue">Método DescargarRecepcionBienServicioXML</font>===
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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="6"|Int
|TipoDocumento
|TipoDocumento
|Es el tipo de documento del cual se desea descrgar el XML.
|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  
|identificadorEmisor  
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|nmeroDocumento
|Identificador del documento
|2 caracteres
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
</pre>
====<font color="Blue">Ejemplo de salida</font>====
<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>
</pre>
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| -
|archivo
|Archivo en Base 64 del documento
|-
|rowspan="2"|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|sizeFile
|tamaño del documento
|-
|rowspan="4"|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)
|}
===<font color="blue">Método DescargarAcuseReclamo</font>===
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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="6"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|-
|nombreFileApplicationResponse  
|nombreFileApplicationResponse  
|Nombre del documento que se encuentra en Lista de Anexo (Opcional)
|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 [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|-
|nmeroDocumento
|nmeroDocumento
|Consecutivo del documento del cual se desea obtener el XML.
|Identificador del documento
|2 caracteres
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
 
 
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
 
 
 
 
 
 
</pre>
 
 
====<font color="Blue">Ejemplo de salida</font>====
<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>
 
 
 
 
 
 
 
</pre>
 
 
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| -
|archivo
|Archivo en Base 64 del documento
|-
|rowspan="2"|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|sizeFile
|tamaño del documento
|-
|rowspan="4"|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)
|}
 
 
 
 
 
 
 
 
 
 
 
===<font color="blue">Método DescargarAcuseRecibido</font>===
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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="6"|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
|tipoDescarga
|Igual a 1
|Tipo de Descarga del documento
|
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|-
|tipoIdentificacionemisor
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|nmeroDocumento
|Identificador del documento
|2 caracteres
|-
|-
|rowspan="3"|String
|tokenEmpresa
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|-
|tokenPassword
|tokenPassword
|}
|}
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<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>
</pre>
====<font color="Blue">Ejemplo de salida</font>====
<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>
</pre>




Línea 532: Línea 2556:
|- valign="center"
|- valign="center"
|-
|-
|Bytes
| -
|archivo
|archivo
|Archivo en Base64 del documento
|Archivo en Base 64 del documento
|-
|-
|rowspan="2"|Int
|rowspan="2"|Int
Línea 558: Línea 2582:




<font color="Blue">Ejemplo de entrada</font>
 
 
 
 
 
 
 
 
 
 
 
 
===<font color="blue">Método DescargarAcuseAceptacion</font>===
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
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="6"|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 [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|nmeroDocumento
|Identificador del documento
|2 caracteres
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
 
 
====<font color="Blue">Ejemplo de entrada</font>====
<pre>
<pre>
<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:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
Línea 564: Línea 2645:
     <soapenv:Body>
     <soapenv:Body>
         <tem:DescargarAcuseAceptacionXML>
         <tem:DescargarAcuseAceptacionXML>
    <!--Optional:-->
     <tem:request>
     <tem:request>
        <!--Optional:-->
         <wcf:TipoDocumento></wcf:TipoDocumento>
         <wcf:TipoDocumento></wcf:TipoDocumento>
        <!--Optional:-->
         <wcf:identificadorEmisor>90……26</wcf:identificadorEmisor>
         <wcf:identificadorEmisor>90……26</wcf:identificadorEmisor>
        <!--Optional:-->
         <wcf:nombreFileApplicationResponse>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</wcf:nombreFileApplicationResponse>
         <wcf:nombreFileApplicationResponse>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</wcf:nombreFileApplicationResponse>
        <!--Optional:-->
         <wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento>
         <wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento>
        <!--Optional:-->
         <wcf:tipoDescarga>1</wcf:tipoDescarga>
         <wcf:tipoDescarga>1</wcf:tipoDescarga>
        <!--Optional:-->
         <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
         <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
        <!--Optional:-->
         <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>
         <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>
        <!--Optional:-->
         <wcf:tokenPassword>b3…………43</wcf:tokenPassword>
         <wcf:tokenPassword>b3…………43</wcf:tokenPassword>
     </tem:request>
     </tem:request>
Línea 577: Línea 2667:
     </soapenv:Body>
     </soapenv:Body>
</soapenv:Envelope>
</soapenv:Envelope>
</pre>
</pre>




<font color="Blue">Ejemplo de salida</font>
====<font color="Blue">Ejemplo de salida</font>====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
     <s:Body>
     <s:Body>
Línea 597: Línea 2696:
     </s:Body>
     </s:Body>
</s:Envelope>
</s:Envelope>
</pre>
</pre>
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| -
|archivo
|Archivo en Base 64 del documento
|-
|rowspan="2"|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|sizeFile
|tamaño del documento
|-
|rowspan="4"|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)
|}
</pre>
'''Mensaje:''' String que contiene mensaje descriptivo del resultado de la operación
'''resultado:'''  String que contiene información adicional (Uso futuro)

Revisión actual - 17:12 11 feb 2026

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
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
tokenPassword

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
tokenPassword


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


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
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


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


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


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

Este método permite la actualización del estado (o generación de eventos) de un Documento de Facturación Electrónica previamente emitido. Solo cuando el Adquiriente (Receptor de la factura electrónica) tiene a The Factory HKA Colombia como su Proveedor Tecnológico de Facturación Electrónica.

NOTA:Si el documento está en un estado DIAN y se requiere cambiar a otro estado y se genera una regla de rechazo, puede que se encuentre en espera para recibir respuesta de la DIAN del cambio de estado inicial, por lo cual se recomienda esperar 5 minutos antes de realizar un nuevo cambio de estado.

REQUEST
Parámetros a Enviar
Tipo Identificador Atributo Descripción
class EjecutadorPor Apellido Apellido de la persona encargada de realizar el cambio de estado.
Cargo Cargo u ocupación que desempeña la persona que realiza el cambio de estado en la organización, organismo o empresa.(opcional).
Departamento. Área en la que se encuentra la persona encargada del cambio de estado (opcional).
DV Digito verificador del NIT de la empresa.
NumeroIdentificacion NIT de la empresa.
TipoIdentificacion Tipo de identifiación de la empresa según la Tabla 4
Nombre Nombre de la persona encargada de realizar el cambi de estado o envio de eventos hacia la DIAN.
String TipoDocumento Es el tipo de documento al cual se le aplicará el cambio de estado (01 para facturas)
codigoRechazo Código de la razón por la cual se realiza el reclamo de la factura según Tabla 6.

IMPORTANTE: El codigoRechazo es requerido al realizar el reclamo de una factura.

identificadorEmisor NIT del Emisor o Identificador Tributario del Emisor de la Factura, de 6 a 20 dígitos
numeroDocumento Consecutivo 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 Tipo de identificador del Emisor del documento según Tabla 4
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:CambioEstatus>
         <tem:request>
            <wcf:EjecutadoPor>
               <wcf:Apellido>López</wcf:Apellido>
               <wcf:Cargo>Pruebas</wcf:Cargo>
               <wcf:Departamento>Calidad</wcf:Departamento>
               <wcf:Identificacion>
                  <wcf:Dv/>
                  <wcf:NumeroIdentificacion>148777333351</wcf:NumeroIdentificacion>
                  <wcf:TipoIdentificacion>13</wcf:TipoIdentificacion>
               </wcf:Identificacion>
               <wcf:Nombre>Adriana</wcf:Nombre>
            </wcf:EjecutadoPor>
            <wcf:TipoDocumento>01</wcf:TipoDocumento>
            <wcf:codigoRechazo>02</wcf:codigoRechazo>
            <wcf:identificadorEmisor>90………26</wcf:identificadorEmisor>
            <wcf:numeroDocumento>AKLAA16</wcf:numeroDocumento>
            <wcf:status>10</wcf:status>
            <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
            <wcf:tokenEmpresa>xxxxxxxxxx</wcf:tokenEmpresa>
            <wcf:tokenPassword>xxxxxxxxxxx</wcf:tokenPassword>
         </tem:request>
      </tem:CambioEstatus>
   </soapenv:Body>
</soapenv:Envelope>

Ejemplo de salida


<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
tokenPassword


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


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
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
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

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


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 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


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


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 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


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


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


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
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


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
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


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
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


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
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)