Diferencia entre revisiones de «Métodos servicio adjuntos web soap - Indice Manual Integración Directa»
(→Método “CargarAdjuntos”) |
|||
| Línea 3: | Línea 3: | ||
===Método “CargarAdjuntos”=== | ===Método “CargarAdjuntos”=== | ||
Permite adjuntar o enviar archivos (anexos) por email durante la emisión del documento electrónico. Este método se ejecuta después de consumir el método '''Enviar''' con el parámetro adjuntos en “1” o en “11”. A continuación, se presenta el flujo del método: | Permite adjuntar o enviar archivos (anexos) por email durante la emisión del documento electrónico. Este método se ejecuta después de consumir el método '''Enviar''' con el parámetro adjuntos en “1” o en “11”. A continuación, se presenta el flujo del método: | ||
| + | |||
| + | [[Archivo:Diagrama de Envio de adjuntos.png|sinmarco|centro|Diagrama de Envío de adjuntos]] | ||
'''@IMPORTANTE:''' El método '''CargarAdjuntos''' recibe entre sus parámetros un campo para indicar el envío del correo, es decir, si el campo o propiedad '''enviar''' recibe un “0” entonces el documento sigue a la espera por más adjuntos y si recibe “1” se realiza el envío con los adjuntos que se hayan cargado hasta ese momento. | '''@IMPORTANTE:''' El método '''CargarAdjuntos''' recibe entre sus parámetros un campo para indicar el envío del correo, es decir, si el campo o propiedad '''enviar''' recibe un “0” entonces el documento sigue a la espera por más adjuntos y si recibe “1” se realiza el envío con los adjuntos que se hayan cargado hasta ese momento. | ||
| Línea 84: | Línea 86: | ||
|} | |} | ||
{{clear}} | {{clear}} | ||
| + | |||
===Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)=== | ===Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)=== | ||
Para el caso en que el emisor contrate un servicio de representación gráfica con la casa de software, o desarrollador, encargado de realizar los ajustes correspondientes en el software contable o ERP para la emisión de documentos electrónicos, se deben tener en cuenta los siguientes aspectos: | Para el caso en que el emisor contrate un servicio de representación gráfica con la casa de software, o desarrollador, encargado de realizar los ajustes correspondientes en el software contable o ERP para la emisión de documentos electrónicos, se deben tener en cuenta los siguientes aspectos: | ||
Revisión del 20:59 22 jul 2020
Métodos servicio adjuntos web soap
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 (en KB) de los mismos).
Método “CargarAdjuntos”
Permite adjuntar o enviar archivos (anexos) por email durante la emisión del documento electrónico. Este método se ejecuta después de consumir el método Enviar con el parámetro adjuntos en “1” o en “11”. A continuación, se presenta el flujo del método:
@IMPORTANTE: El método CargarAdjuntos recibe entre sus parámetros un campo para indicar el envío del correo, es decir, si el campo o propiedad enviar recibe un “0” entonces el documento sigue a la espera por más adjuntos y si recibe “1” se realiza el envío con los adjuntos que se hayan cargado hasta ese momento.
- REQUEST
- Parámetros a Enviar
| Tipo | Identificador | Descripción |
|---|---|---|
| String | tokenEmpresa | Suministrado por The Factory HKA Colombia |
| tokenPassword | ||
| Adjunto | Adjunto | Datos de control del documento que se desea adjuntar |
Donde Class.Adjunto contiene la siguiente información:
| Tipo | Identificador | Descripción |
|---|---|---|
| byte[] | Archivo | Arreglo de bytes del archivo que se desea adjuntar |
| Array <string> | Correo al cual se desea enviar el XML (AttachedDocument) con todos los adjuntos cargados hasta el momento (se activa envío cuando enviar es “1”) | |
| String | Enviar |
|
| String | Formato | Extensión del archivo adjunto, formatos permitidos:
|
| String | Nombre | Nombre que tomará el archivo adjunto |
| String | numeroDocumento | Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212” |
| String | Tipo | "2" Tipo de documento anexo o adjuntos |
- REQUEST
- Parámetros a Recibir
| Tipo | Identificador | Descripción |
|---|---|---|
| int | Código | Indica el Estado de la operación retornado por el servicio |
| String | Mensaje | Este mensaje de identificación de errores |
| Array <String> | mensajesValidacion | Mensajes de validación en caso de rechazo |
| String | resultado | Resultado |
Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)
Para el caso en que el emisor contrate un servicio de representación gráfica con la casa de software, o desarrollador, encargado de realizar los ajustes correspondientes en el software contable o ERP para la emisión de documentos electrónicos, se deben tener en cuenta los siguientes aspectos:
- The Factory HKA es responsable de la generación del UBL y su transmisión a la DIAN.
- Una vez se compruebe la correcta validación y generación del UBL la casa de software puede proceder a generar una representación gráfica que debe cumplir con:
- Los elementos de ley exigidos por la DIAN: inclusión del código QR y de la cadena del CUFE ó CUDE en los documentos, según corresponda.
- Los elementos de ley exigidos por cualquier entidad supervisora al emisor de los documentos.
- Los elementos visuales y de representación de marca exigidos por el propio cliente: logos, información bancaria, leyendas referentes a las responsabilidades tributarias del emisor, etc.
- La Casa de Software, en este escenario, asume la responsabilidad junto con el propio contribuyente de cualquier incidente de fraude por evasión, malinterpretación, error u omisión de información relevante y obligatoria por parte de la normativa.
- TFHKA no resguarda esta representación en sus sistemas y deja claro que su participación como proveedor tecnológico se limita a la generación del UBL y su validación ante la DIAN.
