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
← Edición anterior
Nhoyos (discusión | contribs.)
344 ediciones
Sin resumen de edición
Sin resumen de edición
 
(No se muestran 11 ediciones intermedias de 2 usuarios)
Línea 1: Línea 1:


<includeonly>=</includeonly>==<font color="blue">Servicios de Manejo de Documentos Electrónicos para Receptor</font>==<includeonly>=</includeonly>
<includeonly>=</includeonly>==<font color="blue" strong>Métodos del Servicio Web HKA Recepción </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 12: Línea 28:
! 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="2"|Int
|Class
|consecutivo
|metadata
|Número consecutivo de los documentos a revisa
|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 del documento o en blanco
|-
|-
|status_code
|rowspan="3"|String
|Código de Estatus del documento
|archivo
|Requerido para la búsqueda*,se puede verificar en la siguiente[[#Tabla.1|Tabla.1]].
|Archivo XML en Base64 que contiene el documento electrónico que se desea enviar
|-
|-
|rowspan="2"|String
|tokenEmpresa
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|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">Tabla 1</font>====
{| class="wikitable" style="width: 100%;"
|+ Descripción del Estado del Documento
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|00
|Cargado
|-
|01
|Entregado
|-
|02
|Aceptación expresa (DIAN)
|-
|04
|Reclamo (DIAN)
|-
|10
|Acuse de recibo (DIAN
|-
|11
|Rechazado (DIAN)
|-
|12
|Recibo del bien y/o prestación del servicio
|-
|13
|Precargado
|}
|}
====<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 146: Línea 53:
|- valign="center"
|- valign="center"
|-
|-
|Int
|rowspan="7"|String
|Código
|codigo
|Código de retorno. Ver catálogo de respuesta del método
|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]]
|-
|-
|Int
|documentoId
|CorrelativoEmpresa
|Consecutivo del documento remitido.
|Número correlativo de la empresa
|-
|-
|String
|estatusDocumento
|estatus
|Estatus final del documento del Documento.
|Estatus del documento en el que se encuentra (Ver tabla relacionada)
|-
|-
|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
|
|-
|Int
|tipoentidad
|Identificador del Emisor (Revisión de tabla )
|-
|String
|mensaje
|mensaje
|Mensaje descriptivo del resultado de la operación
|Mensaje descriptivo del resultado de la operación.
|-
|-
|Boolean
|numeroIdentificacion
|pendiente
|Número de identificación del emisor del documento remitido.
|respuesta (false/True
|-
|-
|String
|resultado
|resultado
|Contiene información adicional (Procesado/Error)
|Contiene información adicional (Procesado/Error)
|-
|-
|Int
|tipoIdentificacion
|ultimoenviado
|Tipo de identificación del emisor del documento remitido.
|Último número consecutivo
|}
|}


===<font color="blue">Método Reporte</font>===
<font color="Blue">Ejemplo de entrada</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
|-
|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:Reporte>
         <tem:EnviarXML>
             <tem:request>
             <tem:request>
                 <wcf:consecutivo>800</wcf:consecutivo>
                 <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:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                 <wcf:tokenPassword>b3…………43</wcf:tokenPassword>
                 <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
             </tem:request>
             </tem:request>
         </tem:Reporte>
         </tem:EnviarXML>
     </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>
         <ReporteResponse xmlns="http://tempuri.org/">
         <EnviarXMLResponse xmlns="http://tempuri.org/">
             <ReporteResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
             <EnviarXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                 <a:codigo>200</a:codigo>
                 <a:codigo>203</a:codigo>
                 <a:documentoselectronicos>
                 <a:documentoId>AHJ07</a:documentoId>
                    <a:InfoDocumento>
                <a:estatusDocumento>Cargado</a:estatusDocumento>
                        <a:correlativoempresa>733</a:correlativoempresa>
                <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:cufe>0e12f97ef32ed6c1b104bfb...ad96f36060039e2d5f2</a:cufe>
