Ver el código de «Servicios de Manejo de Documentos Electronicos para Receptor - Indice Manual Integración Recepción Electrónica»


<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>===
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
{| 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
|consecutivo 
|Número consecutivo de los documentos a revisa
|número consecutivo del documento o en blanco
|-
|rowspan="2"|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: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>

</pre>
==<font color="Blue">Ejemplo de salida</font>==
<pre>

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


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


==<font color="Blue">Ejemplos: tomando el ultimoenviado</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: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>

</pre>

==<font color="Blue">Ejemplo Respuesta:Tomando el ultimo enviado</font>==
<pre>

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

</pre>
'''Apartado pendientes: False es indicativo que no hay más documentos por mostrar, True indica que hay más documentos anteriores.'''

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

==<font color="Blue">Tabla 3</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">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
|}
|}