Diferencia entre revisiones de «Servicios de Manejo de Documentos Electrónicos para Receptor - Índice Manual Integración Recepción Electrónica»

De tfhkacolwiki
Ir a la navegación Ir a la búsqueda
 
(No se muestran 8 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 [[Tablas de códigos de propiedades para emisión de documentos - Índice Manual Integración Recepción Electrónica[[#Tabla 1|Tabla 1]]
+
|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">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>====
 
====<font color="Blue">Ejemplo de entrada</font>====
 
<pre>
 
<pre>
Línea 156: Línea 123:
 
|String
 
|String
 
|estatus
 
|estatus
|Estatus del documento en el que se encuentra (Ver tabla relacionada)
+
|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 (Revisión de tabla )
+
|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 (false/True
+
|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 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.'''
  
====<font color="Blue">Tabla 2</font>====
+
 
{| class="wikitable" style="width: 100%;"
+
'''NOTA:'''  El '''ultimoEnviado''' es el número consecutivo para ver los archivos anteriores a el último que se
|+ Códigos de retorno y sin estatus
+
muestra. Si se tienen más documentos el reporte mostrará '''true''' en la etiqueta pendientes, de caso
|- valign="center"
+
contrario si se tiene '''false''' indica que ya no se tienen documentos.
|-style="text-align:center;"
+
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"  
+
 
! style="color:white;background:#2F5496; text-align:center;"|Código
+
; RESPONSE: Parámetros a Recibir
! style="color:white;background:#2F5496; text-align:center;"|Descripción
+
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|- valign="center"
 
|200
 
|Reporte Generado Satisfactoriamente
 
 
|-
 
|-
|102
+
! style="background:#f2f2f2; text-align:center;"|Tipo
|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}
+
! style="background:#f2f2f2; text-align:center;"|Identificador
|-
+
! style="background:#f2f2f2; text-align:center;"|Descripción
|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"
 
|- valign="center"
|00
 
|Cargado
 
 
|-
 
|-
|01
+
|Int
|Entregado
+
|Código
 +
|Código de retorno. Ver catálogo de respuesta del método
 
|-
 
|-
|02
+
|Int
|Aceptación expresa (DIAN)
+
|CorrelativoEmpresa
 +
|Número correlativo de la empresa
 
|-
 
|-
|04
+
|String
|Reclamo (DIAN)
+
|cufe
 +
|Certificado Único de Facturación Electrónica.
 
|-
 
|-
|10
+
|Date
|Acuse de recibo (DIAN
+
|fechaemision
 +
|Fecha en el que fue emitido el documento
 
|-
 
|-
|11
+
|Date
|Rechazado (DIAN)
+
|fecharecepcion
 +
|Fecha en que anexado
 
|-
 
|-
|12
+
|Time
|Recibo del bien y/o prestación del servicio
+
|horaemisión
 +
|Hora de emisión
 
|-
 
|-
|13
+
|Int
|Precargado
+
|montotal
|}
+
|Monto total de la factura electrónica
|}
 
 
 
 
 
===<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
+
|String
! style="background:#f2f2f2; text-align:center;"|Identificador
+
|numerodocumento
! style="background:#f2f2f2; text-align:center;"|Descripción
+
|Identificador del documento
! style="background:#f2f2f2; text-align:center;"|Valor numérico
 
|- valign="center"
 
 
|-
 
|-
|rowspan="2"|Int
+
|Int
|identificadorEmisor
+
|numeroidentificacion
 
|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
+
|String
|Identificador del Emisor (Revisión de tabla 1 )
+
|razonsocial
|2 caracteres
+
|Razón social del Emisor
 
|-
 
|-
|rowspan="3"|String
+
|String
|numeroDocumento
+
|tipodocumento
 
|Identificador del documento
 
|Identificador del documento
|Hasta 20 caracteres
 
 
|-
 
|-
|tokenEmpresa
+
|Int
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
+
|tipoemisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 3|Tabla 3]]
|rowspan="2"|40 caracteres
+
|
 +
|-
 +
|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
 
|-
 
|-
|tokenPassword
+
|Boolean
|}
+
|pendiente
 
+
|respuesta (<span style="color:#F1142F; background:#FFFFFF"><b>False</b></span>/<span style="color:#15C71D; background:#FFFFFF"><b>True</b></span>)
 
+
|-
====<font color="Blue">Ejemplo de entrada</font>====
+
|String
<pre>
+
|resultado
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
+
|Contiene información adicional (<span style="color:#15C71D; background:#FFFFFF"><b>Procesado</b></span>/<span style="color:#F1142F; background:#FFFFFF"><b>Error</b></span>)
    <soapenv:Header/>
+
|-
    <soapenv:Body>
+
|Int
        <tem:DescargarXML>
+
|ultimoenviado
            <tem:request>
+
|Último número consecutivo
                <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>
 
  
 
  
 
+
===<font color="blue">Método de Descarga XML</font>===
</pre>
+
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
 
 
; 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 505: Línea 446:
 
! 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="3"|Int
|archivo
+
|TipoDocumento
|Archivo en Base 64
+
|Es el tipo de documento que se va a manejar.
 +
|2 caracteres
 
|-
 
|-
|Int
+
|identificadorEmisor
|Código
+
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|Código de retorno. Ver catálogo de respuesta del método
+
|De 6 a 20 dígitos
 
|-
 
|-
|String
+
|tipoIdentificacionemisor
|crc
+
|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]]
|Chequeo de Redundancia Cíclica
+
|2 caracteres
 
|-
 
|-
|String
+
|rowspan="3"|String
|cufe
+
|numeroDocumento
|Certificado Único de Facturación Electrónica.
+
|Identificador del documento
 +
|Hasta 20 caracteres
 
|-
 
|-
|String
+
|tokenEmpresa
|mensaje
+
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|Mensaje descriptivo del resultado de la operación
+
|rowspan="2"|40 caracteres
 
|-
 
|-
|String
+
|tokenPassword
|resultado
+
|}
|Contiene información adicional (Procesado/Error)
+
 
|-
+
 
|Int
+
====<font color="Blue">Ejemplo de entrada</font>====
|size
+
<pre>
|Tamaño del documento
+
<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>
 +
 
 +
 +
 
 +
 
 +
</pre>
  
  
Línea 557: Línea 519:
  
  
====<font color="Blue">Tabla 4</font>====
+
; RESPONSE: Parámetros a Recibir
{| class="wikitable" style="width: 100%;"
+
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|+ 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">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;"|Tipo
 
! 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="2"|Int
+
| -
|identificadorEmisor
+
|archivo
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
+
|Archivo en Base 64
|De 6 a 20 dígitos
 
 
|-
 
|-
|tipoIdentificacionemisor
+
|Int
|Identificador del Emisor  (Revisión de tabla 1 )
+
|Código
|2 caracteres
+
|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.
 
|-
 
|-
|rowspan="3"|String
+
|String
|numeroDocumento
+
|mensaje
|Identificador del documento
+
|Mensaje descriptivo del resultado de la operación
|Hasta 20 caracteres
 
 
|-
 
|-
|tokenEmpresa
+
|String
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
+
|resultado
|rowspan="2"|40 caracteres
+
|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
 +
|size
 +
|Tamaño del documento
 
|}
 
|}
  
 +
===<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
  
====<font color="Blue">Ejemplo de entrada</font>====
+
; REQUEST: Parámetros a Enviar
<pre>
+
{| 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
 +
|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="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:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
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:
  
  
; RESPONSE: Parámetros a Recibir
+
====<font color="Blue">Ejemplo de salida</font>====
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
+
<pre>
|-
 
! 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
 
|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)
 
|}
 
 
 
 
 
====<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>
Línea 679: Línea 635:
  
  
====<font color="Blue">Tabla 5</font>====
+
; RESPONSE: Parámetros a Recibir
{| class="wikitable" style="width: 100%;"
+
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|+ Códigos de retorno DescargarRepGráfica
 
|- 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
+
! style="background:#f2f2f2; text-align:center;"|Tipo
|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}
+
! 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
 
|-
 
|-
|103
+
|String
|Error Interno en el Servicio
+
|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>===
Línea 714: Línea 673:
 
|- valign="center"
 
|- valign="center"
 
|-
 
|-
|rowspan="2"|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 720: Línea 683:
 
|-
 
|-
 
|tipoIdentificacionemisor
 
|tipoIdentificacionemisor
|Identificador del Emisor (Revisión de tabla 1 )
+
|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:DescargarAnexo>
+
         <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:identificadorInternoAnexo>32168992-676A-44C8-862D-F5E5EBC762DB</wcf:identificadorInternoAnexo>
 
 
                 <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:DescargarAnexo>
+
         </tem:DescargarRepGrafica>
 
     </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>
 +
        <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>
 +
 
 +
 
 +
 
 +
; 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 777: Línea 770:
 
|Int
 
|Int
 
|codigo
 
|codigo
|Código de retorno. Ver catálogo de respuesta del método
+
|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 816: Línea 809:
 
|}
 
|}
 
|}
 
|}
 +
 +
===<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
  
  
====<font color="Blue">Ejemplo de salida</font>====
+
; REQUEST: Parámetros a Enviar
<pre>
+
{| 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
 +
|}
  
<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>
 
  
 +
====<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">Tabla 6</font>====
 
{| class="wikitable" style="width: 100%;"
 
|+ Códigos de retorno Descarga de Adjuntos/Anexos
 
|- 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
 
|}
 
|}
 
  
  
 +
</pre>
  
===<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
 
  
 +
====<font color="Blue">Ejemplo de salida</font>====
 +
<pre>
  
; REQUEST: Parámetros a Enviar
+
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
+
    <s:Body>
|-
+
        <EstadoDocumentoResponse xmlns="http://tempuri.org/">
! style="background:#f2f2f2; text-align:center;"|Tipo
+
            <EstadoDocumentoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
! style="background:#f2f2f2; text-align:center;"|Identificador
+
                <a:ListEstatusHistory>
! style="background:#f2f2f2; text-align:center;"|Descripción
+
                    <a:HistorialEstatus>
! style="background:#f2f2f2; text-align:center;"|Valor numérico
+
                        <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Aceptación expresa (DIAN)</a:Comentarios>
|- valign="center"
+
    <a:Descripcion>Aceptación expresa (DIAN)</a:Descripcion>
|-
+
                        <a:codigoEstatus>2</a:codigoEstatus>
|rowspan="2"|Int
+
                        <a:fecha>2022-03-07 13:37:47</a:fecha>
|identificadorEmisor
+
                    </a:HistorialEstatus>
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
+
                    <a:HistorialEstatus>
|De 6 a 20 dígitos
+
                        <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>
|tipoIdentificacionemisor
+
                        <a:codigoEstatus>12</a:codigoEstatus>
|Identificador del Emisor  (Revisión de tabla 1 )
+
                        <a:fecha>2022-03-07 13:37:46</a:fecha>
|2 caracteres
+
                    </a:HistorialEstatus>
|-
+
                    <a:HistorialEstatus>
|rowspan="3"|String
+
                        <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Acuse de recibo (DIAN)</a:Comentarios>
|numeroDocumento
+
                        <a:Descripcion>Acuse de recibo (DIAN)</a:Descripcion>
|Identificador del documento
+
                        <a:codigoEstatus>10</a:codigoEstatus>
|Hasta 20 caracteres
+
                        <a:fecha>2022-03-07 13:32:19</a:fecha>
|-
+
                    </a:HistorialEstatus>
|tokenEmpresa
+
                    <a:HistorialEstatus>
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
+
                        <a:Comentarios>Cambio de Estado a Entregado por Descarga de Documento Electrónico</a:Comentarios>
|rowspan="2"|40 caracteres
+
                        <a:Descripcion>Entregado</a:Descripcion>
|-
+
                        <a:codigoEstatus>1</a:codigoEstatus>
|tokenPassword
+
                        <a:fecha>2022-02-11 12:38:25</a:fecha>
|}
+
                    </a:HistorialEstatus>
 
+
                    <a:HistorialEstatus>
 
+
                        <a:Comentarios>Cargado</a:Comentarios>
====<font color="Blue">Ejemplo de entrada</font>====
+
                        <a:Descripcion>Cargado</a:Descripcion>
<pre>
+
                        <a:codigoEstatus>0</a:codigoEstatus>
 
+
                        <a:fecha>2022-02-11 12:23:02</a:fecha>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
+
                    </a:HistorialEstatus>
    <soapenv:Header/>
+
                </a:ListEstatusHistory>
    <soapenv:Body>
+
                <a:codigo>200</a:codigo>
        <tem:EstadoDocumento>
+
                <a:estatusDIANDescripcion/>
            <tem:request>
+
                <a:estatusDIANcodigo/>
                 <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
+
                <a:estatusDIANfecha/>
                 <wcf:numeroDocumento>ABB09</wcf:numeroDocumento>
+
                <a:estatusDocumento>Aceptación expresa (DIAN)</a:estatusDocumento>
                 <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
+
                 <a:fechaDocumento>2022-02-11T12:23:01</a:fechaDocumento>
                 <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
+
                 <a:mensaje>Se retorna los datos del estado del documento</a:mensaje>
                 <wcf:tokenPassword>b3……………43</wcf:tokenPassword>
+
                 <a:resultado>Procesado</a:resultado>
             </tem:request>
+
                 <a:tipoDocumento>01</a:tipoDocumento>
         </tem:EstadoDocumento>
+
                 <a:uuid>0e12f97ef3...060039e2d5f2</a:uuid>
     </soapenv:Body>
+
             </EstadoDocumentoResult>
</soapenv:Envelope>
+
         </EstadoDocumentoResponse>
 +
     </s:Body>
 +
</s:Envelope>
  
  
 
</pre>
 
</pre>
 +
 +
  
  
Línea 934: Línea 950:
 
|String
 
|String
 
|comentarios
 
|comentarios
|Status del documento . Ver catálogo de respuesta del método
+
|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 942: 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 953: 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.
  
====<font color="Blue">Ejemplo de salida</font>====
+
'''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
<pre>
 
  
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
+
; REQUEST: Parámetros a Enviar
    <s:Body>
+
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
        <EstadoDocumentoResponse xmlns="http://tempuri.org/">
+
|-
            <EstadoDocumentoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
+
! style="background:#f2f2f2; text-align:center;"|Tipo
                <a:ListEstatusHistory>
+
! style="background:#f2f2f2; text-align:center;"|Identificador
                    <a:HistorialEstatus>
+
! style="background:#f2f2f2; text-align:center;"|Atributo
                        <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Aceptación expresa (DIAN)</a:Comentarios>
+
! style="background:#f2f2f2; text-align:center;"|Descripción
    <a:Descripcion>Aceptación expresa (DIAN)</a:Descripcion>
+
|- valign="center"
                        <a:codigoEstatus>2</a:codigoEstatus>
+
|-
                        <a:fecha>2022-03-07 13:37:47</a:fecha>
+
|rowspan="7"|String
                    </a:HistorialEstatus>
+
|rowspan="7"|EjecutadorPor
                    <a:HistorialEstatus>
+
|Apellido
                        <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Recibo del bien y/o prestación del servicio</a:Comentarios>
+
|Apellido de la persona encargada de enviar evento.
                        <a:Descripcion>Recibo del bien y/o prestación del servicio</a:Descripcion>
+
|-
                        <a:codigoEstatus>12</a:codigoEstatus>
+
|Cargo
                        <a:fecha>2022-03-07 13:37:46</a:fecha>
+
|Función de la cual una persona tiene la responsabilidad en una organización, un organismo o una empresa.(opcional).
                    </a:HistorialEstatus>
+
|-
                    <a:HistorialEstatus>
+
|Departamento.
                        <a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Acuse de recibo (DIAN)</a:Comentarios>
+
|Área en la que se encuentra la persona encargada de envío de eventos (opcional).
                        <a:Descripcion>Acuse de recibo (DIAN)</a:Descripcion>
+
|-
                        <a:codigoEstatus>10</a:codigoEstatus>
+
|DV
                        <a:fecha>2022-03-07 13:32:19</a:fecha>
+
|Digito verificador del nit de la empresa.
                    </a:HistorialEstatus>
+
|-
                    <a:HistorialEstatus>
+
|NumeroIdentificacion
                        <a:Comentarios>Cambio de Estado a Entregado por Descarga de Documento Electrónico</a:Comentarios>
+
|Nit de la empresa.
                        <a:Descripcion>Entregado</a:Descripcion>
+
|-
                        <a:codigoEstatus>1</a:codigoEstatus>
+
|TipoIdentificacion
                        <a:fecha>2022-02-11 12:38:25</a:fecha>
+
|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]]
                    </a:HistorialEstatus>
+
|-
                    <a:HistorialEstatus>
+
|Nombre
                        <a:Comentarios>Cargado</a:Comentarios>
+
|Nombre de la persona encargada a enviar eventos hacia la DIAN.
                        <a:Descripcion>Cargado</a:Descripcion>
+
|-
                        <a:codigoEstatus>0</a:codigoEstatus>
+
|rowspan="5"|Int
                        <a:fecha>2022-02-11 12:23:02</a:fecha>
+
|TipoDocumento
                    </a:HistorialEstatus>
+
|Es el tipo de documento que se va a manejar.
                </a:ListEstatusHistory>
+
|2 caracteres
                <a:codigo>200</a:codigo>
+
|-
                <a:estatusDIANDescripcion/>
+
|identificadorEmisor
                <a:estatusDIANcodigo/>
+
|
                <a:estatusDIANfecha/>
+
|NIT del Emisor o Identificador Tributario del Emisor de la Factura, de 6 a 20 dígitos
                <a:estatusDocumento>Aceptación expresa (DIAN)</a:estatusDocumento>
+
|-
                <a:fechaDocumento>2022-02-11T12:23:01</a:fechaDocumento>
+
|numeroDocumento
                <a:mensaje>Se retorna los datos del estado del documento</a:mensaje>
+
|
                <a:resultado>Procesado</a:resultado>
+
|Identificador del documento hasta 20 caracteres
                <a:tipoDocumento>01</a:tipoDocumento>
+
|-
                <a:uuid>0e12f97ef3...060039e2d5f2</a:uuid>
+
|status
            </EstadoDocumentoResult>
+
|
        </EstadoDocumentoResponse>
+
|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]]
    </s:Body>
+
|-
</s:Envelope>
+
|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.
  
</pre>
+
====<font color="Blue">CodigoRechazo</font>====
 
 
 
 
====<font color="Blue">Tabla 7</font>====
 
 
{| class="wikitable" style="width: 100%;"
 
{| class="wikitable" style="width: 100%;"
|+ Códigos de retorno Descarga de Estatus
+
|+ CodigoRechazo
 
|- valign="center"
 
|- valign="center"
 
|-style="text-align:center;"  
 
|-style="text-align:center;"  
Línea 1021: 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"
|200
+
|01
|Reporte Generado Satisfactoriamente
+
|Documento con inconsistencias
 +
|-
 +
|02
 +
|Mercancía no entregada totalmente
 
|-
 
|-
|102
+
|03
|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}
+
|Mercancía no entregada parcialmente
 
|-
 
|-
|103
+
|04
|Error Interno en el Servicio
+
|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>
  
===<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
+
; 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 1050: 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
! style="background:#f2f2f2; text-align:center;"|Valor numérico
 
 
|- valign="center"
 
|- valign="center"
 
|-
 
|-
|rowspan="2"|Int
+
|Int
|identificadorEmisor
+
|Código
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
+
|Código de retorno. Ver catálogo de respuesta del método
|De 6 a 20 dígitos
 
 
|-
 
|-
|tipoIdentificacionemisor
+
|String
|Identificador del Emisor (Revisión de tabla 1 )
+
|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  
 
|-
 
|-
|rowspan="4"|String
 
 
|numeroDocumento
 
|numeroDocumento
 
|Identificador del documento
 
|Identificador del documento
 
|Hasta 20 caracteres
 
|Hasta 20 caracteres
 
|-
 
|-
|String
+
|rowspan="2"|String
|Identificadorinternoanexo
 
|dentificador del Anexo el cual debe de consultarse en el Método de ListaAnexo
 
|
 
|-
 
 
|tokenEmpresa
 
|tokenEmpresa
 
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
 
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
Línea 1077: Línea 1188:
 
|-
 
|-
 
|tokenPassword
 
|tokenPassword
|}
 
 
El código de Rechazo es requerido para realizar cualquier cambio de estado.
 
 
====<font color="Blue">CodigoRechazo</font>====
 
{| class="wikitable" style="width: 100%;"
 
|+ CodigoRechazo
 
|- 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"
 
|01
 
|Documento con inconsistencias
 
|-
 
|02
 
|Mercancía no entregada totalmente
 
|-
 
|03
 
|Mercancía no entregada parcialmente
 
|-
 
|04
 
|Servicio no prestado
 
|}
 
 
|}
 
|}
  
