Electronic Document Management Services for Recipient - HKA Reception Direct Integration Manual Index

De tfhkacolwiki
Revisión del 16:14 17 feb 2023 de Eruiz (discusión | contribuciones) (Traducción recepción)
(dif) ← Revisión anterior | Revisión actual (dif) | Revisión siguiente → (dif)
Ir a la navegación Ir a la búsqueda

Electronic Document Management Services for Recipient

Report Method with Status (ReportStatus)

Shows the list of the last 500 Electronic Invoicing documents with the respective status that is being searched for, that have been received for a given Recipient and that have a consecutive associated with less than a supplied value.

REQUEST
Parameters to Send
Type identifier Description numeric
Int consecutive Consecutive number of the documents to review consecutive number of the document or blank
status_code Document Status Code Required for the search*, it can be verified in the following Table 1
String tokenenterprise Data provided by The Factory HKA Colombia 40 characters
tokenPassword

The following table shows the possible states +(Table 1) of the document to enter them and obtain a report only with the documents with the provided state.


Input example


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

Output Example


<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:reception date>2021-11-17T19:24:07</a:reception date>
              	<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:typedocumento>01</a:typedocumento>
              	<a:typeemisor>1</a:typeemisor>
              	<a:typeidentidad>31</a:typeidentidad>
           	</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>

NOTE: The lastSent is the consecutive number to view files older than the last one displayed. If there are more documents, the report will show true in the pending label, otherwise if it has false it indicates that there are no more documents.


RESPONSE
Parameters to Receive
type identifier Description
Int Code Return code. View method response catalog
Int CorrelativeCompany Sequential number of the company
String estatus Status of the document in which it is located Table 1
String cufe Unique Certificate of Electronic Invoicing.
Date Broadcast date Date the document was issued
Date reception date Fecha en que anexado
Time Broadcast time Broadcast time
Int total amount Total amount of the electronic invoice
String document number Document ID
Int identification number NIT of the Issuer or Tax identifier of the Issuer of the Invoice
String business name Company name of the Issuer
String type document Document ID
Int type Issuer table 3
Int typeentidad Issuer ID Table 4
String message Descriptive message of the result of the operation
Boolean pending answer (False/True)
String result Contains additional information (process/Error)
Int last sent last consecutive number

Report Method

Shows the list of the last 500 Electronic Invoicing documents that have been received for a given Receiver and that have a consecutive associated with a value supplied.

The report will show the information of the document, regardless of its status.

REQUEST
Parameters to Send
type identifier Description Numerical value
Int consecutive Consecutive number of the documents to review consecutive number of the document or blank
String tokenEnterprise Data provided by The Factory HKA Colombia 40 characters
tokenPassword


Input example


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

Output example


<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Body>
        <ReporteResponse xmlns="http://tempuri.org/">
            <ReporteResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <a:codigo>200</a:codigo>
                <a:documentoselectronicos>
                    <a:InfoDocumento>
                        <a:correlativoempresa>733</a:correlativoempresa>
                        <a:cufe>0e12f97ef32ed6c1b104bfb...ad96f36060039e2d5f2</a:cufe>
                        <a:estatusDIANcodigo/>
                        <a:estatusDIANdescripcion/>
  <a:estatusDIANfecha/>
                        <a:fechaemision>2021-08-31</a:fechaemision>
                        <a:reception date>2022-02-17T16:56:55</a:reception date>
                        <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:typedocumento>01</a:typedocumento>
                        <a:typeemisor>1</a:typeemisor>
                        <a:typeidentidad>31</a:typeidentidad>
                    </a:InfoDocumento>
                    <a:InfoDocumento>...</a:InfoDocumento>
                </a:documentoselectronicos>
                <a:mensaje>Procesado</a:mensaje>
                <a:pendiente>true</a:pendiente>
                <a:resultado>Procesado</a:resultado>
                <a:ultimoEnviado>234</a:ultimoEnviado>
            </ReporteResult>
        </ReporteResponse>
    </s:Body>
