API da VTEX: como tirar pedido, faturamento e cancelamento sem o número divergir
O List orders da VTEX para em 30 páginas e só vê pedido indexado. Faturado, cancelado e devolvido moram em campos diferentes do OMS.
Blog técnico da Precisian — AI-powered data integrity
O List orders da VTEX para em 30 páginas e só vê pedido indexado. Faturado, cancelado e devolvido moram em campos diferentes do OMS.
O /orders do Mercado Livre traz a comissão em sale_fee, mas o frete do vendedor exige /shipments/{id}/costs e a devolução vive em outro recurso.
O gateway MCP centraliza autenticação, log e limite de chamadas dos agentes. Ele não decide o que a métrica significa: isso fica na camada semântica.
O gclid é o ID do clique no Google Ads. Chega na URL, vive num cookie do seu domínio e só volta ao Google se for guardado junto com o pedido.
O MCP do BigQuery dá ao agente 9 ferramentas, SQL em tabela crua e 3.000 linhas por resposta. Não traz teto de bytes por consulta nem definição de métrica.
Data lake guarda o dado no formato em que a fonte entrega e aplica o esquema só na leitura. No e-commerce, ele guarda o histórico que as APIs apagam.
MCP é o protocolo aberto que descreve ferramentas para um modelo de IA. Ele não substitui a API: muda quem decide a chamada, o desenvolvedor ou o modelo.
UTM são parâmetros na URL que dizem ao GA4 de onde veio a visita. O GA4 diferencia maiúsculas: facebook e Facebook viram duas origens no relatório.
O Windsor.ai leva dado de mídia à planilha e ao Claude a partir de US$ 19/mês. A Precisian guarda, define e opera o dado do varejo médio.
O MCP Inspector prova que o servidor fala o protocolo, não que a resposta está certa. Roteiro com cópia anonimizada, gabarito, escopo e custo.
Ranking de 13 CDPs e da Precisian por sete critérios de dado. Nenhum dos 13 declara métrica versionada aprovada pelo cliente; ativação é deles.
Oito consultorias e agências de dados de marketing e uma plataforma operada, comparadas em sete critérios públicos para o e-commerce brasileiro.
18 ferramentas de analytics e atribuição para e-commerce comparadas em sete critérios: isolamento do dado, métrica versionada, MCP, VTEX e propriedade.
Ranking de 10 ferramentas de ETL e da Precisian por sete critérios. Das nove estrangeiras, nenhuma listava conector de VTEX em 26/10/2026.
Ranking de 15 ferramentas de análise de dados com IA pelos critérios C1 a C7. Dez das 14 concorrentes exigem um data warehouse já montado.
Ranking de 10 plataformas de dados para e-commerce brasileiro por sete critérios. Cinco têm MCP; nenhuma declara métrica versionada aprovada pelo cliente.
A Biglink vende painel com agente de IA próprio a partir de R$ 399,99/mês. A Precisian entrega o dado modelado para a IA que o cliente já usa.
A Biso entrega painel e agente de IA próprio sobre mais de 30 integrações. A Precisian entrega a camada semântica para a IA do cliente. Qual escolher?
Dadosfera e Precisian são plataformas de dados com IA e serviço. A Dadosfera atende médias e grandes de todo setor; a Precisian, e-commerce sem time de dados.
A Kondado tem MCP incluso a partir de R$ 99/mês, em autosserviço. A Precisian opera lake isolado e métrica versionada para o e-commerce médio.
Nekt e Precisian servem dado com camada semântica por MCP. A Nekt é autosserviço em dólar, a partir de US$ 149/mês; a Precisian é operada para o varejo.
A Nemu vende atribuição com painel e setup feito pelo time dela; a Precisian entrega dado governado à IA do cliente. Como escolher pelos 7 critérios.
Prax e Precisian ligam Claude e ChatGPT ao dado da loja por MCP. A Prax vende painel pronto; a Precisian, métrica versionada em lake isolado.
ROQT e Precisian prometem um só número e conectam o Claude por MCP. A ROQT é horizontal e roda na sua nuvem; a Precisian é vertical em e-commerce.
O SMKTY Tracker envia conversão server-side a Meta e Google por R$ 0 a R$ 3.490/mês. A Precisian coleta com o Pixel e modela o dado para a IA da empresa.
A Solomon vende atribuição, painel e IA em autosserviço; a Precisian opera o dado até a camada semântica. Como escolher pelos 7 critérios.
A Triple Whale é feita para marca Shopify que opera em inglês e paga em dólar. Para loja VTEX que quer a própria IA lendo o dado, a conta muda.
Coorte, segmento e LTV saem de um identificador pseudonimizado. O agente quase nunca precisa de nome, CPF, e-mail ou telefone para responder.
O vazamento mais provável entre clientes não é ataque: é contexto que sobra na conversa, cache sem chave de cliente e uma credencial que alcança todos.
A API de Conversões manda à Meta o evento que o seu servidor registrou. Sem event_id igual ao do Pixel em até 48 horas, a mesma compra conta duas vezes.
O ctwa_clid é o ID do clique no anúncio de WhatsApp. Chega uma vez, no webhook, e só vale para atribuir a venda se for guardado junto com o pedido.
Dado próprio é o que a empresa coleta direto da relação com o cliente. Conversão modelada e audiência da plataforma parecem, mas não são.
Dicionário de dados descreve cada métrica: nome, definição, fonte, dono, fórmula e exclusões. Um documento de 4 KB elevou a acurácia da IA em 17 a 23 pontos.
Governança de dados é o registro de quem decide sobre cada dado. No e-commerce, o mínimo útil cabe em cinco itens: dono, definição, acesso, retenção e mudança.
Nenhum painel lista todos os agentes de IA ligados ao seu dado. O inventário de permissões tem sete colunas e uma revisão mensal e trimestral.
Linhagem de dados é o caminho de um número da origem até o relatório. A do dbt mostra as colunas, mas não mostra o filtro que mudou o resultado.
O log de auditoria do agente é gravado no servidor que executa a consulta. O logging do MCP foi descontinuado na revisão 2026-07-28 e não serve para isso.
CDP mantém um registro unificado do cliente, acessível a outros sistemas, para ativar. Data lake guarda todas as fontes para análise. Qual vem primeiro?
Data lake guarda o cru, data warehouse guarda o modelado, lakehouse tenta as duas coisas no mesmo arquivo. Nenhum dos três define o que é receita.
Fivetran cobra por linha ativa e Airbyte por crédito, mas em 14/10/2026 nenhuma das duas tinha conector de VTEX ou Nuvemshop no catálogo oficial.
Google Ads conta 30 dias após o clique, a Meta 7 dias após o clique e 1 após a visualização. Com os três MCPs, o agente soma o mesmo pedido duas vezes.
Governança de IA decide quem usa o modelo e o que ele pode ler. A segunda parte pede cinco respostas: escopo, isolamento, retenção, trilha e métrica.
IA para análise de dados funciona para explorar uma planilha e falha para decidir com ela: o modelo calcula certo sobre uma definição que ele mesmo escolheu.
LTV/CAC divide a margem que o cliente deixa pelo custo de trazê-lo. Com marketplace, a loja perde a recompra e a plataforma barateia o CAC.
O MCP oficial da Meta Ads saiu em beta aberto em 29/04/2026 e expõe 91 ferramentas. A conversão que ele devolve é a atribuída pela própria Meta.
A VTEX tem dois MCPs oficiais e nenhum lê pedido. A Nuvemshop tem um que lê venda. Os da Shopify servem a quem compra. Nenhum responde margem por canal.
O MCP do Google Ads lê a conta por GAQL, só em leitura. Responde o que o Google registrou como conversão; não vê pedido faturado, marketplace nem devolução.
O MCP do Google Analytics lê o GA4 pela Data API, que segue a identidade de relatório da propriedade. Se ela é combinada, o número já vem modelado.
ROAS é a receita atribuída à campanha dividida pelo gasto nela. R$ 100 mil sobre R$ 20 mil de mídia dão ROAS 5. Fórmula, ROI, MER e limites.
O MCP do Google Ads só lê, mas a credencial dele pode editar e apagar a conta. Em dado de mídia, o risco do MCP mora no escopo do token.
Supermetrics e Windsor.ai levam o dado à planilha e à IA a partir de US$ 19/mês. Nenhum deles decide o que receita significa na sua empresa.
A SQL que roda é o pior caso de text-to-SQL: coluna errada, janela errada e join que duplica linha devolvem um número limpo, sem erro nenhum.
O histórico do chat guarda o que foi dito, não o que foi consultado. E o art. 37 da LGPD exige registro das operações de tratamento.
O export do GA4 para o BigQuery tem teto de 1 milhão de eventos por dia, pausa em silêncio e não reprocessa os dias perdidos.
Um publica contexto em tabelas dentro do warehouse; o outro é transporte para ferramentas. A diferença real é de governança.
Um guarda e calcula; o outro define o que está sendo calculado. Sem a camada, tudo funciona e os números discordam.
Num comparativo que pune SQL errado, recusar todas as perguntas marca 50% e supera a maior parte dos sistemas em produção.
Nome de campanha aceita 256 caracteres e o Google não documenta validação de conteúdo. O agente lê isso como dado.
Em tabela não agrupada, LIMIT não reduz o que você paga. E o Databricks entrega tempo-limite padrão de dois dias.
A espec proíbe sessão para autenticação. E política de linha é tão forte quanto fraco for o papel de conexão do agente.
O pedido do Omie não devolve CPF nem CNPJ, e no Olist o campo chamado origem não é o marketplace, é PDV.
O Pix liquida em até 40 segundos, mas a cobrança pode viver 30 dias. O GA4 só aceita retroagir evento em 72 horas.
O GA4 tem 5 papéis e 2 restrições de dado, entre elas uma que esconde receita. O padrão de mercado é conceder Administrador.
Acesso, definição, atualidade e procedência, decididos antes da pergunta. Conectar está resolvido; confiar é o que ninguém entregou.
O Airflow documenta o modo de falha numa frase: se a execução nunca termina, o prazo nunca é verificado.
A espec define a ferramenta como controlada pelo modelo. O que você expõe é a fronteira de segurança: exponha perguntas, não tabelas.
Os canais não devolvem chave comum, e documentam a remoção. A Amazon anonimiza o e-mail; o Magalu não devolve e-mail nenhum.
No Brasil o preço tem que incluir imposto; nos EUA, excluir. Seguir tutorial americano dispara reprovação preventiva.
No GA4 padrão são 2 ou 14 meses, e propriedade grande fica em 2. O relatório agregado sobrevive; a exploração, não.
O Google promete durabilidade total num subdomínio. O WebKit limita a 7 dias o cookie de subdomínio que resolve por CNAME.
O Google exclui explicitamente o export para BigQuery do dado modelado. Interface e warehouse medem coisas diferentes, por desenho.
Um contrato de dados declara forma, garantias e significado. Em Snowflake, BigQuery e Redshift, a chave primária declarada e nunca cobrada.
O Google reverteu em abril de 2025 e, em outubro, aposentou Topics e Attribution Reporting. Não existe sucessor.
Os dois números estão certos. A norma contábil reconhece receita na transferência de controle; o marketing mede no checkout.
Nenhuma plataforma desconta a conversão que a concorrente já contou. O mesmo pedido cabe na janela de três delas ao mesmo tempo.
Painel responde pergunta prevista; servidor MCP responde pergunta nova. Os dois leem a mesma definição de métrica embaixo.
Dá para calcular o custo do lake próprio com tabela oficial aberta. Do lado gerenciado, a tarifa por volume não é publicada.
O objeto referral entrega o identificador do anúncio, não da campanha. E o wa_id não conversa com nenhum identificador do lado web.
A especificação do MCP não obriga autenticação. Medição de 2026 achou 40,55% dos servidores públicos expondo ferramentas sem nenhuma.
O schema oficial da Amazon devolve 28 campos de tráfego por produto e nenhum de origem. Atribuir venda de marketplace a canal é impossível por construção.
Para mandar dado de cliente a um LLM fora do Brasil existem dois caminhos legais vivos, não três. Normas corporativas globais não é um deles.
GA4 exclui frete e imposto da receita; VTEX e Shopify incluem. Três definições diferentes, documentadas, produzem três números.
Camada semântica é onde ficam escritas, em formato que a máquina lê, as regras de cálculo das suas métricas. Não é ferramenta: é decisão registrada.
Alucinação de métrica é a IA calculando certo sobre uma definição que a empresa nunca escreveu. Dar a definição ao modelo levou a acurácia de 45,5% a 67,7%.
Dashboard mostra ROI 5x mas o caixa não fecha? Descubra custos ocultos e vendas não-incrementais que transformam lucro em ilusão.
Holdout regional é o único teste que separa um MMM que descobriu sinal real de um que memorizou ruído. Aprenda a desenhar e interpretar testes de validação.
Nosso primeiro artigo explica o que esperar do blog da Precisian: insights técnicos sobre GA4, data quality, attribution e engenharia de analytics.
Deixe seu contato e a conversa abre direto no WhatsApp.
Abrindo o WhatsApp...