<a:numeroIdentificacion>45......34</a:numeroIdentificacion>
                        <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:ultimoEnviado>234</a:ultimoEnviado>
                 <a:tipoIdentificacion>31</a:tipoIdentificacion>
             </ReporteResult>
             </EnviarXMLResult>
         </ReporteResponse>
         </EnviarXMLResponse>
     </s:Body>
     </s:Body>
</s:Envelope>
</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.
====<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>
</pre>


====<font color="Blue">Ejemplo Respuesta:Tomando el ultimo enviado</font>====
<pre>


<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
====<font color="blue">Método Envío de Representación Gráfica (EnviarRepGrafica) </font>====
  <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>


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


====<font color="Blue">Tabla 2</font>====
{| class="wikitable" style="width: 100%;"
|+ Códigos de retorno y sin estatus
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango /  Valor no válido para el campo {nombre del campo}
|-
|103
|Error Interno en el Servicio
|}
|}


====<font color="Blue">Tabla 3</font>====
{| class="wikitable" style="width: 100%;"
|+ Descripción del Estado del Documento
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|00
|Cargado
|-
|01
|Entregado
|-
|02
|Aceptación expresa (DIAN)
|-
|04
|Reclamo (DIAN)
|-
|10
|Acuse de recibo (DIAN
|-
|11
|Rechazado (DIAN)
|-
|12
|Recibo del bien y/o prestación del servicio
|-
|13
|Precargado
|}
|}
===<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
; 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 451: Línea 137:
! 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="2"|Int
|rowspan="1"|Bytes
|identificadorEmisor  
|archivo
|Archivo PDF en Base64 que contiene la representación gráfica del documento electrónico que se desea enviar
|-
|rowspan="9"|String
|TipoDocumento
|Es el tipo de documento al cual se le va a remitir la representación gráfica.
|-
|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
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|-
|tipoIdentificacionemisor
|nombre
|Identificador del Emisor  (Revisión de tabla 1 )
|Nombre del archivo de la Representación Gráfica
|2 caracteres
|-
|-
|rowspan="3"|String
|numeroDocumento
|numeroDocumento
|Identificador del documento
|Consecutivo del documento al cual se le remite la representación gráfica.
|Hasta 20 caracteres
|-
|tipoIdentificadoremisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|
|-
|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
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|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: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>




Línea 506: Línea 180:
! 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
|Código
|codigo
|Código de retorno. Ver catálogo de respuesta del método
|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
|rowspan="2"|String
|crc
|Chequeo de Redundancia Cíclica
|-
|String
|cufe
|Certificado Único de Facturación Electrónica.
|-
|String
|mensaje
|mensaje
|Mensaje descriptivo del resultado de la operación
|Mensaje descriptivo del resultado de la operación
|-
|-
|String
|String
|resultado
|resultado, contiene información adicional (Procesado/Error)
|Contiene información adicional (Procesado/Error)  
|-
|Int
|size
|Tamaño del documento
|}
|}


 
<font color="Blue">Ejemplo de entrada</font>
====<font color="Blue">Ejemplo de salida</font>====
<pre>
<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>
====<font color="Blue">Tabla 4</font>====
{| class="wikitable" style="width: 100%;"
|+ Códigos de retorno y sin estatus
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango /  Valor no válido para el campo {nombre del campo}
|-
|103
|Error Interno en el Servicio
|}
|}
===<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
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor  (Revisión de tabla 1 )
|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: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:DescargarRepGrafica>
         <tem:EnviarRepGrafica>
             <tem:request>
             <tem:request>
                 <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
                <wcf:TipoDocumento>91</wcf:TipoDocumento>
                 <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
                <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: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:DescargarRepGrafica>
         </tem:EnviarRepGrafica>
     </soapenv:Body>
     </soapenv:Body>
</soapenv:Envelope>
</soapenv: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"
|-
|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)
|}


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




====<font color="Blue">Tabla 5</font>====
====<font color="blue">Método Envío de Anexo "EnvioAnexo" </font>====
{| class="wikitable" style="width: 100%;"
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.
|+ Códigos de retorno DescargarRepGráfica
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango /  Valor no válido para el campo {nombre del campo}
|-
|103
|Error Interno en el Servicio
|}
|}
 
 
 
