ÍNDICE

  1. Visión general
  2. Ejemplo de utilización
  3. Pantalla XXX
    1. Otras acciones / Acciones relacionadas
  4. Pantalla XXX
    1. Principales campos y controles
  5. Tablas


01. VISIÓN GENERAL

El Servicio Adjuntos Web SOAP, expone un único método que se utilizará 'n' veces por documento electrónico generado, donde 'n' es la cantidad de archivos adjuntos que tenga la factura electrónica que se está procesando. Tener en cuenta que al ser un correo en donde se envía la factura con su representación gráfica y los adjuntos, entonces existe un límite de adjuntos basándose en el peso de los mismos. El peso máximo de los documentos no deben superar los 1.8 MB.


Para esta funcionalidad se habilitaron dos opciones en la rutina de Transmitir Factura Electrónica (MATA486), las opciones son las siguientes:



La configuración definida en el parámetro MV_CONFADJ aplica para todos los documentos. Si se tiene la necesidad de condicionar el envío de adjuntos, se tiene la funcionalidad del punto de entrada M486PEADJU, para permitir modificar el atributo 'Adjuntos'. El valor asignado con el punto de entrada tiene prioridad sobre el valor del parámetro. Para mayor información, consultar la sección Información relacionada.


Existen dos opciones para el envío de los documentos adjuntos:

  1. Inmediatamente después de hacer la transmisión del documento para la aprobación de la DIAN. Los documentos adjuntos deben estar asociados antes de hacer la transmisión.
  2. Si el documento fue transmitido y aprobado por la DIAN, pero no contaba con los adjuntos, estos deberán ser enviados a través de Otras Acciones >> Enviar adjuntos.

En ambas opciones, si los documentos adjuntos fueron enviados y procesados sin errores, no será posible enviar más adjuntos.


Adicionalmente, se habilitaron dos nuevos estatus para los documentos; en ambos, el documento ya fue aprobado por la DIAN.

Nota: Para los documentos con estatus "Autorizado con adjuntos" no es posible adicionar más adjuntos.


Las URL del servicio de homologación y producción son las siguientes:

URL Homologación: https://demoemision21v4.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsdl
URL Producción: https://emision21v4.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsdl


Para utilizar esta funcionalidad, deberá contar con la configuración para la facturación electrónica de Colombia.


02. EJEMPLO DE UTILIZACIÓN

  1. Confirmar la actualización del diccionario de datos. Para mayor información, consultar la sección de DICCIONARIO DE DATOS.
  2. Realizar la configuración para la facturación electrónica de Colombia. Para mayor información de la configuración, consultar la sección INFORMACIÓN RELACIONADA.
  3. Configurar los siguientes parámetros:
    1. MV_CONFADJ = 1
    2. MV_WSADJUN = URL del servicio adjuntos
    3. MV_EMAILRE = Email para la recepción de documentos electrónicos, para el proceso de documento soporte y notas de ajuste.
  4. Para cada uno de clientes, deberá configurar los siguientes campos para la recepción de correos electrónicos. Si el campo Email Receb (AI0_RECE) tiene información, no es considerado el campo E-mail (A1_EMAIL). 
    1. Email Receb (AI0_RECE)
    2. E-mail (A1_EMAIL).
  5. Para los proveedores que son emitidos documentos de soporte y notas de ajuste, deberá configurar el siguiente campo para la recepción de correos electrónicos. Si el campo de E-mail no tiene información, se utiliza la cuenta de correo informada en el parámetro MV_EMAILRE.
    1. E-mail (A2_EMAIL). 
  1. Ingresar a la rutina de Transmitir Factura Electrónica (MATA486).
  2. Verificar que en "Otras Acciones" se tiene la opción de "Conocimiento".
  3. Seleccionar algún documento que tenga estatus diferente a "Documento Autorizado", posteriormente dar clic en la opción de "Conocimiento".
  4. En la ventana de "Vínculo - Banco de Conocimiento", en Otras Acciones, seleccionar "Conocim.".
    1. Dar clic en "Incluir".
      1. Informar la descripción y palabra claves.
      2. En "Otras Acciones" dar clic en "Selecciona Objeto".
      3. Seleccionar el documento que será adjuntado/anexado al documento fiscal. 
      4. Después de seleccionar el archivo, dar clic en "Abrir".
      5. Dar clic en "Confirmar".
    2. Confirmar que el registro fue incluido con éxito.
    3. Salir de la opción "Conocim".
  5. En la ventana "Vínculo - Banco de Conocimiento", editar el campo "Cod. Objeto". 
    1. Abrir la consulta del campo "Cod. Objeto".
    2. Seleccionar el registro del archivo previamente cargado en el banco de conocimiento.
  6. Dar clic en "Grabar".


A continuación se muestra un ejemplo del documento seleccionado en el banco de conocimiento. Este documento será enviado como adjunto.


