Documentação completa — todos os dados coletados pelos promotores exclusivos UISA
A API retorna todos os dados das visitas dos promotores exclusivos UISA (Itamarati), incluindo check-in, check-out, pesquisa de share, fotos de abastecimento, rupturas, datas críticas, estoque, preços, pontos extras e concorrência.
https://base44.app/api/apps/691c8b90f6d2322375e88c7f/functions/exportUisaVisitsAPIMétodo: GET — todos os parâmetros são opcionais e passados como query string.
datestring (YYYY-MM-DD)start_datestring (YYYY-MM-DD)end_datestring (YYYY-MM-DD)promoter_emailstringpromoter_idstringpromoter_namestringstore_codestringTodas as visitas de hoje:
https://base44.app/api/apps/691c8b90f6d2322375e88c7f/functions/exportUisaVisitsAPI?date=2026-06-25Visitas de um período:
https://base44.app/api/apps/691c8b90f6d2322375e88c7f/functions/exportUisaVisitsAPI?start_date=2026-06-01&end_date=2026-06-30Por ID do promotor:
https://base44.app/api/apps/691c8b90f6d2322375e88c7f/functions/exportUisaVisitsAPI?promoter_id=11342Por nome do promotor (busca parcial):
https://base44.app/api/apps/691c8b90f6d2322375e88c7f/functions/exportUisaVisitsAPI?promoter_name=nilsonPor loja específica:
https://base44.app/api/apps/691c8b90f6d2322375e88c7f/functions/exportUisaVisitsAPI?store_code=9569Combinação de filtros:
https://base44.app/api/apps/691c8b90f6d2322375e88c7f/functions/exportUisaVisitsAPI?start_date=2026-06-01&end_date=2026-06-30&promoter_id=11342A resposta é um JSON com a seguinte estrutura raiz:
{
"success": true,
"total_visits": 645,
"total_promoters": 20,
"filters_applied": { ... },
"data": [ ...array de visitas... ]
}visit_idstringvisit_datestring (YYYY-MM-DD)statusenumcheckin_timestring (ISO 8601)checkout_timestring (ISO 8601)promotor_idstringpromotor_cpfstringpromotor_namestringpromotor_emailstringstore_codestringstore_namestringstore_citystringstore_ufstringstore_redestringstore_cnpjstringstore_enderecostringloja_idstringcheckin.data_horastring (ISO 8601)checkin.latitudenumbercheckin.longitudenumbercheckin.fotosarrayfotos_abastecimento.pre_abastecimentoarrayfotos_abastecimento.abastecimentoarrayCada foto é um objeto com: url, tag_loja, tag_endereco, tag_data, tag_categoria, tag_promotor, e stamp_text (legenda formatada para impressão).
sku_eanstringsku_idstringsku_nomestringquantidadenumberumenumtipo_avariaenumdata_validadestring (date)indicio_em_outras_marcasbooleanobservacaostringurls_fotosarrayfotosarrayqtd_caixas_abertasnumberqtd_caixas_fechadasnumberfez_triagembooleanmotivo_triagemstringfoto_triagem_urlstringfoto_triagemobjectprodutos_abastecidosarrayobservacaostringsku_eanstringsku_idstringsku_nomestringquantidadenumberumenumdata_validadestring (date)lotestringretirado_da_gondolabooleanqual_providenciastringurls_fotosarrayfotosarraysku_eanstringsku_idstringsku_nomestringquantidadenumberumenumlotestringdata_validadestring (date)tipo_estoqueenumem_rupturabooleanmotivo_rupturastringobservacao_rupturastringfoto_ruptura_urlstringfoto_rupturaobjectsku_eanstringsku_idstringsku_nomestringtipo_pontoenummotivostringquantidadenumberdias_exposicaonumberdata_validadestring (date)material_utilizadoenumlocalizacaostringponto_mistobooleanurls_fotosarrayfotosarraysku_eanstringsku_idstringsku_nomestringpreco_varejonumberpreco_sugeridonumberem_promocaobooleandescricao_promocaostringdiferenca_pctnumberconformebooleanfoto_urlstringfotoobjectsku_eanstringsku_idstringsku_nomestringmotivo_rupturaenumobservacaostringurls_fotosarrayfotosarrayA pesquisa de share é dividida em 5 categorias: Açúcar Cristal, Refinado, Triturado, Demerara e Mascavo. Cada categoria contém as marcas encontradas na gôndola e suas frentes (espaços).
categoriastringtotal_frentesnumberfotos_gondolaarraymarcasarraymarcas[].marcastringmarcas[].frentesnumbermarcas[].share_pctnumberconcorrencia.tem_acao_concorrenciabooleanconcorrencia.tipos_acaoarrayconcorrencia.descricaostringconcorrencia.foto_urlstringconcorrencia.fotoobjectshare_completedboolean{
"visit_id": "6a3d3f5772f5eee59f0509fb",
"visit_date": "2026-06-25",
"status": "em_andamento",
"checkin_time": "2026-06-25T14:46:47.320Z",
"checkout_time": null,
"promotor_id": "11342",
"promotor_cpf": "70790302268",
"promotor_name": "NILSON PEREIRA LISBOA",
"promotor_email": "nilsonlisboa1278@gmail.com",
"store_code": "9569",
"store_name": "LJ 286 ATACADAO JAPIIM",
"store_city": "MANAUS",
"store_uf": "AM",
"store_rede": "",
"store_cnpj": "75315333028623",
"store_endereco": "AV RODRIGO OTAVIO, 900 - JAPIIM, MANAUS/AM",
"loja_id": "698b43d619f8290b2c4c9b2f",
"checkin": {
"data_hora": "2026-06-25T14:46:47.320Z",
"latitude": -3.1089078,
"longitude": -59.9818986,
"fotos": [{
"url": "https://base44.app/.../ stamped.jpg",
"tag_loja": "LJ 286 ATACADAO JAPIIM",
"tag_endereco": "AV RODRIGO OTAVIO, 900 - JAPIIM, MANAUS/AM",
"tag_data": "25/06/2026",
"tag_categoria": "Check-in",
"tag_promotor": "NILSON PEREIRA LISBOA",
"stamp_text": "LJ 286 ATACADAO JAPIIM\nAV RODRIGO OTAVIO, 900...\n25/06/2026 | Check-in\nPromotor: NILSON PEREIRA LISBOA"
}]
},
"fotos_abastecimento": {
"pre_abastecimento": [ ...fotos... ],
"abastecimento": [ ...fotos... ]
},
"avarias": [ ... ],
"caixas_abertas": [ ... ],
"datas_criticas": [ ... ],
"estoque": [ ... ],
"pontos_extras": [ ... ],
"precos_frente": [ ... ],
"rupturas": [ ... ],
"pesquisa_share": [
{
"categoria": "Açúcar Cristal",
"total_frentes": 20,
"fotos_gondola": [ ...fotos... ],
"marcas": [
{ "marca": "ITAMARATI", "frentes": 8, "share_pct": 40 },
{ "marca": "UNIÃO", "frentes": 5, "share_pct": 25 },
{ "marca": "CARAVELAS", "frentes": 7, "share_pct": 35 }
]
},
...
],
"concorrencia": {
"tem_acao_concorrencia": true,
"tipos_acao": ["Ponto Extra", "Degustação"],
"descricao": "Concorrente X montou display...",
"foto_url": "https://...",
"foto": { ...com tags... }
},
"share_completed": true
}exclusivo_uisa ou treinamento_uisa.promotor_id é o ID do promotor na API Icatu (campo promoter_id do AppUser). Se o promotor não tiver esse campo, usa o ID interno do banco como fallback.stamp_text com a legenda formatada para impressão.sku_id e sku_nome são enriquecidos a partir da entidade SKU, quando disponível.status = "em_andamento" não têm checkout_time (será null).