Diferencia entre revisiones de «Servicios de Manejo de Documentos Electronicos para Receptor - Indice Manual Integración Recepción Electrónica»
Línea 1: | Línea 1: | ||
+ | |||
+ | <includeonly>=</includeonly>==<font color="blue">Servicios de Manejo de Documentos Electronicos para Receptor</font>==<includeonly>=</includeonly> | ||
+ | |||
+ | ===<font color="blue">Método de Reporte con Estatus (ReporteStatus</font>=== | ||
+ | Muestra la lista de los 500 últimos documentos de Facturación Electrónica con el respectivo estado que se | ||
+ | está buscando, que se han recibidos para un Receptor dado y que tienen asociado un consecutivo menor a | ||
+ | un valor suministrado. | ||
+ | ; REQUEST: Parámetros a Enviar | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
+ | |- | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Valor numérico | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |rowspan="2"|Int | ||
+ | |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. | ||
+ | |- | ||
+ | |rowspan="2"|String | ||
+ | |tokenEmpresa | ||
+ | |rowspan="2"|Dato suministrado por The Factory HKA Colombia | ||
+ | |rowspan="2"|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. | ||
+ | |||
+ | ==<font color="Blue">Tabla 1</font>== | ||
+ | {| class="wikitable" style="width: 100%;" | ||
+ | |+ Descripción del Estado del Documento | ||
+ | |- valign="center" | ||
+ | |-style="text-align:center;" | ||
+ | {| class="wikitable" style="width: 100%;" style="margin: auto;" | ||
+ | ! style="color:white;background:#2F5496; text-align:center;"|Código | ||
+ | ! style="color:white;background:#2F5496; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |00 | ||
+ | |Cargado | ||
+ | |- | ||
+ | |01 | ||
+ | |Entregado | ||
+ | |- | ||
+ | |02 | ||
+ | |Aceptación expresa (DIAN) | ||
+ | |- | ||
+ | |04 | ||
+ | |Reclamo (DIAN) | ||
+ | |- | ||
+ | |10 | ||
+ | |Acuse de recibo (DIAN | ||
+ | |- | ||
+ | |11 | ||
+ | |Rechazado (DIAN) | ||
+ | |- | ||
+ | |12 | ||
+ | |Recibo del bien y/o prestación del servicio | ||
+ | |- | ||
+ | |13 | ||
+ | |Precargado | ||
+ | |} | ||
+ | |} | ||
+ | ==<font color="Blue">Ejemplo de entrada</font>== | ||
+ | <pre> | ||
+ | |||
+ | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> | ||
+ | <soapenv:Header/> | ||
+ | <soapenv:Body> | ||
+ | <tem:ReporteStatus> | ||
+ | <tem:request> | ||
+ | <wcf:consecutivo>500</wcf:consecutivo> | ||
+ | <wcf:status_code>01</wcf:status_code> | ||
+ | <wcf:tokenEmpresa>89………………………………52</wcf:tokenEmpresa> | ||
+ | <wcf:tokenPassword>b3…………………………43</wcf:tokenPassword> | ||
+ | </tem:request> | ||
+ | </tem:ReporteStatus> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | </pre> | ||
+ | |||
+ | ==<font color="Blue">Ejemplo de Salida</font>== | ||
+ | <pre> | ||
+ | |||
+ | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
+ | <s:Body> | ||
+ | <ReporteStatusResponse xmlns="http://tempuri.org/"> | ||
+ | <ReporteStatusResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | ||
+ | <a:codigo>200</a:codigo> | ||
+ | <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"> | ||
+ | <s:Body> | ||
+ | <ReporteStatusResponse xmlns="http://tempuri.org/"> | ||
+ | <ReporteStatusResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> | ||
+ | <a:codigo>200</a:codigo> | ||
+ | <a:documentoselectronicos> | ||
+ | <a:InfoDocumentoStatus> | ||
+ | <a:correlativoempresa>177</a:correlativoempresa> | ||
+ | <a:cufe>90931e5e4e97f8d695326b2cd49328b1fcb0bf669bf9252b02acfaaab6bebe281c6adc846165e3b00a3cf23d00dfeb99</a:cufe> | ||
+ | <a:estatus>1</a:estatus> | ||
+ | <a:estatusDIANcodigo/> | ||
+ | <a:estatusDIANdescripcion | ||
+ | <a:estatusDIANfecha/> | ||
+ | <a:estatusnombre>Entregado</a:estatusnombre> | ||
+ | <a:fechaemision>2021-09-21</a:fechaemision> | ||
+ | <a:fecharecepcion>2021-11-17T19:24:07</a:fecharecepcion> | ||
+ | <a:horaemision>23:24:46</a:horaemision> | ||
+ | <a:montototal>21665472.08</a:montototal> | ||
+ | <a:numerodocumento>SUN64</a:numerodocumento> | ||
+ | <a:numeroidentificacion>595454595</a:numeroidentificacion> | ||
+ | <a:razonsocial>Ady.SA</a:razonsocial> | ||
+ | <a:tipodocumento>01</a:tipodocumento> | ||
+ | <a:tipoemisor>1</a:tipoemisor> | ||
+ | <a:tipoidentidad>31</a:tipoidentidad> | ||
+ | </a:InfoDocumentoStatus> | ||
+ | |||
+ | ………………… | ||
+ | </a:documentoselectronicos> | ||
+ | <a:mensaje>Procesado</a:mensaje> | ||
+ | <a:pendiente>false</a:pendiente> | ||
+ | <a:resultado>Procesado</a:resultado> | ||
+ | <a:ultimoEnviado>25</a:ultimoEnviado> | ||
+ | </ReporteStatusResult> | ||
+ | </ReporteStatusResponse> | ||
+ | </s:Body> | ||
+ | </s:Envelope> | ||
+ | |||
+ | </pre> | ||
+ | |||
+ | '''NOTA:''' El '''ultimoEnviado''' es el número consecutivo para ver los archivos anteriores a el último que se | ||
+ | muestra. Si se tienen más documentos el reporte mostrará true en la etiqueta pendientes, de caso | ||
+ | contrario si se tiene false indica que ya no se tienen documentos. | ||
+ | |||
+ | |||
+ | ; RESPONSE: Parámetros a Recibir | ||
+ | {| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;" | ||
+ | |- | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Tipo | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Identificador | ||
+ | ! style="background:#f2f2f2; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |- | ||
+ | |Int | ||
+ | |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 (Ver tabla relacionada) | ||
+ | |- | ||
+ | |String | ||
+ | |cufe | ||
+ | |Certificado Único de Facturación Electrónica. | ||
+ | |- | ||
+ | |Date | ||
+ | |fechaemision | ||
+ | |Fecha en el que fue emitido el documento | ||
+ | |- | ||
+ | |Date | ||
+ | |fecharecepcion | ||
+ | |Fecha en que anexado | ||
+ | |- | ||
+ | |Time | ||
+ | |horaemisión | ||
+ | |Hora de emisión | ||
+ | |- | ||
+ | |Int | ||
+ | |montotal | ||
+ | |Monto total de la factura electrónica | ||
+ | |- | ||
+ | |String | ||
+ | |numerodocumento | ||
+ | |Identificador del documento | ||
+ | |- | ||
+ | |Int | ||
+ | |numeroidentificacion | ||
+ | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
+ | |- | ||
+ | |String | ||
+ | |razonsocial | ||
+ | |Razón social del Emisor | ||
+ | |- | ||
+ | |String | ||
+ | |tipodocumento | ||
+ | |Identificador del documento | ||
+ | |- | ||
+ | |Int | ||
+ | |tipoemisor | ||
+ | | | ||
+ | |- | ||
+ | |Int | ||
+ | |tipoentidad | ||
+ | |Identificador del Emisor (Revisión de tabla ) | ||
+ | |- | ||
+ | |String | ||
+ | |mensaje | ||
+ | |Mensaje 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 | ||
+ | |} | ||
+ | |||
===<font color="blue">Método Reporte</font>=== | ===<font color="blue">Método Reporte</font>=== | ||
Línea 219: | Línea 439: | ||
|13 | |13 | ||
|Precargado | |Precargado | ||
+ | |} | ||
+ | |} | ||
+ | |||
+ | |||
+ | ===<font color="blue">Método Descargar XML</font>=== | ||
+ | Permite obtener el Archivo XML codificado 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="2"|Int | ||
+ | |identificadorEmisor | ||
+ | |NIT del Emisor o Identificador Tributario del Emisor de la Factura | ||
+ | |De 6 a 20 dígitos | ||
+ | |- | ||
+ | |tipoIdentificacionemisor | ||
+ | |Identificador del Emisor (Revisión de tabla 1 ) | ||
+ | |2 caracteres | ||
+ | |- | ||
+ | |rowspan="3"|String | ||
+ | |numeroDocumento | ||
+ | |Identificador del documento | ||
+ | |Hasta 20 caracteres | ||
+ | |- | ||
+ | |tokenEmpresa | ||
+ | |rowspan="2"|Dato suministrado por The Factory HKA Colombia | ||
+ | |rowspan="2"|40 caracteres | ||
+ | |- | ||
+ | |tokenPassword | ||
+ | |} | ||
+ | |||
+ | |||
+ | ==<font color="Blue">Ejemplo de entrada</font>== | ||
+ | <pre> | ||
+ | <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP"> | ||
+ | <soapenv:Header/> | ||
+ | <soapenv:Body> | ||
+ | <tem:DescargarXML> | ||
+ | <tem:request> | ||
+ | <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor> | ||
+ | <wcf:numeroDocumento>ABB10</wcf:numeroDocumento> | ||
+ | <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor> | ||
+ | <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa> | ||
+ | <wcf:tokenPassword>b3……………43</wcf:tokenPassword> | ||
+ | </tem:request> | ||
+ | </tem:DescargarXML> | ||
+ | </soapenv:Body> | ||
+ | </soapenv:Envelope> | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | </pre> | ||
+ | |||
+ | |||
+ | ; 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 | ||
+ | |- | ||
+ | |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 | ||
+ | |} | ||
+ | |||
+ | |||
+ | ==<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> | ||
+ | |||
+ | |||
+ | ==<font color="Blue">Tabla 2</font>== | ||
+ | {| class="wikitable" style="width: 100%;" | ||
+ | |+ Códigos de retorno y sin estatus | ||
+ | |- valign="center" | ||
+ | |-style="text-align:center;" | ||
+ | {| class="wikitable" style="width: 100%;" style="margin: auto;" | ||
+ | ! style="color:white;background:#2F5496; text-align:center;"|Código | ||
+ | ! style="color:white;background:#2F5496; text-align:center;"|Descripción | ||
+ | |- valign="center" | ||
+ | |200 | ||
+ | |Reporte Generado Satisfactoriamente | ||
+ | |- | ||
+ | |102 | ||
+ | |El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango / Valor no válido para el campo {nombre del campo} | ||
+ | |- | ||
+ | |103 | ||
+ | |Error Interno en el Servicio | ||
|} | |} | ||
|} | |} |
Revisión del 15:09 2 may 2022
Sumario
- 1 Servicios de Manejo de Documentos Electronicos para Receptor
- 2 Tabla 1
- 3 Ejemplo de entrada
- 4 Ejemplo de Salida
- 5 Ejemplo de entrada
- 6 Ejemplo de salida
- 7 Ejemplos: tomando el ultimoenviado
- 8 Ejemplo Respuesta:Tomando el ultimo enviado
- 9 Tabla 2
- 10 Tabla 3
- 11 Ejemplo de entrada
- 12 Ejemplo de salida
- 13 Tabla 2
Servicios de Manejo de Documentos Electronicos 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. | |
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.
Tabla 1
Código | Descripción |
---|---|
00 | Cargado |
01 | Entregado |
02 | Aceptación expresa (DIAN) |
04 | Reclamo (DIAN) |
10 | Acuse de recibo (DIAN |
11 | Rechazado (DIAN) |
12 | Recibo del bien y/o prestación del servicio |
13 | Precargado |
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 (Ver tabla relacionada) |
String | cufe | Certificado Único de Facturación Electrónica. |
Date | fechaemision | Fecha en el que fue emitido el documento |
Date | fecharecepcion | Fecha en que anexado |
Time | horaemisión | Hora de emisión |
Int | montotal | Monto total de la factura electrónica |
String | numerodocumento | Identificador del documento |
Int | numeroidentificacion | NIT del Emisor o Identificador Tributario del Emisor de la Factura |
String | razonsocial | Razón social del Emisor |
String | tipodocumento | Identificador del documento |
Int | tipoemisor | |
Int | tipoentidad | Identificador del Emisor (Revisión de tabla ) |
String | mensaje | Mensaje 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> <!--Optional:--> <wcf:tokenEmpresa>89………b52</wcf:tokenEmpresa> <!--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.
Tabla 2
Código | Descripción |
---|---|
200 | Reporte Generado Satisfactoriamente |
102 | El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango / Valor no válido para el campo {nombre del campo} |
103 | Error Interno en el Servicio |
Tabla 3
Código | Descripción |
---|---|
00 | Cargado |
01 | Entregado |
02 | Aceptación expresa (DIAN) |
04 | Reclamo (DIAN) |
10 | Acuse de recibo (DIAN |
11 | Rechazado (DIAN) |
12 | Recibo del bien y/o prestación del servicio |
13 | Precargado |
Método Descargar XML
Permite obtener el Archivo XML codificado 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 | identificadorEmisor | NIT del Emisor o Identificador Tributario del Emisor de la Factura | De 6 a 20 dígitos |
tipoIdentificacionemisor | Identificador del Emisor (Revisión de tabla 1 ) | 2 caracteres | |
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: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>
- 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 |
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>
Tabla 2
Código | Descripción |
---|---|
200 | Reporte Generado Satisfactoriamente |
102 | El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango / Valor no válido para el campo {nombre del campo} |
103 | Error Interno en el Servicio |