Electronic Document Management Services for Recipient - HKA Reception Direct Integration Manual Index
Sumario
- 1 Electronic Document Management Services for Recipient
- 1.1 Report Method with Status (ReportStatus)
- 1.2 Report Method
- 1.3 XML Download Method
- 1.4 Download Method Graphic Representation
- 1.5 Attachment Download Method/Anexos
- 1.6 Document Status Query Method
- 1.7 Change of Status Method
- 1.8 Metadata Query Method (infodata) (to documents) QueryDocumentsMetadata
- 1.9 Method ListAppendix
- 1.10 Method DownloadAnnex
- 1.11 Graphic Representation Submission Method (EnviarRepGrafica)
- 1.12 XML Submission Method “EnviarXML”
- 1.13 Annex Submission Method (EnvioAnexo)
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
| 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)