Línea 1110: Línea 1196:
 
     <soapenv:Header/>
 
     <soapenv:Header/>
 
     <soapenv:Body>
 
     <soapenv:Body>
         <tem:CambioEstatus>
+
         <tem:CosultaDocumentoMetadata>
 
             <tem:request>
 
             <tem:request>
                <wcf:EjecutadoPor>
 
                    <wcf:Apellido>López</wcf:Apellido>
 
                    <wcf:Cargo>Recursos</wcf:Cargo>
 
                    <wcf:Departamento>RG</wcf:Departamento>
 
                    <wcf:Identificacion>
 
                        <wcf:Dv>9</wcf:Dv>
 
                        <wcf:NumeroIdentificacion>31</wcf:NumeroIdentificacion>
 
                        <wcf:TipoIdentificacion>31</wcf:TipoIdentificacion>
 
                    </wcf:Identificacion>
 
                    <wcf:Nombre>Adriana</wcf:Nombre>
 
                </wcf:EjecutadoPor>
 
                <wcf:codigoRechazo>01</wcf:codigoRechazo>
 
 
                 <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
 
                 <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
                 <wcf:numeroDocumento>ABB01</wcf:numeroDocumento>
+
                 <wcf:numeroDocumento>ABB09</wcf:numeroDocumento>
                <wcf:status>13</wcf:status>
 
 
                 <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:CambioEstatus>
