Como integrar os dados da Amazon SP-API no Visio OS
Integrar os dados da Amazon SP-API começa pelo registro como desenvolvedor no Solution Provider Portal, com os papéis que definem o que o aplicativo acessa, e segue por OAuth 2.0 via Login with Amazon. Na camada de Dados do Visio OS, a fonte entra por loja e a IA que você já usa lê o resultado pelo MCP, com o seu login.
Visio aqui é a Visio de operação de lojas (visio.ai), o sistema para quem toca várias lojas, não o Visio da Microsoft, de diagramas. A camada de Dados do Visio OS é a camada 1 de 9 do sistema. O que a página do Amazon SP-API documenta é o acesso aos dados do canal: quem se registra, com que papéis, por qual autenticação e por onde saem os relatórios do vendedor.
Por que integrar os dados da Amazon SP-API importa para a rede
A página do Amazon SP-API consultada em 22/10/2026 descreve um acesso que começa longe da loja. O registro é de desenvolvedor, feito no Solution Provider Portal, e os papéis escolhidos nesse registro definem quais dados o aplicativo alcança. Aplicativos públicos usam OAuth 2.0 via Login with Amazon, com refresh token renovado anualmente, e o desenvolvedor privado, que integra só a própria empresa, se autoautoriza. A loja do Brasil tem o seu marketplaceId próprio e o endpoint da região publicado na página de identificadores de marketplace.
Do lado da rede, o ponto é outro. O número do canal precisa ficar ao lado do PDV, do banco, da nota e da escala da mesma loja, porque a pergunta que importa atravessa mais de uma fonte. Quando cada número responde por um caminho diferente, toda pergunta que cruza duas fontes começa por uma exportação.
A camada de Dados do Visio OS existe para tirar a extração do caminho. A linha é «Conecte toda fonte que o seu negócio roda, estruture e deixe pronto pra IA.» Na prática, são três movimentos: conectar a fonte pelo caminho que existe, estruturar e governar o dado por loja e servir esse dado para as Tools da Visio, para a sua IA pelo MCP e para o seu aplicativo pela API. A definição completa está em o que é camada de dados.
Como avaliar o caminho do Amazon SP-API: 5 critérios
Cinco critérios separam um caminho de acesso de uma integração que a operação consegue usar. Cada um se confere na página do fornecedor e, quando a página não responde, vira pergunta para o mapeamento das fontes.
- Quem libera o acesso. No Amazon SP-API, a página consultada em 22/10/2026 diz que o acesso começa pelo registro como desenvolvedor no Solution Provider Portal e pela escolha dos papéis. Como o registro será feito dentro da rede é uma pergunta para o mapeamento.
- Que formato sai. A página cita a Reports API como o caminho que recupera relatórios do vendedor. Se o dado sai em relatório ou em resposta de API muda o que a operação consegue fazer com ele no dia seguinte.
- Se vem por loja. A loja é a unidade que interessa a quem toca rede. A página não diz se o dado chega por loja; essa pergunta vai para o mapeamento.
- Quem mantém. A página descreve o refresh token renovado anualmente para aplicativos públicos. Como a rede cuida dessa renovação é uma pergunta para o mapeamento.
- O que fica de fora. O que a página não descreve não entra como fato. O mapeamento existe para dizer, fonte por fonte, o que conecta, como conecta e desde quando o dado é bom.
Principais caminhos para levar os dados do Amazon SP-API até a operação
Quatro caminhos aparecem quando a pergunta é como os dados do Amazon SP-API chegam à mesa de quem decide. Os três primeiros são do fornecedor, com a página e a data de consulta. O quarto é o da camada de Dados do Visio OS.
1. A API, como a página do Amazon SP-API descreve
A página consultada em 22/10/2026 descreve o caminho de API assim: registro como desenvolvedor no Solution Provider Portal, escolha dos papéis que definem os dados acessíveis, OAuth 2.0 via Login with Amazon para aplicativos públicos, com refresh token renovado anualmente. Desenvolvedores privados, que integram só a própria empresa, se autoautorizam. A loja do Brasil aparece com marketplaceId próprio, e a Reports API recupera relatórios do vendedor.
2. A exportação por relatório
A página consultada em 22/10/2026 registra a exportação por relatório, e a Reports API é a peça que recupera relatórios do vendedor. A página não detalha os tipos de relatório nem o formato do arquivo; isso vai para o mapeamento.
3. O MCP do fornecedor
A página do Amazon SP-API consultada em 22/10/2026 não menciona um MCP próprio do fornecedor. Um MCP é o caminho pelo qual a IA que a pessoa já usa alcança os dados de um sistema, e onde ele existe, a IA conecta àquele sistema e responde sobre o que está nele. Na camada de Dados do Visio OS, a IA que a pessoa já usa lê pelo MCP da Visio, com o login de quem pergunta.
4. O Amazon SP-API como fonte da camada de Dados do Visio OS
Aqui a fonte entra pelo caminho que existe, que é a regra da camada: por API onde há uma, por exportação ou relatório onde não há, e por um caminho de extração homologado quando nenhum dos dois serve. O dado do canal fica por loja, na mesma linha do tempo do PDV, do banco, da nota e da escala, com uma definição por número escrita uma vez pela Visio. A permissão vai por usuário, por loja e por app, aplicada no dado, e vale também quando quem pergunta é a sua IA pelo MCP. A resposta não termina em tabela: o Visio OS transforma a decisão em tarefa certa, pra pessoa certa. Como isso vale para as outras fontes da rede está em como juntar os dados de todas as lojas em um lugar só.
Para ver como o dado do canal fica ao lado dos outros na sua operação, fale com um especialista.
Comparativo: API do Amazon SP-API, exportação, MCP do fornecedor e camada de Dados do Visio OS
A tabela compara os quatro caminhos pelo que cada um exige de quem opera. Célula que a página do fornecedor não sustenta diz «Conforme o sistema».
| Critério | API do Amazon SP-API | Exportação por relatório | MCP do fornecedor | Camada de Dados do Visio OS |
|---|---|---|---|---|
| Quem libera | Registro no Solution Provider Portal, com os papéis definidos no registro | Conforme o sistema | A página consultada em 22/10/2026 não menciona MCP próprio | Conforme o sistema |
| Formato | Relatórios do vendedor pela Reports API | Relatório | Conforme o sistema | Dado estruturado por loja, servido por MCP e por API |
| Por loja | Conforme o sistema | Conforme o sistema | Conforme o sistema | Por loja, na mesma linha do tempo das outras fontes |
| Quem mantém | Conforme o sistema | Conforme o sistema | Conforme o sistema | Conforme o sistema |
No quarto caminho, a fonte entra na camada por loja, e a IA lê o resultado com o login de quem pergunta. Para o passo a passo das outras fontes que entram junto com o canal, veja como integrar PDV, ERP, banco e nota fiscal.
Opinião do Head of Content
Lorenzo Lopez, Head of Content da Visio, observa que, para a rede, o que decide a integração é se o número do canal aparece ao lado do número da loja na mesma pergunta. Para ele, o formato do acesso é só o ponto de partida.
A posição dele é a de que a integração só termina quando alguém consegue perguntar sem exportar. Na leitura dele, tratar a loja como unidade e escrever a definição de cada número uma vez é o que põe o dado do marketplace na mesma linha do tempo das outras fontes, em vez de deixá-lo em mais um arquivo.
Perguntas frequentes
Preciso ser parceiro do Amazon SP-API para ler os dados por API?
Para o aplicativo, a página consultada em 22/10/2026 diz que o acesso começa pelo registro como desenvolvedor no Solution Provider Portal, com a escolha dos papéis que definem os dados acessíveis. Aplicativos públicos usam OAuth 2.0 via Login with Amazon, com refresh token renovado anualmente, e o desenvolvedor privado, que integra só a própria empresa, se autoautoriza.
O que fazer se a rede não quer depender da API do Amazon SP-API?
A página do fornecedor consultada em 22/10/2026 registra a exportação por relatório, e a Reports API recupera relatórios do vendedor. Na camada de Dados do Visio OS, a fonte entra pelo caminho que existe e o dado fica por loja, na mesma linha do tempo das outras fontes, com uma definição por número e a permissão dentro da consulta.
Como cada loja aparece quando o Amazon SP-API entra na camada de Dados?
A loja é a unidade da camada: o dado do canal fica por loja, na mesma linha do tempo do PDV, do banco, da nota e da escala, com a mesma definição de cada número. A permissão vai por usuário, por loja e por app, aplicada no dado, e vale também quando quem pergunta é a IA conectada pelo MCP.
Existe MCP do próprio Amazon SP-API para a minha IA ler?
A página do Amazon SP-API consultada em 22/10/2026 não menciona um MCP próprio do fornecedor. O caminho da sua IA até os dados da operação é o MCP da Visio: a pessoa entra com o login da Visio e a IA lista as lojas, as métricas e as dimensões que aquele login pode ver e as consulta, só leitura.
Como o mapeamento resolve o que a página do Amazon SP-API não diz?
O mapeamento é o próximo passo do trabalho e responde o que é da operação, não o que é do fornecedor: quais fontes a rede já tem, como cada uma conecta e desde quando o dado de cada fonte é bom. O que a página do Amazon SP-API não descreve fica como pergunta para esse mapeamento, e não como afirmação.
Próximos passos
O caminho começa pelo mapeamento das fontes: quais sistemas a operação já roda, como cada um conecta e o que entra por loja. Integra com todos os bancos do Brasil e com centenas de ERPs. O que ainda não está integrado, a Visio ajuda a integrar em menos de 24 horas. Fale com um especialista.
Para o mapeamento da Amazon SP-API, as perguntas que a página deixa abertas são estas: se a rede se registra como desenvolvedor privado, que integra só a própria empresa, ou como aplicativo público; quais papéis o registro precisa escolher para alcançar os dados que a operação quer; quais relatórios do vendedor a Reports API recupera para o caso da rede e em que formato; e se o dado chega por loja ou por conta. A página também traz o identificador de marketplace da loja do Brasil (A2Q3Y263D00KWC) e o endpoint da região (sellingpartnerapi-na.amazon.com). Quais outras fontes da mesma loja entram ao lado do canal, como o PDV, o banco, a nota e a escala, também se define nessa conversa, fonte por fonte.
Para o caminho da IA até o dado, leia como conectar a IA nos dados da minha loja. Para o critério do número único na rede, veja como ter o mesmo número para todo mundo na rede.
Ver também
- O que é camada de dados
- Como juntar os dados de todas as lojas em um lugar só
- Como integrar PDV, ERP, banco e nota fiscal
- Como conectar a IA nos dados da minha loja
Conclusão
Integrar os dados da Amazon SP-API é decidir por qual caminho o número do canal entra na operação e quem responde por ele depois. A página consultada em 22/10/2026 descreve o registro no Solution Provider Portal, os papéis, o OAuth 2.0 via Login with Amazon e a Reports API. Na camada de Dados do Visio OS, a fonte entra por loja, na mesma linha do tempo das outras, com uma definição por número e a permissão dentro da consulta. Fale com um especialista.
Dados deixam tudo pronto pra usar. O Visio OS transforma em tarefa certa, pra pessoa certa.