Este servicio REST permite crear un token de autenticación para ser utilizado en las solicitudes posteriores a la API. El token generado es del tipo JWT (JSON Web Token) y tendrá una vigencia de 12 horas.
El servicio espera los siguientes parámetros en formato JSON en el cuerpo de la solicitud: correo_electronico_registrado
Si la solicitud es exitosa, el servicio responderá con un código de estado 200 OK y un token JWT en el cuerpo de la respuesta:
El servicio puede responder con los siguientes códigos de estado y mensajes de error:
El servicio requiere autenticación básica para acceder. Las credenciales de autenticación deben enviarse en el cuerpo de la peticion con el formato text/plain. Por ejemplo, para el usuario "mi_correo@worldoffice.com.co", sería:
Una vez se genera el token se debe incluir en el encabezado de cada petición de los servicio para tener una conexión exitosa, se debe anteponer el prefijo “WO” de la siguiente forma “WO Token“:
En caso que no se envié el sistema le retornara un 401 Unauthorized
Es factible crear un token mediante la interfaz gráfica dentro de la aplicación en la nube. Esto se puede lograr siguiendo los pasos que detallo a continuación: accede al menú desplegable (también conocido como "menú hamburguesa") y selecciona la opción "Configuración", posteriormente navega hacia "Configuración General".
Como se muestra en la siguiente guía visual:
Dentro de la sección "Configuración", elige la opción "API". Aquí encontrarás un token disponible, acompañado de la fecha límite hasta la cual estará vigente para los servicios de comunicación. Observa esta información en la imagen.
Si haces clic sobre el token, este se copiará automáticamente al portapapeles, listo para ser utilizado. Puedes visualizar este proceso en la imagen.
No dudes en contactarnos si necesitas más asistencia o aclaraciones respecto a este procedimiento. Estamos aquí para ayudarte.
Para los servicios de compras y ventas, se requiere incluir el parámetro "documentoTipo", el cual debe obtenerse del servicio "Listar tipos de documentos". Si, por ejemplo, el proceso en curso es una Compra y el parámetro indicado es "FV", se generará este mensaje de error, y se debe cambiar el parámetro por un tipo de documento válido para compras.
El ID de la empresa ingresada no está registrado en el sistema. Por favor, verifique el ID de la empresa o regístrela correctamente antes de continuar.
El tercero ingresado no se encuentra registrado en el sistema. Asegúrese de que el tercero sea válido y esté registrado antes de continuar con la operación.
La dirección del tercero externo no se encuentra registrada. Verifique la dirección proporcionada o asegúrese de que el tercero externo esté registrado con la dirección correcta.
La forma de pago ingresada no se encuentra registrada en el sistema. Por favor, elija una forma de pago válida o regístrela antes de continuar con la transacción.
La moneda especificada no está registrada en el sistema. Asegúrese de utilizar una moneda válida o regístrela adecuadamente antes de proceder.
El prefijo ingresado no se encuentra registrado. Verifique el prefijo proporcionado o asegúrese de que esté registrado en el sistema.
La unidad de inventario no está registrada en el sistema. Por favor, asegúrese de utilizar una unidad válida o regístrela antes de continuar.
El centro de costo no está registrado. Verifique el centro de costo proporcionado o regístrelo adecuadamente antes de proseguir.
La unidad de inventario no está registrada en el sistema. Por favor, asegúrese de utilizar una unidad válida o regístrela antes de continuar.
No se encuentra registrado uno de los ID de inventarios proporcionados. Verifique los ID de inventarios o asegúrese de que estén correctamente registrados.
Debe ingresar un motivo de devolución válido. Asegúrese de especificar un motivo de devolución que esté registrado en el sistema antes de proceder.
La clasificación ingresada no está registrada. Verifique la clasificación proporcionada o asegúrese de que esté registrada correctamente.
Para el proceso de eliminar varios registros, el límite es de 5 registros por petición. Si envía más registros, recibirá esta respuesta. Asegúrese de enviar un número adecuado de registros para el proceso de eliminación.
Este error se produce cuando se encuentra registrado un documento con el mismo número que se está ajustando, y además, los campos prefijo, idEmpresa y documentoTipo coinciden. Por favor, verifique los datos para evitar duplicados en el sistema.
La fecha ingresada es incorrecta. Por favor, verifique la fecha y asegúrese de proporcionarla en el formato correcto antes de continuar.
Esta respuesta indica que no se encontró ningún registro que coincida con la consulta realizada. Verifique los parámetros de búsqueda o asegúrese de que la compra exista en el sistema.
La compra no ha sido actualizada correctamente. Para obtener más detalles sobre el error, revise el campo "moreInfo" de la respuesta, donde se proporcionará una descripción detallada del problema encontrado durante la actualización.
La cuenta contable especificada no ha sido encontrada en el sistema. Por favor, verifique el número de cuenta contable o asegúrese de que esté registrada correctamente antes de continuar. Si la cuenta contable es requerida para una operación específica, asegúrese de proporcionar un número de cuenta válido y existente en el sistema.
Se ha producido un error de negocio durante la consulta. Revise el campo "moreInfo" para obtener más información sobre el error específico y tome las acciones necesarias para corregirlo.
La cuenta contable especificada no está registrada en el sistema. Asegúrese de utilizar una cuenta contable válida o regístrela adecuadamente antes de continuar.
El código ingresado ya ha sido registrado previamente en el sistema. Por favor, utilice un código único o verifique el registro existente correspondiente.
El nombre ingresado ya ha sido registrado previamente en el sistema. Utilice un nombre único o verifique el registro existente asociado.
El grupo de cuenta contable no ha sido ingresado. Asegúrese de especificar el grupo de cuenta contable correspondiente para completar el registro.
No es posible borrar la cuenta, ya que está vinculada a otros elementos o registros en el sistema. Para eliminar la cuenta, primero es necesario eliminar todas las referencias vinculadas a ella. Verifique las relaciones y proceda con la eliminación adecuada.
Alguno de los detalles no se registró correctamente. Asegúrate de proporcionar los detalles de manera precisa y completa para que puedan ser registrados sin problemas.
La venta no ha sido actualizada. Para obtener más detalles sobre el error, consulta el campo "moreInfo" de la respuesta, donde encontrarás una descripción detallada del problema que ocurrió durante la actualización.
No se actualizaron todos los detalles del documento. Verifica que todos los detalles estén correctamente ingresados y actualizados para evitar este error.
El documento buscado no pudo ser encontrado en el sistema. Verifica los parámetros de búsqueda o asegúrate de que el documento esté registrado correctamente.
Se ha producido un error en el proceso de facturación electrónica. Por favor, revisa los detalles de la facturación y asegúrate de resolver el problema antes de continuar.
Debes realizar primero el proceso de contabilización antes de proceder con la facturación electrónica. La contabilización es un paso necesario para garantizar la integridad de la información contable.
Este documento no puede ser facturado electrónicamente. Verifica si el tipo de documento es elegible para la facturación electrónica y asegúrate de cumplir con los requisitos necesarios.
La unidad de inventario especificada no está registrada en el sistema. Asegúrate de utilizar una unidad válida y registrada antes de continuar con la operación.
El inventario buscado no pudo ser encontrado en el sistema. Verifica los parámetros de búsqueda o asegúrate de que el inventario esté registrado correctamente.
El ID de la unidad de medida ingresada no está registrada en el sistema. Asegúrate de utilizar un ID de unidad de medida válido y registrado antes de continuar.
El ID de la clasificación de inventario no está registrado en el sistema. Verifica el ID de clasificación proporcionado o asegúrate de que esté registrado correctamente.
El ID del tipo de impuesto de venta del inventario no se encuentra registrado. Asegúrate de utilizar un ID válido y registrado para el tipo de impuesto de venta antes de continuar.
El ID de contabilización no se encuentra registrado en el sistema. Asegúrate de utilizar un ID de contabilización válido y registrado antes de continuar.
No es posible eliminar el producto, ya que está relacionado en diferentes documentos. Antes de intentar eliminarlo, verifica las relaciones y elimina cualquier vínculo asociado.
Supera la cantidad máxima de caracteres permitidos para el campo de código. Asegúrate de que el código cumpla con las restricciones de longitud establecidas.
No es posible cambiar la unidad de medida, ya que el inventario ha sido utilizado en documentos anteriores. La unidad de medida no puede modificarse si el inventario ya ha sido utilizado en transacciones previas.
El tercero buscado no pudo ser encontrado en el sistema. Verifica los parámetros de búsqueda o asegúrate de que el tercero esté registrado correctamente.
No es posible eliminar el tercero, ya que está vinculado a otros elementos o registros en el sistema. Si deseas eliminar este tercero, primero debes eliminar todas las referencias o vínculos asociados. Verifica las relaciones y procede con la eliminación adecuada.
Puedes contactarnos creando un ticket en el centro de servicios de World Office Cloud. Nuestro equipo estará encantado de ayudarte con tus inquietudes relacionadas con la API.