+
        </tem:CosultaDocumentoMetadata>
 
     </soapenv:Body>
 
     </soapenv:Body>
 
</soapenv:Envelope>
 
</soapenv:Envelope>
</p>
 
  
 
+
</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"
 
|-
 
|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)
 
|}
 
  
 
====<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>
+
<s:Body>
         <CambioEstatusResponse xmlns="http://tempuri.org/">
+
         <CosultaDocumentoMetadataResponse xmlns="http://tempuri.org/">
             <CambioEstatusResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
+
             <CosultaDocumentoMetadataResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                 <a:codigo>103</a:codigo>
+
                 <a:ListMetadata>
                <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:SPPostMetadata>
                <a:resultado>Error</a:resultado>
+
                        <a:createdat>2022-02-17T12:08:47</a:createdat>
            </CambioEstatusResult>
+
                        <a:createdby>Customer</a:createdby>
        </CambioEstatusResponse>
+
                        <a:label>Nueva Categoría 2</a:label>
    </s:Body>
+
                        <a:updatedat>2022-02-17T12:08:47</a:updatedat>
</s:Envelope>
+
                        <a:updatedby>Customer</a:updatedby>
 
+
                        <a:value>A</a:value>
 
+
                    </a:SPPostMetadata>
 
+
                    <a:SPPostMetadata>
