Este servicio web te permite subir archivos directamente desde tu propia aplicación a tu administración en Yuki. Este servicio web funciona a través de HTTP POST.
Los archivos pueden ser publicados uno por uno con el tipo de contenido 'multipart/form-data' en 'application/x-www-form-urlencoded'.
Para simplificar el proceso de desarrollo puedes encontrar a continuación un par de enlaces con aplicaciones ejemplares que pueden ayudarte con este método de servicio web.
Dirección web
El servicio web, la aplicación de prueba, la descripción de los campos y los procedimientos se encuentran en la siguiente dirección web:
https://api.yukiworks.es/docs/Upload.aspx
Autentificación
Contables con portal
Los contables con un portal pueden autenticarse por medio de la llave de acceso al servicio web. Esta llave puede ser creada en el portal.
Los usuarios
Los usuarios pueden autenticarse por medio de la WebserviceAccessKey o con un nombre de usuario y una contraseña.
Respuesta de estado
Este servicio web ofrece dos opciones para responder al resultado de la acción POST:
Con un mensaje XML (método de respuesta por defecto)
El mensaje XML puede ser leído en la respuesta de este servicio web. Incluye el estado de la carga y las posibles notificaciones de validación.
Con una redirección
Con esta opción puedes introducir una dirección web que determina la redirección dependiendo de si la subida tiene éxito o no.
Parámetros
Dominio
El nombre del dominio al que quiere enviar sus documentos.
Nombre de usuario
El nombre de usuario con el que tienes acceso a tu dominio en Yuki. Este parámetro es obligatorio en caso de que no se utilice una WebServiceAccessKey como autenticación.
WebServiceAccessKey
La WebServiceAccessKey puede ser creada en el dominio o portal. Este código de acceso puede otorgar al servicio web un acceso a nivel de administración o de dominio. Para obtener más información sobre el código de acceso, consulte el artículo Código de acceso al servicio web (WebserviceAccessKey).
Administración
La identificación de la administración a la que quieres subir el documento. Para más información sobre el ID de la administración, por favor consulta el artículo ID de la administración.
Carpeta
La carpeta en la que quieres archivar el documento. El valor por defecto de este parámetro es '7' (carpeta que será manejada por Yuki). Las opciones posibles son:
del ID del pedido
Pedido ID Descripción
0 | Otro |
1 | Compra |
2 | Ventas |
3 | Banco |
4 | Recursos Humanos |
5 | Impuestos |
6 | Seguros |
7 | To be handled by Yuki |
8 | Otro finanzas |
100 | To be filed by me |
101 | Correspondencia |
102 | Reuniones |
Tabulador de la carpeta
La pestaña de la carpeta en la que quieres archivar el documento. El valor por defecto de este parámetro está en blanco.
ID del Projecto
La identificación de un proyecto con el que se quiere vincular el documento. La implementación de este parámetro hace que el parámetro "ProjectCode" sea irrelevante. Yuki Proyectos tiene que estar habilitado de antemano en el contrato.
Código del proyecto
El código del proyecto con el que quiere vincular el documento. Este parámetro sólo se utiliza si no se da el parámetro "ProjectID". Yuki Proyectos tiene que estar habilitado de antemano en el contrato.
Archivo
El documento que debe ser presentado
Tipo de respuesta
Este parámetro determina la forma en que el servicio web responde al resultado de la acción POST.
Para XML: el resultado de la acción POST se sobrescribirá en el formato XML del navegador.
Para Redirect: Se llevará a cabo una redirección después de la acción POST.
El valor por defecto de este parámetro es 'XML'.
RedirectUrlSuccess
Este parámetro (cadena) sólo es obligatorio en combinación con ResponseType 'Redirect' y determina la URL para la redirección si se completa la subida. Por lo tanto, un parámetro extra DocumentID= se agrega a la URL con como valor el ID (GUID) del documento archivado en Yuki.
RedirectUrlFailed
Este parámetro (cadena) sólo es obligatorio en combinación con ResponseType 'Redirect' y determina la URL para la redirección si la subida es fallida. Por lo tanto, un parámetro extra DocumentID= se agrega a la URL con como valor el ID (GUID) del documento archivado en Yuki.