# Integração Audaces   Idea

idea

## GET /audaces/idea/api/version

> Obtem versão da api audaces

```json
{"openapi":"3.0.1","info":{"title":"Integração Idea - Audaces","version":"1.0"},"tags":[{"name":"Integração Audaces - Idea","description":"idea"}],"servers":[{"url":"https://localhost/audaces/v10"},{"url":"http://localhost/audaces/v10"}],"paths":{"/audaces/idea/api/version":{"get":{"tags":["Integração Audaces - Idea"],"summary":"Obtem versão da api audaces","operationId":"ObterVersao","parameters":[{"name":"api_key","in":"query","description":"Token de acesso","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"integer"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Too Many Requests","content":{}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}},"components":{"schemas":{"Erro":{"type":"object","properties":{"mensagem":{"type":"string","description":"Mensagem de erro"}}}}}}
```

## POST /audaces/idea/api/v1/user/login

> Valida usuário e senha e retorna token de acesso. Utilizado especificamente para integração com Audaces - Idea

```json
{"openapi":"3.0.1","info":{"title":"Integração Idea - Audaces","version":"1.0"},"tags":[{"name":"Integração Audaces - Idea","description":"idea"}],"servers":[{"url":"https://localhost/audaces/v10"},{"url":"http://localhost/audaces/v10"}],"paths":{"/audaces/idea/api/v1/user/login":{"post":{"tags":["Integração Audaces - Idea"],"summary":"Valida usuário e senha e retorna token de acesso. Utilizado especificamente para integração com Audaces - Idea","operationId":"AutenticarUsuario","parameters":[{"name":"api_key","in":"query","description":"Token de acesso","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"required":["password","username"],"type":"object","properties":{"username":{"type":"string","description":"Nome do usuário"},"password":{"type":"string","description":"Senha do usuário"}}}},"application/json":{"schema":{"required":["password","username"],"type":"object","properties":{"username":{"type":"string","description":"Nome do usuário"},"password":{"type":"string","description":"Senha do usuário"}}}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/login"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Too Many Requests","content":{}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}},"components":{"schemas":{"login":{"type":"object","properties":{"access_token":{"type":"string","description":"Token de acesso"},"expires_in":{"type":"string","description":"Tempo para expiração do token de acesso"},"token_type":{"type":"string","description":"Tipo do tokend de acesso"}}},"Erro":{"type":"object","properties":{"mensagem":{"type":"string","description":"Mensagem de erro"}}}}}}
```

## GET /audaces/idea/api/v1/query

> Retorna objetos variados de consultas, ver documentação Audaces.

```json
{"openapi":"3.0.1","info":{"title":"Integração Idea - Audaces","version":"1.0"},"tags":[{"name":"Integração Audaces - Idea","description":"idea"}],"servers":[{"url":"https://localhost/audaces/v10"},{"url":"http://localhost/audaces/v10"}],"security":[{"csw_auth":[]}],"components":{"securitySchemes":{"csw_auth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"Erro":{"type":"object","properties":{"mensagem":{"type":"string","description":"Mensagem de erro"}}}}},"paths":{"/audaces/idea/api/v1/query":{"get":{"tags":["Integração Audaces - Idea"],"summary":"Retorna objetos variados de consultas, ver documentação Audaces.","operationId":"ConsultarDadosIdea","parameters":[{"name":"type","in":"query","description":"Tipo","schema":{"type":"string"}},{"name":"uid","in":"query","description":"Código único do objeto a ser buscado (prefixo-código)","schema":{"type":"string"}},{"name":"reference","in":"query","description":"Código da referência","schema":{"type":"string"}},{"name":"sector","in":"query","description":"Setor","schema":{"type":"string"}},{"name":"machine","in":"query","description":"Máquina","schema":{"type":"string"}},{"name":"description","in":"query","description":"Descrição","schema":{"type":"string"}},{"name":"collection","in":"query","description":"Coleção","schema":{"type":"string"}},{"name":"product_group","in":"query","description":"Grupo de produto do material","schema":{"type":"string"}},{"name":"supplier","in":"query","description":"Fornecedor","schema":{"type":"string"}}],"responses":{"200":{"description":"OK. Obtjeto de retorno dinâmico de acordo com parâmetros da requesição.","content":{}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Too Many Requests","content":{}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}}}
```