</pre>
+
                        <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>
====<font color="Blue">Tabla 8</font>====
+
                        <a:value>Calle Carrera</a:value>
{| class="wikitable" style="width: 100%;"
+
                    </a:SPPostMetadata>
|+ Códigos de retorno Descarga de Estatus
+
                    <a:SPPostMetadata>
|- valign="center"
+
                        <a:createdat>2022-02-17T12:08:47</a:createdat>
|-style="text-align:center;"
+
                        <a:createdby>Customer</a:createdby>
{| class="wikitable" style="width: 100%;" style="margin: auto;"
+
                        <a:label>Regiones 1</a:label>
! style="color:white;background:#2F5496; text-align:center;"|Código
+
                        <a:updatedat>2022-02-17T12:08:47</a:updatedat>
! style="color:white;background:#2F5496; text-align:center;"|Descripción
+
                        <a:updatedby>Customer</a:updatedby>
|- valign="center"
+
                        <a:value>J&amp;J</a:value>
|200
+
                    </a:SPPostMetadata>
|Reporte Generado Satisfactoriamente
+
                </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;"
 
|-
 
|-
|102
+
! style="background:#f2f2f2; text-align:center;"|Tipo
|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}
+
! style="background:#f2f2f2; text-align:center;"|Identificador
|-
+
! style="background:#f2f2f2; text-align:center;"|Descripción
|103
 
|Error Interno en el Servicio
 
|}
 
|}
 
 
 
 
 
 
 
====<font color="Blue">Tabla 9</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"
 
|- valign="center"
|00
 
|Cargado
 
 
|-
 
|-
|01
+
|String
|Entregado
+
|createdat
 +
|Creación del Infodato
 
|-
 
|-
|02
+
|String
|Aceptación expresa (DIAN)
+
|createdby
 +
|Quien lo creo
 
|-
 
|-
|04
+
|String
|Reclamo (DIAN)
+
|label
 +
|Nombre del Infodato
 
|-
 
|-
|10
+
|Time
|Acuse de recibo (DIAN
+
|updatedat
 +
|Tiempo de relación
 
|-
 
|-
|11
+
|String
|Rechazado (DIAN)
+
|value
|-
+
|Nombre de la subcategoría o valor que está relacionado del Infodato
|12
 
|Recibo del bien y/o prestación del servicio
 
|-
 
|13
 
|Precargado
 
|}
 
 
|}
 
|}
  
  
 +
</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
  
===<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
 
  
  
Línea 1256: 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 1261: Línea 1324:
 
|-
 
|-
 
|tipoIdentificacionemisor
 
|tipoIdentificacionemisor
|Identificador del Emisor (Revisión de tabla 1 )
+
|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
 
|-
 
|-
|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 1282: Línea 1345:
 
     <soapenv:Header/>
 
     <soapenv:Header/>
 
     <soapenv:Body>
 
     <soapenv:Body>
        <tem:CosultaDocumentoMetadata>
+
<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>ABB09</wcf:numeroDocumento>
+
                 <wcf:numeroDocumento>LAS40588</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>
