> For the complete documentation index, see [llms.txt](https://kb.stoque.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.stoque.com.br/zeev/integracoes/como-criar-integracoes/controle-e-tratamento-de-erros.md).

# Controle e tratamento de erros

## Controle de erros

Ao realizar uma integração é necessário considerar as situações onde o outro sistema dá algum tipo de retorno em caso de erro na operação. Isso pode ocorrer por alguma validação que o outro sistema execute e precise, por exemplo, apresentar alguma mensagem de erro.

Quando o sistema externo retorna um código HTTP de erro então a máquina de execução de processos entende que ocorreu um erro na comunicação. Para que a mensagem de erro técnica possa ser identificada é necessário definir um identificador de nodo de erro.

Caso, além da mensagem técnica, a integração retorne uma mensagem amigável, então o nodo de identificação da mesma deve ser preenchido. Isso fará com que essa mensagem seja apresentada ao usuário da integração, isto é, uma mensagem amigável ao invés da mensagem técnica.

Tanto o identificador do nodo de erro quanto o de erro amigável devem ser preenchidos da mesma forma como demonstrado no item "Mapemento".

{% hint style="info" %}
Parte desses erros são sinalizados **em tempo real** na [Central de Alertas](/zeev/integracoes/como-criar-integracoes/central-de-alertas.md) do módulo de integrações.
{% endhint %}

## Limite de tempo de execução

O tempo de execução do teste de uma integração ou a execução em um aplicativo é medido. Isso é necessário para manter a boa performance do produto como um todo.

{% hint style="danger" %}
O tempo máximo de execução de uma integração é de 10 segundos. Esse limite é aplicado tanto para a operação de teste da integração quanto da execução através de campos de formulário ou tarefa de serviço. Caso este tempo seja excedido, o sistema apresentará mensagem de erro indicando tempo excedido e encerrará o processamento do aplicativo.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://kb.stoque.com.br/zeev/integracoes/como-criar-integracoes/controle-e-tratamento-de-erros.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.