Para mayor información relacionada al banco de conocimiento, consultar la sección Información relacionada.

  1. A través de la rutina de Facturación (Actualizaciones | Facturación), incluir una factura.
  2. Ingresar a la rutina de Transmitir Factura Electrónica.
  3. Seleccionar el documento que fue registrado previamente.
    1. La factura está con estatus "No transmitida".
  4. En el menú Otras Acciones, seleccionar la opción "Conocimiento". 
    1. Seleccionar el documento que se desea enviar como adjunto.
  5. Dar clic en "Grabar".
  6. Dar clic en la opción de "Transmitir".
    1. Informar los parámetros:
      1. ¿Serie de la factura?
      2. ¿Factura Inicial?
      3. ¿Factura Final?
    2. Confirmar que la factura se transmitió con éxito.
      1. Puede visualizar el log, esto es opcional.
    3. Después de completar el proceso de transmisión y si el documento fue validado y aceptado por la DIAN, se realiza en automático el envío de los adjuntos.
      1. Visualizar el log de procesamiento de los documentos adjuntos (opcional).
        1. Los documentos que son procesados correctamente tienen código 200-Procesado. 
  7. Confirmar que el finalizar el documento se encuentre con estatus "Autorizado con adjuntos".
  8. La DIAN enviará por correo electrónico el xml y la representación gráfica de la factura e incluirá los documentos enviados como adjuntos.  El correo electrónico será enviado a la cuenta de correo definida en las configuraciones previas.


Ejemplo del log de procesamiento de los documentos adjuntos.


Ejemplo del documento autorizado con adjuntos.

  1. A través de la rutina de Facturación (Actualizaciones | Facturación), incluir una factura.
  2. Ingresar a la rutina de Transmitir Factura Electrónica.
  3. Seleccionar el documento que fue registrado previamente.
    1. La factura está con estatus "No transmitida".
  4. Dar clic en la opción de "Transmitir".
    1. Informar los parámetros:
      1. ¿Serie de la factura?
      2. ¿Factura inicial?
      3. ¿Factura final?
    2. Confirmar que la factura se transmitió con éxito.
      1. Puede visualizar el log, esto es opcional.
  5. Al finalizar el proceso de transmisión, el documento quedará con estatus "Autorizado y pendiente de adjuntos".
  6. Seleccionar el documento que fue transmitido previamente.
  7. En el menú Otras Acciones, seleccionar la opción "Conocimiento". 
    1. Seleccionar el documento que se desea enviar como adjunto.
  8. Dar clic en "Grabar".
  9. En el menú Otras Acciones, seleccionar la opción "Enviar Adjuntos".
    1. Informar los parámetros:
      1. ¿Serie de documentos?
      2. ¿Documento inicial?
      3. ¿Documento final?
    2. Dar clic en "OK", para realizar el envío de los adjuntos.
    3. Visualizar el log de procesamiento de los documentos adjuntos (opcional).
      1. Los documentos que son procesados correctamente tienen código 200-Procesado. 
  10. Confirmar que el finalizar el documento se encuentre con estatus "Autorizado con adjuntos".
  11. La DIAN enviará por correo electrónico el xml y la representación gráfica de la factura e incluirá los documentos enviados como adjuntos.  El correo electrónico será enviado a la cuenta de correo definida en las configuraciones previas.


Ejemplo de los parámetros de la opción "Enviar adjuntos".


Ejemplo del log de procesamiento de los documentos adjuntos.


Ejemplo del documento autorizado con adjuntos.




03. DICCIONARIO DE DATOS

ParámetroTipoContenidoDescripción
MV_CONFADJC1Define si admite adjuntos en la facturación electrónica. Los valores permitidos son: 0-No admite; 1-Admite adjuntos.
MV_WSADJUNChttps://demoemision21v4.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsdlURL de servicio de adjuntos.
OrdenPreguntaTipoTamañoValidaciónConsulta
01¿Serie de documento?Carácter3
SERNF
02¿Documento inicial?Carácter13

03¿Documento final?Carácter13!Empty(MV_PAR03) .And. MV_PAR02<=MV_PAR03
TablaCampoLista de opcionesValidación
SF1F1_FLFTEX0=No Enviado,1=Enviado a TSS,4=Esperando procesamiento,5=Rechazado,6=Autorizado,7=Pendiente Adjuntos,8=Autoriz. C/AdjuntoPertence("0145678") .Or. Vazio()
SF2F2_FLFTEX0=No Enviado;1=Enviado a TSS;4=Esperando procesamiento;5=Rechazado;6=Autorizado,7=Pendiente Adjuntos,8=Autoriz. C/AdjuntoPertence("0145678") .Or. Vazio()

04. PANTALLA XXXXX

Principales campos y controles

CampoDescripción
IIncluya el campoIncluya la descripción relacionada
Incluya el campoIncluya la descripción relacionada
Incluya el campoIncluya la descripción relacionada



05. TABLAS UTILIZADAS