+
         </tem:ListaAnexo>
 
     </soapenv:Body>
 
     </soapenv:Body>
 
</soapenv:Envelope>
 
</soapenv:Envelope>
Línea 1298: Línea 1362:
  
  
; RESPONSE: Parámetros a Recibir
+
====<font color="Blue">Ejemplo de salida</font>====
{| 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"
 
|-
 
|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
 
|}
 
 
 
====<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>
+
    <s:Body>
         <CosultaDocumentoMetadataResponse xmlns="http://tempuri.org/">
+
         <ListaAnexoResponse xmlns="http://tempuri.org/">
             <CosultaDocumentoMetadataResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
+
             <ListaAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                 <a:ListMetadata>
+
                 <a:ListArchivoDocumento>
                     <a:SPPostMetadata>
+
                     <a:ArchivoDocumento>
                         <a:createdat>2022-02-17T12:08:47</a:createdat>
+
                         <a:CreatedAt>2022-02-01T10:14:09.223</a:CreatedAt>
                         <a:createdby>Customer</a:createdby>
+
                        <a:Format>.pdf</a:Format>
                         <a:label>Nueva Categoría 2</a:label>
+
                         <a:InvoiceFileId>5782</a:InvoiceFileId>
                         <a:updatedat>2022-02-17T12:08:47</a:updatedat>
+
                         <a:InvoiceId>19981</a:InvoiceId>
                         <a:updatedby>Customer</a:updatedby>
+
                         <a:NameDisplay>LAS40588</a:NameDisplay>
                         <a:value>A</a:value>
+
                        <a:NameFile>LAS40588</a:NameFile>
                    </a:SPPostMetadata>
+
                         <a:PathFile>Recepcion/542/31/45......34/2021/8/11/LAS40588/</a:PathFile>
                    <a:SPPostMetadata>
+
                         <a:ProviderVisible>true</a:ProviderVisible>
                         <a:createdat>2022-02-17T12:08:47</a:createdat>
+
                        <a:Type>Representacion Gráfica</a:Type>
                         <a:createdby>Customer</a:createdby>
+
                        <a:TypeCode>1</a:TypeCode>
                        <a:label>Nueva Categoría</a:label>
+
                         <a:UpdatedAt>2022-02-01T10:14:09.223</a:UpdatedAt>
                         <a:updatedat>2022-02-17T12:08:47</a:updatedat>
+
                         <a:size>43282</a:size>
                         <a:updatedby>Customer</a:updatedby>
+
                    </a:ArchivoDocumento>
                         <a:value>Calle Carrera</a:value>
+
                    <a:ArchivoDocumento>
                    </a:SPPostMetadata>
+
                         <a:CreatedAt>2022-03-09T12:16:47.597</a:CreatedAt>
                    <a:SPPostMetadata>
+
                         <a:Format>.pdf</a:Format>
                         <a:createdat>2022-02-17T12:08:47</a:createdat>
+
                         <a:InvoiceFileId>5984</a:InvoiceFileId>
                         <a:createdby>Customer</a:createdby>
+
                        <a:InvoiceId>19981</a:InvoiceId>
                         <a:label>Regiones 1</a:label>
+
                        <a:NameDisplay>ad0000346585016210001271e</a:NameDisplay>
                         <a:updatedat>2022-02-17T12:08:47</a:updatedat>
+
                         <a:NameFile>32168992-676A-44C8-862D-F5E5EBC762DB</a:NameFile>
                         <a:updatedby>Customer</a:updatedby>
+
<a:PathFile>Recepcion/542/31/45......34/2021/8/11/LAS40588/</a:PathFile>
                         <a:value>J&amp;J</a:value>
+
                         <a:ProviderVisible>true</a:ProviderVisible>
                     </a:SPPostMetadata>
+
                         <a:Type>Anexo</a:Type>
                 </a:ListMetadata>
+
                         <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:estatusDIANDescripcion/>
+
                 <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:estatusDIANcodigo/>
+
                 <a:resultado>Procesado</a:resultado>
                <a:estatusDIANfecha/>
+
             </ListaAnexoResult>
                <a:estatusDocumento>Aceptación expresa (DIAN)</a:estatusDocumento>
+
         </ListaAnexoResponse>
                <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:Body>
</s:Envelope>
 
 
 
 
  
 
</pre>
 
</pre>
  
  
 
+
; RESPONSE: Parámetros a Recibir
 
+
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
====<font color="Blue">Tabla 10</font>====
+
|-
{| class="wikitable" style="width: 100%;"
+
! style="background:#f2f2f2; text-align:center;"|Tipo
|+ Códigos de retorno Metadata
+
! style="background:#f2f2f2; text-align:center;"|Identificador
|- valign="center"
+
! style="background:#f2f2f2; text-align:center;"|Descripción
|-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"
 
|- valign="center"
|200
 
|Reporte Generado Satisfactoriamente
 
 
|-
 
|-
|102
+
|rowspan="4"|Int
|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}
+
|InvoiceFileId
 +
|Campo de control de identificación del archivo
 
|-
 
|-
|103
+
|InvoiceId
|Error Interno en el Servicio
+
|Campo de control de identificación del documento
|}
 
|}
 
 
 
 
 
 
 
 
 
 
 
===<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
 
 
 
 
 
 
 
 
 
; REQUEST: Parámetros a Enviar
 
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
 
 
|-
 
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
+
|TypeCode
! style="background:#f2f2f2; text-align:center;"|Identificador
+
|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]]
! style="background:#f2f2f2; text-align:center;"|Descripción
 
! style="background:#f2f2f2; text-align:center;"|Valor numérico
 
|- valign="center"
 
 
|-
 
|-
|rowspan="2"|Int
+
|size
|identificadorEmisor
+
|tamaño del documento
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
 
|De 6 a 20 dígitos
 
 
|-
 
|-
|tipoIdentificacionemisor
+
|rowspan="5"|String
|Identificador del Emisor  (Revisión de tabla 1 )
+
|Format
|2 caracteres  
+
|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
 
|-
 
|-
|rowspan="3"|String
+
|Type
|numeroDocumento
+
|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
|Identificador del documento
 
|Hasta 20 caracteres
 
 
|-
 
|-
|tokenEmpresa
+
|NameFile
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
+
|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"|40 caracteres
 
 
|-
 
|-
|tokenPassword
+
|rowspan="2"|Time
|}
+
|UpdatedAt
 
+
|fecha de la última actualización del archivo
 
+
|-
====<font color="Blue">Ejemplo de entrada</font>====
+
|CreatedAt
<pre>
+
|Fecha en la que fue incorporado el archivo
<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/>
+
|Boolean
    <soapenv:Body>
