> 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 MSS 5.1 - Extensibility - myTeam - 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
CampoTipoFormatoDescrição
currentStartDatestringyyyyMMddData início do período atual selecionado no monitor
currentEndDatestringyyyyMMddData fim do período atual selecionado no monitor
previousStartDatestringyyyyMMddData início do período anterior (para comparação)
previousEndDatestringyyyyMMddData fim do período anterior (para comparação)
relativeDatastring—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
ClienteAtualAnteriorVar.
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 %}