Electronic Document Management Services for Recipient

Sumario

1 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
Int	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
String	tokenPassword	Data provided by The Factory HKA Colombia	40 characters

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
String	tokenPassword	Data provided by The Factory HKA Colombia	40 characters

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
Int	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	Data provided by The Factory HKA Colombia	40 characters

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
Int	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	Data provided by The Factory HKA Colombia	40 characters

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
Int	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	Data provided by The Factory HKA Colombia	40 characters

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
Int	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	Data provided by The Factory HKA Colombia	40 characters

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
String	tokenPassword	Data provided by The Factory HKA Colombia	40 characters

The rejection code is required to make any status change.

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
String	tokenPassword	Data provided by The Factory HKA Colombia	40 characters

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
Int	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	Data provided by The Factory HKA Colombia	40 characters

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
Time	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	Data provided by The Factory HKA Colombia	40 characters

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
Int	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	Data provided by The Factory HKA Colombia	40 characters

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	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	Data provided by The Factory HKA Colombia	40 characters

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
Int	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	Data provided by The Factory HKA Colombia	40 characters

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

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

Sumario