</s:Envelope>


NOTE: The lastSent is the consecutive number to view files older than the last one displayed. If there are more documents, the report will show true in the pending label, otherwise, if there are false, it indicates that there are no more documents.


Examples: taking the last sent


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

Example Response: Taking the last sent


<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
  	<ReporteResponse xmlns="http://tempuri.org/">
     	<ReporteResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        	<a:codigo>200</a:codigo>
        	<a:documentoselectronicos>
           	<a:InfoDocumento>
              	<a:correlativoempresa>252</a:correlativoempresa>
              	<a:cufe>cdb0097ff69b252d8c1dd27b57fa8d5637a661de7a30e0554c99babd295354506dbdb33c48ba3c6dfbd8fc474984a60c</a:cufe>
              	<a:estatusDIANcodigo/>
              	<a:estatusDIANdescripcion/>
              	<a:estatusDIANfecha/>
              	<a:fechaemision>2021-08-11</a:fechaemision>
              	<a:reception date>2021-11-26T12:19:30</a:reception date>
              	<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:typedocumento>01</a:typedocumento>
              	<a:typeemisor>1</a:typeemisor>
              	<a:typeidentidad>31</a:typeidentidad>
           	</a:InfoDocumento>

..............
           	<a:InfoDocumento>
              	<a:correlativoempresa>1</a:correlativoempresa>
              	<a:cufe>e1307a9f41f427d2ce379a6b951b82fe3c0c2400468ed22bb3f571f50112c7c67ee551d865c50b95252f62b06043b14b</a:cufe>
              	<a:estatusDIANcodigo/>
              	<a:estatusDIANdescripcion/>
              	<a:estatusDIANfecha/>
              	<a:fechaemision>2021-08-11</a:fechaemision>
              	<a:reception date>2021-08-13T10:44:47</a:reception date>
              	<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:typedocumento>01</a:typedocumento>
              	<a:typeemisor>1</a:typeemisor>
                <a:typeidentidad>31</a:typeidentidad>
           	</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>

Pending section: False indicates that there are no more documents to display, True indicates that there are more previous documents.


NOTE: The lastSent is the consecutive number to view files older than the last one displayed. If there are more documents, the report will show true in the pending label, otherwise if it has false it indicates that there are no more documents.


RESPONSE
Parameters to Receive
type identifier Description
Int Code Return code. View method response catalog
Int CorrelativoEmpresa Sequential number of the company
String cufe Unique Certificate of Electronic Invoicing.
Date fechaemision Date the document was issued
Date reception date Date attached
Time horaemisión Broadcast time
Int total amount Total amount of the electronic invoice
String numerodocumento Document ID
Int numeroidentificacion NIT of the Issuer or Tax identifier of the Issuer of the Invoice
String razonsocial Company name of the Issuer
String typedocumento Document ID
Int emitter type table 3
Int typeentidad identifier del Emisor Table 4
String mensaje Descriptive message of the result of the operation
Boolean pendiente respuesta (False/True)
String resultado Contains additional information (Procesado/Error)
Int ultimoenviado last consecutive number


XML Download Method

It allows obtaining the XML File encoded in Base64, corresponding to the Electronic Invoicing document identified for a given value and issued by an identified issuer, whose acquirer is the Recipient that is requesting it.

REQUEST
Parameters to Send
type identifier Description Numerical value
Int identifierEmisor NIT of the Issuer or Tax identifier of the Issuer of the Invoice From 6 to 20 digits
typeIdentificacionemisor identifier del Emisor Table 4 2 characters
String numeroDocumento Document ID Up to 20 characters
tokenEmpresa Data provided by The Factory HKA Colombia 40 characters
tokenPassword


Input example

<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:identifierEmisor>45......34</wcf:identifierEmisor>
                <wcf:numeroDocumento>ABB10</wcf:numeroDocumento>
                <wcf:typeIdentificacionemisor>31</wcf:typeIdentificacionemisor>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
        </tem:DescargarXML>
    </soapenv:Body>
