A API Cidade Express para o seu ERP

Sincronize catálogo, estoque e preços do seu sistema para a loja, e traga os pedidos de volta — sem digitação manual.

Solicitar chave e sandbox Já tenho minha chave

Esta página é aberta para você avaliar a integração. A documentação completa (guias, referência e console interativo) é liberada com a sua chave, que você recebe ao solicitar o acesso.

Novidade · Integração com IA

Integre rápido com um agente de IA (MCP)

Disponibilizamos um servidor MCP: o seu agente (Claude, Cursor e outros) implementa o lado Cidade Express da integração conversando com você em português, sem decorar endpoints nem montar XML. Você descreve de onde vêm os dados do seu ERP; o agente cria produtos, sincroniza estoque e preços, puxa pedidos e devolve status, testando ao vivo no seu sandbox.

Ver como funciona o MCP →

Opcional e já vem com a sua chave. Os detalhes de conexão e as ferramentas ficam na documentação, liberada ao solicitar o acesso.

O que a integração faz

Tudo o que o seu ERP precisa para manter a loja no marketplace em dia, nos dois sentidos:

Catálogo de produtos

Cria, atualiza, arquiva e remove produtos. Nome, descrição, preço, SKU (referência), código de barras, imposto e marca, tudo a partir do seu ERP.

Categorias e marcas

Monta a árvore de categorias da loja e cadastra os fabricantes/marcas para organizar o catálogo.

Variações

Cria eixos (tamanho, cor), seus valores e as combinações do produto, cada uma com o próprio SKU e preço.

Estoque

Envia a quantidade disponível de cada produto e variação. A loja desconta sozinha nas vendas online.

Preços e promoções

Atualiza preços e aplica promoções (percentual ou em reais), inclusive por variação.

Imagens

Envia, lista e remove as fotos de cada produto; a primeira vira a capa.

Pedidos

Importa os pedidos da loja para o ERP, com os itens e os SKUs para casar com o seu sistema.

Status do pedido

Devolve o andamento à loja (em separação, enviado), notificando o cliente automaticamente.

Dados de referência

Consulta idiomas, impostos, grupos de imposto e os dados da loja para preencher tudo certo.

É simples para o seu ERP?

Dá para decidir em minutos. A integração é viável se o seu sistema consegue:

Fazer chamadas HTTP com autenticação básica (uma chave por loja, HTTPS). Qualquer linguagem que faça uma requisição HTTP serve.
Montar e ler XML. As leituras podem vir em JSON; a escrita (criar/atualizar) é em XML.
Trabalhar por consulta periódica para pedidos. Não há webhooks: o ERP pergunta pelos pedidos novos de tempos em tempos (polling por data).

Se o seu ERP faz isso, você já tem quase todo o caminho. Cada chave é restrita a uma única loja, então o seu cliente lojista só expõe os próprios dados.

Compatível com o formato de webservice do PrestaShop, então conectores que o seu ERP já use para esse padrão funcionam aqui com poucos ajustes.

Como começar

Solicite a chave e um sandbox pelo WhatsApp (botão acima). Conte qual é o seu ERP e o que pretende integrar.
Receba a sua chave e a loja de teste isolada, só sua.
Acesse a documentação com a chave: os guias e o console já vêm com a sua chave aplicada, prontos para copiar e testar.

Já recebeu a sua chave? Acessar a documentação →