Diferencia entre revisiones de «Servicios de Manejo de Documentos Electrónicos para Receptor - Índice Manual Integración Recepción Electrónica»
(No se muestran 13 ediciones intermedias del mismo usuario) | |||
Línea 22: | Línea 22: | ||
|status_code | |status_code | ||
|Código de Estatus del documento | |Código de Estatus del documento | ||
− | |Requerido para la búsqueda*,se puede verificar en la siguiente | + | |Requerido para la búsqueda*,se puede verificar en la siguiente [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]] |
|- | |- | ||
|rowspan="2"|String | |rowspan="2"|String | ||
Línea 34: | Línea 34: | ||
obtener un reporte solo con los documentos con el estado proporcionado. | obtener un reporte solo con los documentos con el estado proporcionado. | ||
− | + | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
====<font color="Blue">Ejemplo de entrada</font>==== | ====<font color="Blue">Ejemplo de entrada</font>==== | ||
<pre> | <pre> | ||
Línea 134: | Línea 101: | ||
'''NOTA:''' El '''ultimoEnviado''' es el número consecutivo para ver los archivos anteriores a el último que se | '''NOTA:''' El '''ultimoEnviado''' es el número consecutivo para ver los archivos anteriores a el último que se | ||
− | muestra. Si se tienen más documentos el reporte mostrará true en la etiqueta pendientes, de caso | + | muestra. Si se tienen más documentos el reporte mostrará '''true''' en la etiqueta pendientes, de caso |
− | contrario si se tiene false indica que ya no se tienen documentos. | + | contrario si se tiene '''false''' indica que ya no se tienen documentos. |
Línea 156: | Línea 123: | ||
|String | |String | ||
|estatus | |estatus | ||
− | |Estatus del documento en el que se encuentra | + | |Estatus del documento en el que se encuentra [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]] |
|- | |- | ||
|String | |String | ||
Línea 195: | Línea 162: | ||
|- | |- | ||
|Int | |Int | ||
− | |tipoemisor | + | |tipoemisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 3|Tabla 3]] |
| | | | ||
|- | |- | ||
|Int | |Int | ||
|tipoentidad | |tipoentidad | ||
− | |Identificador del Emisor | + | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] |
|- | |- | ||
|String | |String | ||
Línea 208: | Línea 175: | ||
|Boolean | |Boolean | ||
|pendiente | |pendiente | ||
− | |respuesta ( | + | |respuesta (<span style="color:#F1142F; background:#FFFFFF"><b>False</b></span>/<span style="color:#15C71D; background:#FFFFFF"><b>True</b></span>) |
|- | |- | ||
|String | |String | ||
|resultado | |resultado | ||
− | |Contiene información adicional (Procesado/Error) | + | |Contiene información adicional (<span style="color:#15C71D; background:#FFFFFF"><b>Procesado</b></span>/<span style="color:#F1142F; background:#FFFFFF"><b>Error</b></span>) |
|- | |- | ||
|Int | |Int | ||
Línea 218: | Línea 185: | ||
|Último número consecutivo | |Último número consecutivo | ||
|} | |} | ||
− | |||
===<font color="blue">Método Reporte</font>=== | ===<font color="blue">Método Reporte</font>=== | ||
Línea 319: | Línea 285: | ||
<!--Optional:--> | <!--Optional:--> | ||
<wcf:consecutivo>253</wcf:consecutivo> | <wcf:consecutivo>253</wcf:consecutivo> | ||
− | + | <wcf:tokenEmpresa>89………b52</wcf:tokenEmpresa> | |
+ | <!--Optional:--> | ||
<!--Optional:--> | <!--Optional:--> | ||
<wcf:tokenPassword>b3…………43</wcf:tokenPassword> | <wcf:tokenPassword>b3…………43</wcf:tokenPassword> | ||
Línea 387: | Línea 354: | ||
'''Apartado pendientes: False es indicativo que no hay más documentos por mostrar, True indica que hay más documentos anteriores.''' | '''Apartado pendientes: False es indicativo que no hay más documentos por mostrar, True indica que hay más documentos anteriores.''' | ||
− | + | ||
− | + | '''NOTA:''' El '''ultimoEnviado''' es el número consecutivo para ver los archivos anteriores a el último que se | |
− | + | muestra. Si se tienen más documentos el reporte mostrará '''true''' en la etiqueta pendientes, de caso | |
− | + | contrario si se tiene '''false''' indica que ya no se tienen documentos. | |
− | + | ||
− | {| class="wikitable | + | |
− | + | ; RESPONSE: Parámetros a Recibir | |
− | + | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | |
− | |||
− | |||
− | |||
|- | |- | ||
− | + | ! style="background:#f2f2f2; text-align:center;"|Tipo | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Identificador | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Descripción | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ! style=" | ||
− | ! style=" | ||
|- valign="center" | |- valign="center" | ||
− | |||
− | |||
|- | |- | ||
− | | | + | |Int |
− | | | + | |Código |
+ | |Código de retorno. Ver catálogo de respuesta del método | ||
|- | |- | ||
− | | | + | |Int |
− | | | + | |CorrelativoEmpresa |
+ | |Número correlativo de la empresa | ||
|- | |- | ||
− | | | + | |String |
− | | | + | |cufe |
+ | |Certificado Único de Facturación Electrónica. | ||
|- | |- | ||
− | | | + | |Date |
− | | | + | |fechaemision |
+ | |Fecha en el que fue emitido el documento | ||
|- | |- | ||
− | | | + | |Date |
− | | | + | |fecharecepcion |
+ | |Fecha en que anexado | ||
|- | |- | ||
− | | | + | |Time |
− | | | + | |horaemisión |
+ | |Hora de emisión | ||
|- | |- | ||
− | | | + | |Int |
− | | | + | |montotal |
− | | | + | |Monto total de la factura electrónica |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | + | |String | |
− | + | |numerodocumento | |
− | + | |Identificador del documento | |
− | |||
− | |||
|- | |- | ||
− | + | |Int | |
− | | | + | |numeroidentificacion |
|NIT del Emisor o Identificador Tributario del Emisor de la Factura | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
− | |||
|- | |- | ||
− | | | + | |String |
− | | | + | |razonsocial |
− | + | |Razón social del Emisor | |
|- | |- | ||
− | + | |String | |
− | | | + | |tipodocumento |
|Identificador del documento | |Identificador del documento | ||
− | |||
|- | |- | ||
− | | | + | |Int |
− | | | + | |tipoemisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 3|Tabla 3]] |
− | | | + | | |
+ | |- | ||
+ | |Int | ||
+ | |tipoentidad | ||
+ | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | ||
+ | |- | ||
+ | |String | ||
+ | |mensaje | ||
+ | |Mensaje descriptivo del resultado de la operación | ||
+ | |- | ||
+ | |Boolean | ||
+ | |pendiente | ||
+ | |respuesta (<span style="color:#F1142F; background:#FFFFFF"><b>False</b></span>/<span style="color:#15C71D; background:#FFFFFF"><b>True</b></span>) | ||
+ | |- | ||
+ | |String | ||
+ | |resultado | ||
+ | |Contiene información adicional (<span style="color:#15C71D; background:#FFFFFF"><b>Procesado</b></span>/<span style="color:#F1142F; background:#FFFFFF"><b>Error</b></span>) | ||
|- | |- | ||
− | |tokenPassword | + | |Int |
+ | |ultimoenviado | ||
+ | |Último número consecutivo | ||
+ | |} | ||
+ | |||
+ | |||
+ | ===<font color="blue">Método de Descarga XML</font>=== | ||
+ | Permite obtener el Archivo XML codificado en Base64, correspondiente al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es el Receptor que lo está solicitando. | ||
+ | ; REQUEST: Parámetros a Enviar | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
+ | |- | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Valor numérico | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |rowspan="3"|Int | ||
+ | |TipoDocumento | ||
+ | |Es el tipo de documento que se va a manejar. | ||
+ | |2 caracteres | ||
+ | |- | ||
+ | |identificadorEmisor | ||
+ | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
+ | |De 6 a 20 dígitos | ||
+ | |- | ||
+ | |tipoIdentificacionemisor | ||
+ | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | ||
+ | |2 caracteres | ||
+ | |- | ||
+ | |rowspan="3"|String | ||
+ | |numeroDocumento | ||
+ | |Identificador del documento | ||
+ | |Hasta 20 caracteres | ||
+ | |- | ||
+ | |tokenEmpresa | ||
+ | |rowspan="2"|Dato suministrado por The Factory HKA Colombia | ||
+ | |rowspan="2"|40 caracteres | ||
+ | |- | ||
+ | |tokenPassword | ||
|} | |} | ||
Línea 483: | Línea 482: | ||
<tem:DescargarXML> | <tem:DescargarXML> | ||
<tem:request> | <tem:request> | ||
+ | <wcf:TipoDocumento>?</wcf:TipoDocumento> | ||
<wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> | <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> | ||
<wcf:numeroDocumento>ABB10</wcf:numeroDocumento> | <wcf:numeroDocumento>ABB10</wcf:numeroDocumento> | ||
Línea 495: | Línea 495: | ||
+ | |||
+ | </pre> | ||
+ | |||
+ | |||
+ | ====<font color="Blue">Ejemplo de salida</font>==== | ||
+ | <pre> | ||
+ | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
+ | <s:Body> | ||
+ | <DescargarXMLResponse xmlns="http://tempuri.org/"> | ||
+ | <DescargarXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | ||
+ | <a:archivo>PD94b………………….b2N1bWVudD4=</a:archivo> | ||
+ | <a:codigo>200</a:codigo> | ||
+ | <a:crc>4ecd4e588d71e689a32bb07d92c58b4e</a:crc> | ||
+ | <a:cufe>0e12f97ef32ed6c1b104bfb13...f36060039e2d5f2</a:cufe> | ||
+ | <a:mensaje>Se retorna el archivo solicitado</a:mensaje> | ||
+ | <a:resultado>Procesado</a:resultado> | ||
+ | <a:size>44864</a:size> | ||
+ | </DescargarXMLResult> | ||
+ | </DescargarXML | ||
+ | </s:Envelope> | ||
</pre> | </pre> | ||
Línea 529: | Línea 549: | ||
|String | |String | ||
|resultado | |resultado | ||
− | |Contiene información adicional (Procesado/Error) | + | |Contiene información adicional (<span style="color:#15C71D; background:#FFFFFF"><b>Procesado</b></span>/<span style="color:#F1142F; background:#FFFFFF"><b>Error</b></span>) |
|- | |- | ||
|Int | |Int | ||
Línea 536: | Línea 556: | ||
|} | |} | ||
+ | ===<font color="blue">Método de Descarga RepresentacionGrafica</font>=== | ||
+ | Permite obtener el Archivo que contiene la Representación Gráfica codificado Base64, correspondiente al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es un Receptor que lo está solicitando | ||
− | + | ; REQUEST: Parámetros a Enviar | |
− | + | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | |
− | + | |- | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Tipo | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Identificador | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Descripción | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Valor numérico | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | {| class="wikitable" style=" | ||
− | |||
− | |- | ||
− | |||
− | |||
− | ! style=" | ||
− | ! style=" | ||
|- valign="center" | |- valign="center" | ||
− | |||
− | |||
|- | |- | ||
− | + | |rowspan="2"|Int | |
− | + | |TipoDocumento | |
− | + | |Es el tipo de documento que se va a manejar. | |
− | + | |2 caracteres | |
− | + | |- | |
− | + | |tipoIdentificacionemisor | |
− | + | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | |
− | + | |2 caracteres | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |rowspan="2"|Int | ||
− | | | ||
− | | | ||
− | | | ||
− | |- | ||
− | |tipoIdentificacionemisor | ||
− | |Identificador del Emisor | ||
− | |2 caracteres | ||
|- | |- | ||
|rowspan="3"|String | |rowspan="3"|String | ||
Línea 622: | Línea 598: | ||
<tem:DescargarRepGrafica> | <tem:DescargarRepGrafica> | ||
<tem:request> | <tem:request> | ||
+ | <!--Optional:--> | ||
+ | <wcf:TipoDocumento>91</wcf:TipoDocumento> | ||
<wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> | <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> | ||
<wcf:numeroDocumento>LAS40588</wcf:numeroDocumento> | <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento> | ||
Línea 636: | Línea 614: | ||
− | + | ====<font color="Blue">Ejemplo de salida</font>==== | |
− | + | <pre> | |
− | + | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | |
− | + | <s:Body> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ====<font color="Blue">Ejemplo de salida</font>==== | ||
− | <pre> | ||
− | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
− | <s:Body> | ||
<DescargarRepGraficaResponse xmlns="http://tempuri.org/"> | <DescargarRepGraficaResponse xmlns="http://tempuri.org/"> | ||
<DescargarRepGraficaResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | <DescargarRepGraficaResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | ||
Línea 679: | Línea 635: | ||
− | + | ; RESPONSE: Parámetros a Recibir | |
− | {| class=" | + | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | ! style="background:#f2f2f2; text-align:center;"|Tipo |
− | | | + | ! style="background:#f2f2f2; text-align:center;"|Identificador |
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |Bas64 | ||
+ | |archivo | ||
+ | |Archivo en Base 64 | ||
+ | |- | ||
+ | |Int | ||
+ | |codigo | ||
+ | |Código de retorno. [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]] | ||
+ | |- | ||
+ | |string | ||
+ | |mensaje | ||
+ | |Mensaje descriptivo del resultado de la operación | ||
|- | |- | ||
− | | | + | |String |
− | | | + | |resultado |
− | | | + | |Contiene información adicional (<span style="color:#15C71D; background:#FFFFFF"><b>Procesado</b></span>/<span style="color:#F1142F; background:#FFFFFF"><b>Error</b></span>) |
|} | |} | ||
− | |||
− | |||
===<font color="blue">Método de Descarga de Adjuntos/Anexos</font>=== | ===<font color="blue">Método de Descarga de Adjuntos/Anexos</font>=== | ||
− | Permite obtener el Archivo que contiene el Anexo cuya identificación interna fue indicada, correspondiente al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es el Receptor que lo está solicitando. El contenido del archivo es presentado codificado base64. | + | Permite obtener el Archivo que contiene el Anexo cuya identificación interna fue indicada, correspondiente al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es el Receptor que lo está solicitando. El contenido del archivo es presentado codificado en base64. |
Línea 714: | Línea 673: | ||
|- valign="center" | |- valign="center" | ||
|- | |- | ||
− | |rowspan=" | + | |rowspan="3"|Int |
+ | |TipoDocumento | ||
+ | |Es el tipo de documento que se va a manejar. | ||
+ | |2 caracteres | ||
+ | |- | ||
|identificadorEmisor | |identificadorEmisor | ||
|NIT del Emisor o Identificador Tributario del Emisor de la Factura | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
Línea 720: | Línea 683: | ||
|- | |- | ||
|tipoIdentificacionemisor | |tipoIdentificacionemisor | ||
− | |Identificador del Emisor | + | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] |
|2 caracteres | |2 caracteres | ||
|- | |- | ||
Línea 747: | Línea 710: | ||
<soapenv:Header/> | <soapenv:Header/> | ||
<soapenv:Body> | <soapenv:Body> | ||
− | <tem: | + | <tem:DescargarRepGrafica> |
<tem:request> | <tem:request> | ||
+ | <!--Optional:--> | ||
+ | <wcf:TipoDocumento>91</wcf:TipoDocumento> | ||
<wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> | <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> | ||
− | |||
<wcf:numeroDocumento>LAS40588</wcf:numeroDocumento> | <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento> | ||
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
Línea 756: | Línea 720: | ||
<wcf:tokenPassword>b3……………43</wcf:tokenPassword> | <wcf:tokenPassword>b3……………43</wcf:tokenPassword> | ||
</tem:request> | </tem:request> | ||
− | </tem: | + | </tem:DescargarRepGrafica> |
</soapenv:Body> | </soapenv:Body> | ||
</soapenv:Envelope> | </soapenv:Envelope> | ||
+ | |||
</pre> | </pre> | ||
+ | |||
+ | |||
+ | ====<font color="Blue">Ejemplo de salida</font>==== | ||
+ | <pre> | ||
+ | |||
+ | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
+ | <s:Body> | ||
+ | <DescargarAnexoResponse xmlns="http://tempuri.org/"> | ||
+ | <DescargarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | ||
+ | <a:archivo>JVB……………………….YK</a:archivo> | ||
+ | <a:codigo>200</a:codigo> | ||
+ | <a:crc>5e9b2925ae58b8f7c2c95ef8d748d864</a:crc> | ||
+ | <a:cufe>6c406410fc912ca1...8da809c1517da5</a:cufe> | ||
+ | <a:displayname>ad0000346585016210001271e</a:displayname> | ||
+ | <a:extension>pdf</a:extension> | ||
+ | <a:idfile>5984</a:idfile> | ||
+ | <a:mensaje>Se retorna el archivo solicitado</a:mensaje> | ||
+ | <a:resultado>Procesado</a:resultado> | ||
+ | <a:sizefile>43203</a:sizefile> | ||
+ | <a:type>2</a:type> | ||
+ | </DescargarAnexoResult> | ||
+ | </DescargarAnexoResponse> | ||
+ | </s:Body> | ||
+ | </s:Envelope> | ||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
Línea 777: | Línea 770: | ||
|Int | |Int | ||
|codigo | |codigo | ||
− | |Código de retorno. | + | |Código de retorno. [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]] |
|- | |- | ||
|String | |String | ||
Línea 814: | Línea 807: | ||
|Type | |Type | ||
|Tipo de documento, (Ver catálogo) | |Tipo de documento, (Ver catálogo) | ||
+ | |} | ||
|} | |} | ||
+ | ===<font color="blue">Método Consulta de Estado Documento</font>=== | ||
+ | Permite conocer el estatus, así como la lista de estados por la que ha pasado un documento de Facturación Electrónica, que originalmente fue emitida por un Proveedor, cuyo adquiriente tiene como proveedor tecnológico de Facturación Electrónica a The Factory HKA Colombia | ||
− | |||
− | |||
− | + | ; REQUEST: Parámetros a Enviar | |
− | + | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | |
− | + | |- | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Tipo | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Identificador | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Descripción | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Valor numérico | |
− | + | |- valign="center" | |
− | + | |- | |
− | + | |rowspan="3"|Int | |
− | + | |TipoDocumento | |
− | + | |Es el tipo de documento que se va a manejar. | |
− | + | |2 caracteres | |
− | + | |- | |
− | + | |identificadorEmisor | |
− | + | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | |
− | + | |De 6 a 20 dígitos | |
− | + | |- | |
− | + | |tipoIdentificacionemisor | |
− | + | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | |
− | + | |2 caracteres | |
− | + | |- | |
− | + | |rowspan="3"|String | |
− | + | |numeroDocumento | |
− | + | |Identificador del documento | |
− | {| class="wikitable" style=" | + | |Hasta 20 caracteres |
− | |||
− | |- | ||
− | |||
− | |||
− | ! style=" | ||
− | ! style=" | ||
− | |- valign="center" | ||
− | | | ||
− | | | ||
|- | |- | ||
− | | | + | |tokenEmpresa |
− | | | + | |rowspan="2"|Dato suministrado por The Factory HKA Colombia |
+ | |rowspan="2"|40 caracteres | ||
|- | |- | ||
− | | | + | |tokenPassword |
− | |||
− | |||
|} | |} | ||
+ | ====<font color="Blue">Ejemplo de entrada</font>==== | ||
+ | <pre> | ||
+ | |||
+ | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> | ||
+ | <soapenv:Header/> | ||
+ | <soapenv:Body> | ||
+ | <tem:EstadoDocumento> | ||
+ | <!--Optional:--> | ||
+ | <tem:request> | ||
+ | <!--Optional:--> | ||
+ | <wcf:TipoDocumento></wcf:TipoDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:identificadorEmisor>25………1</wcf:identificadorEmisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:numeroDocumento>ERTYBNT017</wcf:numeroDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenPassword>b3…………43</wcf:tokenPassword> | ||
+ | </tem:request> | ||
+ | </tem:EstadoDocumento> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | |||
+ | |||
+ | |||
+ | </pre> | ||
− | |||
− | |||
+ | ====<font color="Blue">Ejemplo de salida</font>==== | ||
+ | <pre> | ||
− | + | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | |
− | + | <s:Body> | |
− | + | <EstadoDocumentoResponse xmlns="http://tempuri.org/"> | |
− | + | <EstadoDocumentoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | |
− | + | <a:ListEstatusHistory> | |
− | + | <a:HistorialEstatus> | |
− | + | <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Aceptación expresa (DIAN)</a:Comentarios> | |
− | + | <a:Descripcion>Aceptación expresa (DIAN)</a:Descripcion> | |
− | + | <a:codigoEstatus>2</a:codigoEstatus> | |
− | + | <a:fecha>2022-03-07 13:37:47</a:fecha> | |
− | + | </a:HistorialEstatus> | |
− | + | <a:HistorialEstatus> | |
− | + | <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Recibo del bien y/o prestación del servicio</a:Comentarios> | |
− | + | <a:Descripcion>Recibo del bien y/o prestación del servicio</a:Descripcion> | |
− | + | <a:codigoEstatus>12</a:codigoEstatus> | |
− | + | <a:fecha>2022-03-07 13:37:46</a:fecha> | |
− | + | </a:HistorialEstatus> | |
− | + | <a:HistorialEstatus> | |
− | + | <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Acuse de recibo (DIAN)</a:Comentarios> | |
− | + | <a:Descripcion>Acuse de recibo (DIAN)</a:Descripcion> | |
− | + | <a:codigoEstatus>10</a:codigoEstatus> | |
− | + | <a:fecha>2022-03-07 13:32:19</a:fecha> | |
− | + | </a:HistorialEstatus> | |
− | + | <a:HistorialEstatus> | |
− | + | <a:Comentarios>Cambio de Estado a Entregado por Descarga de Documento Electrónico</a:Comentarios> | |
− | + | <a:Descripcion>Entregado</a:Descripcion> | |
− | + | <a:codigoEstatus>1</a:codigoEstatus> | |
− | + | <a:fecha>2022-02-11 12:38:25</a:fecha> | |
− | + | </a:HistorialEstatus> | |
− | + | <a:HistorialEstatus> | |
− | + | <a:Comentarios>Cargado</a:Comentarios> | |
− | + | <a:Descripcion>Cargado</a:Descripcion> | |
− | < | + | <a:codigoEstatus>0</a:codigoEstatus> |
− | + | <a:fecha>2022-02-11 12:23:02</a:fecha> | |
− | < | + | </a:HistorialEstatus> |
− | + | </a:ListEstatusHistory> | |
− | + | <a:codigo>200</a:codigo> | |
− | + | <a:estatusDIANDescripcion/> | |
− | + | <a:estatusDIANcodigo/> | |
− | < | + | <a:estatusDIANfecha/> |
− | < | + | <a:estatusDocumento>Aceptación expresa (DIAN)</a:estatusDocumento> |
− | < | + | <a:fechaDocumento>2022-02-11T12:23:01</a:fechaDocumento> |
− | < | + | <a:mensaje>Se retorna los datos del estado del documento</a:mensaje> |
− | < | + | <a:resultado>Procesado</a:resultado> |
− | </ | + | <a:tipoDocumento>01</a:tipoDocumento> |
− | </ | + | <a:uuid>0e12f97ef3...060039e2d5f2</a:uuid> |
− | </ | + | </EstadoDocumentoResult> |
− | </ | + | </EstadoDocumentoResponse> |
+ | </s:Body> | ||
+ | </s:Envelope> | ||
</pre> | </pre> | ||
+ | |||
+ | |||
Línea 933: | Línea 950: | ||
|String | |String | ||
|comentarios | |comentarios | ||
− | |Status del documento . | + | |Status del documento . [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]] |
|- | |- | ||
|String | |String | ||
Línea 941: | Línea 958: | ||
|Int | |Int | ||
|codigoEStatus | |codigoEStatus | ||
− | |Código del estatus | + | |Código del estatus. [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]] |
|- | |- | ||
|Date | |Date | ||
Línea 952: | Línea 969: | ||
|} | |} | ||
+ | ===<font color="blue">Método Cambio de Status</font>=== | ||
+ | Permite cambiar el estatus de un documento de Facturación Electrónica, que originalmente fue emitida por un Emisor, del cual el adquiriente tiene como proveedor tecnológico de Facturación Electrónica a The Factory HKA Colombia. | ||
− | + | '''Nota:'''Si el documento está en un estado DIAN y se requiere cambiar a otro estado y es imposible hacerlo, puede que esté en espera para recibir respuesta de la DIAN, por lo cual se debe de esperar 5 minutos para realizar el cambio | |
− | |||
− | + | ; REQUEST: Parámetros a Enviar | |
− | + | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | |
− | + | |- | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Tipo | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Identificador | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Atributo | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Descripción | |
− | + | |- valign="center" | |
− | + | |- | |
− | + | |rowspan="7"|String | |
− | + | |rowspan="7"|EjecutadorPor | |
− | + | |Apellido | |
− | + | |Apellido de la persona encargada de enviar evento. | |
− | + | |- | |
− | + | |Cargo | |
− | + | |Función de la cual una persona tiene la responsabilidad en una organización, un organismo o una empresa.(opcional). | |
− | + | |- | |
− | + | |Departamento. | |
− | + | |Área en la que se encuentra la persona encargada de envío de eventos (opcional). | |
− | + | |- | |
− | + | |DV | |
− | + | |Digito verificador del nit de la empresa. | |
− | + | |- | |
− | + | |NumeroIdentificacion | |
− | + | |Nit de la empresa. | |
− | + | |- | |
− | + | |TipoIdentificacion | |
− | + | |Tipo de identifiación según la [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | |
− | + | |- | |
− | + | |Nombre | |
− | + | |Nombre de la persona encargada a enviar eventos hacia la DIAN. | |
− | + | |- | |
− | + | |rowspan="5"|Int | |
− | + | |TipoDocumento | |
− | + | |Es el tipo de documento que se va a manejar. | |
− | + | |2 caracteres | |
− | + | |- | |
− | + | |identificadorEmisor | |
− | + | | | |
− | + | |NIT del Emisor o Identificador Tributario del Emisor de la Factura, de 6 a 20 dígitos | |
− | + | |- | |
− | + | |numeroDocumento | |
− | + | | | |
− | + | |Identificador del documento hasta 20 caracteres | |
− | + | |- | |
− | + | |status | |
− | + | | | |
− | + | |Código de Estatus del documento,requerido para la búsqueda*,se puede verificar en la siguiente [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]] | |
− | + | |- | |
− | + | |tipoIdentificacionemisor | |
+ | | | ||
+ | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | ||
+ | |- | ||
+ | |rowspan="2"|String | ||
+ | |tokenEmpresa | ||
+ | |rowspan="2"|Dato suministrado por The Factory HKA Colombia | ||
+ | |rowspan="2"|40 caracteres | ||
+ | |- | ||
+ | |tokenPassword | ||
+ | |- | ||
+ | |} | ||
+ | El código de Rechazo es requerido para realizar cualquier cambio de estado. | ||
− | + | ====<font color="Blue">CodigoRechazo</font>==== | |
− | |||
− | |||
− | ====<font color="Blue"> | ||
{| class="wikitable" style="width: 100%;" | {| class="wikitable" style="width: 100%;" | ||
− | |+ | + | |+ CodigoRechazo |
|- valign="center" | |- valign="center" | ||
|-style="text-align:center;" | |-style="text-align:center;" | ||
Línea 1020: | Línea 1047: | ||
! style="color:white;background:#2F5496; text-align:center;"|Descripción | ! style="color:white;background:#2F5496; text-align:center;"|Descripción | ||
|- valign="center" | |- valign="center" | ||
− | | | + | |01 |
− | | | + | |Documento con inconsistencias |
|- | |- | ||
− | | | + | |02 |
− | | | + | |Mercancía no entregada totalmente |
|- | |- | ||
− | | | + | |03 |
− | | | + | |Mercancía no entregada parcialmente |
+ | |- | ||
+ | |04 | ||
+ | |Servicio no prestado | ||
|} | |} | ||
|} | |} | ||
+ | ====<font color="Blue">Ejemplo de entrada</font>==== | ||
+ | <pre> | ||
+ | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> | ||
+ | <soapenv:Header/> | ||
+ | <soapenv:Body> | ||
+ | <tem:CambioEstatus> | ||
+ | <!--Optional:--> | ||
+ | <tem:request> | ||
+ | <!--Optional:--> | ||
+ | <wcf:EjecutadoPor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:Apellido>López</wcf:Apellido> | ||
+ | <!--Optional:--> | ||
+ | <wcf:Cargo>Pruebas</wcf:Cargo> | ||
+ | <!--Optional:--> | ||
+ | <wcf:Departamento>Calidad</wcf:Departamento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:Identificacion> | ||
+ | <!--Optional:--> | ||
+ | <wcf:Dv></wcf:Dv> | ||
+ | <!--Optional:--> | ||
+ | <wcf:NumeroIdentificacion>14…………51</wcf:NumeroIdentificacion> | ||
+ | <!--Optional:--> | ||
+ | <wcf:TipoIdentificacion>11</wcf:TipoIdentificacion> | ||
+ | </wcf:Identificacion> | ||
+ | <!--Optional:--> | ||
+ | <wcf:Nombre>Adriana</wcf:Nombre> | ||
+ | </wcf:EjecutadoPor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:TipoDocumento>91</wcf:TipoDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:codigoRechazo>02</wcf:codigoRechazo> | ||
+ | <!--Optional:--> | ||
+ | <wcf:identificadorEmisor>90………26</wcf:identificadorEmisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:numeroDocumento>AKLAA16</wcf:numeroDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:status>10</wcf:status> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenEmpresa>89………52</wcf:tokenEmpresa> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenPassword>b3……………43</wcf:tokenPassword> | ||
+ | </tem:CambioEstatus> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | </p> | ||
+ | ====<font color="Blue">Ejemplo de salida</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> | ||
+ | |||
+ | |||
+ | |||
+ | </pre> | ||
− | + | ; RESPONSE: Parámetros a Recibir | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | ; | ||
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
|- | |- | ||
Línea 1049: | Línea 1139: | ||
! style="background:#f2f2f2; text-align:center;"|Identificador | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
− | |||
|- valign="center" | |- valign="center" | ||
|- | |- | ||
− | + | |Int | |
− | | | + | |Código |
− | | | + | |Código de retorno. Ver catálogo de respuesta del método |
− | |||
|- | |- | ||
− | |tipoIdentificacionemisor | + | |String |
− | |Identificador del Emisor | + | |mensaje |
− | |2 caracteres | + | |Mensaje descriptivo del resultado de la operación |
+ | |- | ||
+ | |String | ||
+ | |resultado | ||
+ | |Contiene información adicional (Procesado/Error) | ||
+ | |} | ||
+ | |||
+ | ===<font color="blue">Método Consulta de Metadata (infodatos) (a los documentos) ConsultaDocumentosMetadata</font>=== | ||
+ | (Infodatos) | ||
+ | Permite a un Receptor consultar el o los metadato(s) (infodatos) correspondientes a un documento de Facturación Electrónica, identificado con el numero documento, emitido por un proveedor de bienes y servicios identificado al Receptor ya mencionado | ||
+ | |||
+ | |||
+ | |||
+ | ; REQUEST: Parámetros a Enviar | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
+ | |- | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Valor numérico | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |rowspan="3"|Int | ||
+ | |identificadorEmisor | ||
+ | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
+ | |De 6 a 20 dígitos | ||
+ | |- | ||
+ | |tipoIdentificacionemisor | ||
+ | |Identificador del Emisor[[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | ||
+ | |2 caracteres | ||
|- | |- | ||
− | |||
|numeroDocumento | |numeroDocumento | ||
|Identificador del documento | |Identificador del documento | ||
|Hasta 20 caracteres | |Hasta 20 caracteres | ||
|- | |- | ||
− | |String | + | |rowspan="2"|String |
− | |||
− | |||
− | |||
− | |||
|tokenEmpresa | |tokenEmpresa | ||
|rowspan="2"|Dato suministrado por The Factory HKA Colombia | |rowspan="2"|Dato suministrado por The Factory HKA Colombia | ||
Línea 1078: | Línea 1190: | ||
|} | |} | ||
− | |||
− | + | ====<font color="Blue">Ejemplo de entrada</font>==== | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ====<font color="Blue">Ejemplo de entrada</font>==== | ||
<pre> | <pre> | ||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> | ||
<soapenv:Header/> | <soapenv:Header/> | ||
<soapenv:Body> | <soapenv:Body> | ||
− | <tem: | + | <tem:CosultaDocumentoMetadata> |
<tem:request> | <tem:request> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
<wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> | <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> | ||
− | <wcf:numeroDocumento> | + | <wcf:numeroDocumento>ABB09</wcf:numeroDocumento> |
− | |||
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> | <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> | ||
<wcf:tokenPassword>b3……………43</wcf:tokenPassword> | <wcf:tokenPassword>b3……………43</wcf:tokenPassword> | ||
</tem:request> | </tem:request> | ||
− | + | </tem:CosultaDocumentoMetadata> | |
</soapenv:Body> | </soapenv:Body> | ||
</soapenv:Envelope> | </soapenv:Envelope> | ||
+ | </pre> | ||
− | + | ====<font color="Blue">Ejemplo de salida</font>==== | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ====<font color="Blue">Ejemplo de salida</font>==== | ||
<pre> | <pre> | ||
− | |||
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
− | + | <s:Body> | |
− | < | + | <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: | + | <a:ListMetadata> |
− | + | <a:SPPostMetadata> | |
− | + | <a:createdat>2022-02-17T12:08:47</a:createdat> | |
− | + | <a:createdby>Customer</a:createdby> | |
− | + | <a:label>Nueva Categoría 2</a:label> | |
− | + | <a:updatedat>2022-02-17T12:08:47</a:updatedat> | |
− | </ | + | <a:updatedby>Customer</a:updatedby> |
− | + | <a:value>A</a:value> | |
− | + | </a:SPPostMetadata> | |
− | + | <a:SPPostMetadata> | |
− | </ | + | <a:createdat>2022-02-17T12:08:47</a:createdat> |
− | + | <a:createdby>Customer</a:createdby> | |
− | + | <a:label>Nueva Categoría</a:label> | |
− | + | <a:updatedat>2022-02-17T12:08:47</a:updatedat> | |
− | + | <a:updatedby>Customer</a:updatedby> | |
− | + | <a:value>Calle Carrera</a:value> | |
− | + | </a:SPPostMetadata> | |
− | + | <a:SPPostMetadata> | |
− | + | <a:createdat>2022-02-17T12:08:47</a:createdat> | |
− | + | <a:createdby>Customer</a:createdby> | |
− | + | <a:label>Regiones 1</a:label> | |
− | + | <a:updatedat>2022-02-17T12:08:47</a:updatedat> | |
− | + | <a:updatedby>Customer</a:updatedby> | |
− | |- | + | <a:value>J&J</a:value> |
− | + | </a:SPPostMetadata> | |
− | + | </a:ListMetadata> | |
+ | <a:codigo>200</a:codigo> | ||
+ | <a:estatusDIANDescripcion/> | ||
+ | <a:estatusDIANcodigo/> | ||
+ | <a:estatusDIANfecha/> | ||
+ | <a:estatusDocumento>Aceptación expresa (DIAN)</a:estatusDocumento> | ||
+ | <a:fechaDocumento>2022-02-11T12:23:01</a:fechaDocumento> | ||
+ | <a:mensaje>Se retorna los datos sobre metadatos del documento</a:mensaje> | ||
+ | <a:resultado>Procesado</a:resultado> | ||
+ | <a:tipoDocumento>01</a:tipoDocumento> | ||
+ | <a:uuid>0e12f97ef32ed6...11ad96f36060039e2d5f2</a:uuid> | ||
+ | </CosultaDocumentoMetadataResult> | ||
+ | </CosultaDocumentoMetadataResponse> | ||
+ | </s:Body> | ||
+ | </s:Envelope> | ||
+ | |||
+ | </pre> | ||
+ | |||
+ | ; RESPONSE: Parámetros a Recibir | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
|- | |- | ||
− | + | ! style="background:#f2f2f2; text-align:center;"|Tipo | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Identificador | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Descripción | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ! style=" | ||
− | ! style=" | ||
|- valign="center" | |- valign="center" | ||
− | |||
− | |||
|- | |- | ||
− | | | + | |String |
− | | | + | |createdat |
+ | |Creación del Infodato | ||
|- | |- | ||
− | | | + | |String |
− | | | + | |createdby |
+ | |Quien lo creo | ||
|- | |- | ||
− | | | + | |String |
− | | | + | |label |
+ | |Nombre del Infodato | ||
|- | |- | ||
− | | | + | |Time |
− | | | + | |updatedat |
+ | |Tiempo de relación | ||
|- | |- | ||
− | | | + | |String |
− | | | + | |value |
− | | | + | |Nombre de la subcategoría o valor que está relacionado del Infodato |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
+ | </pre> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===<font color="blue">Método ListaAnexo </font>=== | ||
+ | Permite obtener la lista de anexos asociados al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es el Receptor que lo está solicitando | ||
− | |||
− | |||
− | |||
Línea 1255: | Línea 1315: | ||
|- | |- | ||
|rowspan="3"|Int | |rowspan="3"|Int | ||
+ | |TipoDocumento | ||
+ | |Es el tipo de documento que se va a manejar. | ||
+ | |2 caracteres | ||
+ | |- | ||
|identificadorEmisor | |identificadorEmisor | ||
|NIT del Emisor o Identificador Tributario del Emisor de la Factura | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
Línea 1260: | Línea 1324: | ||
|- | |- | ||
|tipoIdentificacionemisor | |tipoIdentificacionemisor | ||
− | |Identificador del Emisor | + | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] |
|2 caracteres | |2 caracteres | ||
|- | |- | ||
+ | |rowspan="3"|String | ||
|numeroDocumento | |numeroDocumento | ||
|Identificador del documento | |Identificador del documento | ||
|Hasta 20 caracteres | |Hasta 20 caracteres | ||
|- | |- | ||
− | |||
|tokenEmpresa | |tokenEmpresa | ||
|rowspan="2"|Dato suministrado por The Factory HKA Colombia | |rowspan="2"|Dato suministrado por The Factory HKA Colombia | ||
Línea 1281: | Línea 1345: | ||
<soapenv:Header/> | <soapenv:Header/> | ||
<soapenv:Body> | <soapenv:Body> | ||
− | + | <tem:ListaAnexo> | |
<tem:request> | <tem:request> | ||
+ | <wcf:TipoDocumento>91</wcf:TipoDocumento> | ||
<wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> | <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> | ||
− | <wcf:numeroDocumento> | + | <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento> |
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
− | <wcf:tokenEmpresa> | + | <wcf:tokenEmpresa>89………………52</wcf:tokenEmpresa> |
<wcf:tokenPassword>b3……………43</wcf:tokenPassword> | <wcf:tokenPassword>b3……………43</wcf:tokenPassword> | ||
</tem:request> | </tem:request> | ||
− | </tem: | + | </tem:ListaAnexo> |
</soapenv:Body> | </soapenv:Body> | ||
</soapenv:Envelope> | </soapenv:Envelope> | ||
Línea 1297: | Línea 1362: | ||
− | + | ====<font color="Blue">Ejemplo de salida</font>==== | |
− | + | <pre> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ====<font color="Blue">Ejemplo de salida</font>==== | ||
− | <pre> | ||
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
− | <s:Body> | + | <s:Body> |
− | < | + | <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: | + | <a:ListArchivoDocumento> |
− | <a: | + | <a:ArchivoDocumento> |
− | <a: | + | <a:CreatedAt>2022-02-01T10:14:09.223</a:CreatedAt> |
− | <a: | + | <a:Format>.pdf</a:Format> |
− | <a: | + | <a:InvoiceFileId>5782</a:InvoiceFileId> |
− | <a: | + | <a:InvoiceId>19981</a:InvoiceId> |
− | <a: | + | <a:NameDisplay>LAS40588</a:NameDisplay> |
− | <a: | + | <a:NameFile>LAS40588</a:NameFile> |
− | + | <a:PathFile>Recepcion/542/31/45......34/2021/8/11/LAS40588/</a:PathFile> | |
− | + | <a:ProviderVisible>true</a:ProviderVisible> | |
− | <a: | + | <a:Type>Representacion Gráfica</a:Type> |
− | <a: | + | <a:TypeCode>1</a:TypeCode> |
− | + | <a:UpdatedAt>2022-02-01T10:14:09.223</a:UpdatedAt> | |
− | <a: | + | <a:size>43282</a:size> |
− | <a: | + | </a:ArchivoDocumento> |
− | <a: | + | <a:ArchivoDocumento> |
− | + | <a:CreatedAt>2022-03-09T12:16:47.597</a:CreatedAt> | |
− | + | <a:Format>.pdf</a:Format> | |
− | <a: | + | <a:InvoiceFileId>5984</a:InvoiceFileId> |
− | <a: | + | <a:InvoiceId>19981</a:InvoiceId> |
− | <a: | + | <a:NameDisplay>ad0000346585016210001271e</a:NameDisplay> |
− | <a: | + | <a:NameFile>32168992-676A-44C8-862D-F5E5EBC762DB</a:NameFile> |
− | <a: | + | <a:PathFile>Recepcion/542/31/45......34/2021/8/11/LAS40588/</a:PathFile> |
− | <a: | + | <a:ProviderVisible>true</a:ProviderVisible> |
− | </a: | + | <a:Type>Anexo</a:Type> |
− | </a: | + | <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: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> | |
− | |||
− | <a:mensaje>Se retorna los datos | ||
− | <a:resultado>Procesado</a:resultado | ||
− | |||
− | |||
− | </ | ||
− | </ | ||
</s:Body> | </s:Body> | ||
− | |||
− | |||
− | |||
− | |||
</pre> | </pre> | ||
− | + | ; RESPONSE: Parámetros a Recibir | |
− | + | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | |
− | + | |- | |
− | {| class="wikitable" style=" | + | ! style="background:#f2f2f2; text-align:center;"|Tipo |
− | + | ! style="background:#f2f2f2; text-align:center;"|Identificador | |
− | |- | + | ! style="background:#f2f2f2; text-align:center;"|Descripción |
− | |||
− | |||
− | ! style=" | ||
− | ! style=" | ||
|- valign="center" | |- valign="center" | ||
− | |||
− | |||
|- | |- | ||
− | | | + | |rowspan="4"|Int |
− | | | + | |InvoiceFileId |
+ | |Campo de control de identificación del archivo | ||
+ | |- | ||
+ | |InvoiceId | ||
+ | |Campo de control de identificación del documento | ||
|- | |- | ||
− | | | + | |TypeCode |
− | | | + | |Entero que indica el código de tipo de anexo; a saber admite los siguientes valores [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 5|Tabla 5]] |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ; | ||
− | |||
|- | |- | ||
− | + | |size | |
− | + | |tamaño del documento | |
− | |||
− | |||
− | |||
|- | |- | ||
− | |rowspan=" | + | |rowspan="5"|String |
− | | | + | |Format |
− | | | + | |Extensión del Archivo |
− | | | + | |- |
+ | |NameDisplay | ||
+ | |Nombre Archivo dado por el Proveedor Tecnológico, hasta 100 caracteres | ||
|- | |- | ||
− | | | + | |PathFile |
− | | | + | |Campo de control de identificación del documento |
− | |||
|- | |- | ||
− | | | + | |Type |
− | + | |Indica el tipo de adjunto; a saber : Representación Gráfica, Anexo, Acuse de Recibido, Acuse de Aceptado, Acuse de Rechazado y Acuse de Aceptación Tácita | |
− | |||
− | | | ||
|- | |- | ||
− | | | + | |NameFile |
− | | | + | |Nombre interno del archivo. Este valor es usado tanto para la solicitud de recuperación, como la solicitud de eliminación del archivo |
− | |||
|- | |- | ||
− | | | + | |rowspan="2"|Time |
− | + | |UpdatedAt | |
− | + | |fecha de la última actualización del archivo | |
− | + | |- | |
− | + | |CreatedAt | |
− | + | |Fecha en la que fue incorporado el archivo | |
− | + | |- | |
− | + | |Boolean | |
− | + | |ProviderVisible | |
− | + | |Indicador que señala si el archivo puede ser descargado por el emisor | |
− | + | |} | |
− | + | ||
− | + | NameFile : Este es indispensable para el método DercargaAnexo este debe de coincidir Type: Anexo. Para la descarga del Anexo que es el siguiente método | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
</pre> | </pre> | ||
+ | ===<font color="blue">Método DescargaAnexo</font>=== | ||
+ | |||
+ | Permite la descarga del Anexo o adjunto del documento que se encuentra vinculado al documento de factura. Que originalmente fue anexada al documento. | ||
− | ; | + | ; REQUEST: Parámetros a Enviar |
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
|- | |- | ||
Línea 1470: | Línea 1472: | ||
! style="background:#f2f2f2; text-align:center;"|Identificador | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Valor numérico | ||
|- valign="center" | |- valign="center" | ||
|- | |- | ||
− | |rowspan=" | + | |rowspan="2"|Int |
− | | | + | |TipoDocumento |
− | | | + | |Es el tipo de documento que se va a manejar. |
+ | |2 caracteres | ||
|- | |- | ||
− | | | + | |identificadorEmisor |
− | | | + | |NIT del Emisor o Identificador Tributario del Emisor de la Factura |
− | | | + | |De 6 a 20 dígitos |
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
|rowspan="5"|String | |rowspan="5"|String | ||
− | | | + | |identificadorinternoanexo |
− | | | + | |Identificador del Anexo el cual debe de consultarse en el '''Método de ListaAnexo''' |
+ | | | ||
|- | |- | ||
− | | | + | |tipoIdentificacionemisor |
− | | | + | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] |
+ | |2 caracteres | ||
|- | |- | ||
− | | | + | |numeroDocumento |
− | | | + | |Identificador del documento |
+ | |Hasta 20 caracteres | ||
|- | |- | ||
− | | | + | |tokenEmpresa |
− | | | + | |rowspan="2"|Dato suministrado por The Factory HKA Colombia |
+ | |rowspan="2"|40 caracteres | ||
|- | |- | ||
− | | | + | |tokenPassword |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
− | + | ====<font color="Blue">Ejemplo de entrada</font>==== | |
+ | <pre> | ||
+ | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> | ||
+ | <soapenv:Header/> | ||
+ | <soapenv:Body> | ||
+ | <tem:DescargarAnexo> | ||
+ | <tem:request> | ||
+ | <wcf:TipoDocumento>91</wcf:TipoDocumento> | ||
+ | <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> | ||
+ | <wcf:identificadorInternoAnexo>32168992-0000-44C8-862D-F5E5EBC762DB</wcf:identificadorInternoAnexo> | ||
+ | <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento> | ||
+ | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
+ | <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> | ||
+ | <wcf:tokenPassword>b3……………43</wcf:tokenPassword> | ||
+ | </tem:request> | ||
+ | </tem:DescargarAnexo> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | </pre> | ||
Línea 1520: | Línea 1529: | ||
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
<s:Body> | <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: | + | <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> | |
− | + | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | < | ||
− | |||
− | <a: | ||
− | <a: | ||
− | </ | ||
− | </ | ||
− | </s:Body> | ||
</pre> | </pre> | ||
− | + | ; RESPONSE: Parámetros a Recibir | |
− | + | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | |
− | + | |- | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Tipo | |
− | {| class="wikitable" style=" | + | ! style="background:#f2f2f2; text-align:center;"|Identificador |
− | + | ! style="background:#f2f2f2; text-align:center;"|Descripción | |
− | |- | ||
− | |||
− | |||
− | ! style=" | ||
− | ! style=" | ||
|- valign="center" | |- valign="center" | ||
− | |||
− | |||
|- | |- | ||
− | | | + | | - |
− | | | + | |archivo |
+ | |Archivo en Base 64 del documento | ||
+ | |- | ||
+ | |rowspan="4"|Int | ||
+ | |codigo | ||
+ | |Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | ||
+ | |- | ||
+ | |Id | ||
+ | |Id del documento. | ||
|- | |- | ||
− | |3 | + | |Type |
− | | | + | |Tipo de documento, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 3|Tabla 3]] |
|- | |- | ||
− | | | + | |sizeFile |
− | | | + | |tamaño del documento |
|- | |- | ||
− | | | + | |rowspan="6"|String |
− | | | + | |crc |
+ | |Chequeo de Redundancia Cíclica | ||
|- | |- | ||
− | | | + | |cufe |
− | | | + | |Certificado Único de Facturación Electrónica. |
|- | |- | ||
− | | | + | |displayname |
− | | | + | | |
|- | |- | ||
− | | | + | |extension |
− | | | + | |Tipo de documento que se tiene |
− | | | + | |- |
− | | | + | |mensaje |
− | + | |Mensaje descriptivo del resultado de la operación | |
− | + | |- | |
− | + | |resultado | |
− | + | |Contiene información adicional (Procesado/Error) | |
+ | |} | ||
+ | |||
+ | </pre> | ||
+ | ===<font color="blue">Método Envío de Representación Gráfica (EnviarRepGrafica) </font>=== | ||
− | + | Permite a un Receptor enviar el archivo que corresponde a la representación gráfica de un documento de Facturación Electrónica, identificado con el número documento, emitido por un proveedor de bienes y servicios identificado al Receptor ya mencionado; el archivo está codificado en Base64. | |
− | |||
Línea 1618: | Línea 1612: | ||
|- valign="center" | |- valign="center" | ||
|- | |- | ||
− | |Int | + | |rowspan="3"|Int |
− | |identificadorEmisor | + | |TipoDocumento |
+ | |Es el tipo de documento que se va a manejar. | ||
+ | |2 caracteres | ||
+ | |- | ||
+ | |visible | ||
+ | |Indica si el archivo posteriormente puede ser o no descargado por el Emisor | ||
+ | |Visible = 1, No visible = 0, 1 dígito | ||
+ | |- | ||
+ | |identificadorEmisor | ||
|NIT del Emisor o Identificador Tributario del Emisor de la Factura | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
− | | | + | | |
|- | |- | ||
− | |rowspan=" | + | |rowspan="7"|String |
− | | | + | |archivo |
− | | | + | |Archivo XML en Base64 que contiene el documento electrónico que se desea enviar |
| | | | ||
|- | |- | ||
− | | | + | |nombre |
− | |Identificador del Emisor | + | |Nombre del documento de la Representación Gráfica |
− | | | + | |Hasta 100 caracteres |
+ | |- | ||
+ | |extension | ||
+ | |Indica el formato del archivo remitido; los valores admitidos son | ||
+ | |png|bmp|jpg|pdf|doc|docx|xls|xlsx|ppt|pptx|rar|zip | ||
+ | |- | ||
+ | |identificadorEmisor | ||
+ | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
+ | |De 6 a 9 digitos | ||
|- | |- | ||
|numeroDocumento | |numeroDocumento | ||
Línea 1642: | Línea 1652: | ||
|tokenPassword | |tokenPassword | ||
|} | |} | ||
+ | |||
====<font color="Blue">Ejemplo de entrada</font>==== | ====<font color="Blue">Ejemplo de entrada</font>==== | ||
Línea 1648: | Línea 1659: | ||
<soapenv:Header/> | <soapenv:Header/> | ||
<soapenv:Body> | <soapenv:Body> | ||
− | <tem: | + | <tem:EnviarRepGrafica> |
<tem:request> | <tem:request> | ||
− | <wcf:identificadorEmisor> | + | <wcf:TipoDocumento>91</wcf:TipoDocumento> |
− | <wcf: | + | <wcf:archivo>JVB……FT0YK</wcf:archivo> |
− | <wcf:numeroDocumento> | + | <wcf:extension>ppt</wcf:extension> |
+ | <wcf:identificadorEmisor>45…34</wcf:identificadorEmisor> | ||
+ | <wcf:nombre>SOAP01-2</wcf:nombre> | ||
+ | <wcf:numeroDocumento>SOAP019</wcf:numeroDocumento> | ||
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> | <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> | ||
<wcf:tokenPassword>b3……………43</wcf:tokenPassword> | <wcf:tokenPassword>b3……………43</wcf:tokenPassword> | ||
+ | <wcf:visible>1</wcf:visible> | ||
</tem:request> | </tem:request> | ||
− | </tem: | + | </tem:EnviarRepGrafica> |
</soapenv:Body> | </soapenv:Body> | ||
</soapenv:Envelope> | </soapenv:Envelope> | ||
+ | |||
+ | |||
</pre> | </pre> | ||
− | ; RESPONSE: Parámetros a Recibir | + | ====<font color="Blue">Ejemplo de salida</font>==== |
+ | <pre> | ||
+ | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
+ | <s:Body> | ||
+ | <EnviarRepGraficaResponse xmlns="http://tempuri.org/"> | ||
+ | <EnviarRepGraficaResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | ||
+ | <a:codigo>102</a:codigo> | ||
+ | <a:mensaje>Token Password es Requerido</a:mensaje> | ||
+ | <a:resultado>Error</a:resultado> | ||
+ | </EnviarRepGraficaResult> | ||
+ | </EnviarRepGraficaResponse> | ||
+ | </s:Body> | ||
+ | </s:Envelope> | ||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
+ | |||
+ | |||
+ | ; RESPONSE: Parámetros a Recibir | ||
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
|- | |- | ||
Línea 1672: | Línea 1708: | ||
|- valign="center" | |- valign="center" | ||
|- | |- | ||
− | + | |Int | |
− | |||
− | |||
− | |||
− | |||
|codigo | |codigo | ||
|Código de retorno, (Ver catálogo de respuesta del método) | |Código de retorno, (Ver catálogo de respuesta del método) | ||
|- | |- | ||
− | | | + | |rowspan="2"|String |
− | | | + | |mensaje |
+ | |Mensaje descriptivo del resultado de la operación | ||
|- | |- | ||
− | | | + | |String |
− | | | + | |resultado, contiene información adicional (Procesado/Error) |
+ | |} | ||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
+ | ===<font color="blue">Método Envío de XML Método de “EnviarXML” </font>=== | ||
+ | |||
+ | Permite enviar el archivo XML que representa Documento Fiscal Electrónico, el cual fue emitido por un proveedor* de bienes y servicios a un cliente The Factory HKA Colombia, el archivo XML está representado en Base64. Opcionalmente se puede remitir los llamados Metadatos | ||
+ | |||
+ | |||
+ | |||
+ | ; REQUEST: Parámetros a Enviar | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
|- | |- | ||
− | | | + | ! style="background:#f2f2f2; text-align:center;"|Tipo |
− | | | + | ! style="background:#f2f2f2; text-align:center;"|Identificador |
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Valor numérico | ||
+ | |- valign="center" | ||
|- | |- | ||
− | | | + | |Int |
− | | | + | |metadata |
− | | | + | |Lista Optativa de cuarteto, que permite especificar atributos adicionales referentes al Documento Fiscal Electrónico; los cuartetos son de la forma (code, value, internal1 (optativo), internal2 (optativo)); estableciendo una asociación entre el elemento code (que representa el código de metadata ) y el resto de los “atributos” del cuarteto en cuestión. |
+ | | | ||
|- | |- | ||
− | |String | + | |rowspan="3"|String |
− | | | + | |archivo |
− | + | |Archivo XML en Base64 que contiene el documento electrónico que se desea enviar | |
− | |||
− | |||
− | | | ||
| | | | ||
|- | |- | ||
− | | | + | |tokenEmpresa |
− | | | + | |rowspan="2"|Dato suministrado por The Factory HKA Colombia |
− | | | + | |rowspan="2"|40 caracteres |
|- | |- | ||
− | | | + | |tokenPassword |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
− | + | ====<font color="Blue">Ejemplo de entrada</font>==== | |
− | ====<font color="Blue">Ejemplo de | ||
<pre> | <pre> | ||
− | < | + | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> |
− | + | <soapenv:Header/> | |
− | + | <soapenv:Body> | |
− | + | <tem:EnviarXML> | |
− | + | <tem:request> | |
− | + | <wcf:archivo>PD94b…………..bnQ+</wcf:archivo> | |
− | < | + | <wcf:metadata> |
− | < | + | <wcf:metadata> |
− | + | <wcf:Metadata> | |
− | + | <wcf:code>01</wcf:code> | |
− | + | <wcf:internal1/> | |
− | + | <wcf:internal2/> | |
− | + | <wcf:value/> | |
− | < | + | </wcf:Metadata> |
− | < | + | </wcf:metadata> |
− | </ | + | </wcf:metadata> |
− | </ | + | <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> |
− | </ | + | <wcf:tokenPassword>b3……………43</wcf:tokenPassword> |
− | </ | + | </tem:request> |
− | + | </tem:EnviarXML> | |
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
</pre> | </pre> | ||
Línea 1743: | Línea 1785: | ||
− | ====<font color="Blue"> | + | ====<font color="Blue">Ejemplo de salida</font>==== |
− | + | <pre> | |
− | + | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | |
− | + | <s:Body> | |
− | + | <EnviarXMLResponse xmlns="http://tempuri.org/"> | |
− | + | <EnviarXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | |
− | + | <a:codigo>203</a:codigo> | |
− | + | <a:documentoId>AHJ07</a:documentoId> | |
− | + | <a:estatusDocumento>Cargado</a:estatusDocumento> | |
− | + | <a:mensaje>Documento Enviado Satisfactoriamente - Problema(s) con Metadato(s) : Valor(es) suministrado(s) para Metadato(s) no corresponde(n) a la(s) lista(s) definida(s)</a:mensaje> | |
− | + | <a:numeroIdentificacion>45......34</a:numeroIdentificacion> | |
− | + | <a:resultado>Procesado</a:resultado> | |
− | + | <a:tipoIdentificacion>31</a:tipoIdentificacion> | |
− | + | </EnviarXMLResult> | |
− | + | </EnviarXMLResponse> | |
− | + | </s:Body> | |
− | + | </s:Envelope> | |
− | |||
− | |||
+ | </pre> | ||
− | + | ; RESPONSE: Parámetros a Recibir | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | ; | ||
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
|- | |- | ||
Línea 1779: | Línea 1812: | ||
! style="background:#f2f2f2; text-align:center;"|Identificador | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
− | |||
|- valign="center" | |- valign="center" | ||
|- | |- | ||
− | | | + | | - |
− | | | + | |archivo |
− | | | + | |Archivo en Base 64 del documento |
− | |||
|- | |- | ||
− | |rowspan="3"| | + | |rowspan="3"|Int |
− | | | + | |codigo |
− | | | + | |Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]] |
− | | | ||
|- | |- | ||
− | | | + | |numeroIdentificacion |
− | | | + | |Id del documento. |
− | |||
|- | |- | ||
− | | | + | |tipoIdentificacion |
− | |} | + | |Tipo de identificación del documento |
− | + | |- | |
+ | |rowspan="4"|String | ||
+ | |Identificador del documento | ||
+ | |- | ||
+ | |estatusDocumento | ||
+ | |Estatus del Documento | ||
+ | |- | ||
+ | |mensaje | ||
+ | |Mensaje descriptivo del resultado de la operación | ||
+ | |- | ||
+ | |String | ||
+ | |resultado | ||
+ | |Contiene información adicional (Procesado/Error) | ||
+ | |} | ||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
+ | |||
+ | |||
+ | ===<font color="blue">Método Envío de Anexo (EnvioAnexo) </font>=== | ||
+ | Permite a un Receptor enviar un archivo que archivo que se “adjunta” a un documento de Facturación Electrónica , identificado con el numero documento, emitido por un proveedor de bienes y servicios también identificado; al Receptor ya mencionado; el archivo está codificado en Base64. | ||
+ | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | ; REQUEST: Parámetros a Enviar | |
− | |||
− | ; | ||
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
|- | |- | ||
Línea 1835: | Línea 1859: | ||
! style="background:#f2f2f2; text-align:center;"|Identificador | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Valor numérico | ||
|- valign="center" | |- valign="center" | ||
|- | |- | ||
− | | - | + | | - |
|archivo | |archivo | ||
− | |Archivo en | + | |Archivo en Base64 que representa un anexo de factura identificada por número de documento |
+ | | | ||
+ | |- | ||
+ | |Byte | ||
+ | |Indica si el archivo posteriormente puede ser o no descargado por el Emisor. | ||
+ | |Visible = 1, No visible = 0, 1 dígito | ||
|- | |- | ||
|rowspan="3"|Int | |rowspan="3"|Int | ||
− | | | + | |TipoDocumento |
− | | | + | |Es el tipo de documento que se va a manejar. |
+ | |2 caracteres | ||
+ | |- | ||
+ | |tipoidentificadoremisor | ||
+ | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | ||
+ | |- | ||
+ | |identificadorEmisor | ||
+ | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
+ | | | ||
|- | |- | ||
− | | | + | |rowspan="5"|String |
− | | | + | |nombre |
+ | |Nombre del documento de la Representación Gráfica | ||
+ | |Hasta 100 caracteres | ||
|- | |- | ||
− | | | + | |extension |
− | | | + | |Indica el formato del archivo remitido; los valores admitidos son |
+ | |png|bmp|jpg|pdf|doc|docx|xls|xlsx|ppt|pptx|rar|zip | ||
|- | |- | ||
− | | | + | |numeroDocumento |
|Identificador del documento | |Identificador del documento | ||
+ | |Hasta 20 caracteres | ||
|- | |- | ||
− | | | + | |tokenEmpresa |
− | | | + | |rowspan="2"|Dato suministrado por The Factory HKA Colombia |
+ | |rowspan="2"|40 caracteres | ||
|- | |- | ||
− | | | + | |tokenPassword |
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
+ | |||
+ | |||
+ | ====<font color="Blue">Ejemplo de entrada</font>==== | ||
+ | <pre> | ||
+ | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> | ||
+ | <soapenv:Header/> | ||
+ | <soapenv:Body> | ||
+ | <tem:EnviarAnexo> | ||
+ | <tem:request> | ||
+ | <wcf:archivo>JVB…….</wcf:archivo> | ||
+ | <wcf:extension>pdf</wcf:extension> | ||
+ | <wcf:TipoDocumento>91</wcf:TipoDocumento> | ||
+ | <wcf:identificadorEmisor>456…34</wcf:identificadorEmisor> | ||
+ | <wcf:nombre>AHJ07-7</wcf:nombre> | ||
+ | <wcf:numeroDocumento>AHJ07</wcf:numeroDocumento> | ||
+ | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
+ | <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> | ||
+ | <wcf:tokenPassword>b3……………43</wcf:tokenPassword> | ||
+ | <wcf:visible>1</wcf:visible> | ||
+ | </tem:request> | ||
+ | </tem:EnviarAnexo> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | |||
+ | |||
+ | |||
+ | </pre> | ||
Línea 1869: | Línea 1934: | ||
====<font color="Blue">Ejemplo de salida</font>==== | ====<font color="Blue">Ejemplo de salida</font>==== | ||
<pre> | <pre> | ||
+ | <?xml version="1.0" encoding="UTF-8"?> | ||
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
<s:Body> | <s:Body> | ||
− | < | + | <EnviarAnexoResponse xmlns="http://tempuri.org/"> |
− | < | + | <EnviarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> |
− | <a:codigo> | + | <a:codigo>200</a:codigo> |
− | + | <a:mensaje>Archivo enviado satisfactoriamente</a:mensaje> | |
− | |||
− | <a:mensaje> | ||
− | |||
<a:resultado>Procesado</a:resultado> | <a:resultado>Procesado</a:resultado> | ||
− | + | </EnviarAnexoResult> | |
− | </ | + | </EnviarAnexoResponse> |
− | </ | ||
</s:Body> | </s:Body> | ||
</s:Envelope> | </s:Envelope> | ||
Línea 1888: | Línea 1950: | ||
− | + | ; RESPONSE: Parámetros a Recibir | |
− | + | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | |
− | {| class="wikitable" style=" | + | |- |
− | + | ! style="background:#f2f2f2; text-align:center;"|Tipo | |
− | |- | + | ! style="background:#f2f2f2; text-align:center;"|Identificador |
− | + | ! style="background:#f2f2f2; text-align:center;"|Descripción | |
− | |||
− | ! style=" | ||
− | ! style=" | ||
|- valign="center" | |- valign="center" | ||
− | |||
− | |||
|- | |- | ||
− | | | + | |Int |
− | | | + | |codigo |
+ | |Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]] | ||
|- | |- | ||
− | | | + | |rowspan="2"|String |
− | | | + | |mensaje |
− | | | + | |Mensaje descriptivo del resultado de la operación |
+ | |- | ||
+ | |String | ||
+ | |resultado | ||
+ | |Contiene información adicional (Procesado/Error) | ||
|} | |} | ||
− | + | </pre> | |
− | + | ===<font color="blue">Método EliminarRepGrafica</font>=== | |
− | + | Método que permite a un Receptor eliminar la Representación Gráfica de un documento de Facturación Electrónica que esté vinculado. | |
− | |||
− | |||
− | ===<font color="blue">Método | ||
− | |||
− | |||
− | |||
− | |||
− | |||
; REQUEST: Parámetros a Enviar | ; REQUEST: Parámetros a Enviar | ||
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
Línea 1929: | Línea 1983: | ||
|- valign="center" | |- valign="center" | ||
|- | |- | ||
− | |rowspan=" | + | |rowspan="3"|Int |
− | | | + | |TipoDocumento |
− | | | + | |Es el tipo de documento que se va a manejar. |
− | | | + | |2 caracteres |
|- | |- | ||
− | |identificadorEmisor | + | |identificadorEmisor |
|NIT del Emisor o Identificador Tributario del Emisor de la Factura | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
− | | | + | |De 6 a 20 dígitos |
|- | |- | ||
− | | | + | |tipoIdentificacionemisor |
− | + | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | |
− | + | |2 caracteres | |
− | |||
− | | | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | | | ||
− | |||
− | | | ||
|- | |- | ||
+ | |rowspan="3"|String | ||
|tokenEmpresa | |tokenEmpresa | ||
|rowspan="2"|Dato suministrado por The Factory HKA Colombia | |rowspan="2"|Dato suministrado por The Factory HKA Colombia | ||
Línea 1972: | Línea 2010: | ||
<soapenv:Header/> | <soapenv:Header/> | ||
<soapenv:Body> | <soapenv:Body> | ||
− | <tem: | + | <tem:EliminarRepGrafica> |
− | + | <!--Optional:--> | |
− | + | <tem:request> | |
− | + | <!--Optional:--> | |
− | + | <wcf:TipoDocumento>91</wcf:TipoDocumento> | |
− | + | <!--Optional:--> | |
− | + | <wcf:identificadorEmisor>25…………08</wcf:identificadorEmisor> | |
− | + | <!--Optional:--> | |
− | + | <wcf:numeroDocumento>ERTYBNT017</wcf:numeroDocumento> | |
− | + | <!--Optional:--> | |
− | + | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | |
− | + | <!--Optional:--> | |
− | + | <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> | |
+ | <!--Optional:--> | ||
+ | <wcf:tokenPassword>b3……..43</wcf:tokenPassword> | ||
+ | </tem:request> | ||
+ | </tem:EliminarRepGrafica> | ||
+ | |||
+ | |||
</soapenv:Body> | </soapenv:Body> | ||
</soapenv:Envelope> | </soapenv:Envelope> | ||
+ | |||
+ | |||
</pre> | </pre> | ||
+ | |||
+ | ====<font color="Blue">Ejemplo de salida</font>==== | ||
+ | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
+ | <s:Body> | ||
+ | <EliminarRepGraficaResponse xmlns="http://tempuri.org/"> | ||
+ | <EliminarRepGraficaResponse xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | ||
+ | <a:codigo>103</a:codigo> | ||
+ | <a:mensaje>Se produjo un error en el servicio...{"Codigo":"104","Mensaje":"No se tiene registrado como válido el anexo ERTYBNT017 en el documento ERTYBNT017 emitido por NIT 25………08 a NIT 90………98","Resultado":"Error"} por favor inténtelo más tarde</a:mensaje> | ||
+ | <a:resultado>Error</a:resultado> | ||
+ | </EliminarRepGraficaResult> | ||
+ | </EliminarRepGraficaResponse> | ||
+ | </s:Body> | ||
+ | </s:Envelope> | ||
+ | |||
+ | </pre> | ||
Línea 1996: | Línea 2057: | ||
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
|- | |- | ||
− | ! style="background:#f2f2f2; text-align:center;"| | + | ! style="background:#f2f2f2; text-align:center;"|Código |
− | |||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
|- valign="center" | |- valign="center" | ||
|- | |- | ||
− | | | + | | 200 |
− | | | + | | Representación Gráfica enviada satisfactoriamente |
− | | | + | |- |
+ | |102 | ||
+ | |El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango./ Dato que es erróneo | ||
|- | |- | ||
− | | | + | |103 |
− | | | + | |Error Interno en el Servicio |
− | | | + | |Código de retorno. Ver catálogo de respuesta del método |
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
− | + | ===<font color="blue">Método EliminarAnexo/font>=== | |
− | + | Método que permite al Receptor eliminar anexos que estén vinculados a un documento de Facturación Electrónica. | |
− | + | ; REQUEST: Parámetros a Enviar | |
− | + | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | |
− | + | |- | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Tipo | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Identificador | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Descripción | |
− | + | ! style="background:#f2f2f2; text-align:center;"|Valor numérico | |
− | + | |- valign="center" | |
− | + | |- | |
− | + | |rowspan="3"|Int | |
− | + | |TipoDocumento | |
− | + | |Es el tipo de documento que se va a manejar. | |
− | + | |2 caracteres | |
− | + | |- | |
− | + | |identificadorEmisor | |
− | + | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | |
− | + | |De 6 a 20 dígitos | |
− | + | |- | |
− | + | |tipoIdentificacionemisor | |
− | + | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | |
− | |- | + | |2 caracteres |
− | |||
− | |||
− | ! style=" | ||
− | ! style=" | ||
− | |- valign="center" | ||
− | | | ||
− | | | ||
|- | |- | ||
− | | | + | |rowspan="3"|String |
− | | | + | |tokenEmpresa |
+ | |rowspan="2"|Dato suministrado por The Factory HKA Colombia | ||
+ | |rowspan="2"|40 caracteres | ||
|- | |- | ||
− | | | + | |tokenPassword |
− | |||
− | |||
|} | |} | ||
− | + | ||
− | + | ====<font color="Blue">Ejemplo de entrada</font>==== | |
+ | <pre> | ||
+ | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> | ||
+ | <soapenv:Header/> | ||
+ | <soapenv:Body> | ||
+ | <tem:EliminarAnexo> | ||
+ | <!--Optional:--> | ||
+ | <tem:request> | ||
+ | <!--Optional:--> | ||
+ | <wcf:TipoDocumento>91</wcf:TipoDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:identificadorEmisor>25……08</wcf:identificadorEmisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:identificadorInternoAnexo>A177CFD9-695C-4E0A-BC36-0A8DC187A4C9</wcf:identificadorInternoAnexo> | ||
+ | <!--Optional:--> | ||
+ | <wcf:numeroDocumento>ERTYBNT017</wcf:numeroDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenPassword>b3…………………43</wcf:tokenPassword> | ||
+ | </tem:request> | ||
+ | </tem:EliminarAnexo> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | |||
+ | |||
+ | |||
+ | </pre> | ||
− | ===<font color=" | + | ====<font color="Blue">Ejemplo de salida</font>==== |
− | + | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | |
+ | <s:Body> | ||
+ | <EliminarAnexoResponse xmlns="http://tempuri.org/"> | ||
+ | <EliminarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | ||
+ | <a:codigo>103</a:codigo> | ||
+ | <a:mensaje>Se produjo un error en el servicio...{"Codigo":"104","Mensaje":"No se tiene registrado como válido el anexo A177CFD9-695C-4E0A-BC36-0A8DC187A4C9 en el documento ERTYBNT017 emitido por NIT 25………08 a NIT 90………98","Resultado":"Error"} por favor inténtelo más tarde</a:mensaje> | ||
+ | <a:resultado>Error</a:resultado> | ||
+ | </EliminarAnexoResult> | ||
+ | </EliminarAnexoResponse> | ||
+ | </s:Body> | ||
+ | </s:Envelope> | ||
+ | </pre> | ||
− | ; | + | ; RESPONSE: Parámetros a Recibir |
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
|- | |- | ||
− | |||
! style="background:#f2f2f2; text-align:center;"|Identificador | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
! style="background:#f2f2f2; text-align:center;"|Descripción | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
− | |||
|- valign="center" | |- valign="center" | ||
|- | |- | ||
− | | | + | | Identificador |
− | | | + | | Código de retorno. |
− | | | + | |- |
− | | | + | |mensaje |
+ | |Mensaje descriptivo del resultado de la operación | ||
+ | |- | ||
+ | |resultado | ||
+ | |Contiene información adicional (Procesado/Error) | ||
+ | |} | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===<font color="blue">Método DescargarRecepcionBienServicioXML</font>=== | ||
+ | Método que permite a un Receptor, descargar el Response del evento de Recibo del bien y/o Prestación de servicio, el cual está asociado a un documento que se en encuentra en el sistema | ||
+ | ; REQUEST: Parámetros a Enviar | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
|- | |- | ||
− | | | + | ! style="background:#f2f2f2; text-align:center;"|Tipo |
− | | | + | ! style="background:#f2f2f2; text-align:center;"|Identificador |
− | | | + | ! style="background:#f2f2f2; text-align:center;"|Descripción |
+ | ! style="background:#f2f2f2; text-align:center;"|Valor numérico | ||
+ | |- valign="center" | ||
|- | |- | ||
− | |rowspan=" | + | |rowspan="6"|Int |
− | | | + | |TipoDocumento |
− | | | + | |Es el tipo de documento que se va a manejar. |
|2 caracteres | |2 caracteres | ||
|- | |- | ||
− | | | + | |nombreFileApplicationResponse |
− | | | + | |Nombre del documento que se encuentra en Lista de Anexo |
+ | | - | ||
+ | |- | ||
+ | |tipoDescarga | ||
+ | |Tipo de Descarga del documento | ||
| | | | ||
|- | |- | ||
− | | | + | |identificadorEmisor |
− | | | + | |NIT del Emisor o Identificador Tributario del Emisor de la Factura |
− | + | |De 6 a 20 dígitos | |
− | | | ||
|- | |- | ||
− | | | + | |tipoIdentificacionemisor |
− | | | + | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] |
− | | | + | |2 caracteres |
|- | |- | ||
− | | | + | |nmeroDocumento |
|Identificador del documento | |Identificador del documento | ||
− | | | + | |2 caracteres |
− | |- | + | |- |
− | |tokenEmpresa | + | |rowspan="3"|String |
− | |rowspan="2"|Dato suministrado por The Factory HKA Colombia | + | |tokenEmpresa |
− | |rowspan="2"|40 caracteres | + | |rowspan="2"|Dato suministrado por The Factory HKA Colombia |
− | |- | + | |rowspan="2"|40 caracteres |
− | |tokenPassword | + | |- |
− | |} | + | |tokenPassword |
+ | |} | ||
+ | |||
+ | |||
+ | ====<font color="Blue">Ejemplo de entrada</font>==== | ||
+ | <pre> | ||
+ | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> | ||
+ | <soapenv:Header/> | ||
+ | <soapenv:Body> | ||
+ | <tem:DescargarRecepcionBienServicioXML> | ||
+ | <!--Optional:--> | ||
+ | <tem:request> | ||
+ | <!--Optional:--> | ||
+ | <wcf:TipoDocumento>01</wcf:TipoDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:identificadorEmisor>90……26</wcf:identificadorEmisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:nombreFileApplicationResponse>f2c7b462-297a-4347-8a35-f63d8a947912.xml</wcf:nombreFileApplicationResponse> | ||
+ | <!--Optional:--> | ||
+ | <wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tipoDescarga>1</wcf:tipoDescarga> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenPassword>b3…………43</wcf:tokenPassword> | ||
+ | </tem:request> | ||
+ | </tem:DescargarRecepcionBienServicioXML> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
+ | |||
+ | ====<font color="Blue">Ejemplo de salida</font>==== | ||
+ | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
+ | <s:Body> | ||
+ | <DescargarRecepcionBienServicioXMLResponse xmlns="http://tempuri.org/"> | ||
+ | <DescargarRecepcionBienServicioXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | ||
+ | <a:archivo>PD94bW…………………</a:archivo> | ||
+ | <a:codigo>200</a:codigo> | ||
+ | <a:crc>dcdc43fb31588b396ccd3ff322fbeda7</a:crc> | ||
+ | <a:cufe>f2c7b462-297a-4347-8a35-f63d8a947912.xml</a:cufe> | ||
+ | <a:mensaje>Se retorna el archivo solicitado</a:mensaje> | ||
+ | <a:resultado>Procesado</a:resultado> | ||
+ | <a:size>15096</a:size> | ||
+ | </DescargarRecepcionBienServicioXMLResult> | ||
+ | </DescargarRecepcionBienServicioXMLResponse> | ||
+ | </s:Body> | ||
+ | </s:Envelope> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
+ | |||
+ | ; RESPONSE: Parámetros a Recibir | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
+ | |- | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | | - | ||
+ | |archivo | ||
+ | |Archivo en Base 64 del documento | ||
+ | |- | ||
+ | |rowspan="2"|Int | ||
+ | |codigo | ||
+ | |Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | ||
+ | |- | ||
+ | |sizeFile | ||
+ | |tamaño del documento | ||
+ | |- | ||
+ | |rowspan="4"|String | ||
+ | |crc | ||
+ | |Chequeo de Redundancia Cíclica | ||
+ | |- | ||
+ | |cufe | ||
+ | |Certificado Único de Facturación Electrónica. | ||
+ | |- | ||
+ | |mensaje | ||
+ | |Mensaje descriptivo del resultado de la operación | ||
+ | |- | ||
+ | |resultado | ||
+ | |Contiene información adicional (Procesado/Error) | ||
+ | |} | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===<font color="blue">Método DescargarAcuseReclamo</font>=== | ||
+ | Método que permite a un Receptor, descargar el Response del evento de Recibo del bien y/o Prestación de servicio, el cual está asociado a un documento que se en encuentra en el sistema | ||
+ | ; REQUEST: Parámetros a Enviar | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
+ | |- | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Valor numérico | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |rowspan="6"|Int | ||
+ | |TipoDocumento | ||
+ | |Es el tipo de documento que se va a manejar. | ||
+ | |2 caracteres | ||
+ | |- | ||
+ | |nombreFileApplicationResponse | ||
+ | |Nombre del documento que se encuentra en Lista de Anexo | ||
+ | | - | ||
+ | |- | ||
+ | |tipoDescarga | ||
+ | |Tipo de Descarga del documento | ||
+ | | | ||
+ | |- | ||
+ | |identificadorEmisor | ||
+ | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
+ | |De 6 a 20 dígitos | ||
+ | |- | ||
+ | |tipoIdentificacionemisor | ||
+ | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | ||
+ | |2 caracteres | ||
+ | |- | ||
+ | |nmeroDocumento | ||
+ | |Identificador del documento | ||
+ | |2 caracteres | ||
+ | |- | ||
+ | |rowspan="3"|String | ||
+ | |tokenEmpresa | ||
+ | |rowspan="2"|Dato suministrado por The Factory HKA Colombia | ||
+ | |rowspan="2"|40 caracteres | ||
+ | |- | ||
+ | |tokenPassword | ||
+ | |} | ||
+ | |||
+ | |||
+ | ====<font color="Blue">Ejemplo de entrada</font>==== | ||
+ | <pre> | ||
+ | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> | ||
+ | <soapenv:Header/> | ||
+ | <soapenv:Body> | ||
+ | <tem:DescargarAcuseReclamoXML> | ||
+ | <!--Optional:--> | ||
+ | <tem:request> | ||
+ | <!--Optional:--> | ||
+ | <wcf:TipoDocumento>01</wcf:TipoDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:identificadorEmisor>90……26</wcf:identificadorEmisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:nombreFileApplicationResponse></wcf:nombreFileApplicationResponse> | ||
+ | <!--Optional:--> | ||
+ | <wcf:numeroDocumento>SETP990441828</wcf:numeroDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tipoDescarga>2</wcf:tipoDescarga> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenPassword>b3………43</wcf:tokenPassword> | ||
+ | </tem:request> | ||
+ | </tem:DescargarAcuseReclamoXML> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
+ | |||
+ | ====<font color="Blue">Ejemplo de salida</font>==== | ||
+ | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
+ | <s:Body> | ||
+ | <DescargarAcuseReclamoXMLResponse xmlns="http://tempuri.org/"> | ||
+ | <DescargarAcuseReclamoXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | ||
+ | <a:archivo>PD94bWwgdmVyc…………………</a:archivo> | ||
+ | <a:codigo>200</a:codigo> | ||
+ | <a:crc>0e6751bef6bf2815685fc4203efa9ba1</a:crc> | ||
+ | <a:cufe>62229467-75a3-4d3f-97b3-923798c52431.xml</a:cufe> | ||
+ | <a:mensaje>Se retorna el archivo solicitado</a:mensaje> | ||
+ | <a:resultado>Procesado</a:resultado> | ||
+ | <a:size>14792</a:size> | ||
+ | </DescargarAcuseReclamoXMLResult> | ||
+ | </DescargarAcuseReclamoXMLResponse> | ||
+ | </s:Body> | ||
+ | </s:Envelope> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
+ | |||
+ | ; RESPONSE: Parámetros a Recibir | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
+ | |- | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | | - | ||
+ | |archivo | ||
+ | |Archivo en Base 64 del documento | ||
+ | |- | ||
+ | |rowspan="2"|Int | ||
+ | |codigo | ||
+ | |Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | ||
+ | |- | ||
+ | |sizeFile | ||
+ | |tamaño del documento | ||
+ | |- | ||
+ | |rowspan="4"|String | ||
+ | |crc | ||
+ | |Chequeo de Redundancia Cíclica | ||
+ | |- | ||
+ | |cufe | ||
+ | |Certificado Único de Facturación Electrónica. | ||
+ | |- | ||
+ | |mensaje | ||
+ | |Mensaje descriptivo del resultado de la operación | ||
+ | |- | ||
+ | |resultado | ||
+ | |Contiene información adicional (Procesado/Error) | ||
+ | |} | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===<font color="blue">Método DescargarAcuseRecibido</font>=== | ||
+ | Método que permite a un Receptor, descargar el Response del evento del Acuse de Recibido, el cual está asociado a un documento que se en encuentra en el sistema Método | ||
+ | ; REQUEST: Parámetros a Enviar | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
+ | |- | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Valor numérico | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |rowspan="6"|Int | ||
+ | |TipoDocumento | ||
+ | |Es el tipo de documento que se va a manejar. | ||
+ | |2 caracteres | ||
+ | |- | ||
+ | |nombreFileApplicationResponse | ||
+ | |Nombre del documento que se encuentra en Lista de Anexo | ||
+ | | - | ||
+ | |- | ||
+ | |tipoDescarga | ||
+ | |Tipo de Descarga del documento | ||
+ | | | ||
+ | |- | ||
+ | |identificadorEmisor | ||
+ | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
+ | |De 6 a 20 dígitos | ||
+ | |- | ||
+ | |tipoIdentificacionemisor | ||
+ | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | ||
+ | |2 caracteres | ||
+ | |- | ||
+ | |nmeroDocumento | ||
+ | |Identificador del documento | ||
+ | |2 caracteres | ||
+ | |- | ||
+ | |rowspan="3"|String | ||
+ | |tokenEmpresa | ||
+ | |rowspan="2"|Dato suministrado por The Factory HKA Colombia | ||
+ | |rowspan="2"|40 caracteres | ||
+ | |- | ||
+ | |tokenPassword | ||
+ | |} | ||
+ | |||
+ | |||
+ | ====<font color="Blue">Ejemplo de entrada</font>==== | ||
+ | <pre> | ||
+ | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> | ||
+ | <soapenv:Header/> | ||
+ | <soapenv:Body> | ||
+ | <tem:DescargarAcuseRecibidoXML> | ||
+ | <!--Optional:--> | ||
+ | <tem:request> | ||
+ | <!--Optional:--> | ||
+ | <wcf:TipoDocumento></wcf:TipoDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:identificadorEmisor>90……26</wcf:identificadorEmisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:nombreFileApplicationResponse>226a6537-fdc5-4224-84cd-bd31fbe39af5.xml</wcf:nombreFileApplicationResponse> | ||
+ | <!--Optional:--> | ||
+ | <wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tipoDescarga>1</wcf:tipoDescarga> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenPassword>b3………43</wcf:tokenPassword> | ||
+ | </tem:request> | ||
+ | </tem:DescargarAcuseRecibidoXML> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
+ | |||
+ | ====<font color="Blue">Ejemplo de salida</font>==== | ||
+ | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
+ | <s:Body> | ||
+ | <DescargarAcuseRecibidoXMLResponse xmlns="http://tempuri.org/"> | ||
+ | <DescargarAcuseRecibidoXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | ||
+ | <a:archivo>PD94bWwgdm…………………</a:archivo> | ||
+ | <a:codigo>200</a:codigo> | ||
+ | <a:crc>a26ecb9330992ac9ab4479f457fbdaeb</a:crc> | ||
+ | <a:cufe>226a6537-fdc5-4224-84cd-bd31fbe39af5.xml</a:cufe> | ||
+ | <a:mensaje>Se retorna el archivo solicitado</a:mensaje> | ||
+ | <a:resultado>Procesado</a:resultado> | ||
+ | <a:size>15100</a:size> | ||
+ | </DescargarAcuseRecibidoXMLResult> | ||
+ | </DescargarAcuseRecibidoXMLResponse> | ||
+ | </s:Body> | ||
+ | </s:Envelope> | ||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
+ | |||
+ | ; RESPONSE: Parámetros a Recibir | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
+ | |- | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | | - | ||
+ | |archivo | ||
+ | |Archivo en Base 64 del documento | ||
+ | |- | ||
+ | |rowspan="2"|Int | ||
+ | |codigo | ||
+ | |Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | ||
+ | |- | ||
+ | |sizeFile | ||
+ | |tamaño del documento | ||
+ | |- | ||
+ | |rowspan="4"|String | ||
+ | |crc | ||
+ | |Chequeo de Redundancia Cíclica | ||
+ | |- | ||
+ | |cufe | ||
+ | |Certificado Único de Facturación Electrónica. | ||
+ | |- | ||
+ | |mensaje | ||
+ | |Mensaje descriptivo del resultado de la operación | ||
+ | |- | ||
+ | |resultado | ||
+ | |Contiene información adicional (Procesado/Error) | ||
+ | |} | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===<font color="blue">Método DescargarAcuseAceptacion</font>=== | ||
+ | Método que permite a un Receptor, descargar el Response del evento de Aceptación, el cual está asociado a un documento que se en encuentra en el sistema | ||
+ | ; REQUEST: Parámetros a Enviar | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
+ | |- | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Valor numérico | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |rowspan="6"|Int | ||
+ | |TipoDocumento | ||
+ | |Es el tipo de documento que se va a manejar. | ||
+ | |2 caracteres | ||
+ | |- | ||
+ | |nombreFileApplicationResponse | ||
+ | |Nombre del documento que se encuentra en Lista de Anexo | ||
+ | | - | ||
+ | |- | ||
+ | |tipoDescarga | ||
+ | |Tipo de Descarga del documento | ||
+ | | | ||
+ | |- | ||
+ | |identificadorEmisor | ||
+ | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
+ | |De 6 a 20 dígitos | ||
+ | |- | ||
+ | |tipoIdentificacionemisor | ||
+ | |Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | ||
+ | |2 caracteres | ||
+ | |- | ||
+ | |nmeroDocumento | ||
+ | |Identificador del documento | ||
+ | |2 caracteres | ||
+ | |- | ||
+ | |rowspan="3"|String | ||
+ | |tokenEmpresa | ||
+ | |rowspan="2"|Dato suministrado por The Factory HKA Colombia | ||
+ | |rowspan="2"|40 caracteres | ||
+ | |- | ||
+ | |tokenPassword | ||
+ | |} | ||
+ | |||
+ | |||
+ | ====<font color="Blue">Ejemplo de entrada</font>==== | ||
+ | <pre> | ||
+ | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> | ||
+ | <soapenv:Header/> | ||
+ | <soapenv:Body> | ||
+ | <tem:DescargarAcuseAceptacionXML> | ||
+ | <!--Optional:--> | ||
+ | <tem:request> | ||
+ | <!--Optional:--> | ||
+ | <wcf:TipoDocumento></wcf:TipoDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:identificadorEmisor>90……26</wcf:identificadorEmisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:nombreFileApplicationResponse>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</wcf:nombreFileApplicationResponse> | ||
+ | <!--Optional:--> | ||
+ | <wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tipoDescarga>1</wcf:tipoDescarga> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> | ||
+ | <!--Optional:--> | ||
+ | <wcf:tokenPassword>b3…………43</wcf:tokenPassword> | ||
+ | </tem:request> | ||
+ | </tem:DescargarAcuseAceptacionXML> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
+ | |||
+ | ====<font color="Blue">Ejemplo de salida</font>==== | ||
+ | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
+ | <s:Body> | ||
+ | <DescargarAcuseAceptacionXMLResponse xmlns="http://tempuri.org/"> | ||
+ | <DescargarAcuseAceptacionXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | ||
+ | <a:archivo>PD94bWwgd…………………</a:archivo> | ||
+ | <a:codigo>200</a:codigo> | ||
+ | <a:crc>022770951408403f9442f9d09e52be15</a:crc> | ||
+ | <a:cufe>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</a:cufe> | ||
+ | <a:mensaje>Se retorna el archivo solicitado</a:mensaje> | ||
+ | <a:resultado>Procesado</a:resultado> | ||
+ | <a:size>14688</a:size> | ||
+ | </DescargarAcuseRecibidoXMLResult> | ||
+ | </DescargarAcuseRecibidoXMLResponse> | ||
+ | </s:Body> | ||
+ | </s:Envelope> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
+ | |||
+ | ; RESPONSE: Parámetros a Recibir | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
+ | |- | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | | - | ||
+ | |archivo | ||
+ | |Archivo en Base 64 del documento | ||
+ | |- | ||
+ | |rowspan="2"|Int | ||
+ | |codigo | ||
+ | |Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]] | ||
+ | |- | ||
+ | |sizeFile | ||
+ | |tamaño del documento | ||
+ | |- | ||
+ | |rowspan="4"|String | ||
+ | |crc | ||
+ | |Chequeo de Redundancia Cíclica | ||
+ | |- | ||
+ | |cufe | ||
+ | |Certificado Único de Facturación Electrónica. | ||
+ | |- | ||
+ | |mensaje | ||
+ | |Mensaje descriptivo del resultado de la operación | ||
+ | |- | ||
+ | |resultado | ||
+ | |Contiene información adicional (Procesado/Error) | ||
+ | |} | ||
+ | |||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
'''Mensaje:''' String que contiene mensaje descriptivo del resultado de la operación | '''Mensaje:''' String que contiene mensaje descriptivo del resultado de la operación | ||
− | '''resultado:''' String que contiene información adicional (Uso futuro) | + | '''resultado:''' String que contiene información adicional (Uso futuro) |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Revisión actual del 21:23 19 ene 2024
Sumario
- 1 Servicios de Manejo de Documentos Electrónicos para Receptor
- 1.1 Método de Reporte con Estatus (ReporteStatus)
- 1.2 Método Reporte
- 1.3 Método de Descarga XML
- 1.4 Método de Descarga RepresentacionGrafica
- 1.5 Método de Descarga de Adjuntos/Anexos
- 1.6 Método Consulta de Estado Documento
- 1.7 Método Cambio de Status
- 1.8 Método Consulta de Metadata (infodatos) (a los documentos) ConsultaDocumentosMetadata
- 1.9 Método ListaAnexo
- 1.10 Método DescargaAnexo
- 1.11 Método Envío de Representación Gráfica (EnviarRepGrafica)
- 1.12 Método Envío de XML Método de “EnviarXML”
- 1.13 Método Envío de Anexo (EnvioAnexo)
- 1.14 Método EliminarRepGrafica
- 1.15 Método EliminarAnexo/font>
- 1.16 Método DescargarRecepcionBienServicioXML
- 1.17 Método DescargarAcuseReclamo
- 1.18 Método DescargarAcuseRecibido
- 1.19 Método DescargarAcuseAceptacion
Servicios de Manejo de Documentos Electrónicos para Receptor
Método de Reporte con Estatus (ReporteStatus)
Muestra la lista de los 500 últimos documentos de Facturación Electrónica con el respectivo estado que se está buscando, que se han recibidos para un Receptor dado y que tienen asociado un consecutivo menor a un valor suministrado.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | consecutivo | Número consecutivo de los documentos a revisa | número consecutivo del documento o en blanco |
status_code | Código de Estatus del documento | Requerido para la búsqueda*,se puede verificar en la siguiente Tabla 1 | |
String | tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres |
tokenPassword |
En la siguiente tabla se muestran los estados +(tabla 1) posibles del documento para ingresarlos y obtener un reporte solo con los documentos con el estado proporcionado.
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:ReporteStatus> <tem:request> <wcf:consecutivo>500</wcf:consecutivo> <wcf:status_code>01</wcf:status_code> <wcf:tokenEmpresa>89………………………………52</wcf:tokenEmpresa> <wcf:tokenPassword>b3…………………………43</wcf:tokenPassword> </tem:request> </tem:ReporteStatus> </soapenv:Body> </soapenv:Envelope>
Ejemplo de Salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <ReporteStatusResponse xmlns="http://tempuri.org/"> <ReporteStatusResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:codigo>200</a:codigo> <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <ReporteStatusResponse xmlns="http://tempuri.org/"> <ReporteStatusResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:codigo>200</a:codigo> <a:documentoselectronicos> <a:InfoDocumentoStatus> <a:correlativoempresa>177</a:correlativoempresa> <a:cufe>90931e5e4e97f8d695326b2cd49328b1fcb0bf669bf9252b02acfaaab6bebe281c6adc846165e3b00a3cf23d00dfeb99</a:cufe> <a:estatus>1</a:estatus> <a:estatusDIANcodigo/> <a:estatusDIANdescripcion <a:estatusDIANfecha/> <a:estatusnombre>Entregado</a:estatusnombre> <a:fechaemision>2021-09-21</a:fechaemision> <a:fecharecepcion>2021-11-17T19:24:07</a:fecharecepcion> <a:horaemision>23:24:46</a:horaemision> <a:montototal>21665472.08</a:montototal> <a:numerodocumento>SUN64</a:numerodocumento> <a:numeroidentificacion>595454595</a:numeroidentificacion> <a:razonsocial>Ady.SA</a:razonsocial> <a:tipodocumento>01</a:tipodocumento> <a:tipoemisor>1</a:tipoemisor> <a:tipoidentidad>31</a:tipoidentidad> </a:InfoDocumentoStatus> ………………… </a:documentoselectronicos> <a:mensaje>Procesado</a:mensaje> <a:pendiente>false</a:pendiente> <a:resultado>Procesado</a:resultado> <a:ultimoEnviado>25</a:ultimoEnviado> </ReporteStatusResult> </ReporteStatusResponse> </s:Body> </s:Envelope>
NOTA: El ultimoEnviado es el número consecutivo para ver los archivos anteriores a el último que se muestra. Si se tienen más documentos el reporte mostrará true en la etiqueta pendientes, de caso contrario si se tiene false indica que ya no se tienen documentos.
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
Int | Código | Código de retorno. Ver catálogo de respuesta del método |
Int | CorrelativoEmpresa | Número correlativo de la empresa |
String | estatus | Estatus del documento en el que se encuentra Tabla 1 |
String | cufe | Certificado Único de Facturación Electrónica. |
Date | fechaemision | Fecha en el que fue emitido el documento |
Date | fecharecepcion | Fecha en que anexado |
Time | horaemisión | Hora de emisión |
Int | montotal | Monto total de la factura electrónica |
String | numerodocumento | Identificador del documento |
Int | numeroidentificacion | NIT del Emisor o Identificador Tributario del Emisor de la Factura |
String | razonsocial | Razón social del Emisor |
String | tipodocumento | Identificador del documento |
Int | tipoemisor Tabla 3 | |
Int | tipoentidad | Identificador del Emisor Tabla 4 |
String | mensaje | Mensaje descriptivo del resultado de la operación |
Boolean | pendiente | respuesta (False/True) |
String | resultado | Contiene información adicional (Procesado/Error) |
Int | ultimoenviado | Último número consecutivo |
Método Reporte
Muestra la lista de los 500 últimos documentos de Facturación Electrónica, que se han recibidos para un Receptor dado y que tienen asociado un consecutivo menor a un valor suministrado.
El reporte mostrará la información del documento, sin importar que estatus tenga.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | consecutivo | Número consecutivo de los documentos a revisa | número consecutivo del documento o en blanco |
String | tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:Reporte> <tem:request> <wcf:consecutivo>800</wcf:consecutivo> <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> <wcf:tokenPassword>b3…………43</wcf:tokenPassword> </tem:request> </tem:Reporte> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <ReporteResponse xmlns="http://tempuri.org/"> <ReporteResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:codigo>200</a:codigo> <a:documentoselectronicos> <a:InfoDocumento> <a:correlativoempresa>733</a:correlativoempresa> <a:cufe>0e12f97ef32ed6c1b104bfb...ad96f36060039e2d5f2</a:cufe> <a:estatusDIANcodigo/> <a:estatusDIANdescripcion/> <a:estatusDIANfecha/> <a:fechaemision>2021-08-31</a:fechaemision> <a:fecharecepcion>2022-02-17T16:56:55</a:fecharecepcion> <a:horaemision>01:01:45</a:horaemision> <a:montototal>412423.87</a:montototal> <a:numerodocumento>ABB12</a:numerodocumento> <a:numeroidentificacion>45......34</a:numeroidentificacion> <a:razonsocial>JD Proveedor 01</a:razonsocial> <a:tipodocumento>01</a:tipodocumento> <a:tipoemisor>1</a:tipoemisor> <a:tipoidentidad>31</a:tipoidentidad> </a:InfoDocumento> <a:InfoDocumento>...</a:InfoDocumento> </a:documentoselectronicos> <a:mensaje>Procesado</a:mensaje> <a:pendiente>true</a:pendiente> <a:resultado>Procesado</a:resultado> <a:ultimoEnviado>234</a:ultimoEnviado> </ReporteResult> </ReporteResponse> </s:Body> </s:Envelope>
NOTA: El ultimoEnviado es el número consecutivo para ver los archivos anteriores a el último que se muestra. Si se tienen más documentos el reporte mostrará true en la etiqueta pendientes, de caso contrario si se tiene false indica que ya no se tienen documentos.
Ejemplos: tomando el ultimoenviado
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:Reporte> <!--Optional:--> <tem:request> <!--Optional:--> <wcf:consecutivo>253</wcf:consecutivo> <wcf:tokenEmpresa>89………b52</wcf:tokenEmpresa> <!--Optional:--> <!--Optional:--> <wcf:tokenPassword>b3…………43</wcf:tokenPassword> </tem:request> </tem:Reporte> </soapenv:Body> </soapenv:Envelope>
Ejemplo Respuesta:Tomando el ultimo enviado
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <ReporteResponse xmlns="http://tempuri.org/"> <ReporteResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:codigo>200</a:codigo> <a:documentoselectronicos> <a:InfoDocumento> <a:correlativoempresa>252</a:correlativoempresa> <a:cufe>cdb0097ff69b252d8c1dd27b57fa8d5637a661de7a30e0554c99babd295354506dbdb33c48ba3c6dfbd8fc474984a60c</a:cufe> <a:estatusDIANcodigo/> <a:estatusDIANdescripcion/> <a:estatusDIANfecha/> <a:fechaemision>2021-08-11</a:fechaemision> <a:fecharecepcion>2021-11-26T12:19:30</a:fecharecepcion> <a:horaemision>15:00:00</a:horaemision> <a:montototal>1593558.75</a:montototal> <a:numerodocumento>LAS40021</a:numerodocumento> <a:numeroidentificacion>45671234</a:numeroidentificacion> <a:razonsocial>Karmi</a:razonsocial> <a:tipodocumento>01</a:tipodocumento> <a:tipoemisor>1</a:tipoemisor> <a:tipoidentidad>31</a:tipoidentidad> </a:InfoDocumento> .............. <a:InfoDocumento> <a:correlativoempresa>1</a:correlativoempresa> <a:cufe>e1307a9f41f427d2ce379a6b951b82fe3c0c2400468ed22bb3f571f50112c7c67ee551d865c50b95252f62b06043b14b</a:cufe> <a:estatusDIANcodigo/> <a:estatusDIANdescripcion/> <a:estatusDIANfecha/> <a:fechaemision>2021-08-11</a:fechaemision> <a:fecharecepcion>2021-08-13T10:44:47</a:fecharecepcion> <a:horaemision>15:00:00</a:horaemision> <a:montototal>1593558.75</a:montototal> <a:numerodocumento>LAS15143</a:numerodocumento> <a:numeroidentificacion>45671234</a:numeroidentificacion> <a:razonsocial>Karmi</a:razonsocial> <a:tipodocumento>01</a:tipodocumento> <a:tipoemisor>1</a:tipoemisor> <a:tipoidentidad>31</a:tipoidentidad> </a:InfoDocumento> </a:documentoselectronicos> <a:mensaje>Procesado</a:mensaje> <a:pendiente>false</a:pendiente> <a:resultado>Procesado</a:resultado> <a:ultimoEnviado>1</a:ultimoEnviado> </ReporteResult> </ReporteResponse> </s:Body> </s:Envelope>
Apartado pendientes: False es indicativo que no hay más documentos por mostrar, True indica que hay más documentos anteriores.
NOTA: El ultimoEnviado es el número consecutivo para ver los archivos anteriores a el último que se
muestra. Si se tienen más documentos el reporte mostrará true en la etiqueta pendientes, de caso
contrario si se tiene false indica que ya no se tienen documentos.
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
Int | Código | Código de retorno. Ver catálogo de respuesta del método |
Int | CorrelativoEmpresa | Número correlativo de la empresa |
String | cufe | Certificado Único de Facturación Electrónica. |
Date | fechaemision | Fecha en el que fue emitido el documento |
Date | fecharecepcion | Fecha en que anexado |
Time | horaemisión | Hora de emisión |
Int | montotal | Monto total de la factura electrónica |
String | numerodocumento | Identificador del documento |
Int | numeroidentificacion | NIT del Emisor o Identificador Tributario del Emisor de la Factura |
String | razonsocial | Razón social del Emisor |
String | tipodocumento | Identificador del documento |
Int | tipoemisor Tabla 3 | |
Int | tipoentidad | Identificador del Emisor Tabla 4 |
String | mensaje | Mensaje descriptivo del resultado de la operación |
Boolean | pendiente | respuesta (False/True) |
String | resultado | Contiene información adicional (Procesado/Error) |
Int | ultimoenviado | Último número consecutivo |
Método de Descarga XML
Permite obtener el Archivo XML codificado en Base64, correspondiente al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es el Receptor que lo está solicitando.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 20 dígitos | |
tipoIdentificacionemisor | Identificador del Emisor Tabla 4 | 2 caracteres | |
String | numeroDocumento | Identificador del documento | Hasta 20 caracteres |
tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres | |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:DescargarXML> <tem:request> <wcf:TipoDocumento>?</wcf:TipoDocumento> <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> <wcf:numeroDocumento>ABB10</wcf:numeroDocumento> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> <wcf:tokenPassword>b3……………43</wcf:tokenPassword> </tem:request> </tem:DescargarXML> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <DescargarXMLResponse xmlns="http://tempuri.org/"> <DescargarXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:archivo>PD94b………………….b2N1bWVudD4=</a:archivo> <a:codigo>200</a:codigo> <a:crc>4ecd4e588d71e689a32bb07d92c58b4e</a:crc> <a:cufe>0e12f97ef32ed6c1b104bfb13...f36060039e2d5f2</a:cufe> <a:mensaje>Se retorna el archivo solicitado</a:mensaje> <a:resultado>Procesado</a:resultado> <a:size>44864</a:size> </DescargarXMLResult> </DescargarXML </s:Envelope>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
- | archivo | Archivo en Base 64 |
Int | Código | Código de retorno. Ver catálogo de respuesta del método |
String | crc | Chequeo de Redundancia Cíclica |
String | cufe | Certificado Único de Facturación Electrónica. |
String | mensaje | Mensaje descriptivo del resultado de la operación |
String | resultado | Contiene información adicional (Procesado/Error) |
Int | size | Tamaño del documento |
Método de Descarga RepresentacionGrafica
Permite obtener el Archivo que contiene la Representación Gráfica codificado Base64, correspondiente al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es un Receptor que lo está solicitando
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
tipoIdentificacionemisor | Identificador del Emisor Tabla 4 | 2 caracteres | |
String | numeroDocumento | Identificador del documento | Hasta 20 caracteres |
tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres | |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:DescargarRepGrafica> <tem:request> <!--Optional:--> <wcf:TipoDocumento>91</wcf:TipoDocumento> <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> <wcf:tokenPassword>b3……………43</wcf:tokenPassword> </tem:request> </tem:DescargarRepGrafica> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <DescargarRepGraficaResponse xmlns="http://tempuri.org/"> <DescargarRepGraficaResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:archivo i:nil="true"/> <a:codigo>102</a:codigo> <a:crc i:nil="true"/> <a:cufe i:nil="true"/> <a:mensaje>Longitud No Válida para el Tipo de Identificador del Emisor</a:mensaje> <a:resultado>Error</a:resultado> <a:size i:nil="true"/> </DescargarRepGraficaResult> </DescargarRepGraficaResponse> </s:Body> </s:Envelope>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
Bas64 | archivo | Archivo en Base 64 |
Int | codigo | Código de retorno. Tabla 2 |
string | mensaje | Mensaje descriptivo del resultado de la operación |
String | resultado | Contiene información adicional (Procesado/Error) |
Método de Descarga de Adjuntos/Anexos
Permite obtener el Archivo que contiene el Anexo cuya identificación interna fue indicada, correspondiente al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es el Receptor que lo está solicitando. El contenido del archivo es presentado codificado en base64.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 20 dígitos | |
tipoIdentificacionemisor | Identificador del Emisor Tabla 4 | 2 caracteres | |
String | IdentificadorinternoAnexo | corresponde al identificador interno (NameFile) del anexo que se desea descargar. | El FileName se obtiene con el método ListaAnexo* |
String | numeroDocumento | Identificador del documento | Hasta 20 caracteres |
tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres | |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:DescargarRepGrafica> <tem:request> <!--Optional:--> <wcf:TipoDocumento>91</wcf:TipoDocumento> <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> <wcf:tokenPassword>b3……………43</wcf:tokenPassword> </tem:request> </tem:DescargarRepGrafica> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <DescargarAnexoResponse xmlns="http://tempuri.org/"> <DescargarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:archivo>JVB……………………….YK</a:archivo> <a:codigo>200</a:codigo> <a:crc>5e9b2925ae58b8f7c2c95ef8d748d864</a:crc> <a:cufe>6c406410fc912ca1...8da809c1517da5</a:cufe> <a:displayname>ad0000346585016210001271e</a:displayname> <a:extension>pdf</a:extension> <a:idfile>5984</a:idfile> <a:mensaje>Se retorna el archivo solicitado</a:mensaje> <a:resultado>Procesado</a:resultado> <a:sizefile>43203</a:sizefile> <a:type>2</a:type> </DescargarAnexoResult> </DescargarAnexoResponse> </s:Body> </s:Envelope>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
- | archivo | Archivo XML en Base64 que contiene el documento electrónico. |
Int | codigo | Código de retorno. Tabla 2 |
String | crc | Chequeo de Redundancia Cíclica |
String | cufe | Certificado Único de Facturación Electrónica. |
String | displayname | |
String | extension | Tipo de documento que se tiene |
Int | idfile |
|string |mensaje |Mensaje descriptivo del resultado de la operación |- |String |resultado |Contiene información adicional (Procesado/Error) |- |Int |sizefile |Tamaño del documento |- |Int |Type |Tipo de documento, (Ver catálogo) |} |}
Método Consulta de Estado Documento
Permite conocer el estatus, así como la lista de estados por la que ha pasado un documento de Facturación Electrónica, que originalmente fue emitida por un Proveedor, cuyo adquiriente tiene como proveedor tecnológico de Facturación Electrónica a The Factory HKA Colombia
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 20 dígitos | |
tipoIdentificacionemisor | Identificador del Emisor Tabla 4 | 2 caracteres | |
String | numeroDocumento | Identificador del documento | Hasta 20 caracteres |
tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres | |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:EstadoDocumento> <!--Optional:--> <tem:request> <!--Optional:--> <wcf:TipoDocumento></wcf:TipoDocumento> <!--Optional:--> <wcf:identificadorEmisor>25………1</wcf:identificadorEmisor> <!--Optional:--> <wcf:numeroDocumento>ERTYBNT017</wcf:numeroDocumento> <!--Optional:--> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <!--Optional:--> <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> <!--Optional:--> <wcf:tokenPassword>b3…………43</wcf:tokenPassword> </tem:request> </tem:EstadoDocumento> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <EstadoDocumentoResponse xmlns="http://tempuri.org/"> <EstadoDocumentoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:ListEstatusHistory> <a:HistorialEstatus> <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Aceptación expresa (DIAN)</a:Comentarios> <a:Descripcion>Aceptación expresa (DIAN)</a:Descripcion> <a:codigoEstatus>2</a:codigoEstatus> <a:fecha>2022-03-07 13:37:47</a:fecha> </a:HistorialEstatus> <a:HistorialEstatus> <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Recibo del bien y/o prestación del servicio</a:Comentarios> <a:Descripcion>Recibo del bien y/o prestación del servicio</a:Descripcion> <a:codigoEstatus>12</a:codigoEstatus> <a:fecha>2022-03-07 13:37:46</a:fecha> </a:HistorialEstatus> <a:HistorialEstatus> <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Acuse de recibo (DIAN)</a:Comentarios> <a:Descripcion>Acuse de recibo (DIAN)</a:Descripcion> <a:codigoEstatus>10</a:codigoEstatus> <a:fecha>2022-03-07 13:32:19</a:fecha> </a:HistorialEstatus> <a:HistorialEstatus> <a:Comentarios>Cambio de Estado a Entregado por Descarga de Documento Electrónico</a:Comentarios> <a:Descripcion>Entregado</a:Descripcion> <a:codigoEstatus>1</a:codigoEstatus> <a:fecha>2022-02-11 12:38:25</a:fecha> </a:HistorialEstatus> <a:HistorialEstatus> <a:Comentarios>Cargado</a:Comentarios> <a:Descripcion>Cargado</a:Descripcion> <a:codigoEstatus>0</a:codigoEstatus> <a:fecha>2022-02-11 12:23:02</a:fecha> </a:HistorialEstatus> </a:ListEstatusHistory> <a:codigo>200</a:codigo> <a:estatusDIANDescripcion/> <a:estatusDIANcodigo/> <a:estatusDIANfecha/> <a:estatusDocumento>Aceptación expresa (DIAN)</a:estatusDocumento> <a:fechaDocumento>2022-02-11T12:23:01</a:fechaDocumento> <a:mensaje>Se retorna los datos del estado del documento</a:mensaje> <a:resultado>Procesado</a:resultado> <a:tipoDocumento>01</a:tipoDocumento> <a:uuid>0e12f97ef3...060039e2d5f2</a:uuid> </EstadoDocumentoResult> </EstadoDocumentoResponse> </s:Body> </s:Envelope>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
String | comentarios | Status del documento . Tabla 1 |
String | descripcion | Descripción del status relacionado |
Int | codigoEStatus | Código del estatus. Tabla 1 |
Date | fecha | fecha en formato “s” ”( yyyy'-'MM'-'dd'T'HH':'mm':'ss ) del estatus actual |
String | uuid | Identificador Universal Único |
Método Cambio de Status
Permite cambiar el estatus de un documento de Facturación Electrónica, que originalmente fue emitida por un Emisor, del cual el adquiriente tiene como proveedor tecnológico de Facturación Electrónica a The Factory HKA Colombia.
Nota:Si el documento está en un estado DIAN y se requiere cambiar a otro estado y es imposible hacerlo, puede que esté en espera para recibir respuesta de la DIAN, por lo cual se debe de esperar 5 minutos para realizar el cambio
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Atributo | Descripción |
---|---|---|---|
String | EjecutadorPor | Apellido | Apellido de la persona encargada de enviar evento. |
Cargo | Función de la cual una persona tiene la responsabilidad en una organización, un organismo o una empresa.(opcional). | ||
Departamento. | Área en la que se encuentra la persona encargada de envío de eventos (opcional). | ||
DV | Digito verificador del nit de la empresa. | ||
NumeroIdentificacion | Nit de la empresa. | ||
TipoIdentificacion | Tipo de identifiación según la Tabla 4 | ||
Nombre | Nombre de la persona encargada a enviar eventos hacia la DIAN. | ||
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura, de 6 a 20 dígitos | ||
numeroDocumento | Identificador del documento hasta 20 caracteres | ||
status | Código de Estatus del documento,requerido para la búsqueda*,se puede verificar en la siguiente Tabla 1 | ||
tipoIdentificacionemisor | Identificador del Emisor Tabla 4 | ||
String | tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres |
tokenPassword |
El código de Rechazo es requerido para realizar cualquier cambio de estado.
CodigoRechazo
Código | Descripción |
---|---|
01 | Documento con inconsistencias |
02 | Mercancía no entregada totalmente |
03 | Mercancía no entregada parcialmente |
04 | Servicio no prestado |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:CambioEstatus> <!--Optional:--> <tem:request> <!--Optional:--> <wcf:EjecutadoPor> <!--Optional:--> <wcf:Apellido>López</wcf:Apellido> <!--Optional:--> <wcf:Cargo>Pruebas</wcf:Cargo> <!--Optional:--> <wcf:Departamento>Calidad</wcf:Departamento> <!--Optional:--> <wcf:Identificacion> <!--Optional:--> <wcf:Dv></wcf:Dv> <!--Optional:--> <wcf:NumeroIdentificacion>14…………51</wcf:NumeroIdentificacion> <!--Optional:--> <wcf:TipoIdentificacion>11</wcf:TipoIdentificacion> </wcf:Identificacion> <!--Optional:--> <wcf:Nombre>Adriana</wcf:Nombre> </wcf:EjecutadoPor> <!--Optional:--> <wcf:TipoDocumento>91</wcf:TipoDocumento> <!--Optional:--> <wcf:codigoRechazo>02</wcf:codigoRechazo> <!--Optional:--> <wcf:identificadorEmisor>90………26</wcf:identificadorEmisor> <!--Optional:--> <wcf:numeroDocumento>AKLAA16</wcf:numeroDocumento> <!--Optional:--> <wcf:status>10</wcf:status> <!--Optional:--> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <!--Optional:--> <wcf:tokenEmpresa>89………52</wcf:tokenEmpresa> <!--Optional:--> <wcf:tokenPassword>b3……………43</wcf:tokenPassword> </tem:CambioEstatus> </soapenv:Body> </soapenv:Envelope> </p> ====<font color="Blue">Ejemplo de salida</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
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
Int | Código | Código de retorno. Ver catálogo de respuesta del método |
String | mensaje | Mensaje descriptivo del resultado de la operación |
String | resultado | Contiene información adicional (Procesado/Error) |
Método Consulta de Metadata (infodatos) (a los documentos) ConsultaDocumentosMetadata
(Infodatos) Permite a un Receptor consultar el o los metadato(s) (infodatos) correspondientes a un documento de Facturación Electrónica, identificado con el numero documento, emitido por un proveedor de bienes y servicios identificado al Receptor ya mencionado
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 20 dígitos |
tipoIdentificacionemisor | Identificador del EmisorTabla 4 | 2 caracteres | |
numeroDocumento | Identificador del documento | Hasta 20 caracteres | |
String | tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:CosultaDocumentoMetadata> <tem:request> <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> <wcf:numeroDocumento>ABB09</wcf:numeroDocumento> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> <wcf:tokenPassword>b3……………43</wcf:tokenPassword> </tem:request> </tem:CosultaDocumentoMetadata> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <CosultaDocumentoMetadataResponse xmlns="http://tempuri.org/"> <CosultaDocumentoMetadataResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:ListMetadata> <a:SPPostMetadata> <a:createdat>2022-02-17T12:08:47</a:createdat> <a:createdby>Customer</a:createdby> <a:label>Nueva Categoría 2</a:label> <a:updatedat>2022-02-17T12:08:47</a:updatedat> <a:updatedby>Customer</a:updatedby> <a:value>A</a:value> </a:SPPostMetadata> <a:SPPostMetadata> <a:createdat>2022-02-17T12:08:47</a:createdat> <a:createdby>Customer</a:createdby> <a:label>Nueva Categoría</a:label> <a:updatedat>2022-02-17T12:08:47</a:updatedat> <a:updatedby>Customer</a:updatedby> <a:value>Calle Carrera</a:value> </a:SPPostMetadata> <a:SPPostMetadata> <a:createdat>2022-02-17T12:08:47</a:createdat> <a:createdby>Customer</a:createdby> <a:label>Regiones 1</a:label> <a:updatedat>2022-02-17T12:08:47</a:updatedat> <a:updatedby>Customer</a:updatedby> <a:value>J&J</a:value> </a:SPPostMetadata> </a:ListMetadata> <a:codigo>200</a:codigo> <a:estatusDIANDescripcion/> <a:estatusDIANcodigo/> <a:estatusDIANfecha/> <a:estatusDocumento>Aceptación expresa (DIAN)</a:estatusDocumento> <a:fechaDocumento>2022-02-11T12:23:01</a:fechaDocumento> <a:mensaje>Se retorna los datos sobre metadatos del documento</a:mensaje> <a:resultado>Procesado</a:resultado> <a:tipoDocumento>01</a:tipoDocumento> <a:uuid>0e12f97ef32ed6...11ad96f36060039e2d5f2</a:uuid> </CosultaDocumentoMetadataResult> </CosultaDocumentoMetadataResponse> </s:Body> </s:Envelope>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
String | createdat | Creación del Infodato |
String | createdby | Quien lo creo |
String | label | Nombre del Infodato |
Time | updatedat | Tiempo de relación |
String | value | Nombre de la subcategoría o valor que está relacionado del Infodato |
Método ListaAnexo
Permite obtener la lista de anexos asociados al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es el Receptor que lo está solicitando
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 20 dígitos | |
tipoIdentificacionemisor | Identificador del Emisor Tabla 4 | 2 caracteres | |
String | numeroDocumento | Identificador del documento | Hasta 20 caracteres |
tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres | |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:ListaAnexo> <tem:request> <wcf:TipoDocumento>91</wcf:TipoDocumento> <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <wcf:tokenEmpresa>89………………52</wcf:tokenEmpresa> <wcf:tokenPassword>b3……………43</wcf:tokenPassword> </tem:request> </tem:ListaAnexo> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <ListaAnexoResponse xmlns="http://tempuri.org/"> <ListaAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:ListArchivoDocumento> <a:ArchivoDocumento> <a:CreatedAt>2022-02-01T10:14:09.223</a:CreatedAt> <a:Format>.pdf</a:Format> <a:InvoiceFileId>5782</a:InvoiceFileId> <a:InvoiceId>19981</a:InvoiceId> <a:NameDisplay>LAS40588</a:NameDisplay> <a:NameFile>LAS40588</a:NameFile> <a:PathFile>Recepcion/542/31/45......34/2021/8/11/LAS40588/</a:PathFile> <a:ProviderVisible>true</a:ProviderVisible> <a:Type>Representacion Gráfica</a:Type> <a:TypeCode>1</a:TypeCode> <a:UpdatedAt>2022-02-01T10:14:09.223</a:UpdatedAt> <a:size>43282</a:size> </a:ArchivoDocumento> <a:ArchivoDocumento> <a:CreatedAt>2022-03-09T12:16:47.597</a:CreatedAt> <a:Format>.pdf</a:Format> <a:InvoiceFileId>5984</a:InvoiceFileId> <a:InvoiceId>19981</a:InvoiceId> <a:NameDisplay>ad0000346585016210001271e</a:NameDisplay> <a:NameFile>32168992-676A-44C8-862D-F5E5EBC762DB</a:NameFile> <a:PathFile>Recepcion/542/31/45......34/2021/8/11/LAS40588/</a:PathFile> <a:ProviderVisible>true</a:ProviderVisible> <a:Type>Anexo</a:Type> <a:TypeCode>2</a:TypeCode> <a:UpdatedAt>2022-03-09T12:16:47.597</a:UpdatedAt> <a:size>43203</a:size> </a:ArchivoDocumento> </a:ListArchivoDocumento> <a:codigo>200</a:codigo> <a:mensaje>Se retorna los datos del Archivos asociados al documento LAS40588 emitido por el NIT 45......34 al solicitante con NIT 12.....9</a:mensaje> <a:resultado>Procesado</a:resultado> </ListaAnexoResult> </ListaAnexoResponse> </s:Body>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
Int | InvoiceFileId | Campo de control de identificación del archivo |
InvoiceId | Campo de control de identificación del documento | |
TypeCode | Entero que indica el código de tipo de anexo; a saber admite los siguientes valores Tabla 5 | |
size | tamaño del documento | |
String | Format | Extensión del Archivo |
NameDisplay | Nombre Archivo dado por el Proveedor Tecnológico, hasta 100 caracteres | |
PathFile | Campo de control de identificación del documento | |
Type | Indica el tipo de adjunto; a saber : Representación Gráfica, Anexo, Acuse de Recibido, Acuse de Aceptado, Acuse de Rechazado y Acuse de Aceptación Tácita | |
NameFile | Nombre interno del archivo. Este valor es usado tanto para la solicitud de recuperación, como la solicitud de eliminación del archivo | |
Time | UpdatedAt | fecha de la última actualización del archivo |
CreatedAt | Fecha en la que fue incorporado el archivo | |
Boolean | ProviderVisible | Indicador que señala si el archivo puede ser descargado por el emisor |
NameFile : Este es indispensable para el método DercargaAnexo este debe de coincidir Type: Anexo. Para la descarga del Anexo que es el siguiente método
Método DescargaAnexo
Permite la descarga del Anexo o adjunto del documento que se encuentra vinculado al documento de factura. Que originalmente fue anexada al documento.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 20 dígitos | |
String | identificadorinternoanexo | Identificador del Anexo el cual debe de consultarse en el Método de ListaAnexo | |
tipoIdentificacionemisor | Identificador del Emisor Tabla 4 | 2 caracteres | |
numeroDocumento | Identificador del documento | Hasta 20 caracteres | |
tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres | |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:DescargarAnexo> <tem:request> <wcf:TipoDocumento>91</wcf:TipoDocumento> <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> <wcf:identificadorInternoAnexo>32168992-0000-44C8-862D-F5E5EBC762DB</wcf:identificadorInternoAnexo> <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> <wcf:tokenPassword>b3……………43</wcf:tokenPassword> </tem:request> </tem:DescargarAnexo> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <DescargarAnexoResponse xmlns="http://tempuri.org/"> <DescargarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:archivo>JVBERi0xLjQKM……</a:archivo> <a:codigo>200</a:codigo> <a:crc>5e9b2925ae58b8f7c2c95ef8d748d864</a:crc> <a:cufe>6c406410fc912ca1a937d1b...e08ad3c91fa8da809c1517da5</a:cufe> <a:displayname>ad0000346585016210001271e</a:displayname> <a:extension>pdf</a:extension> <a:idfile>5984</a:idfile> <a:mensaje>Se retorna el archivo solicitado</a:mensaje> <a:resultado>Procesado</a:resultado> <a:sizefile>43203</a:sizefile> <a:type>2</a:type> </DescargarAnexoResult> </DescargarAnexoResponse> </s:Body> </s:Envelope>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
- | archivo | Archivo en Base 64 del documento |
Int | codigo | Código de retorno, Tabla 4 |
Id | Id del documento. | |
Type | Tipo de documento, Tabla 3 | |
sizeFile | tamaño del documento | |
String | crc | Chequeo de Redundancia Cíclica |
cufe | Certificado Único de Facturación Electrónica. | |
displayname | ||
extension | Tipo de documento que se tiene | |
mensaje | Mensaje descriptivo del resultado de la operación | |
resultado | Contiene información adicional (Procesado/Error) |
Método Envío de Representación Gráfica (EnviarRepGrafica)
Permite a un Receptor enviar el archivo que corresponde a la representación gráfica de un documento de Facturación Electrónica, identificado con el número documento, emitido por un proveedor de bienes y servicios identificado al Receptor ya mencionado; el archivo está codificado en Base64.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
visible | Indica si el archivo posteriormente puede ser o no descargado por el Emisor | Visible = 1, No visible = 0, 1 dígito | |
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
String | archivo | Archivo XML en Base64 que contiene el documento electrónico que se desea enviar | |
nombre | Nombre del documento de la Representación Gráfica | Hasta 100 caracteres | |
extension | Indica el formato del archivo remitido; los valores admitidos son | bmp|jpg|pdf|doc|docx|xls|xlsx|ppt|pptx|rar|zip | |
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 9 digitos | |
numeroDocumento | Identificador del documento | Hasta 20 caracteres | |
tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres | |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:EnviarRepGrafica> <tem:request> <wcf:TipoDocumento>91</wcf:TipoDocumento> <wcf:archivo>JVB……FT0YK</wcf:archivo> <wcf:extension>ppt</wcf:extension> <wcf:identificadorEmisor>45…34</wcf:identificadorEmisor> <wcf:nombre>SOAP01-2</wcf:nombre> <wcf:numeroDocumento>SOAP019</wcf:numeroDocumento> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> <wcf:tokenPassword>b3……………43</wcf:tokenPassword> <wcf:visible>1</wcf:visible> </tem:request> </tem:EnviarRepGrafica> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <EnviarRepGraficaResponse xmlns="http://tempuri.org/"> <EnviarRepGraficaResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:codigo>102</a:codigo> <a:mensaje>Token Password es Requerido</a:mensaje> <a:resultado>Error</a:resultado> </EnviarRepGraficaResult> </EnviarRepGraficaResponse> </s:Body> </s:Envelope>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
Int | codigo | Código de retorno, (Ver catálogo de respuesta del método) |
String | mensaje | Mensaje descriptivo del resultado de la operación |
String | resultado, contiene información adicional (Procesado/Error) |
Método Envío de XML Método de “EnviarXML”
Permite enviar el archivo XML que representa Documento Fiscal Electrónico, el cual fue emitido por un proveedor* de bienes y servicios a un cliente The Factory HKA Colombia, el archivo XML está representado en Base64. Opcionalmente se puede remitir los llamados Metadatos
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | metadata | Lista Optativa de cuarteto, que permite especificar atributos adicionales referentes al Documento Fiscal Electrónico; los cuartetos son de la forma (code, value, internal1 (optativo), internal2 (optativo)); estableciendo una asociación entre el elemento code (que representa el código de metadata ) y el resto de los “atributos” del cuarteto en cuestión. | |
String | archivo | Archivo XML en Base64 que contiene el documento electrónico que se desea enviar | |
tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres | |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:EnviarXML> <tem:request> <wcf:archivo>PD94b…………..bnQ+</wcf:archivo> <wcf:metadata> <wcf:metadata> <wcf:Metadata> <wcf:code>01</wcf:code> <wcf:internal1/> <wcf:internal2/> <wcf:value/> </wcf:Metadata> </wcf:metadata> </wcf:metadata> <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> <wcf:tokenPassword>b3……………43</wcf:tokenPassword> </tem:request> </tem:EnviarXML> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <EnviarXMLResponse xmlns="http://tempuri.org/"> <EnviarXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:codigo>203</a:codigo> <a:documentoId>AHJ07</a:documentoId> <a:estatusDocumento>Cargado</a:estatusDocumento> <a:mensaje>Documento Enviado Satisfactoriamente - Problema(s) con Metadato(s) : Valor(es) suministrado(s) para Metadato(s) no corresponde(n) a la(s) lista(s) definida(s)</a:mensaje> <a:numeroIdentificacion>45......34</a:numeroIdentificacion> <a:resultado>Procesado</a:resultado> <a:tipoIdentificacion>31</a:tipoIdentificacion> </EnviarXMLResult> </EnviarXMLResponse> </s:Body> </s:Envelope>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
- | archivo | Archivo en Base 64 del documento |
Int | codigo | Código de retorno, Tabla 2 |
numeroIdentificacion | Id del documento. | |
tipoIdentificacion | Tipo de identificación del documento | |
String | Identificador del documento | |
estatusDocumento | Estatus del Documento | |
mensaje | Mensaje descriptivo del resultado de la operación | |
String | resultado | Contiene información adicional (Procesado/Error) |
Método Envío de Anexo (EnvioAnexo)
Permite a un Receptor enviar un archivo que archivo que se “adjunta” a un documento de Facturación Electrónica , identificado con el numero documento, emitido por un proveedor de bienes y servicios también identificado; al Receptor ya mencionado; el archivo está codificado en Base64.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
- | archivo | Archivo en Base64 que representa un anexo de factura identificada por número de documento | |
Byte | Indica si el archivo posteriormente puede ser o no descargado por el Emisor. | Visible = 1, No visible = 0, 1 dígito | |
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
tipoidentificadoremisor | Identificador del Emisor Tabla 4 | ||
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
String | nombre | Nombre del documento de la Representación Gráfica | Hasta 100 caracteres |
extension | Indica el formato del archivo remitido; los valores admitidos son | bmp|jpg|pdf|doc|docx|xls|xlsx|ppt|pptx|rar|zip | |
numeroDocumento | Identificador del documento | Hasta 20 caracteres | |
tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres | |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:EnviarAnexo> <tem:request> <wcf:archivo>JVB…….</wcf:archivo> <wcf:extension>pdf</wcf:extension> <wcf:TipoDocumento>91</wcf:TipoDocumento> <wcf:identificadorEmisor>456…34</wcf:identificadorEmisor> <wcf:nombre>AHJ07-7</wcf:nombre> <wcf:numeroDocumento>AHJ07</wcf:numeroDocumento> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> <wcf:tokenPassword>b3……………43</wcf:tokenPassword> <wcf:visible>1</wcf:visible> </tem:request> </tem:EnviarAnexo> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<?xml version="1.0" encoding="UTF-8"?> <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> <s:Body> <EnviarAnexoResponse xmlns="http://tempuri.org/"> <EnviarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:codigo>200</a:codigo> <a:mensaje>Archivo enviado satisfactoriamente</a:mensaje> <a:resultado>Procesado</a:resultado> </EnviarAnexoResult> </EnviarAnexoResponse> </s:Body> </s:Envelope>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
Int | codigo | Código de retorno, Tabla 2 |
String | mensaje | Mensaje descriptivo del resultado de la operación |
String | resultado | Contiene información adicional (Procesado/Error) |
Método EliminarRepGrafica
Método que permite a un Receptor eliminar la Representación Gráfica de un documento de Facturación Electrónica que esté vinculado.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 20 dígitos | |
tipoIdentificacionemisor | Identificador del Emisor Tabla 4 | 2 caracteres | |
String | tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:EliminarRepGrafica> <!--Optional:--> <tem:request> <!--Optional:--> <wcf:TipoDocumento>91</wcf:TipoDocumento> <!--Optional:--> <wcf:identificadorEmisor>25…………08</wcf:identificadorEmisor> <!--Optional:--> <wcf:numeroDocumento>ERTYBNT017</wcf:numeroDocumento> <!--Optional:--> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <!--Optional:--> <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> <!--Optional:--> <wcf:tokenPassword>b3……..43</wcf:tokenPassword> </tem:request> </tem:EliminarRepGrafica> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body> <EliminarRepGraficaResponse xmlns="http://tempuri.org/"> <EliminarRepGraficaResponse xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:codigo>103</a:codigo> <a:mensaje>Se produjo un error en el servicio...{"Codigo":"104","Mensaje":"No se tiene registrado como válido el anexo ERTYBNT017 en el documento ERTYBNT017 emitido por NIT 25………08 a NIT 90………98","Resultado":"Error"} por favor inténtelo más tarde</a:mensaje> <a:resultado>Error</a:resultado> </EliminarRepGraficaResult> </EliminarRepGraficaResponse> </s:Body>
</s:Envelope>
- RESPONSE
- Parámetros a Recibir
Código | Descripción | |
---|---|---|
200 | Representación Gráfica enviada satisfactoriamente | |
102 | El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango./ Dato que es erróneo | |
103 | Error Interno en el Servicio | Código de retorno. Ver catálogo de respuesta del método |
Método EliminarAnexo/font>
Método que permite al Receptor eliminar anexos que estén vinculados a un documento de Facturación Electrónica.
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 20 dígitos | |
tipoIdentificacionemisor | Identificador del Emisor Tabla 4 | 2 caracteres | |
String | tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:EliminarAnexo> <!--Optional:--> <tem:request> <!--Optional:--> <wcf:TipoDocumento>91</wcf:TipoDocumento> <!--Optional:--> <wcf:identificadorEmisor>25……08</wcf:identificadorEmisor> <!--Optional:--> <wcf:identificadorInternoAnexo>A177CFD9-695C-4E0A-BC36-0A8DC187A4C9</wcf:identificadorInternoAnexo> <!--Optional:--> <wcf:numeroDocumento>ERTYBNT017</wcf:numeroDocumento> <!--Optional:--> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <!--Optional:--> <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> <!--Optional:--> <wcf:tokenPassword>b3…………………43</wcf:tokenPassword> </tem:request> </tem:EliminarAnexo> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body> <EliminarAnexoResponse xmlns="http://tempuri.org/"> <EliminarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:codigo>103</a:codigo> <a:mensaje>Se produjo un error en el servicio...{"Codigo":"104","Mensaje":"No se tiene registrado como válido el anexo A177CFD9-695C-4E0A-BC36-0A8DC187A4C9 en el documento ERTYBNT017 emitido por NIT 25………08 a NIT 90………98","Resultado":"Error"} por favor inténtelo más tarde</a:mensaje> <a:resultado>Error</a:resultado> </EliminarAnexoResult> </EliminarAnexoResponse> </s:Body>
</s:Envelope>
- RESPONSE
- Parámetros a Recibir
Identificador | Descripción |
---|---|
Identificador | Código de retorno. |
mensaje | Mensaje descriptivo del resultado de la operación |
resultado | Contiene información adicional (Procesado/Error) |
Método DescargarRecepcionBienServicioXML
Método que permite a un Receptor, descargar el Response del evento de Recibo del bien y/o Prestación de servicio, el cual está asociado a un documento que se en encuentra en el sistema
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
nombreFileApplicationResponse | Nombre del documento que se encuentra en Lista de Anexo | - | |
tipoDescarga | Tipo de Descarga del documento | ||
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 20 dígitos | |
tipoIdentificacionemisor | Identificador del Emisor Tabla 4 | 2 caracteres | |
nmeroDocumento | Identificador del documento | 2 caracteres | |
String | tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:DescargarRecepcionBienServicioXML> <!--Optional:--> <tem:request> <!--Optional:--> <wcf:TipoDocumento>01</wcf:TipoDocumento> <!--Optional:--> <wcf:identificadorEmisor>90……26</wcf:identificadorEmisor> <!--Optional:--> <wcf:nombreFileApplicationResponse>f2c7b462-297a-4347-8a35-f63d8a947912.xml</wcf:nombreFileApplicationResponse> <!--Optional:--> <wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento> <!--Optional:--> <wcf:tipoDescarga>1</wcf:tipoDescarga> <!--Optional:--> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <!--Optional:--> <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> <!--Optional:--> <wcf:tokenPassword>b3…………43</wcf:tokenPassword> </tem:request> </tem:DescargarRecepcionBienServicioXML> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body> <DescargarRecepcionBienServicioXMLResponse xmlns="http://tempuri.org/"> <DescargarRecepcionBienServicioXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:archivo>PD94bW…………………</a:archivo> <a:codigo>200</a:codigo> <a:crc>dcdc43fb31588b396ccd3ff322fbeda7</a:crc> <a:cufe>f2c7b462-297a-4347-8a35-f63d8a947912.xml</a:cufe> <a:mensaje>Se retorna el archivo solicitado</a:mensaje> <a:resultado>Procesado</a:resultado> <a:size>15096</a:size> </DescargarRecepcionBienServicioXMLResult> </DescargarRecepcionBienServicioXMLResponse> </s:Body>
</s:Envelope>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
- | archivo | Archivo en Base 64 del documento |
Int | codigo | Código de retorno, Tabla 4 |
sizeFile | tamaño del documento | |
String | crc | Chequeo de Redundancia Cíclica |
cufe | Certificado Único de Facturación Electrónica. | |
mensaje | Mensaje descriptivo del resultado de la operación | |
resultado | Contiene información adicional (Procesado/Error) |
Método DescargarAcuseReclamo
Método que permite a un Receptor, descargar el Response del evento de Recibo del bien y/o Prestación de servicio, el cual está asociado a un documento que se en encuentra en el sistema
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
nombreFileApplicationResponse | Nombre del documento que se encuentra en Lista de Anexo | - | |
tipoDescarga | Tipo de Descarga del documento | ||
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 20 dígitos | |
tipoIdentificacionemisor | Identificador del Emisor Tabla 4 | 2 caracteres | |
nmeroDocumento | Identificador del documento | 2 caracteres | |
String | tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:DescargarAcuseReclamoXML> <!--Optional:--> <tem:request> <!--Optional:--> <wcf:TipoDocumento>01</wcf:TipoDocumento> <!--Optional:--> <wcf:identificadorEmisor>90……26</wcf:identificadorEmisor> <!--Optional:--> <wcf:nombreFileApplicationResponse></wcf:nombreFileApplicationResponse> <!--Optional:--> <wcf:numeroDocumento>SETP990441828</wcf:numeroDocumento> <!--Optional:--> <wcf:tipoDescarga>2</wcf:tipoDescarga> <!--Optional:--> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <!--Optional:--> <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> <!--Optional:--> <wcf:tokenPassword>b3………43</wcf:tokenPassword> </tem:request> </tem:DescargarAcuseReclamoXML> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body> <DescargarAcuseReclamoXMLResponse xmlns="http://tempuri.org/"> <DescargarAcuseReclamoXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:archivo>PD94bWwgdmVyc…………………</a:archivo> <a:codigo>200</a:codigo> <a:crc>0e6751bef6bf2815685fc4203efa9ba1</a:crc> <a:cufe>62229467-75a3-4d3f-97b3-923798c52431.xml</a:cufe> <a:mensaje>Se retorna el archivo solicitado</a:mensaje> <a:resultado>Procesado</a:resultado> <a:size>14792</a:size> </DescargarAcuseReclamoXMLResult> </DescargarAcuseReclamoXMLResponse> </s:Body>
</s:Envelope>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
- | archivo | Archivo en Base 64 del documento |
Int | codigo | Código de retorno, Tabla 4 |
sizeFile | tamaño del documento | |
String | crc | Chequeo de Redundancia Cíclica |
cufe | Certificado Único de Facturación Electrónica. | |
mensaje | Mensaje descriptivo del resultado de la operación | |
resultado | Contiene información adicional (Procesado/Error) |
Método DescargarAcuseRecibido
Método que permite a un Receptor, descargar el Response del evento del Acuse de Recibido, el cual está asociado a un documento que se en encuentra en el sistema Método
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
nombreFileApplicationResponse | Nombre del documento que se encuentra en Lista de Anexo | - | |
tipoDescarga | Tipo de Descarga del documento | ||
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 20 dígitos | |
tipoIdentificacionemisor | Identificador del Emisor Tabla 4 | 2 caracteres | |
nmeroDocumento | Identificador del documento | 2 caracteres | |
String | tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:DescargarAcuseRecibidoXML> <!--Optional:--> <tem:request> <!--Optional:--> <wcf:TipoDocumento></wcf:TipoDocumento> <!--Optional:--> <wcf:identificadorEmisor>90……26</wcf:identificadorEmisor> <!--Optional:--> <wcf:nombreFileApplicationResponse>226a6537-fdc5-4224-84cd-bd31fbe39af5.xml</wcf:nombreFileApplicationResponse> <!--Optional:--> <wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento> <!--Optional:--> <wcf:tipoDescarga>1</wcf:tipoDescarga> <!--Optional:--> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <!--Optional:--> <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> <!--Optional:--> <wcf:tokenPassword>b3………43</wcf:tokenPassword> </tem:request> </tem:DescargarAcuseRecibidoXML> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body> <DescargarAcuseRecibidoXMLResponse xmlns="http://tempuri.org/"> <DescargarAcuseRecibidoXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:archivo>PD94bWwgdm…………………</a:archivo> <a:codigo>200</a:codigo> <a:crc>a26ecb9330992ac9ab4479f457fbdaeb</a:crc> <a:cufe>226a6537-fdc5-4224-84cd-bd31fbe39af5.xml</a:cufe> <a:mensaje>Se retorna el archivo solicitado</a:mensaje> <a:resultado>Procesado</a:resultado> <a:size>15100</a:size> </DescargarAcuseRecibidoXMLResult> </DescargarAcuseRecibidoXMLResponse> </s:Body>
</s:Envelope>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
- | archivo | Archivo en Base 64 del documento |
Int | codigo | Código de retorno, Tabla 4 |
sizeFile | tamaño del documento | |
String | crc | Chequeo de Redundancia Cíclica |
cufe | Certificado Único de Facturación Electrónica. | |
mensaje | Mensaje descriptivo del resultado de la operación | |
resultado | Contiene información adicional (Procesado/Error) |
Método DescargarAcuseAceptacion
Método que permite a un Receptor, descargar el Response del evento de Aceptación, el cual está asociado a un documento que se en encuentra en el sistema
- REQUEST
- Parámetros a Enviar
Tipo | Identificador | Descripción | Valor numérico |
---|---|---|---|
Int | TipoDocumento | Es el tipo de documento que se va a manejar. | 2 caracteres |
nombreFileApplicationResponse | Nombre del documento que se encuentra en Lista de Anexo | - | |
tipoDescarga | Tipo de Descarga del documento | ||
identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 20 dígitos | |
tipoIdentificacionemisor | Identificador del Emisor Tabla 4 | 2 caracteres | |
nmeroDocumento | Identificador del documento | 2 caracteres | |
String | tokenEmpresa | Dato suministrado por The Factory HKA Colombia | 40 caracteres |
tokenPassword |
Ejemplo de entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> <soapenv:Header/> <soapenv:Body> <tem:DescargarAcuseAceptacionXML> <!--Optional:--> <tem:request> <!--Optional:--> <wcf:TipoDocumento></wcf:TipoDocumento> <!--Optional:--> <wcf:identificadorEmisor>90……26</wcf:identificadorEmisor> <!--Optional:--> <wcf:nombreFileApplicationResponse>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</wcf:nombreFileApplicationResponse> <!--Optional:--> <wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento> <!--Optional:--> <wcf:tipoDescarga>1</wcf:tipoDescarga> <!--Optional:--> <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> <!--Optional:--> <wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa> <!--Optional:--> <wcf:tokenPassword>b3…………43</wcf:tokenPassword> </tem:request> </tem:DescargarAcuseAceptacionXML> </soapenv:Body> </soapenv:Envelope>
Ejemplo de salida
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body> <DescargarAcuseAceptacionXMLResponse xmlns="http://tempuri.org/"> <DescargarAcuseAceptacionXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <a:archivo>PD94bWwgd…………………</a:archivo> <a:codigo>200</a:codigo> <a:crc>022770951408403f9442f9d09e52be15</a:crc> <a:cufe>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</a:cufe> <a:mensaje>Se retorna el archivo solicitado</a:mensaje> <a:resultado>Procesado</a:resultado> <a:size>14688</a:size> </DescargarAcuseRecibidoXMLResult> </DescargarAcuseRecibidoXMLResponse> </s:Body>
</s:Envelope>
- RESPONSE
- Parámetros a Recibir
Tipo | Identificador | Descripción |
---|---|---|
- | archivo | Archivo en Base 64 del documento |
Int | codigo | Código de retorno, Tabla 4 |
sizeFile | tamaño del documento | |
String | crc | Chequeo de Redundancia Cíclica |
cufe | Certificado Único de Facturación Electrónica. | |
mensaje | Mensaje descriptivo del resultado de la operación | |
resultado | Contiene información adicional (Procesado/Error) |
Mensaje: String que contiene mensaje descriptivo del resultado de la operación resultado: String que contiene información adicional (Uso futuro)