Servicios de Manejo de Documentos Electronicos para Receptor - Indice Manual Integración Recepción Electrónica
Revisión del 15:09 2 may 2022 de Nhoyos (discusión | contribuciones)
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 |
