# API Auvo REST, sin estado, autenticación mediante Bearer JWT de 30 minutos. Límite de 400 solicitudes por minuto por IP. API pública de la plataforma Auvo Version: 2.0.0 License: Proprietary (Auvo) ## Servers Produção ``` https://api.auvo.com.br/v2 ``` Sandbox (proposed — not yet available) ``` https://sandbox.api.auvo.com.br/v2 ``` ## Security ### bearerAuth Obtenha um token chamando `POST /login`. O token expira em 30 minutos e deve ser renovado. Type: http Scheme: bearer Bearer Format: JWT ## Download OpenAPI description [API Auvo](https://developer.auvo.com.br/_bundle/@l10n/es/openapi/api-reference.yaml) ## Login Autenticación y emisión de tokens Bearer JWT. ### Autenticar mediante query parameters - [GET /login](https://developer.auvo.com.br/es/openapi/api-reference/login/retrieve-a-authentication-get.md): Autentica con apiKey y apiToken enviados como parámetros de consulta. Devuelve un accessToken válido por 30 minutos. ### Autenticar mediante body - [POST /login](https://developer.auvo.com.br/es/openapi/api-reference/login/retrieve-a-authentication-post.md): Autentica con apiKey y apiToken en el cuerpo de la solicitud. Es preferible a GET para evitar exponer credenciales en logs de URL. ## Usuarios Usuarios administradores y técnicos de la cuenta Auvo. ### Obtener usuario - [GET /users/{id}](https://developer.auvo.com.br/es/openapi/api-reference/usuarios/retrieve-a-user.md): Devuelve los detalles de un registro de usuarios identificado por su ID único. ### Editar usuario - [PATCH /users/{id}](https://developer.auvo.com.br/es/openapi/api-reference/usuarios/edit-a-user.md): Actualiza los campos editables de un registro existente de usuarios. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Eliminar usuario - [DELETE /users/{id}](https://developer.auvo.com.br/es/openapi/api-reference/usuarios/delete-a-user.md): Elimina la relación o el registro de usuarios de tu cuenta. Esta operación no se puede deshacer. ### Crear usuario - [POST /users](https://developer.auvo.com.br/es/openapi/api-reference/usuarios/add-a-new-user.md): Crea un registro de usuarios en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Crear o actualizar usuario - [PUT /users](https://developer.auvo.com.br/es/openapi/api-reference/usuarios/upsert-add-a-new-user-or-update-an-existing-one.md): Actualiza o reemplaza datos de usuarios usando el payload enviado en el cuerpo de la solicitud. ### Listar usuarios - [GET /users](https://developer.auvo.com.br/es/openapi/api-reference/usuarios/retrieve-a-list-of-users.md): Devuelve una lista paginada de usuarios registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Clientes Clientes registrados en la cuenta. ### Obtener cliente - [GET /customers/{id}](https://developer.auvo.com.br/es/openapi/api-reference/clientes/retrieve-a-customer.md): Devuelve los detalles de un registro de clientes identificado por su ID único. ### Editar cliente - [PATCH /customers/{id}](https://developer.auvo.com.br/es/openapi/api-reference/clientes/edit-a-customer.md): Actualiza los campos editables de un registro existente de clientes. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Eliminar cliente - [DELETE /customers/{id}](https://developer.auvo.com.br/es/openapi/api-reference/clientes/delete-a-customer.md): Elimina la relación o el registro de clientes de tu cuenta. Esta operación no se puede deshacer. ### Crear cliente - [POST /customers](https://developer.auvo.com.br/es/openapi/api-reference/clientes/add-a-new-customer.md): Crea un registro de clientes en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Crear o actualizar cliente - [PUT /customers](https://developer.auvo.com.br/es/openapi/api-reference/clientes/upsert-a-customer.md): Actualiza o reemplaza datos de clientes usando el payload enviado en el cuerpo de la solicitud. ### Listar clientes - [GET /customers](https://developer.auvo.com.br/es/openapi/api-reference/clientes/retrieve-a-list-of-customers.md): Devuelve una lista paginada de clientes registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ### Crear cliente completo - [POST /customers/complete](https://developer.auvo.com.br/es/openapi/api-reference/clientes/add-a-new-customer-complete.md): Crea un registro de clientes en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Crear o actualizar cliente completo - [PUT /customers/complete](https://developer.auvo.com.br/es/openapi/api-reference/clientes/upsert-a-customer-complete.md): Actualiza o reemplaza datos de clientes usando el payload enviado en el cuerpo de la solicitud. ### Actualizar customer attachments - [PUT /customers/{id}/attachments](https://developer.auvo.com.br/es/openapi/api-reference/clientes/update-customer-attachments.md): Actualiza o reemplaza datos de clientes usando el payload enviado en el cuerpo de la solicitud. ## Grupos de clientes Grupos de clientes usados para segmentar registros. ### Listar grupos de clientes - [GET /customergroups](https://developer.auvo.com.br/es/openapi/api-reference/grupos-de-clientes/retrieve-a-list-of-customer-groups.md): Devuelve una lista paginada de grupos de clientes registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ### Crear grupo de clientes - [POST /customergroups](https://developer.auvo.com.br/es/openapi/api-reference/grupos-de-clientes/add-a-new-customer-group.md): Crea un registro de grupos de clientes en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar clientes de un grupo de clientes - [GET /customergroups/{clientGroupId}/clients](https://developer.auvo.com.br/es/openapi/api-reference/grupos-de-clientes/retrieve-clients-of-a-customer-group.md): Devuelve una lista paginada de grupos de clientes registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ### Eliminar grupo de clientes - [DELETE /customergroups/{id}](https://developer.auvo.com.br/es/openapi/api-reference/grupos-de-clientes/delete-a-customer-group.md): Elimina la relación o el registro de grupos de clientes de tu cuenta. Esta operación no se puede deshacer. ## Productos Productos e ítems de inventario registrados en la cuenta. ### Obtener producto - [GET /products/{id}](https://developer.auvo.com.br/es/openapi/api-reference/productos/retrieve-a-product.md): Devuelve los detalles de un registro de productos identificado por su ID único. ### Editar producto - [PATCH /products/{id}](https://developer.auvo.com.br/es/openapi/api-reference/productos/edit-a-product.md): Actualiza los campos editables de un registro existente de productos. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Eliminar producto - [DELETE /products/{id}](https://developer.auvo.com.br/es/openapi/api-reference/productos/delete-a-product.md): Elimina la relación o el registro de productos de tu cuenta. Esta operación no se puede deshacer. ### Crear producto - [POST /products](https://developer.auvo.com.br/es/openapi/api-reference/productos/add-a-new-product.md): Crea un registro de productos en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Crear o actualizar producto - [PUT /products](https://developer.auvo.com.br/es/openapi/api-reference/productos/upsert-a-product.md): Actualiza o reemplaza datos de productos usando el payload enviado en el cuerpo de la solicitud. ### Listar productos - [GET /products](https://developer.auvo.com.br/es/openapi/api-reference/productos/retrieve-a-list-of-products.md): Devuelve una lista paginada de productos registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ### Actualizar product attachments - [PUT /products/{id}/attachments](https://developer.auvo.com.br/es/openapi/api-reference/productos/update-product-attachments.md): Actualiza o reemplaza datos de productos usando el payload enviado en el cuerpo de la solicitud. ### Actualizar stock de productos del colaborador - [PUT /products/employee-product-stock](https://developer.auvo.com.br/es/openapi/api-reference/productos/update-employee-product-stock.md): Actualiza o reemplaza datos de productos usando el payload enviado en el cuerpo de la solicitud. ## Categorías de productos Categorías usadas para organizar productos. ### Obtener categoría de producto - [GET /productcategories/{id}](https://developer.auvo.com.br/es/openapi/api-reference/categorias-de-productos/retrieve-a-product-category.md): Devuelve los detalles de un registro de categorías de producto identificado por su ID único. ### Editar categoría de producto - [PATCH /productcategories/{id}](https://developer.auvo.com.br/es/openapi/api-reference/categorias-de-productos/edit-a-product-category.md): Actualiza los campos editables de un registro existente de categorías de producto. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Eliminar categoría de producto - [DELETE /productcategories/{id}](https://developer.auvo.com.br/es/openapi/api-reference/categorias-de-productos/delete-a-product-category.md): Elimina la relación o el registro de categorías de producto de tu cuenta. Esta operación no se puede deshacer. ### Crear categoría de producto - [POST /productcategories](https://developer.auvo.com.br/es/openapi/api-reference/categorias-de-productos/add-a-new-product-category.md): Crea un registro de categorías de producto en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Crear o actualizar categoría de producto - [PUT /productcategories](https://developer.auvo.com.br/es/openapi/api-reference/categorias-de-productos/upsert-a-product-category.md): Actualiza o reemplaza datos de categorías de producto usando el payload enviado en el cuerpo de la solicitud. ### Listar categorías de producto - [GET /productcategories](https://developer.auvo.com.br/es/openapi/api-reference/categorias-de-productos/retrieve-a-list-of-product-categories.md): Devuelve una lista paginada de categorías de producto registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Servicios Servicios ofrecidos y consumidos por las operaciones de campo. ### Obtener servicio - [GET /services/{id}](https://developer.auvo.com.br/es/openapi/api-reference/servicios/retrieve-a-service.md): Devuelve los detalles de un registro de servicios identificado por su ID único. ### Editar servicio - [PATCH /services/{id}](https://developer.auvo.com.br/es/openapi/api-reference/servicios/edit-a-service.md): Actualiza los campos editables de un registro existente de servicios. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Eliminar servicio - [DELETE /services/{id}](https://developer.auvo.com.br/es/openapi/api-reference/servicios/delete-a-service.md): Elimina la relación o el registro de servicios de tu cuenta. Esta operación no se puede deshacer. ### Crear servicio - [POST /services](https://developer.auvo.com.br/es/openapi/api-reference/servicios/add-a-new-service.md): Crea un registro de servicios en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Crear o actualizar servicio - [PUT /services](https://developer.auvo.com.br/es/openapi/api-reference/servicios/upsert-a-service.md): Actualiza o reemplaza datos de servicios usando el payload enviado en el cuerpo de la solicitud. ### Listar servicios - [GET /services](https://developer.auvo.com.br/es/openapi/api-reference/servicios/retrieve-a-list-of-services.md): Devuelve una lista paginada de servicios registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ### Retrieve all Services (legacy) - [GET /services/obterListaServicos](https://developer.auvo.com.br/es/openapi/api-reference/servicios/retrieve-all-services-legacy.md): Devuelve los detalles de un registro de servicios identificado por su ID único. ## Equipos Equipos de clientes y registros relacionados. ### Obtener equipo - [GET /equipments/{id}](https://developer.auvo.com.br/es/openapi/api-reference/equipos/retrieve-an-equipment.md): Devuelve los detalles de un registro de equipos identificado por su ID único. ### Editar equipo - [PATCH /equipments/{id}](https://developer.auvo.com.br/es/openapi/api-reference/equipos/edit-an-equipment.md): Actualiza los campos editables de un registro existente de equipos. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Eliminar equipo - [DELETE /equipments/{id}](https://developer.auvo.com.br/es/openapi/api-reference/equipos/delete-an-equipment.md): Elimina la relación o el registro de equipos de tu cuenta. Esta operación no se puede deshacer. ### Crear equipo - [POST /equipments](https://developer.auvo.com.br/es/openapi/api-reference/equipos/add-a-new-equipment.md): Crea un registro de equipos en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Crear o actualizar equipo - [PUT /equipments](https://developer.auvo.com.br/es/openapi/api-reference/equipos/upsert-an-equipment.md): Actualiza o reemplaza datos de equipos usando el payload enviado en el cuerpo de la solicitud. ### Listar equipos - [GET /equipments](https://developer.auvo.com.br/es/openapi/api-reference/equipos/retrieve-a-list-of-equipments.md): Devuelve una lista paginada de equipos registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ### Actualizar equipment attachments - [PUT /equipments/{id}/attachments](https://developer.auvo.com.br/es/openapi/api-reference/equipos/update-equipment-attachments.md): Actualiza o reemplaza datos de equipos usando el payload enviado en el cuerpo de la solicitud. ## Categorías de equipos Categorías usadas para organizar equipos. ### Obtener categoría de equipo - [GET /equipmentcategories/{id}](https://developer.auvo.com.br/es/openapi/api-reference/categorias-de-equipos/retrieve-an-equipment-category.md): Devuelve los detalles de un registro de categorías de equipo identificado por su ID único. ### Editar categoría de equipo - [PATCH /equipmentcategories/{id}](https://developer.auvo.com.br/es/openapi/api-reference/categorias-de-equipos/edit-an-equipment-category.md): Actualiza los campos editables de un registro existente de categorías de equipo. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Eliminar categoría de equipo - [DELETE /equipmentcategories/{id}](https://developer.auvo.com.br/es/openapi/api-reference/categorias-de-equipos/delete-an-equipment-category.md): Elimina la relación o el registro de categorías de equipo de tu cuenta. Esta operación no se puede deshacer. ### Crear categoría de equipo - [POST /equipmentcategories](https://developer.auvo.com.br/es/openapi/api-reference/categorias-de-equipos/add-a-new-equipment-category.md): Crea un registro de categorías de equipo en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar categorías de equipo - [GET /equipmentcategories](https://developer.auvo.com.br/es/openapi/api-reference/categorias-de-equipos/retrieve-a-list-of-equipment-categories.md): Devuelve una lista paginada de categorías de equipo registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Palabras clave Palabras clave usadas para clasificar y buscar registros. ### Obtener palabra clave - [GET /keywords/{id}](https://developer.auvo.com.br/es/openapi/api-reference/palabras-clave/retrieve-a-keyword.md): Devuelve los detalles de un registro de palabras clave identificado por su ID único. ### Editar palabra clave - [PATCH /keywords/{id}](https://developer.auvo.com.br/es/openapi/api-reference/palabras-clave/edit-a-keyword.md): Actualiza los campos editables de un registro existente de palabras clave. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Eliminar palabra clave - [DELETE /keywords/{id}](https://developer.auvo.com.br/es/openapi/api-reference/palabras-clave/delete-a-keyword.md): Elimina la relación o el registro de palabras clave de tu cuenta. Esta operación no se puede deshacer. ### Crear palabra clave - [POST /keywords](https://developer.auvo.com.br/es/openapi/api-reference/palabras-clave/add-a-new-keyword.md): Crea un registro de palabras clave en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar palabras clave - [GET /keywords](https://developer.auvo.com.br/es/openapi/api-reference/palabras-clave/retrieve-a-list-of-keywords.md): Devuelve una lista paginada de palabras clave registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Tipos de tarea Configuración de tipos de tarea para flujos de campo. ### Obtener tipo de tarea - [GET /tasktypes/{id}](https://developer.auvo.com.br/es/openapi/api-reference/tipos-de-tarea/retrieve-a-task-type.md): Devuelve los detalles de un registro de tipos de tarea identificado por su ID único. ### Editar tipo de tarea - [PATCH /tasktypes/{id}](https://developer.auvo.com.br/es/openapi/api-reference/tipos-de-tarea/edit-a-task-type.md): Actualiza los campos editables de un registro existente de tipos de tarea. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Eliminar tipo de tarea - [DELETE /tasktypes/{id}](https://developer.auvo.com.br/es/openapi/api-reference/tipos-de-tarea/delete-a-task-type.md): Elimina la relación o el registro de tipos de tarea de tu cuenta. Esta operación no se puede deshacer. ### Crear tipo de tarea - [POST /tasktypes](https://developer.auvo.com.br/es/openapi/api-reference/tipos-de-tarea/add-a-new-task-type.md): Crea un registro de tipos de tarea en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar tipos de tarea - [GET /tasktypes](https://developer.auvo.com.br/es/openapi/api-reference/tipos-de-tarea/retrieve-a-list-of-task-types.md): Devuelve una lista paginada de tipos de tarea registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Equipos de trabajo Equipos y sus usuarios asignados. ### Obtener equipo - [GET /teams/{id}](https://developer.auvo.com.br/es/openapi/api-reference/equipos-de-trabajo/retrieve-a-team.md): Devuelve los detalles de un registro de equipos identificado por su ID único. ### Crear equipo - [POST /teams](https://developer.auvo.com.br/es/openapi/api-reference/equipos-de-trabajo/add-a-new-team.md): Crea un registro de equipos en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar equipos - [GET /teams](https://developer.auvo.com.br/es/openapi/api-reference/equipos-de-trabajo/retrieve-a-list-of-teams.md): Devuelve una lista paginada de equipos registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ### Retrieve Team Participants - [GET /teams/{teamId}/users](https://developer.auvo.com.br/es/openapi/api-reference/equipos-de-trabajo/retrieve-team-participants.md): Devuelve los detalles de un registro de equipos identificado por su ID único. ## Segmentos Segmentos de clientes y operación. ### Obtener segmento - [GET /segments/{id}](https://developer.auvo.com.br/es/openapi/api-reference/segmentos/retrieve-a-segment.md): Devuelve los detalles de un registro de segmentos identificado por su ID único. ### Editar segmento - [PATCH /segments/{id}](https://developer.auvo.com.br/es/openapi/api-reference/segmentos/edit-a-segment.md): Actualiza los campos editables de un registro existente de segmentos. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Eliminar segmento - [DELETE /segments/{id}](https://developer.auvo.com.br/es/openapi/api-reference/segmentos/delete-a-segment.md): Elimina la relación o el registro de segmentos de tu cuenta. Esta operación no se puede deshacer. ### Crear segmento - [POST /segments](https://developer.auvo.com.br/es/openapi/api-reference/segmentos/add-a-new-segment.md): Crea un registro de segmentos en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar segmentos - [GET /segments](https://developer.auvo.com.br/es/openapi/api-reference/segmentos/retrieve-a-list-of-segments.md): Devuelve una lista paginada de segmentos registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Tareas Órdenes de servicio, visitas y tareas de campo. ### Obtener tarea - [GET /tasks/{id}](https://developer.auvo.com.br/es/openapi/api-reference/tareas/retrieve-a-task.md): Devuelve los detalles de un registro de tareas identificado por su ID único. ### Editar tarea - [PATCH /tasks/{id}](https://developer.auvo.com.br/es/openapi/api-reference/tareas/edit-a-task.md): Actualiza los campos editables de un registro existente de tareas. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Eliminar tarea - [DELETE /tasks/{id}](https://developer.auvo.com.br/es/openapi/api-reference/tareas/delete-a-task.md): Elimina la relación o el registro de tareas de tu cuenta. Esta operación no se puede deshacer. ### Crear tarea - [POST /tasks](https://developer.auvo.com.br/es/openapi/api-reference/tareas/add-a-new-task.md): Crea un registro de tareas en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Crear o actualizar tarea - [PUT /tasks](https://developer.auvo.com.br/es/openapi/api-reference/tareas/upsert-add-a-new-task-or-update-an-existing-one.md): Actualiza o reemplaza datos de tareas usando el payload enviado en el cuerpo de la solicitud. ### Listar tareas - [GET /tasks](https://developer.auvo.com.br/es/openapi/api-reference/tareas/retrieve-a-list-of-tasks.md): Devuelve una lista paginada de tareas registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ### Crear o actualizar task attachments - [PUT /tasks/{id}/attachments](https://developer.auvo.com.br/es/openapi/api-reference/tareas/upsert-task-attachments.md): Actualiza o reemplaza datos de tareas usando el payload enviado en el cuerpo de la solicitud. ### Crear o actualizar task products - [PUT /tasks/{id}/products](https://developer.auvo.com.br/es/openapi/api-reference/tareas/upsert-task-products.md): Actualiza o reemplaza datos de tareas usando el payload enviado en el cuerpo de la solicitud. ### Delete Task Products - [DELETE /tasks/{id}/products](https://developer.auvo.com.br/es/openapi/api-reference/tareas/delete-task-products.md): Elimina la relación o el registro de tareas de tu cuenta. Esta operación no se puede deshacer. ### Crear o actualizar task services - [PUT /tasks/{id}/services](https://developer.auvo.com.br/es/openapi/api-reference/tareas/upsert-task-services.md): Actualiza o reemplaza datos de tareas usando el payload enviado en el cuerpo de la solicitud. ### Delete Task Services - [DELETE /tasks/{id}/services](https://developer.auvo.com.br/es/openapi/api-reference/tareas/delete-task-services.md): Elimina la relación o el registro de tareas de tu cuenta. Esta operación no se puede deshacer. ### Crear o actualizar task additional costs - [PUT /tasks/{id}/additional-costs](https://developer.auvo.com.br/es/openapi/api-reference/tareas/upsert-task-additional-costs.md): Actualiza o reemplaza datos de tareas usando el payload enviado en el cuerpo de la solicitud. ### Delete Task Additional Costs - [DELETE /tasks/{id}/additional-costs](https://developer.auvo.com.br/es/openapi/api-reference/tareas/delete-task-additional-costs.md): Elimina la relación o el registro de tareas de tu cuenta. Esta operación no se puede deshacer. ### Enviar respuestas de cuestionario de la tarea - [PUT /tasks/{id}/questionnaire-response](https://developer.auvo.com.br/es/openapi/api-reference/tareas/upsert-task-questionnaire-responses.md): Envía respuestas de cuestionario para una tarea. Las respuestas se envían en el array answers, con 1 a 100 elementos por solicitud. 202 significa que el lote fue validado y aceptado para procesamiento, no que las respuestas fueron guardadas. Cada respuesta se procesa de forma independiente; una respuesta que falle durante el procesamiento no afecta a las demás y no se informa de vuelta. Confirma el resultado consultando las respuestas del cuestionario de la tarea después del procesamiento. Si algún elemento es inválido, se rechaza toda la solicitud. La API devuelve solo el primer error de checklist o de pregunta encontrado. El checklistId debe existir en la cuenta y el questionId debe pertenecer al checklistId informado; de lo contrario, se devuelve 404. Los nombres de los campos deben enviarse en inglés, exactamente como están documentados (answers, itemId, checklistId, questionId, answer, equipmentId). Los campos con nombres en portugués no se reconocen y la solicitud se rechaza con un error de campo obligatorio ausente. ### Listar tareas eliminadas - [GET /tasks/GetDeletedTasks](https://developer.auvo.com.br/es/openapi/api-reference/tareas/retrieve-a-list-of-deleted-tasks.md): Devuelve una lista paginada de tareas registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Tickets Tickets de soporte y tipos de solicitud. ### Obtener ticket - [GET /tickets/{id}](https://developer.auvo.com.br/es/openapi/api-reference/tickets/retrieve-a-ticket.md): Devuelve los detalles de un registro de tickets identificado por su ID único. ### Editar ticket - [PATCH /tickets/{id}](https://developer.auvo.com.br/es/openapi/api-reference/tickets/edit-a-ticket.md): Actualiza los campos editables de un registro existente de tickets. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Crear ticket - [POST /tickets](https://developer.auvo.com.br/es/openapi/api-reference/tickets/add-a-new-ticket.md): Crea un registro de tickets en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar tickets - [GET /tickets](https://developer.auvo.com.br/es/openapi/api-reference/tickets/retrieve-a-list-of-tickets.md): Devuelve una lista paginada de tickets registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ### Retrieve Ticket Request Types - [GET /tickets/request-type](https://developer.auvo.com.br/es/openapi/api-reference/tickets/retrieve-ticket-request-types.md): Devuelve los detalles de un registro de tickets identificado por su ID único. ## Estados de ticket Configuración de estados de ticket. ### Listar estados de ticket activos - [GET /tickets/status](https://developer.auvo.com.br/es/openapi/api-reference/estados-de-ticket/retrieve-active-ticket-statuses.md): Devuelve una lista paginada de estados de ticket registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Cuestionarios Cuestionarios y respuestas recolectadas en campo. ### Obtener cuestionario - [GET /questionnaires/{id}](https://developer.auvo.com.br/es/openapi/api-reference/cuestionarios/retrieve-a-questionnaire.md): Devuelve los detalles de un registro de cuestionarios identificado por su ID único. ### Listar cuestionarios - [GET /questionnaires](https://developer.auvo.com.br/es/openapi/api-reference/cuestionarios/retrieve-a-list-of-questionnaires.md): Devuelve una lista paginada de cuestionarios registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## GPS Posiciones GPS capturadas por usuarios de campo. ### Listar posiciones GPS - [GET /gps](https://developer.auvo.com.br/es/openapi/api-reference/gps/retrieve-a-list-of-gps-positions.md): Devuelve una lista paginada de gps registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Órdenes de servicio Órdenes de servicio y trabajos operativos. ### Obtener orden de servicio - [GET /serviceorders/{code}](https://developer.auvo.com.br/es/openapi/api-reference/ordenes-de-servicio/retrieve-a-service-order.md): Devuelve los detalles de un registro de órdenes de servicio identificado por su ID único. ### Editar orden de servicio - [PATCH /serviceorders/{code}](https://developer.auvo.com.br/es/openapi/api-reference/ordenes-de-servicio/edit-a-service-order.md): Actualiza los campos editables de un registro existente de órdenes de servicio. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Crear orden de servicio - [POST /serviceorders](https://developer.auvo.com.br/es/openapi/api-reference/ordenes-de-servicio/add-a-new-service-order.md): Crea un registro de órdenes de servicio en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar órdenes de servicio - [GET /serviceorders](https://developer.auvo.com.br/es/openapi/api-reference/ordenes-de-servicio/retrieve-a-list-of-service-orders.md): Devuelve una lista paginada de órdenes de servicio registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Gastos Gastos registrados por usuarios. ### Obtener gasto - [GET /expenses/{id}](https://developer.auvo.com.br/es/openapi/api-reference/gastos/retrieve-an-expense.md): Devuelve los detalles de un registro de gastos identificado por su ID único. ### Editar gasto - [PATCH /expenses/{id}](https://developer.auvo.com.br/es/openapi/api-reference/gastos/edit-an-expense.md): Actualiza los campos editables de un registro existente de gastos. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Eliminar gasto - [DELETE /expenses/{id}](https://developer.auvo.com.br/es/openapi/api-reference/gastos/delete-an-expense.md): Elimina la relación o el registro de gastos de tu cuenta. Esta operación no se puede deshacer. ### Crear gasto - [POST /expenses](https://developer.auvo.com.br/es/openapi/api-reference/gastos/add-a-new-expense.md): Crea un registro de gastos en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar gastos - [GET /expenses](https://developer.auvo.com.br/es/openapi/api-reference/gastos/retrieve-a-list-of-expenses.md): Devuelve una lista paginada de gastos registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ### Actualizar expense attachments - [PUT /expenses/{id}/attachments](https://developer.auvo.com.br/es/openapi/api-reference/gastos/update-expense-attachments.md): Actualiza o reemplaza datos de gastos usando el payload enviado en el cuerpo de la solicitud. ## Tipos de gasto Configuración de tipos de gasto. ### Obtener tipo de gasto - [GET /expensetypes/{id}](https://developer.auvo.com.br/es/openapi/api-reference/tipos-de-gasto/retrieve-an-expense-type.md): Devuelve los detalles de un registro de tipos de gasto identificado por su ID único. ### Editar tipo de gasto - [PATCH /expensetypes/{id}](https://developer.auvo.com.br/es/openapi/api-reference/tipos-de-gasto/edit-an-expense-type.md): Actualiza los campos editables de un registro existente de tipos de gasto. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Eliminar tipo de gasto - [DELETE /expensetypes/{id}](https://developer.auvo.com.br/es/openapi/api-reference/tipos-de-gasto/delete-an-expense-type.md): Elimina la relación o el registro de tipos de gasto de tu cuenta. Esta operación no se puede deshacer. ### Crear tipo de gasto - [POST /expensetypes](https://developer.auvo.com.br/es/openapi/api-reference/tipos-de-gasto/add-a-new-expense-type.md): Crea un registro de tipos de gasto en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar tipos de gasto - [GET /expensetypes](https://developer.auvo.com.br/es/openapi/api-reference/tipos-de-gasto/retrieve-a-list-of-expense-types.md): Devuelve una lista paginada de tipos de gasto registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Costos adicionales Costos adicionales vinculados a tareas, presupuestos y flujos financieros. ### Listar costos adicionales - [GET /additionalcosts](https://developer.auvo.com.br/es/openapi/api-reference/costos-adicionales/retrieve-a-list-of-additional-costs.md): Devuelve una lista paginada de costos adicionales registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ### Crear costo adicional - [POST /additionalcosts](https://developer.auvo.com.br/es/openapi/api-reference/costos-adicionales/add-a-new-additional-cost.md): Crea un registro de costos adicionales en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Actualizar costo adicional - [PUT /additionalcosts/{id}](https://developer.auvo.com.br/es/openapi/api-reference/costos-adicionales/update-an-additional-cost.md): Actualiza o reemplaza datos de costos adicionales usando el payload enviado en el cuerpo de la solicitud. ## Facturas Facturas y registros de cobranza. ### Obtener factura - [GET /invoices/{id}](https://developer.auvo.com.br/es/openapi/api-reference/facturas/retrieve-an-invoice.md): Devuelve los detalles de un registro de facturas identificado por su ID único. ### Actualizar factura - [PUT /invoices/{id}](https://developer.auvo.com.br/es/openapi/api-reference/facturas/update-an-invoice.md): Actualiza o reemplaza datos de facturas usando el payload enviado en el cuerpo de la solicitud. ### Crear factura - [POST /invoices](https://developer.auvo.com.br/es/openapi/api-reference/facturas/add-a-new-invoice.md): Crea un registro de facturas en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar facturas - [GET /invoices](https://developer.auvo.com.br/es/openapi/api-reference/facturas/retrieve-a-list-of-invoices.md): Devuelve una lista paginada de facturas registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Presupuestos Presupuestos comerciales y sus ítems. ### Obtener presupuesto - [GET /quotations/{id}](https://developer.auvo.com.br/es/openapi/api-reference/presupuestos/retrieve-a-quotation.md): Devuelve los detalles de un registro de presupuestos identificado por su ID único. ### Editar presupuesto - [PATCH /quotations/{id}](https://developer.auvo.com.br/es/openapi/api-reference/presupuestos/edit-a-quotation.md): Actualiza los campos editables de un registro existente de presupuestos. Solo se modifican las propiedades presentes en el cuerpo de la solicitud. ### Crear presupuesto - [POST /quotations](https://developer.auvo.com.br/es/openapi/api-reference/presupuestos/add-a-new-quotation.md): Crea un registro de presupuestos en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar presupuestos - [GET /quotations](https://developer.auvo.com.br/es/openapi/api-reference/presupuestos/retrieve-a-list-of-quotations.md): Devuelve una lista paginada de presupuestos registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ### Agregar servicio a presupuesto - [POST /quotations/{id}/services/{idService}](https://developer.auvo.com.br/es/openapi/api-reference/presupuestos/add-service-to-quotation.md): Crea un registro de presupuestos en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Actualizar servicio en presupuesto - [PUT /quotations/{id}/services/{idService}](https://developer.auvo.com.br/es/openapi/api-reference/presupuestos/update-service-in-quotation.md): Actualiza o reemplaza datos de presupuestos usando el payload enviado en el cuerpo de la solicitud. ### Eliminar servicio de presupuesto - [DELETE /quotations/{id}/services/{idService}](https://developer.auvo.com.br/es/openapi/api-reference/presupuestos/delete-service-from-quotation.md): Elimina la relación o el registro de presupuestos de tu cuenta. Esta operación no se puede deshacer. ### Agregar producto a presupuesto - [POST /quotations/{id}/products](https://developer.auvo.com.br/es/openapi/api-reference/presupuestos/add-product-to-quotation.md): Crea un registro de presupuestos en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Actualizar producto en presupuesto - [PUT /quotations/{id}/products/{idProduct}](https://developer.auvo.com.br/es/openapi/api-reference/presupuestos/update-product-in-quotation.md): Actualiza o reemplaza datos de presupuestos usando el payload enviado en el cuerpo de la solicitud. ### Eliminar producto de presupuesto - [DELETE /quotations/{id}/products/{idProduct}](https://developer.auvo.com.br/es/openapi/api-reference/presupuestos/delete-product-from-quotation.md): Elimina la relación o el registro de presupuestos de tu cuenta. Esta operación no se puede deshacer. ### Crear o actualizar costo adicional en presupuesto - [PUT /quotations/{id}/adicost](https://developer.auvo.com.br/es/openapi/api-reference/presupuestos/upsert-additional-cost-in-quotation.md): Actualiza o reemplaza datos de presupuestos usando el payload enviado en el cuerpo de la solicitud. ### Eliminar costo adicional de presupuesto - [DELETE /quotations/{id}/adicost](https://developer.auvo.com.br/es/openapi/api-reference/presupuestos/delete-additional-cost-from-quotation.md): Elimina la relación o el registro de presupuestos de tu cuenta. Esta operación no se puede deshacer. ## Cuentas por cobrar Cuentas por cobrar. ### Obtener cuenta por cobrar - [GET /receivables/{id}](https://developer.auvo.com.br/es/openapi/api-reference/cuentas-por-cobrar/retrieve-a-receivable.md): Devuelve los detalles de un registro de cuentas por cobrar identificado por su ID único. ### Actualizar cuenta por cobrar - [PUT /receivables/{id}](https://developer.auvo.com.br/es/openapi/api-reference/cuentas-por-cobrar/update-a-receivable.md): Actualiza o reemplaza datos de cuentas por cobrar usando el payload enviado en el cuerpo de la solicitud. ### Crear cuenta por cobrar - [POST /receivables](https://developer.auvo.com.br/es/openapi/api-reference/cuentas-por-cobrar/add-a-new-receivable.md): Crea un registro de cuentas por cobrar en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar cuentas por cobrar - [GET /receivables](https://developer.auvo.com.br/es/openapi/api-reference/cuentas-por-cobrar/retrieve-a-list-of-receivables.md): Devuelve una lista paginada de cuentas por cobrar registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Categorías financieras Categorías financieras usadas en registros de cobranza. ### Listar categorías financieras - [GET /financialcategories](https://developer.auvo.com.br/es/openapi/api-reference/categorias-financieras/retrieve-a-list-of-financial-categories.md): Devuelve una lista paginada de categorías financieras registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Métodos de pago Métodos de pago configurados en la cuenta. ### Listar métodos de pago - [GET /paymentmethods](https://developer.auvo.com.br/es/openapi/api-reference/metodos-de-pago/retrieve-a-list-of-payment-methods.md): Devuelve una lista paginada de métodos de pago registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## Encuestas de satisfacción Respuestas de encuestas de satisfacción. ### Listar respuestas de encuestas de satisfacción - [GET /satisfactionsurveys](https://developer.auvo.com.br/es/openapi/api-reference/encuestas-de-satisfaccion/retrieve-a-list-of-satisfaction-survey-responses.md): Devuelve una lista paginada de satisfaction surveys registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados. ## WebHooks Registro y gestión de suscripciones de Webhooks. ### Obtener webhook - [GET /webhooks/{id}](https://developer.auvo.com.br/es/openapi/api-reference/webhooks/retrieve-a-web-hook.md): Devuelve los detalles de un registro de webhooks identificado por su ID único. ### Eliminar webhook - [DELETE /webhooks/{id}](https://developer.auvo.com.br/es/openapi/api-reference/webhooks/delete-a-web-hook.md): Elimina la relación o el registro de webhooks de tu cuenta. Esta operación no se puede deshacer. ### Crear webhook - [POST /webhooks](https://developer.auvo.com.br/es/openapi/api-reference/webhooks/add-a-new-web-hook.md): Crea un registro de webhooks en tu cuenta usando los datos enviados en el cuerpo de la solicitud. ### Listar webhooks - [GET /webhooks](https://developer.auvo.com.br/es/openapi/api-reference/webhooks/retrieve-a-list-of-web-hooks.md): Devuelve una lista paginada de webhooks registrados en tu cuenta. Usa los parámetros de consulta para filtrar, ordenar y paginar resultados.