> For the complete documentation index, see [llms.txt](https://doc.sysdevmobile.com/mss-extensibility/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.sysdevmobile.com/mss-extensibility/mss-5.1/myteam/monitors-tab.md). # Monitors Tab Exemplos práticos de payloads para a extensibilidade de tabs nos **Monitores de Vendas** (MVND) e **Encomendas** (MENC). ### Contexto Quando o utilizador está num ecrã de monitor e clica num tab personalizado, o myTeam envia um POST ao URL configurado com os filtros de período atualmente selecionados no monitor. Ambos os monitores (vendas e encomendas) utilizam a **mesma estrutura de filtros**. *** ### Payload - Monitor de Vendas (MVND) ```json { "authentication": { "user": "admin", "hash": "a1b2c3d4e5f6..." }, "filter": { "currentStartDate": "20260101", "currentEndDate": "20260331", "previousStartDate": "20250101", "previousEndDate": "20250331", "relativeData": "order" } } ``` ### Payload - Monitor de Encomendas (MENC) ```json { "authentication": { "user": "admin", "hash": "a1b2c3d4e5f6..." }, "filter": { "currentStartDate": "20260401", "currentEndDate": "20260630", "previousStartDate": "20250401", "previousEndDate": "20250630", "relativeData": "deliver" } } ``` ### Campos do Filtro

Campo	Tipo	Formato	Descrição
`currentStartDate`	string	`yyyyMMdd`	Data início do período atual selecionado no monitor
`currentEndDate`	string	`yyyyMMdd`	Data fim do período atual selecionado no monitor
`previousStartDate`	string	`yyyyMMdd`	Data início do período anterior (para comparação)
`previousEndDate`	string	`yyyyMMdd`	Data fim do período anterior (para comparação)
`relativeData`	string	—	Tipo de data relativa: `"order"` (encomenda) ou `"deliver"` (entrega)

### Exemplo de resposta O serviço externo deve devolver uma página HTML completa. Exemplo de um resumo de vendas: ```html

Resumo de Vendas — Q1 2026

€ 125.430

Período Atual

€ 98.200

Período Anterior

+27,7%

Variação

Cliente	Atual	Anterior	Var.
Empresa A	€ 45.000	€ 38.000	+18,4%
Empresa B	€ 32.500	€ 29.100	+11,7%
Empresa C	€ 28.200	€ 21.600	+30,6%

``` *** ### Fluxo ``` Utilizador está no Monitor de Vendas (período Q1 2026 vs Q1 2025) │ ▼ Clica no tab personalizado │ ▼ myTeam envia POST ao URL configurado │ payload: { authentication: {...}, filter: { currentStartDate: "20260101", ... } } ▼ Serviço externo valida autenticação │ ▼ Consulta dados de vendas para os períodos recebidos │ ▼ Devolve HTML com resumo/gráficos (status 200) │ ▼ Conteúdo apresentado no iframe do tab ``` {% hint style="info" %} O campo `relativeData` indica se os dados devem ser filtrados pela data de encomenda (`"order"`) ou pela data de entrega (`"deliver"`). Este valor reflete a seleção do utilizador no monitor.Quando o utilizador altera os filtros de período no monitor, o tab **não é recarregado automaticamente**. O tab é carregado quando o utilizador clica nele. {% 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://doc.sysdevmobile.com/mss-extensibility/mss-5.1/myteam/monitors-tab.md?ask=&goal= ``` `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.