+
|ProviderVisible
<tem:ListaAnexo>
+
|Indicador que señala si el archivo puede ser descargado por el emisor
            <tem:request>
+
|}
                <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
+
 
                <wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
+
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
                <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>
 
  
 
</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.
  
  
; RESPONSE: Parámetros a Recibir
+
; 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 1471: 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="4"|Int
+
|rowspan="2"|Int
|InvoiceFileId
+
|TipoDocumento
|Campo de control de identificación del archivo
+
|Es el tipo de documento que se va a manejar.
 +
|2 caracteres
 
|-
 
|-
|InvoiceId
+
|identificadorEmisor
|Campo de control de identificación del documento
+
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|-
+
|De 6 a 20 dígitos
|TypeCode
 
|Entero que indica el código de tipo de anexo; a saber admite los siguientes valores (Ver tabla)
 
|-
 
|size
 
|tamaño del documento
 
 
|-
 
|-
 
|rowspan="5"|String
 
|rowspan="5"|String
|Format
+
|identificadorinternoanexo
|Extensión del Archivo
+
|Identificador del Anexo el cual debe de consultarse en el '''Método de ListaAnexo'''
 +
|
 
|-
 
|-
|NameDisplay
+
|tipoIdentificacionemisor
|Nombre Archivo dado por el Proveedor Tecnológico, hasta 100 caracteres
+
|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  
 
|-
 
|-
|PathFile
+
|numeroDocumento
|Campo de control de identificación del documento
+
|Identificador del documento
 +
|Hasta 20 caracteres
 
|-
 
|-
|Type
+
|tokenEmpresa
|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
+
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
 +
|rowspan="2"|40 caracteres
 
|-
 
|-
|NameFile
+
|tokenPassword
|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
+
====<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 1521: 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>
         <ListaAnexoResponse xmlns="http://tempuri.org/">
+
         <DescargarAnexoResponse xmlns="http://tempuri.org/">
             <ListaAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
+
             <DescargarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                 <a:ListArchivoDocumento>
+
                 <a:archivo>JVBERi0xLjQKM……</a:archivo>
                    <a:ArchivoDocumento>
+
                <a:codigo>200</a:codigo>
                        <a:CreatedAt>2022-02-01T10:14:09.223</a:CreatedAt>
+
                <a:crc>5e9b2925ae58b8f7c2c95ef8d748d864</a:crc>
                        <a:Format>.pdf</a:Format>
+
                <a:cufe>6c406410fc912ca1a937d1b...e08ad3c91fa8da809c1517da5</a:cufe>
                        <a:InvoiceFileId>5782</a:InvoiceFileId>
+
                <a:displayname>ad0000346585016210001271e</a:displayname>
                        <a:InvoiceId>19981</a:InvoiceId>
+
                <a:extension>pdf</a:extension>
                        <a:NameDisplay>LAS40588</a:NameDisplay>
+
                <a:idfile>5984</a:idfile>
                        <a:NameFile>LAS40588</a:NameFile>
+
                <a:mensaje>Se retorna el archivo solicitado</a:mensaje>
                        <a:PathFile>Recepcion/542/31/45......34/2021/8/11/LAS40588/</a:PathFile>
+
                 <a:resultado>Procesado</a:resultado>
                        <a:ProviderVisible>true</a:ProviderVisible>
+
                 <a:sizefile>43203</a:sizefile>
                        <a:Type>Representacion Gráfica</a:Type>
+
                 <a:type>2</a:type>
                        <a:TypeCode>1</a:TypeCode>
+
             </DescargarAnexoResult>
                        <a:UpdatedAt>2022-02-01T10:14:09.223</a:UpdatedAt>
+
         </DescargarAnexoResponse>
                        <a:size>43282</a:size>
+
     </s:Body>
                    </a:ArchivoDocumento>
+
</s:Envelope>
                    <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>
 
  
 
</pre>
 
</pre>
  
 
+
; RESPONSE: Parámetros a Recibir
 
+
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
 
+
|-
====<font color="Blue">Tabla 11</font>====
+
! style="background:#f2f2f2; text-align:center;"|Tipo
{| class="wikitable" style="width: 100%;"
+
! style="background:#f2f2f2; text-align:center;"|Identificador
|+ Códigos de TypeCode
+
! style="background:#f2f2f2; text-align:center;"|Descripción
|- 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"
 
|- valign="center"
|1
 
|Representación Gráfica
 
 
|-
 
|-
|2
+
| -
|Anexo
+
|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
|Para uso futuro
+
|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]]
 
|-
 
|-
|4
+
|sizeFile
|Para uso futuro
+
|tamaño del documento
 
|-
 
|-
|5
+
|rowspan="6"|String
|Acuse de recibo de Factura Electrónica de Venta
+
|crc
 +
|Chequeo de Redundancia Cíclica
 
|-
 
|-
|6
+
|cufe
|Acuse Aceptación expresa
+
|Certificado Único de Facturación Electrónica.
 
|-
 
|-
|7
+
|displayname
|Acuse de Reclamo de la Factura Electrónica de Venta
+
|
 
|-
 
|-
|12
+
|extension
|Acuse de Recibo del bien y/o prestación del servicio
+
|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>===
  
===<font color="blue">Método DescargaAnexo</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.
  
Permite la descarga del Anexo o adjunto del documento que se encuentra vinculado al documento de factura. Que originalmente fue anexada al documento.
 
  
  
Línea 1619: 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
|De 6 a 20 dígitos
 
|-
 
|rowspan="5"|String
 
|identificadorinternoanexo
 
|Identificador del Anexo el cual debe de consultarse en el '''Método de ListaAnexo'''
 
 
|
 
|
 
|-
 
|-
|tipoIdentificacionemisor
+
|rowspan="7"|String
|Identificador del Emisor (Revisión de tabla 1 )
+
|archivo
|2 caracteres
+
|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
 +
|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 1643: Línea 1652:
 
|tokenPassword
 
|tokenPassword
 
|}
 
|}
 +
  
 
====<font color="Blue">Ejemplo de entrada</font>====
 
====<font color="Blue">Ejemplo de entrada</font>====
Línea 1649: Línea 1659:
 
     <soapenv:Header/>
 
     <soapenv:Header/>
 
     <soapenv:Body>
 
     <soapenv:Body>
         <tem:DescargarAnexo>
+
         <tem:EnviarRepGrafica>
 
             <tem:request>
 
             <tem:request>
                 <wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
+
                <wcf:TipoDocumento>91</wcf:TipoDocumento>
                 <wcf:identificadorInternoAnexo>32168992-0000-44C8-862D-F5E5EBC762DB</wcf:identificadorInternoAnexo>
+
                <wcf:archivo>JVB……FT0YK</wcf:archivo>
                 <wcf:numeroDocumento>LAS40588</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:DescargarAnexo>