</soapenv:Envelope>

 



Output example

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


RESPONSE
Parameters to Receive
type identifier Description
- archivo File in Base 64
Int Code Return code. View method response catalog
String crc Cyclic Redundancy Check
String cufe Unique Certificate of Electronic Invoicing.
String mensaje Descriptive message of the result of the operation
String resultado Contains additional information (Procesado/Error)
Int size document size


Download Method Graphic Representation

Allows obtaining the File containing the Base64-encoded Graphic Representation, corresponding to the Electronic Invoicing document identified for a given value and issued by an identified issuer, whose acquirer is a Recipient who is requesting it.

REQUEST
Parameters to Send
type identifier Description Numerical value
Int identifierEmisor NIT of the Issuer or Tax identifier of the Issuer of the Invoice From 6 to 20 digits
typeIdentificacionemisor identifier del Emisor Table 4 2 characters
String numeroDocumento Document ID Up to 20 characters
tokenEmpresa Data provided by The Factory HKA Colombia 40 characters
tokenPassword


Input example


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



Output example

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


RESPONSE
Parameters to Receive
type identifier Description
Int codigo return code. Table 2
string mensaje Descriptive message of the result of the operation
String resultado Contains additional information (Procesado/Error)


Attachment Download Method/Anexos

It allows obtaining the File that contains the Annex whose internal identification was indicated, corresponding to the Electronic Invoicing document identified for a given value and issued by an identified issuer, whose acquirer is the Recipient that is requesting it. The content of the file is presented encoded in base64.


REQUEST
Parameters to Send
type identifier Description Numerical value
Int identifierEmisor NIT of the Issuer or Tax Identification of the Issuer of the Invoice From 6 to 20 digits
typeIdentificacionemisor identifier del Emisor Table 4 2 characters
String identifierinternoAnexo corresponds to the internal identifier (NameFile) of the attachment to be downloaded. The FileName is obtained with the ListAnexo method*
String numeroDocumento Document ID Up to 20 characters
tokenEmpresa Data provided by The Factory HKA Colombia 40 characters
tokenPassword


Input example


<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:identifierEmisor>45......34</wcf:identifierEmisor>
                <wcf:identifierInternoAnexo>32168992-676A-44C8-862D-F5E5EBC762DB</wcf:identifierInternoAnexo>
                <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
                <wcf:typeIdentificacionemisor>31</wcf:typeIdentificacionemisor>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
        </tem:DescargarAnexo>
    </soapenv:Body>
</soapenv:Envelope>


Output example


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



RESPONSE
Parameters to Receive
type identifier Description
- archivo XML file in Base64 that contains the electronic document.
Int codigo return code. Table 2
String crc Cyclic Redundancy Check
String cufe Unique Certificate of Electronic Invoicing.
String displayname
String extension type of document you have
Int idfile

|string |mensaje |Descriptive message of the result of the operation |- |String |resultado |Contains additional information (Processed/Error) |- |Int |sizefile |document size |- |Int |Type |type of document, (See catalog) |} |}


Document Status Query Method

It allows to know the status, as well as the list of states through which an Electronic Invoicing document has passed, which was originally issued by a Supplier, whose acquirer has The Factory HKA Colombia as Electronic Invoicing technology provider.


REQUEST
Parameters to Send
type identifier Description Numerical value
Int identifierEmisor NIT of the Issuer or Tax identifier of the Issuer of the Invoice From 6 to 20 digits
typeIdentificacionemisor identifier del Emisor Table 4 2 characters
String numeroDocumento Document ID Up to 20 characters
tokenEmpresa Data provided by The Factory HKA Colombia 40 characters
tokenPassword


Input example


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



Output example


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




