# 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: 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://kb.stoque.com.br/zeev/integracoes/como-criar-integracoes/controle-e-tratamento-de-erros.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.