+
         </tem:EnviarRepGrafica>
 
     </soapenv:Body>
 
     </soapenv:Body>
 
</soapenv:Envelope>
 
</soapenv:Envelope>
 +
 +
 +
</pre>
 +
 +
 +
 +
====<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>
 
</pre>
  
Línea 1673: Línea 1708:
 
|- valign="center"
 
|- valign="center"
 
|-
 
|-
| -
+
|Int
|archivo
 
|Archivo en Base 64 del documento
 
|-
 
|rowspan="4"|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)
 
|-
 
|-
|Id
+
|rowspan="2"|String
|Id del documento.
+
|mensaje
 +
|Mensaje descriptivo del resultado de la operación
 
|-
 
|-
|Type
+
|String
|Tipo de documento, (Ver catálogo)
+
|resultado, contiene información adicional (Procesado/Error)
|-
 
|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 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
  
  
====<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>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>
 
  
 
+
; REQUEST: Parámetros a Enviar
</pre>
+
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
 
 
 
 
 
 
====<font color="Blue">Tabla 12</font>====
 
{| class="wikitable" style="width: 100%;"
 
|+ Códigos de DescargaAnexo
 
|- 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">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.
 
 
 
 
 
 
 
; 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;"|Tipo
Línea 1778: Línea 1738:
 
|- valign="center"
 
|- valign="center"
 
|-
 
|-
|rowspan="2"|Int
+
|Int
|visible
+
|metadata
|Indica si el archivo posteriormente puede ser o no descargado por el Emisor
+
|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.
|Visible = 1, No visible = 0, 1 dígito
 
|-
 
|identificadorEmisor
 
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
 
 
|
 
|
 
|-
 
|-
|rowspan="7"|String
+
|rowspan="3"|String
 
|archivo
 
|archivo
 
|Archivo XML en Base64 que contiene el documento electrónico que se desea enviar
 
|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
 
|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
 
|Identificador del documento
 
|Hasta 20 caracteres
 
 
|-
 
|-
 
|tokenEmpresa
 
|tokenEmpresa
Línea 1821: Línea 1761:
 
     <soapenv:Header/>
 
     <soapenv:Header/>
 
     <soapenv:Body>
 
     <soapenv:Body>
         <tem:EnviarRepGrafica>
+
         <tem:EnviarXML>
 
             <tem:request>
 
             <tem:request>
                 <wcf:archivo>JVB……FT0YK</wcf:archivo>
+
                 <wcf:archivo>PD94b…………..bnQ+</wcf:archivo>
                 <wcf:extension>ppt</wcf:extension>
+
                 <wcf:metadata>
                <wcf:identificadorEmisor>45…34</wcf:identificadorEmisor>
+
                    <wcf:metadata>
                <wcf:nombre>SOAP01-2</wcf:nombre>
+
                        <wcf:Metadata>
                <wcf:numeroDocumento>SOAP019</wcf:numeroDocumento>
+
                            <wcf:code>01</wcf:code>
                <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
+
                            <wcf:internal1/>
                 <wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
+
<wcf:internal2/>
 +
                            <wcf:value/>
 +
                        </wcf:Metadata>
 +
                    </wcf:metadata>
 +
                </wcf:metadata>
 +
                 <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:EnviarRepGrafica>
+
         </tem:EnviarXML>
 
     </soapenv:Body>
 
     </soapenv:Body>
 
</soapenv:Envelope>
 
</soapenv:Envelope>
  
 +
</pre>
 +
 +
 +
 +
====<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>
 
</pre>
 
  
  
Línea 1850: Línea 1814:
 
|- valign="center"
 
|- valign="center"
 
|-
 
|-
|Int
+
| -
 +
|archivo
 +
|Archivo en Base 64 del documento
 +
|-
 +
|rowspan="3"|Int
 
|codigo
 
|codigo
|Código de retorno, (Ver catálogo de respuesta del método)
+
|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
 
|-
 
|-
|rowspan="2"|String
 
 
|mensaje
 
|mensaje
 
|Mensaje descriptivo del resultado de la operación
 
|Mensaje descriptivo del resultado de la operación
Línea 1864: Línea 1843:
  
  
 +
</pre>
  
====<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>
+
===<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.
 
 
 
 
====<font color="Blue">Tabla 2</font>====
 
{| Códigos de retorno de EnvioRepGrafica
 
|- 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">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
 
  
  
Línea 1921: Línea 1862:
 
|- valign="center"
 
|- valign="center"
 
|-
 
|-
|Int
+
| -
|metadata
+
|archivo
|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.
+
|Archivo en Base64 que representa un anexo de factura identificada por número de documento
 
|
 
|
 
|-
 
|-
|rowspan="3"|String
+
|Byte
|archivo
+
|Indica si el archivo posteriormente puede ser o no descargado por el Emisor.
|Archivo XML en Base64 que contiene el documento electrónico que se desea enviar
+
|Visible = 1, No visible = 0, 1 dígito
 +
|-
 +
|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
 +
|Hasta 20 caracteres
 
|-
 
|-
 
|tokenEmpresa
 
|tokenEmpresa
Línea 1944: Línea 1909:
 
     <soapenv:Header/>
 
     <soapenv:Header/>
 
     <soapenv:Body>
 
     <soapenv:Body>
         <tem:EnviarXML>
+
         <tem:EnviarAnexo>
 
             <tem:request>
 
             <tem:request>
                 <wcf:archivo>PD94b…………..bnQ+</wcf:archivo>
+
                 <wcf:archivo>JVB…….</wcf:archivo>
                 <wcf:metadata>
+
                 <wcf:extension>pdf</wcf:extension>
                    <wcf:metadata>
+
                <wcf:TipoDocumento>91</wcf:TipoDocumento>
                        <wcf:Metadata>
+
                <wcf:identificadorEmisor>456…34</wcf:identificadorEmisor>
                            <wcf:code>01</wcf:code>
+
                <wcf:nombre>AHJ07-7</wcf:nombre>
                            <wcf:internal1/>
+
                <wcf:numeroDocumento>AHJ07</wcf:numeroDocumento>
<wcf:internal2/>
+
                <wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
                            <wcf:value/>
 
                        </wcf:Metadata>
 
                    </wcf:metadata>
 
                </wcf:metadata>
 
 
                 <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:EnviarXML>
+
         </tem:EnviarAnexo>
 
     </soapenv:Body>
 
     </soapenv:Body>
 
</soapenv:Envelope>
 
</soapenv:Envelope>
 +
 +
  
 
</pre>
 
</pre>
Línea 1968: Línea 1932:
  
  
; RESPONSE: Parámetros a Recibir
+
====<font color="Blue">Ejemplo de salida</font>====
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
+
<pre>
|-
+
<?xml version="1.0" encoding="UTF-8"?>
! style="background:#f2f2f2; text-align:center;"|Tipo
+
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
! style="background:#f2f2f2; text-align:center;"|Identificador
+
    <s:Body>
! style="background:#f2f2f2; text-align:center;"|Descripción
+
        <EnviarAnexoResponse xmlns="http://tempuri.org/">
|- valign="center"
+
            <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>
 +
 
 +
</pre>
 +
 
 +
 
 +
; RESPONSE: Parámetros a Recibir
 +
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
 
|-
 
|-
| -
+
! style="background:#f2f2f2; text-align:center;"|Tipo
|archivo
+
! style="background:#f2f2f2; text-align:center;"|Identificador
|Archivo en Base 64 del documento
+
! style="background:#f2f2f2; text-align:center;"|Descripción
 +
|- valign="center"
 
|-
 
|-
|rowspan="3"|Int
+
|Int
 
|codigo
 
|codigo
|Código de retorno, (Ver catálogo de respuesta del método)
+
|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
+
|rowspan="2"|String
|Id del documento.
+
|mensaje
 +
|Mensaje descriptivo del resultado de la operación
 
|-
 
|-
|tipoIdentificacion
+
|String
|Tipo de identificación del documento
+
|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.
 +
; 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="4"|String
+
|rowspan="3"|Int
|Identificador del documento
+
|TipoDocumento
 +
|Es el tipo de documento que se va a manejar.
 +
|2 caracteres
 
|-
 
|-
|estatusDocumento
+
|identificadorEmisor
|Estatus del Documento
+
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
 +
|De 6 a 20 dígitos
 
|-
 
|-
|mensaje
+
|tipoIdentificacionemisor
|Mensaje descriptivo del resultado de la operación
+
|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
 
|-
 
|-
|String
+
|rowspan="3"|String
|resultado
+
|tokenEmpresa
|Contiene información adicional (Procesado/Error)
+
|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: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>
 +
 
 +
 +
 
 +
 
 +
</pre>
  
  
 
====<font color="Blue">Ejemplo de salida</font>====
 
====<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>
        <EnviarXMLResponse xmlns="http://tempuri.org/">
+
      <EliminarRepGraficaResponse xmlns="http://tempuri.org/">
            <EnviarXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
+
          <EliminarRepGraficaResponse xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                 <a:codigo>203</a:codigo>
+
                 <a:codigo>103</a:codigo>
                 <a:documentoId>AHJ07</a:documentoId>
+
                 <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:estatusDocumento>Cargado</a:estatusDocumento>
+
                 <a:resultado>Error</a:resultado>
                <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>
+
             </EliminarRepGraficaResult>
<a:numeroIdentificacion>45......34</a:numeroIdentificacion>
+
         </EliminarRepGraficaResponse>
                 <a:resultado>Procesado</a:resultado>
 
                <a:tipoIdentificacion>31</a:tipoIdentificacion>
 
             </EnviarXMLResult>
 
         </EnviarXMLResponse>
 
 
     </s:Body>
 
     </s:Body>
 
</s:Envelope>
 
</s:Envelope>
Línea 2027: Línea 2054:
  
  
 
+
; RESPONSE: Parámetros a Recibir
====<font color="Blue">Tabla 2</font>====
+
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
{| class="wikitable" style="width: 100%;"
+
|-
|+ Códigos de EnvioXML
+
! style="background:#f2f2f2; text-align:center;"|Código
|- valign="center"
+
! style="background:#f2f2f2; text-align:center;"|Descripción
|-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"
 
|- valign="center"
|200
+
|-
|Reporte Generado Satisfactoriamente
+
| 200
 +
| Representación Gráfica enviada satisfactoriamente
 
|-
 
|-
 
|102
 
|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}
+
|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
 
|103
 
|Error Interno en el Servicio
 
|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
===<font color="blue">Método Envío de Anexo (EnvioAnexo) </font>===
+
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
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;"
 
|-
 
 
! style="background:#f2f2f2; text-align:center;"|Tipo
 
! style="background:#f2f2f2; text-align:center;"|Tipo
 
! style="background:#f2f2f2; text-align:center;"|Identificador
 
! style="background:#f2f2f2; text-align:center;"|Identificador
Línea 2067: Línea 2084:
 
|- valign="center"
 
|- valign="center"
 
|-
 
|-
|  -
+
|rowspan="3"|Int
|archivo
+
|TipoDocumento
|Archivo en Base64 que representa  un anexo de factura identificada por número de documento
+
|Es el tipo de documento que se va a manejar.
|
 
|-
 
|Byte
 
|Indica si el archivo posteriormente puede ser o no descargado por el Emisor.
 
|Visible = 1, No visible = 0, 1 dígito
 
|-
 
|rowspan="2"|Int
 
|tipoidentificadoremisor
 
|Identificador del Emisor (Revisión de tabla 1 )
 
 
|2 caracteres
 
|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
 
|-
 
|-
|rowspan="5"|String
+
|tipoIdentificacionemisor
|nombre
+
|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]]
|Nombre del documento de la Representación Gráfica
+
|2 caracteres  
|Hasta 100 caracteres
 
 
|-
 