## POST /audaces/idea/api/v1/garment

> Cadastra nova engenharia.

```json
{"openapi":"3.0.1","info":{"title":"Integração Idea - Audaces","version":"1.0"},"tags":[{"name":"Integração Audaces - Idea","description":"idea"}],"servers":[{"url":"https://localhost/audaces/v10"},{"url":"http://localhost/audaces/v10"}],"security":[{"csw_auth":[]}],"components":{"securitySchemes":{"csw_auth":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"EngenhariaPut":{"type":"object","properties":{"filename":{"type":"string","description":"Nome do arquivo"},"revision":{"type":"string","description":"Tipo"},"author":{"type":"string","description":"Autor"},"responsible":{"type":"string","description":"Responsável"},"last_modified":{"type":"string","description":"Última modificação"},"collection":{"type":"string","description":"Coleção"},"name":{"type":"string","description":"Nome"},"variants":{"type":"array","description":"Variantes","items":{"$ref":"#/components/schemas/Variante"}}}},"Variante":{"type":"object","properties":{"name":{"type":"string","description":"Nome"},"description":{"type":"string","description":"Descrição"},"label":{"type":"string","description":"Label - Nome apresentado na tela do IDEA da variante"},"size":{"type":"string","description":"Tamanho"},"value":{"type":"number","description":"Valor"},"amount":{"type":"number","description":"Quantidade"},"composition":{"type":"string","description":"Composição"},"color":{"$ref":"#/components/schemas/Cor"},"items":{"type":"array","description":"objetos variados pelo tipo 'type', como material e fase","items":{"type":"object","properties":{}}},"custom_fields":{"type":"array","description":"objetos de campos customizados no Idea","items":{"type":"object","properties":{}}}},"description":"Variante"},"Cor":{"type":"object","properties":{"uid":{"type":"string","description":"Identificador único da cor"},"rgb":{"type":"string","description":"RGB da cor"},"value":{"type":"string","description":"Valor"}},"description":"Cor"},"Engenharia":{"type":"object","properties":{"type":{"type":"string","description":"Tipo"},"uid":{"type":"string","description":"Identificador únido da engenharia"},"name":{"type":"string","description":"Nome"},"reference":{"type":"string","description":"Referência"},"description":{"type":"string","description":"Descrição"},"collection":{"type":"string","description":"Coleção"},"product_group":{"type":"string","description":"Grupo de produto"},"notes":{"type":"string","description":"Notas - Narrativa da engenharia"},"value":{"type":"number","description":"Valor"},"variants":{"type":"array","description":"Variantes da engenharia","items":{"$ref":"#/components/schemas/Variante"}},"items":{"type":"array","description":"objetos variados pelo tipo 'type', como material e fase","items":{"type":"object","properties":{}}},"custom_fields":{"type":"array","description":"objetos de campos customizados no Idea","items":{"type":"object","properties":{}}}},"description":"Engenharia"},"Erro":{"type":"object","properties":{"mensagem":{"type":"string","description":"Mensagem de erro"}}}}},"paths":{"/audaces/idea/api/v1/garment":{"post":{"tags":["Integração Audaces - Idea"],"summary":"Cadastra nova engenharia.","operationId":"CadastrarEngenharia","parameters":[{"name":"uid","in":"query","description":"Código do produto para atualização","schema":{"type":"string"}}],"requestBody":{"description":"Dados da engenharia","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EngenhariaPut"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Engenharia"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"Too Many Requests","content":{}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.consistem.com.br/consistem-api/consistem-erp-api/industrial/integracao-idea-audaces-v1.0/integracao-audaces-idea.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.