===<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 711: Línea 244:
! 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="2"|Int
|Bytes
|identificadorEmisor  
|archivo
|Archivo en Base64 que representa  un anexo de factura identificada por número de documento
|-
|rowspan="9"|String
|TipoDocumento
|Es el tipo de documento al cual se le remite el anexo.
|-
|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
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|-
|tipoIdentificacionemisor
|nombre
|Identificador del Emisor  (Revisión de tabla 1 )
|Nombre del documento de la Representación Gráfica (Hasta 100 caracteres)
|2 caracteres  
|-
|numeroDocumento
|Consecutivo del documento al cual se le remite el anexo. (Hasta 20 caracteres)
|-
|-
|String
|tipoidentificadoremisor
|IdentificadorinternoAnexo
|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]]
|corresponde al identificador interno (NameFile) del anexo que se desea descargar.
|El FileName se obtiene con el método  ListaAnexo*
|-
|-
|rowspan="3"|String
|visible
|numeroDocumento
|Indica si el archivo posteriormente puede ser o no descargado por el Emisor. (Visible = 1, No visible = 0)
|Identificador del documento
|Hasta 20 caracteres
|-
|-
|tokenEmpresa
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|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:DescargarAnexo>
            <tem:request>
                <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
                <wcf:identificadorInternoAnexo>32168992-676A-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>




Línea 770: Línea 286:
! 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. Ver catálogo de respuesta del método
|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
|rowspan="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
|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">Ejemplo de salida</font>====
<font color="Blue">Ejemplo de entrada</font>
<pre>
<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>
====<font color="Blue">Tabla 6</font>====
{| class="wikitable" style="width: 100%;"
|+ Códigos de retorno Descarga de Adjuntos/Anexos
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango /  Valor no válido para el campo {nombre del campo}
|-
|103
|Error Interno en el Servicio
|}
|}
===<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
; 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
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor  (Revisión de tabla 1 )
|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: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:EstadoDocumento>
         <tem:EnviarAnexo>
             <tem:request>
             <tem:request>
                 <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
                <wcf:archivo>JVB…….</wcf:archivo>
                 <wcf:numeroDocumento>ABB09</wcf:numeroDocumento>
                <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: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:EstadoDocumento>
         </tem:EnviarAnexo>
     </soapenv:Body>
     </soapenv:Body>
</soapenv:Envelope>
</soapenv:Envelope>
</pre>
</pre>




; RESPONSE: Parámetros a Recibir
<font color="Blue">Ejemplo de salida</font>
{| 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 . Ver catálogo de respuesta del método
|-
|String
|descripcion
|Descripción del status relacionado
|-
|Int
|codigoEStatus
|Código del estatus
|-
|Date
|fecha
|fecha en formato “s” ”( yyyy'-'MM'-'dd'T'HH':'mm':'ss )  del estatus actual
|-
|String
|uuid
|Identificador Universal Único
|}
 
 
====<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>
         <EstadoDocumentoResponse xmlns="http://tempuri.org/">
         <EnviarAnexoResponse xmlns="http://tempuri.org/">
             <EstadoDocumentoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
             <EnviarAnexoResult 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:estatusDIANDescripcion/>
                 <a:mensaje>Archivo enviado satisfactoriamente</a:mensaje>
                <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>
                <a:tipoDocumento>01</a:tipoDocumento>
             </EnviarAnexoResult>
                <a:uuid>0e12f97ef3...060039e2d5f2</a:uuid>
         </EnviarAnexoResponse>
             </EstadoDocumentoResult>
         </EstadoDocumentoResponse>
     </s:Body>
     </s:Body>
</s:Envelope>
</s:Envelope>
</pre>
</pre>
====<font color="Blue">Tabla 7</font>====
{| class="wikitable" style="width: 100%;"
|+ Códigos de retorno Descarga de Estatus
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango /  Valor no válido para el campo {nombre del campo}
|-
|103
|Error Interno en el Servicio
|}
|}