RESPONSE
Parameters to Receive
type identifier Description
String comentarios Document status . Table 1
String descripcion Description of the related status
Int codigoEStatus Status code. Table 1
Date fecha date in “s” format ”( yyyy'-'MM'-'dd'T'HH':'mm':'ss ) of the current status
String uuid Universal Unique identifier



Change of Status Method

It allows changing the status of an Electronic Billing document, which was originally issued by an Issuer, of which the acquirer has The Factory HKA Colombia as Electronic Billing technology provider.

Note:If the document is in a DIAN state and it is required to change to another state and it is impossible to do so, it may be waiting to receive a response from the DIAN, for which you must wait 5 minutes to make the change

REQUEST
Parameters to Send
type identifier Atributo Description
String Executed by Apellido Last name of the person in charge of sending the event.
Cargo Function for which a person is responsible in an organization, body or company. (optional).
Departamento. Area where the person in charge of sending events is located (optional).
DV Verification digit of the company's nit.
NumeroIdentificacion Nit of the company.
typeIdentificacion type of identification according to the Table 4
Nombre Name of the person in charge of sending events to the DIAN.
Int identifierEmisor NIT of the Issuer or Tax identifier of the Issuer of the Invoice, From 6 to 20 digits
numeroDocumento Document ID Up to 20 characters
status Document Status Code, required for the search*, can be verified in the following Table 1
typeIdentificacionemisor identifier del Emisor Table 4
String tokenEmpresa Data provided by The Factory HKA Colombia 40 characters
tokenPassword

The rejection code is required to make any status change.

Rejection Code

Rejection Code
Code Description
01 Document with inconsistencies
02 Merchandise not fully delivered
03 Merchandise not partially delivered
04 service not provided


Input example

<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:typeIdentificacion>31</wcf:typeIdentificacion>
                    </wcf:Identificacion>
                    <wcf:Nombre>Adriana</wcf:Nombre>
                </wcf:EjecutadoPor>
                <wcf:codigoRechazo>01</wcf:codigoRechazo>
                <wcf:identifierEmisor>45......34</wcf:identifierEmisor>
                <wcf:numeroDocumento>ABB01</wcf:numeroDocumento>
                <wcf:status>13</wcf:status>
                <wcf:typeIdentificacionemisor>31</wcf:typeIdentificacionemisor>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
 </tem:CambioEstatus>
    </soapenv:Body>
</soapenv:Envelope>
</p>

====<font color="Blue">Output example</font>====
<pre>

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




RESPONSE
Parameters to Receive
type identifier Description
Int Code Return code. View method response catalog
String mensaje Descriptive message of the result of the operation
String resultado Contains additional information (Processed/Error)




Metadata Query Method (infodata) (to documents) QueryDocumentsMetadata

(infodata) Allows a Recipient to consult the metadata(s) (infodata) corresponding to an Electronic Billing document, identified with the document number, issued by a provider of goods and services identified to the aforementioned Recipient


REQUEST
Parameters to Send
type identifier Description Numerical value
Int identifierEmisor NIT of the Issuer or Tax identifier of the Issuer of the Invoice From 6 to 20 digits
typeIdentificacionemisor identifier del EmisorTable 4 2 characters
numeroDocumento Document ID Up to 20 characters
String tokenEmpresa Data provided by The Factory HKA Colombia 40 characters
tokenPassword


Input example

<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:identifierEmisor>45......34</wcf:identifierEmisor>
                <wcf:numeroDocumento>ABB09</wcf:numeroDocumento>
                <wcf:typeIdentificacionemisor>31</wcf:typeIdentificacionemisor>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
        </tem:CosultaDocumentoMetadata>
    </soapenv:Body>
</soapenv:Envelope>


Output example

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

RESPONSE
Parameters to Receive
type identifier Description
String createdat Creation of the Infodata
String createdby Who created it
String label Infodata Name
Time updatedat relationship time
String value Name of the subcategory or value that is related to the Infodata





Method ListAppendix

Allows obtaining the list of attachments associated with the Electronic Invoicing document identified for a given value and issued by an identified issuer, whose acquirer is the Recipient that is requesting it.