|-
|extension
+
|rowspan="3"|String
|Indica el formato del archivo remitido; los valores admitidos son
+
|tokenEmpresa
|png|bmp|jpg|pdf|doc|docx|xls|xlsx|ppt|pptx|rar|zip
+
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
 +
|rowspan="2"|40 caracteres
 
|-
 
|-
|numeroDocumento
+
|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="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;"
 +
|-
 +
! style="background:#f2f2f2; text-align:center;"|Identificador
 +
! style="background:#f2f2f2; text-align:center;"|Descripción
 +
|- 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="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
 
|Identificador del documento
|Hasta 20 caracteres
+
|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>
 +
 
 +
 
 +
 
 +
 
 +
 
  
  
====<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: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>
 
  
  
  
; 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
 
|codigo
 
|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)
 
|}
 
  
  
  
====<font color="Blue">Ejemplo de salida</font>====
 
<pre>
 
<?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>
 
  
</pre>
 
  
  
  
====<font color="Blue">Tabla 2</font>====
 
{| class="wikitable" style="width: 100%;"
 
|+ Códigos de retorno de EnvioRepGrafica
 
|- 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
 
|}
 
|}
 
  
 
'''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)
 
 
 
 
 
 
====<font color="Blue">Tabla 2</font>====
 
{| class="wikitable" style="width: 100%;"
 
|+ Código de tipo de Identidad  (tipoIdentificacionemisor)
 
|- valign="center"
 
|- 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 actual del 21:23 19 ene 2024

Sumario

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

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)