===<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 Status</font>===
====<font color="blue">Método Cambio de Estatus "CambioEstatus"</font>====
Permite cambiar el estatus de un documento de Facturación Electrónica,  que originalmente fue emitida por un Emisor, del cual el adquiriente tiene como proveedor tecnológico de Facturación Electrónica a The Factory HKA Colombia.
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 es imposible hacerlo, puede que esté en espera para recibir respuesta de la DIAN, por lo cual se debe de esperar 5 minutos para realizar el cambio  
'''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
; REQUEST: Parámetros a Enviar
Línea 1049: Línea 355:
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Atributo
! 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="2"|Int
|rowspan="7"|class
|rowspan="7"|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 [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|Nombre
|Nombre de la persona encargada de realizar el cambi de estado o envio de eventos hacia la DIAN.
|-
|rowspan="8"|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 [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 6|Tabla 6]].
<font color="red">'''IMPORTANTE''':</font> El '''codigoRechazo''' es requerido al realizar el reclamo de una factura.
|-
|identificadorEmisor  
|identificadorEmisor  
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|
|De 6 a 20 dígitos
|NIT del Emisor o Identificador Tributario del Emisor de la Factura, de 6 a 20 dígitos
|-
|-
|tipoIdentificacionemisor
|numeroDocumento
|Identificador del Emisor  (Revisión de tabla 1 )
|
|2 caracteres  
|Consecutivo del documento hasta 20 caracteres  
|-
|-
|rowspan="4"|String
|status
|numeroDocumento
|  
|Identificador del documento
|Código de Estatus del documento,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]]
|Hasta 20 caracteres
|-
|-
|String
|tipoIdentificacionemisor
|Identificadorinternoanexo
|dentificador del Anexo el cual debe de consultarse en el Método de ListaAnexo
|
|
|Tipo de identificador del Emisor del documento según [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|-
|tokenEmpresa
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|rowspan="2"|40 caracteres
|-
|-
|tokenPassword
|tokenPassword
|}
El código de Rechazo es requerido para realizar cualquier cambio de estado.
====<font color="Blue">CodigoRechazo</font>====
{| class="wikitable" style="width: 100%;"
|+ CodigoRechazo
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|01
|Documento con inconsistencias
|-
|02
|Mercancía no entregada totalmente
|-
|03
|Mercancía no entregada parcialmente
|-
|04
|Servicio no prestado
|}
|}
|}
====<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:CambioEstatus>
            <tem:request>
                <wcf:EjecutadoPor>
                    <wcf:Apellido>López</wcf:Apellido>
                    <wcf:Cargo>Recursos</wcf:Cargo>
                    <wcf:Departamento>RG</wcf:Departamento>
                    <wcf:Identificacion>
                        <wcf:Dv>9</wcf:Dv>
                        <wcf:NumeroIdentificacion>31</wcf:NumeroIdentificacion>
                        <wcf:TipoIdentificacion>31</wcf:TipoIdentificacion>
                    </wcf:Identificacion>
                    <wcf:Nombre>Adriana</wcf:Nombre>
                </wcf:EjecutadoPor>
                <wcf:codigoRechazo>01</wcf:codigoRechazo>
                <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
                <wcf:numeroDocumento>ABB01</wcf:numeroDocumento>
                <wcf:status>13</wcf:status>
                <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
</tem:CambioEstatus>
    </soapenv:Body>
</soapenv:Envelope>
</p>




Línea 1158: Línea 436:
|}
|}


====<font color="Blue">Ejemplo de salida</font>====
 
<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: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>
 
</pre>
 
<font color="Blue">Ejemplo de salida</font>
<pre>
<pre>


Línea 1172: Línea 484:
     </s:Body>
     </s:Body>
</s:Envelope>
</s:Envelope>
</pre>
</pre>




 
====<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.
====<font color="Blue">Tabla 8</font>====
{| class="wikitable" style="width: 100%;"
|+ Códigos de retorno Descarga de Estatus
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango /  Valor no válido para el campo {nombre del campo}
|-
|103
|Error Interno en el Servicio
|}
|}
 
 
 
====<font color="Blue">Tabla 9</font>====
{| class="wikitable" style="width: 100%;"
|+ Descripción del Estado del Documento
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|00
|Cargado
|-
|01
|Entregado
|-
|02
|Aceptación expresa (DIAN)
|-
|04
|Reclamo (DIAN)
|-
|10
|Acuse de recibo (DIAN
|-
|11
|Rechazado (DIAN)
|-
|12
|Recibo del bien y/o prestación del servicio
|-
|13
|Precargado
|}
|}
 
 
 
 
===<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
; REQUEST: Parámetros a Enviar
Línea 1252: Línea 496:
! 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"
|-
|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  (Revisión de tabla 1 )
|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>
; 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
|}
====<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>
====<font color="Blue">Tabla 10</font>====
{| class="wikitable" style="width: 100%;"
|+ Códigos de retorno Metadata
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|-
|102
|rowspan="8"|String
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango /  Valor no válido para el campo {nombre del campo}
|TipoDocumento
|Es el tipo de documento del cual se desea descrgar el XML.
|-
|-
|103
|Error Interno en el Servicio
|}
|}
===<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="2"|Int
|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  (Revisión de tabla 1 )
|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: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>
; 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 (Ver tabla)
|-
|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
====<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>
====<font color="Blue">Tabla 11</font>====
{| class="wikitable" style="width: 100%;"
|+ Códigos de TypeCode
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|1
|Representación Gráfica
|-
|2
|Anexo
|-
|3
|Para uso futuro
|-
|4
|Para uso futuro
|-
|-
|5
|nombreFileApplicationResponse
|Acuse de recibo de Factura Electrónica de Venta
|Nombre del documento que se encuentra en Lista de Anexo (Opcional)
|-
|-
|6
|nmeroDocumento
|Acuse Aceptación expresa
|Consecutivo del documento del cual se desea obtener el XML.
|-
|-
|7
|tipoDescarga
|Acuse de Reclamo de la Factura Electrónica de Venta
|Igual a 1
|-
|12
|Acuse de Recibo del bien y/o prestación del servicio
|}
|}
 
 
 
 
 
 
===<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"
|-
|Int
|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
|tipoIdentificacionemisor
|Identificador del Emisor (Revisión de tabla 1 )
|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
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|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:DescargarAnexo>
            <tem:request>
                <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>




Línea 1673: Línea 532:
|- valign="center"
|- valign="center"
|-
|-
| -
|Bytes
|archivo
|archivo
|Archivo en Base 64 del documento
|Archivo en Base64 del documento
|-
|-
|rowspan="4"|Int
|rowspan="2"|Int
|codigo
|codigo
|Código de retorno, (Ver catálogo de respuesta del método)
|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, (Ver catálogo)
|-
|-
|sizeFile
|sizeFile
|tamaño del documento
|tamaño del documento
|-
|-
|rowspan="6"|String
|rowspan="4"|String
|crc
|crc
|Chequeo de Redundancia Cíclica
|Chequeo de Redundancia Cíclica
Línea 1696: Línea 549:
|cufe
|cufe
|Certificado Único de Facturación Electrónica.
|Certificado Único de Facturación Electrónica.
|-
|displayname
|
|-
|extension
|Tipo de documento que se tiene
|-
|-
|mensaje
|mensaje
Línea 1711: Línea 558:




 
<font color="Blue">Ejemplo de entrada</font>
====<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>
 
 
 
====<font color="Blue">Tabla 12</font>====
{| class="wikitable" style="width: 100%;"
|+ Códigos de DescargaAnexo
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango /  Valor no válido para el campo {nombre del campo}
|-
|103
|Error Interno en el Servicio
|}
|}
 
 
 
 
 
===<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
{| 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
|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>
<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:DescargarAcuseAceptacionXML>
            <tem:request>
    <tem:request>
                <wcf:archivo>JVB……FT0YK</wcf:archivo>
        <wcf:TipoDocumento></wcf:TipoDocumento>
                <wcf:extension>ppt</wcf:extension>
        <wcf:identificadorEmisor>90……26</wcf:identificadorEmisor>
                <wcf:identificadorEmisor>45…34</wcf:identificadorEmisor>
        <wcf:nombreFileApplicationResponse>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</wcf:nombreFileApplicationResponse>
                <wcf:nombre>SOAP01-2</wcf:nombre>
        <wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento>
                <wcf:numeroDocumento>SOAP019</wcf:numeroDocumento>
        <wcf:tipoDescarga>1</wcf:tipoDescarga>
                <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:DescargarAcuseAceptacionXML>
        </tem:EnviarRepGrafica>
     </soapenv:Body>
     </soapenv:Body>
</soapenv:Envelope>
</soapenv:Envelope>
</pre>
</pre>




 
<font color="Blue">Ejemplo de salida</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"
|-
|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)
|}
 
 
 
====<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/">
        <DescargarAcuseAceptacionXMLResponse xmlns="http://tempuri.org/">
             <EnviarRepGraficaResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
             <DescargarAcuseAceptacionXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:codigo>102</a:codigo>
              <a:archivo>PD94bWwgd…………………</a:archivo>
                <a:mensaje>Token Password es Requerido</a:mensaje>
                <a:resultado>Error</a:resultado>
            </EnviarRepGraficaResult>
        </EnviarRepGraficaResponse>
    </s:Body>
</s:Envelope>
 
 
</pre>
 
 
 
====<font color="Blue">Tabla 2</font>====
{| Códigos de retorno de EnvioRepGrafica
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango /  Valor no válido para el campo {nombre del campo}
|-
|103
|Error Interno en el Servicio
|}
|}
 
 
 
 
===<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>
 
 
 
; 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, (Ver catálogo de respuesta del método)
|-
|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)
|}
 
 
 
====<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>
 
 
 
====<font color="Blue">Tabla 2</font>====
{| class="wikitable" style="width: 100%;"
|+ Códigos de EnvioXML
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango /  Valor no válido para el campo {nombre del campo}
|-
|103
|Error Interno en el Servicio
|}
|}
 
 
 
 
 
===<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="2"|Int
|tipoidentificadoremisor
|Identificador del Emisor (Revisión de tabla 1 )
|2 caracteres
|-
|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: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>
 
 
 
; 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)
|}
 
 
 
====<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:codigo>200</a:codigo>
                 <a:mensaje>Archivo enviado satisfactoriamente</a:mensaje>
                <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:resultado>Procesado</a:resultado>
             </EnviarAnexoResult>
                <a:size>14688</a:size>
        </EnviarAnexoResponse>
             </DescargarAcuseRecibidoXMLResult>
  </DescargarAcuseRecibidoXMLResponse>
     </s:Body>
     </s:Body>
</s:Envelope>
</s:Envelope>
</pre>
</pre>
====<font color="Blue">Tabla 2</font>====
{| class="wikitable" style="width: 100%;"
|+ Códigos de retorno de EnvioRepGrafica
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango /  Valor no válido para el campo {nombre del campo}
|-
|103
|Error Interno en el Servicio
|}
|}
'''Mensaje:''' String que contiene mensaje descriptivo del resultado de la operación
'''resultado:'''  String que contiene información adicional (Uso futuro) 
====<font color="Blue">Tabla 2</font>====
{| class="wikitable" style="width: 100%;"
|+ Código de tipo de Identidad  (tipoIdentificacionemisor)
|- valign="center"
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango /  Valor no válido para el campo {nombre del campo}
|-
|103
|Error Interno en el Servicio
|}
|}

Revisión actual - 20:14 11 dic 2025

Métodos del Servicio Web HKA Recepción

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:

  • Recepción de Documentos Electrónicos
  • Gestión de Documentos Electrónicos

Recepción de Documentos Electrónicos

Contempla las funcionalidades que permiten remitir los documentos que soportan el documento electrónico, entre ellas se encuentran los métodos disponibles:

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

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


REQUEST
Parámetros a Enviar
Tipo Identificador Descripción
Class 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


RESPONSE
Parámetros a Recibir
Tipo Identificador Descripción
String codigo Código de retorno, Tabla 2
documentoId Consecutivo del documento remitido.
estatusDocumento Estatus final del documento del Documento.
mensaje Mensaje descriptivo del resultado de la operación.
numeroIdentificacion Número de identificación del emisor del documento remitido.
resultado Contiene información adicional (Procesado/Error)
tipoIdentificacion Tipo de identificación del emisor del documento remitido.

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>


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


REQUEST
Parámetros a Enviar
Tipo Identificador Descripción
Bytes archivo Archivo PDF en Base64 que contiene la representación gráfica del documento electrónico que se desea enviar
String TipoDocumento Es el tipo de documento al cual se le va a remitir la representación gráfica.
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
nombre Nombre del archivo de la Representación Gráfica
numeroDocumento Consecutivo del documento al cual se le remite la representación gráfica.
tipoIdentificadoremisor NIT del Emisor o Identificador Tributario del Emisor de la Factura
visible Indica si el archivo posteriormente puede ser o no descargado por el Emisor (Visible = 1, No visible = 0)
tokenEmpresa Dato suministrado por The Factory HKA Colombia (40 caracteres)
tokenPassword


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)

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>


Método Envío de Anexo "EnvioAnexo"

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.


REQUEST
Parámetros a Enviar
Tipo Identificador Descripción
Bytes archivo Archivo en Base64 que representa un anexo de factura identificada por número de documento
String TipoDocumento Es el tipo de documento al cual se le remite el anexo.
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
nombre Nombre del documento de la Representación Gráfica (Hasta 100 caracteres)
numeroDocumento Consecutivo del documento al cual se le remite el anexo. (Hasta 20 caracteres)
tipoidentificadoremisor Tipo de documento del Emisor Tabla 4
visible Indica si el archivo posteriormente puede ser o no descargado por el Emisor. (Visible = 1, No visible = 0)
tokenEmpresa Dato suministrado por The Factory HKA Colombia (40 caracteres)
tokenPassword


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
resultado Contiene información adicional (Procesado/Error)


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>


Gestión de Documentos Electrónicos

Engloba las funcionalidades inherentes a la gestión propia de los documentos ya radicados, para ello se cuenta con los métodos:

Método Cambio de Estatus "CambioEstatus"

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


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)


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>


Método DescargarAcuseAceptacionXML

Permite obtener el archivo XML ApplicationResponse en Base64,correspondiente al evento de aceptación de la Factura Electrónica.

REQUEST
Parámetros a Enviar
Tipo Identificador Descripción
String TipoDocumento Es el tipo de documento del cual se desea descrgar el XML.
identificadorEmisor NIT del Emisor o Identificador Tributario del Emisor de la Factura
nombreFileApplicationResponse Nombre del documento que se encuentra en Lista de Anexo (Opcional)
nmeroDocumento Consecutivo del documento del cual se desea obtener el XML.
tipoDescarga Igual a 1
tipoIdentificacionemisor Identificador del Emisor Tabla 4
tokenEmpresa Dato suministrado por The Factory HKA Colombia (40 caracteres)
tokenPassword


RESPONSE
Parámetros a Recibir
Tipo Identificador Descripción
Bytes archivo Archivo en Base64 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)


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>
     	<tem:request>
        	<wcf:TipoDocumento></wcf:TipoDocumento>
        	<wcf:identificadorEmisor>90……26</wcf:identificadorEmisor>
        	<wcf:nombreFileApplicationResponse>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</wcf:nombreFileApplicationResponse>
        	<wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento>
        	<wcf:tipoDescarga>1</wcf:tipoDescarga>
        	<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
        	<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>
        	<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>
Obtenido de «http://felcowiki.thefactoryhka.com.co/index.php?title=Servicios_de_Manejo_de_Documentos_Electrónicos_para_Receptor_-_Índice_Manual_Integración_Recepción_Electrónica&oldid=9393»