REQUEST
Parameters to Send
type identifier Description Numerical value
Int identifierEmisor NIT of the Issuer or Tax identifier of the Issuer of the Invoice From 6 to 20 digits
typeIdentificacionemisor identifier del Emisor Table 4 2 characters
String numeroDocumento Document ID Up to 20 characters
tokenEmpresa Data provided by The Factory HKA Colombia 40 characters
tokenPassword


Input example

<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:identifierEmisor>45......34</wcf:identifierEmisor>
                <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
                <wcf:typeIdentificacionemisor>31</wcf:typeIdentificacionemisor>
                <wcf:tokenEmpresa>89………………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
        </tem:ListaAnexo>
    </soapenv:Body>
</soapenv:Envelope>


Output example

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


RESPONSE
Parameters to Receive
type identifier Description
Int InvoiceFileId File identification control field
InvoiceId Document identification control field
TypeCode Integer indicating the Code of the attachment type; namely admits the following values Table 5
size document size
String Format File Extension
NameDisplay File Name given by the Technology Provider, up to 100 characters
PathFile Document identification control field
Type Indicates the type of attachment; namely: Graphic Representation, Annex, Acknowledgment of Received, Acknowledgment of Accepted, Acknowledgment of Rejected and Acknowledgment of Tacit Acceptance
NameFile Internal name of the file. This value is used for both the recovery request and the file deletion request.
Time UpdatedAt date of last file update
CreatedAt Date the file was incorporated
Boolean ProviderVisible Indicator indicating whether the file can be downloaded by the sender

Name File : This is essential for the Download Annex method, this must match Type: Annex. For the download of the Annex that is the following method


Method DownloadAnnex

Allows the download of the Annex or attachment of the document that is linked to the invoice document. Which was originally attached to the document.

REQUEST
Parameters to Send
type identifier Description Numerical value
Int identifierEmisor NIT of the Issuer or Tax identifier of the Issuer of the Invoice From 6 to 20 digits
String identifierinternoanexo identifier of the Annex which must be consulted in the Annex List Method
typeIdentificacionemisor identifier del Emisor Table 4 2 characters
numeroDocumento Document ID Up to 20 characters
tokenEmpresa Data provided by The Factory HKA Colombia 40 characters
tokenPassword

Input example

<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:identifierEmisor>45......34</wcf:identifierEmisor>
                <wcf:identifierInternoAnexo>32168992-0000-44C8-862D-F5E5EBC762DB</wcf:identifierInternoAnexo>
                <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
                <wcf:typeIdentificacionemisor>31</wcf:typeIdentificacionemisor>
                <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
                <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
            </tem:request>
        </tem:DescargarAnexo>
    </soapenv:Body>
</soapenv:Envelope>


Output example

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


RESPONSE
Parameters to Receive
type identifier Description
- archivo File in Base 64 of the document
Int codigo Return code, Table 4
Id Document id.
Type document type, table 3
sizeFile document size
String crc Cyclic Redundancy Check
cufe Unique Certificate of Electronic Invoicing.
displayname
extension type of document you have
mensaje Descriptive message of the result of the operation
resultado Contains additional information (Processed/Error)



Graphic Representation Submission Method (EnviarRepGrafica)

It allows a Recipient to send the file that corresponds to the graphic representation of an Electronic Billing document, identified with the document number, issued by a provider of goods and services identified to the aforementioned Recipient; the file is Base64 encoded.


REQUEST
Parameters to Send
type identifier Description Numerical value
Int visible Indicates whether or not the file can later be downloaded by the Issuer Visible = 1, Not Visible = 0, 1 digit
identifierEmisor NIT of the Issuer or Tax identifier of the Issuer of the Invoice
String archivo Base64 XML file containing the electronic document to be sent
nombre Name of the document of the Graphic Representation Up to 100 characters
extension Indicates the format of the submitted file; supported values are bmp|jpg|pdf|doc|docx|xls|xlsx|ppt|pptx|rar|zip
identifierEmisor NIT of the Issuer or Tax identifier of the Issuer of the Invoice From 6 to 9 digits
numeroDocumento Document ID Up to 20 characters
tokenEmpresa Data provided by The Factory HKA Colombia 40 characters
tokenPassword


Input example

<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:archivo>JVB……FT0YK</wcf:archivo>
                <wcf:extension>ppt</wcf:extension>
                <wcf:identifierEmisor>45…34</wcf:identifierEmisor>
                <wcf:nombre>SOAP01-2</wcf:nombre>
                <wcf:numeroDocumento>SOAP019</wcf:numeroDocumento>
                <wcf:typeIdentificacionemisor>31</wcf:typeIdentificacionemisor>
                <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>



Output example

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



RESPONSE
Parameters to Receive
type identifier Description
Int codigo Return code, (View method response catalog)
String mensaje Descriptive message of the result of the operation
String resultado, Contains additional information (Processed/Error)




XML Submission Method “EnviarXML”

It allows sending the XML file that represents the Electronic Fiscal Document, which was issued by a supplier* of goods and services to a client The Factory HKA Colombia, the XML file is represented in Base64. Optionally you can send the so-called Metadata


REQUEST
Parameters to Send
type identifier Description Numerical value
Int metadata Optional Quartet List, which allows specifying additional attributes related to the Electronic Fiscal Document; nibbles are of the form (code, value, internal1 (optional), internal2 (optional)); establishing an association between the code element (which represents the metadata Code ) and the rest of the “attributes” of the nibble in question.
String archivo Base64 XML file containing the electronic document to be sent
tokenEmpresa Data provided by The Factory HKA Colombia 40 characters
tokenPassword


Input example

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


Output example

<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:typeIdentificacion>31</a:typeIdentificacion>
            </EnviarXMLResult>
        </EnviarXMLResponse>
    </s:Body>
</s:Envelope>


RESPONSE
Parameters to Receive
type identifier Description
- archivo File in Base 64 of the document
Int codigo Return code, Table 2
numeroIdentificacion Id del documento.
typeIdentificacion document identification type
String Document ID
estatusDocumento Document Status
mensaje Descriptive message of the result of the operation
String resultado Contains additional information (Processed/Error)



Annex Submission Method (EnvioAnexo)

Allows a Receiver to send a file that is "attached" to an Electronic Billing document, identified with the document number, issued by a provider of goods and services also identified; to the aforementioned Recipient; the file is Base64 encoded.



REQUEST
Parameters to Send
type identifier Description Numerical value
- archivo Base64 file representing an invoice attachment identified by document number
Byte Indicates whether or not the file can later be downloaded by the Issuer. Visible = 1, Not Visible = 0, 1 digit
Int typeidentifieremisor identifier del Emisor Table 4
identifierEmisor NIT of the Issuer or Tax identifier of the Issuer of the Invoice
String nombre Name of the document of the Graphic Representation Up to 100 characters
extension Indicates the format of the submitted file; supported values are bmp|jpg|pdf|doc|docx|xls|xlsx|ppt|pptx|rar|zip
numeroDocumento Document ID Up to 20 characters
tokenEmpresa Data provided by The Factory HKA Colombia 40 characters
tokenPassword


Input example

<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:identifierEmisor>456…34</wcf:identifierEmisor>
                <wcf:nombre>AHJ07-7</wcf:nombre>
                <wcf:numeroDocumento>AHJ07</wcf:numeroDocumento>
                <wcf:typeIdentificacionemisor>31</wcf:typeIdentificacionemisor>
                <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>




Output example

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


RESPONSE
Parameters to Receive
type identifier Description
Int codigo Return code, Table 2
String mensaje Descriptive message of the result of the operation
String resultado Contains additional information (Processed/Error)


Message: String that contains a message descriptive of the result of the operation result: String containing additional information (Future Use)