![](\"https://catalogomobile.com.br/wp-content/uploads/2025/07/integracao-catalogo-mobile.jpg\")
\n\nA integração via webhooks facilita a conexão entre o Catálogo Mobile e o seu sistema de gestão. Com ela, é possível:
\nEnviar produtos para o Catálogo Mobile, com ou sem fotos (via link ou arquivo).
\nAtualizar produtos existentes.
\nAtualizar o preço de um produto.
\nInserir ou remover produtos em promoção.
\nAtualizar o estoque de produtos.
\nReceber pedidos do Catálogo Mobile diretamente no seu sistema via Webhook.
\nTodas as integrações são feitas utilizando o id do produto no seu ERP/Sistema como referência.
\nAcesse o Catálogo Mobile
\nConfigure a integração
\nCrie uma nova integração no sistema.
\nSiga as instruções disponíveis em: Autenticação / Configuração / Instruções.
\nAtive o recebimento de pedidos
\nSe precisar de auxílio, entre em contato com nosso suporte pelo WhatsApp.
\n\n\nCadastrar e alterar os produtos no seu ERP
\n
Envie as informações para o Catálogo Mobile.
Assim, o cliente visualiza sempre as informações atualizadas e o processo se torna mais simples.
\nCaso seu ERP não envie fotos, o cliente pode adicioná-las diretamente no Catálogo Mobile após a sincronização.
\nPossuímos uma função de inserção em massa de imagens, baseada no código do produto e nome do arquivo.
\nAlém disso, ao cadastrar a URL do seu webhook, os pedidos realizados no Catálogo Mobile serão enviados automaticamente ao seu ERP.
\nPara proteger a estabilidade da API, os endpoints de integração possuem limites de requisições por segundo. Ao exceder esses limites, a API retorna HTTP 429 com erro rate_limited.
Aplica-se aos endpoints:
\n/api/v2/integracao/webhook/adicionarProduto/{integrationCode}/
/api/v2/integracao/webhook/notificaEstoque/{integrationCode}/
/api/v2/integracao/webhook/enviaPreco/{integrationCode}/
/api/v2/integracao/webhook/inserirFotos/{integrationCode}/
/api/v2/integracao/webhook/detalharProduto/{integrationCode}/{campo}/{valor}/
/api/v2/integracao/webhook/listarPedidos/{integrationCode}/
/api/v2/integracao/webhook/status/{request_id}/
Limites atuais:
\nObservação: o limite por URL considera o caminho da URL. Query strings, como ?data=YYYY-MM-DD, não aumentam o limite do endpoint.
Para evitar HTTP 429, envie as requisições em ritmo controlado:
Para o mesmo endpoint e mesma integração: no máximo 3 req/s.
\nPara vários endpoints a partir do mesmo servidor/IP: no máximo 15 req/s no total.
\nEm integrações com grande volume, prefira enviar em fila no ERP, com retry em caso de 429.
Exemplo de resposta ao exceder o limite:
\n{
\"error\": \"rate_limited\",
\"message\": \"Limite excedido em /api/v2/integracao/webhook/: 3 requests/s por URL e 15 requests/s por origem.\"
}
Token inserido na configuração das integrações no Catálogo Mobile
\n","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://sistema.catalogomobile.com.br/dashboard/integrations","description":"Para utilizar a integração por Webhook, siga os passos abaixo:
\nAcesse o WebAdmin do Catálogo Mobile com uma conta de administrador.
\nNo menu lateral, acesse: Integrações > Adicionar Nova Integração > Tipo: Webhook.
\nidEcommerce)O idEcommerce é o identificador do seu sistema no Catálogo Mobile.
\nEste valor deve ser enviado em todas as requisições e será utilizado para validação.
\nDurante o desenvolvimento, utilize 0.
Após finalizar, solicite ao suporte do Catálogo Mobile a homologação da integração. O suporte irá atribuir um idEcommerce definitivo ao seu sistema.
Se estiver integrando apenas a sua própria conta, o idEcommerce pode permanecer em 0.
O Token é gerado pelo seu sistema (pode ser criado via um gerador online, com 64 caracteres).
\nEste token deve ser enviado em cada requisição no header:
\n Authorization: Bearer {seu_token}\n\nTodas as requisições serão validadas com base neste token.
\nRecomenda-se a reciclagem do token de forma periódica
\nApós salvar a integração, será gerado um integrationCode (código de 6 dígitos) que identifica a conta do cliente.
\nO integrationCode será utilizado nas URLs de integração geradas.
\nApós configurar sua integração, três links principais serão disponibilizados, usando seu integrationCode.
Exemplo (integrationCode: CWUW7S****):
URL para envio de produtos:
\n https://sistema.catalogomobile.com.br/api/v2/integracao/webhook/adicionarProduto/CWUW7S/\n\nURL para notificações de estoque:
\n https://sistema.catalogomobile.com.br/api/v2/integracao/webhook/notificaEstoque/CWUW7S/\n\nURL para envio de preços:
\n https://sistema.catalogomobile.com.br/api/v2/integracao/webhook/enviaPreco/CWUW7S/\n\nNós iremos armazenar o ID dos seus produtos no campo idMapeamento. Assim você poderá enviar atualizações de preço, estoque, imagens, edições, usando o idMapeamento.
\nidMapeamento: Identificador do produto no seu sistema.
\nExige que todos os produtos sejam adicionados ao Catálogo Mobile pelo sistema de origem.
\nEssa abordagem é mais eficiente.
\nOs produtos podem existir previamente no Catálogo Mobile.
\nO produto será identificado pelo campo codigo (code).
\nSe ambos (skuMapeamento e codigo) forem informados, a busca será priorizada por skuMapeamento.
\n\n","urlObject":{"protocol":"https","path":["dashboard","integrations"],"host":["sistema","catalogomobile","com","br"],"query":[],"variable":[]}},"response":[],"_postman_id":"48aebb4c-f014-42f3-a2da-f3a0c998d6b9"},{"name":"Adicionar/Editar Produto - Catálogo Mobile","id":"e8b2d0e5-3072-4d56-9f85-38db2dd21e45","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer SEUTOKEN","type":"text"}],"body":{"mode":"raw","raw":"{\n \"debug\": \"0\",\n \"versao\": \"1\",\n \"cnpj\": \"39867600000122\",\n \"idEcommerce\": 0,\n \"tipo\": \"produto\",\n \"dados\": {\n \"id\": \"817687417\",\n \"idMapeamento\": \"2172254\",\n \"nome\": \"Caderno 35 \",\n \"codigo\": \"108\",\n \"preco\": \"10.0\",\n \"precoPromocional\": \"0.00\",\n \"ncm\": \"\",\n \"gtin\": \"\",\n \"localizacao\": \"\",\n \"nomeFornecedor\": \"\",\n \"estoqueAtual\": 0,\n \"situacao\": \"A\",\n \"descricaoComplementar\": \"Observação:
\n
Após seguir estes passos, sua integração estará pronta para uso.
Caso surja alguma dúvida, entre em contato com o suporte do Catálogo Mobile.
PAPA <p style=\\\"font-size: 16px; box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px; caret-color: #404040; color: #404040; font-family: Roboto, sans-serif; text-align: justify;\\\"><br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />O Seagate Expansion oferece enorme capacidade e facilidade para armazenar, gerenciar e proteger toda a sua vida digital localmente. O disco rígido portátil Seagate Expansion oferece uma solução fácil de usar quando você precisa adicionar armazenamento instantaneamente ao seu computador e levar seus arquivos aonde você for. O disco rígido portátil Expansion é facilmente instalado conectando-se um cabo USB. Você pode começar a salvar seus arquivos digitais neste disco rígido externo segundos após retirá-lo da caixa.</p>
<p style=\\\"font-size: 16px; box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px; caret-color: #404040; color: #404040; font-family: Roboto, sans-serif; text-align: justify;\\\"><br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />Características HD 1TB Externo Seagate Expansion USB 3.0 Portátil 2,5''<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- Marca: Seagate<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- Modelo: STEA1000400</p>
<p style=\\\"font-size: 16px; box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px; caret-color: #404040; color: #404040; font-family: Roboto, sans-serif; text-align: justify;\\\"><br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />Especificações HD 1TB Seagate Externo USB 3.0 Portátil 2,5''<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- Capacidade: 1TB<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- Interface: USB 3.0<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- Rotação: 5400 RPM<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- Taxa Máxima de Transferência: Até 4,8 Gbps (USB 3.0)<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- Compatibilidade: Sistema operacional Windows XP SP3, Windows Vista®, Windows 7, Windows® 8 ou superior</p>
<p style=\\\"font-size: 16px; box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px; caret-color: #404040; color: #404040; font-family: Roboto, sans-serif; text-align: justify;\\\"><br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />Informações adicionais<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- A instalação é simples e direta, bastando conectar um cabo USB e pronto.<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- O disco é alimentado pelo cabo USB, dispensando uma fonte de alimentação externa.<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- Ele é reconhecido automaticamente pelo sistema operacional Windows®, então não há software para instalar nem nada para configurar.<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- Salvar arquivos é fácil — é só arrastar e soltar.<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- Aproveite ao máximo as velocidades de transferência de dados rápidas da interface USB 3.0 conectando o disco a uma porta USB 3.0 SuperSpeed.<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- A interface USB 3.0 é compatível retroativamente com USB 2.0, proporcionando maior flexibilidade</p>
<p style=\\\"font-size: 16px; box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px; caret-color: #404040; color: #404040; font-family: Roboto, sans-serif; text-align: justify;\\\"><br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />Conteúdo da embalagem<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- Disco rígido portátil Seagate Expansion 1TB<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- Cabo USB 3.0<br style=\\\"box-sizing: border-box; text-decoration-line: none; margin: 0px; padding: 0px; outline: 0px;\\\" />- Guia de início rápido</p>
\",\n \"marca\": \"\",\n \"descricaoCategoria\": \"Nome da Categoria\",\n \"variacoes\": [\n {\n \"id\": \"817687422\",\n \"idMapeamento\": \"2172255\",\n \n \"codigo\": \"100-1\",\n \"gtin\": \"\",\n \"preco\": \"10.00\",\n \"precoPromocional\": \"12.00\",\n \"estoqueAtual\": 0,\n \"grade\": [\n {\n \"chave\": \"Tamanho\",\n \"valor\": \"Grande\"\n }\n ],\n \"anexos\": []\n },\n {\n \"id\": \"817687426\",\n \"idMapeamento\": \"2172256\",\n \n \"codigo\": \"100-2\",\n \"gtin\": \"\",\n \"preco\": \"11.00\",\n \"precoPromocional\": \"0.00\",\n \"estoqueAtual\": 0,\n \"grade\": [\n {\n \"chave\": \"Tamanho\",\n \"valor\": \"Pequeno\"\n }\n ],\n \"anexos\": []\n }\n ],\n \"anexos\": [\n {\n \"url\": \"https://endereco/foto.jpg\"\n },\n {\n \"url\": \"https://endereco/foto2.jpg\"\n },\n {\n \"url\": \"https://endereco/foto3.jpg\"\n },\n {\n \"url\": \"https://endereco/foto4.jpg\"\n }\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://sistema.catalogomobile.com.br/api/v2/integracao/webhook/adicionarProduto/{{integrationCode}}/","description":"Este endpoint permite adicionar novos produtos ao Catálogo Mobile, suportando envio de imagens através de URLs ou arquivos (\"File\"). O produto é inserido de forma assíncrona e o processamento das imagens é assíncrono.
\nPOST /api/v2/integracao/webhook/adicionarProduto/{integrationCode}/
As requisições devem conter o header:
\nAuthorization: Bearer {token}\n\nExemplo:
\n{\n \"debug\": \"1\",\n \"versao\": \"1.\",\n \"cnpj\": \"3986760000220122\",\n \"idEcommerce\": \"1234\",\n \"tipo\": \"produto\",\n \"dados\": {\n \"idMapeamento\": \"2172254\",\n \"nome\": \"Caderno Universitário\",\n \"codigo\": \"108\",\n \"preco\": \"10.00\",\n \"precoPromocional\": \"9.00\",\n \"ncm\": \"\",\n \"gtin\": \"1234567890123\",\n \"localizacao\": \"\",\n \"nomeFornecedor\": \"Fornecedor Exemplo\",\n \"estoqueAtual\": 150,\n \"situacao\": \"A\",\n \"descricaoComplementar\": \"<strong class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>Caderno 200 folhas, capa dura</b>\",\n \"marca\": \"Marca Exemplo\",\n \"descricaoCategoria\": \"Cadernos\",\n \"anexos\": [\n {\"url\": \"https://exemplo.com/imagem1.jpg\"},\n {\"url\": \"https://exemplo.com/imagem2.png\"}\n ],\n \"variacoes\": []\n }\n}\n\n\n\nNota: Produtos sem categoria são adicionados à categoria \"Padrão\".
\n
O endpoint adicionarProduto aceita imagens de duas formas:
\nUse o campo dados.anexos, enviando até 4 URLs de imagem:
\n\"anexos\": [ { \"url\": \"https://exemplo.com/foto1.jpg\" }, { \"url\": \"https://exemplo.com/foto2.jpg\" }, { \"url\": \"https://exemplo.com/foto3.jpg\" }, { \"url\": \"https://exemplo.com/foto4.jpg\" } ]
Mapeamento:
\ndados.anexos[0].url -> foto1 dados.anexos[1].url -> foto2 dados.anexos[2].url -> foto3 dados.anexos[3].url -> foto4
Use multipart/form-data e envie os arquivos nos campos:
\nfoto1 foto2 foto3 foto4
Também são aceitos por compatibilidade:
\nphoto1..photo4 image1..image
Envie imagens por URL ou por arquivo, mas não misture as duas formas no mesmo request.
\nSão aceitas até 4 imagens por produto.
\nPara atualizar somente as imagens de um produto já cadastrado, use o endpoint exclusivo inserirFotos.
\nO produto é adicionado requisição aceita e processada em fila (assíncrono).
\nAs imagens são processadas separadamente (assíncrono).
\n{\n \"status\": \"accepted\",\n \"request_id\": \"uuid\",\n \"message\": \"Webhook recebido. Processamento assincrono.\",\n \"queue\": \"erp-webhook-low\",\n \"duplicate\": false\n}\n\nImagens suportadas: JPG, JPEG, PNG (máximo 4 por produto; serão redimensionadas para 800x800 px).
\nPara sincronização automática de categorias, os nomes devem ser únicos. Nomes semelhantes podem exigir ajuste manual pelo cliente.
\nEm caso de dúvidas, consulte o suporte do Catálogo Mobile.
\nEste endpoint permite atualizar o saldo de estoque de produtos no Catálogo Mobile, utilizando para identificação o idMapeamento ou o codigo do produto.
POST /api/v2/integracao/webhook/notificaEstoque/{integrationCode}/
Inclua o token no header da requisição:
\nAuthorization: Bearer {token}\n\n{\n \"debug\": \"1\",\n \"versao\": \"1.\",\n \"cnpj\": \"3986760000220122\",\n \"idEcommerce\": \"1234\",\n \"tipo\": \"estoque\",\n \"dados\": {\n \"idMapeamento\": \"2172254\",\n \"saldo\": 50,\n \"codigo\": \"108\",\n \"idProduto\": \"56789\",\n \"tipoEstoque\": \"F\"\n }\n}\n\ndados* Obrigatório caso idMapeamento não seja informado.
{\n \"debug\": \"1\",\n \"versao\": \"1.\",\n \"cnpj\": \"3986760000220122\",\n \"idEcommerce\": \"1234\",\n \"tipo\": \"estoque\",\n \"dados\": {\n \"codigo\": \"108\",\n \"saldo\": 0\n }\n}\n\nExemplo de resposta para uma operação bem-sucedida:
\n{\n \"status\": \"success\",\n \"idMapeamento\": \"2172254\",\n \"codigo\": \"108\",\n \"produto_ativo\": true\n}\n\nUtilize sempre o idMapeamento quando possível para evitar ambiguidade.
Estoques menores que 1 (inclusive zero) resultarão no status “Sem estoque” no Catálogo Mobile.
\nEm caso de dúvidas ou para ajustes, entre em contato com o suporte técnico do Catálogo Mobile.
\nEste endpoint permite atualizar o preço e o preço promocional de produtos no Catálogo Mobile. Os produtos podem ser identificados tanto pelo idMapeamento quanto pelo codigo.
POST /api/v2/integracao/webhook/enviaPreco/{integrationCode}/
Inclua o token de autenticação no header da requisição:
\nAuthorization: Bearer {token}\n\n{\n \"debug\": \"1\",\n \"versao\": \"1.\",\n \"cnpj\": \"3986760000220122\",\n \"idEcommerce\": \"1234\",\n \"tipo\": \"precos\",\n \"dados\": {\n \"idMapeamento\": \"2172254\",\n \"nome\": \"Produto Exemplo\",\n \"preco\": \"9.99\",\n \"precoPromocional\": \"7.99\",\n \"codigo\": \"108\",\n \"idProduto\": \"12345\"\n }\n}\n\n1 Obrigatório caso o campo _idMapeamento_ não seja informado.
Ambiguidade no Código:
Se houver mais de um produto com o mesmo código, será considerada a primeira ocorrência do sistema.
Promoção:
Se o campo precoPromocional for maior que zero, o produto será considerado em promoção. Valores iguais a zero desabilitam a promoção.
{\n \"status\": \"success\",\n \"idMapeamento\": \"2172254\",\n \"codigo\": \"108\",\n \"preco\": \"9.99\",\n \"precoPromocional\": \"7.99\"\n}\n\nEm caso de dúvidas ou para mais informações, consulte o suporte do Catálogo Mobile.
\n","urlObject":{"path":["api","v2","integracao","webhook","enviaPreco","{{integrationCode}}",""],"host":["https://sistema.catalogomobile.com.br"],"query":[],"variable":[]}},"response":[],"_postman_id":"869156f9-5d6b-474e-af6b-3440c4cb7c27"},{"name":"Inserir Foto em Produto - Catálogo Mobile","id":"217ff04a-101a-4223-a855-153882f32ca8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer SEUTOKEN","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"foto1","description":"Para adicionar foto a produto por Arquivo.
\n","type":"file","uuid":"9abdb17d-77cc-4605-89bc-a4bbb0361e2b","value":null},{"key":"tipo","value":"foto","type":"text","uuid":"c0f084d9-ce02-407a-83de-6345a156121e"},{"key":"idEcommerce","value":"123","type":"text","uuid":"b8390449-d166-4192-847b-b0a1dd2a3314"},{"key":"cnpj","value":"39867600000121","type":"text","uuid":"5f77ee9d-103c-4526-879a-81003b630091"},{"key":"code","value":"108","type":"text","uuid":"9b79373b-cefa-46f2-85ba-c29b38af3d84","disabled":true},{"key":"skuMapeamento","value":"209213","type":"text","uuid":"46aadbb6-b4c0-4cb8-be2f-682871d8209f","disabled":true},{"key":"idMapeamento","value":"12123","type":"text","uuid":"cf86a8ec-8a52-4708-b964-d6287fb0263e"}]},"url":"https://sistema.catalogomobile.com.br/api/v2/integracao/webhook/inserirFotos/{{integrationCode}}/","description":"Este endpoint permite adicionar ou atualizar imagens de produtos no Catálogo Mobile por meio do envio de arquivos (multipart/form-data).
\nPOST /api/v2/integracao/webhook/inserirFotos/{integrationCode}/
Inclua o token de autenticação no header da requisição:
\nAuthorization: Bearer {token}\n\nO body da requisição deve ser enviado como multipart/form-data com os seguintes campos:
\n*Obrigatório caso idMapeamento não seja informado.
São aceitas imagens nos formatos JPG, JPEG e PNG.
\nAs imagens adicionais (foto2, foto3, foto4) são opcionais.
Sempre utilize idMapeamento para identificação mais precisa do produto.
O tamanho máximo e as dimensões das imagens seguem as diretrizes da plataforma Catálogo Mobile.
\n{\n \"status\": \"success\",\n \"idMapeamento\": \"2172254\",\n \"code\": \"108\",\n \"imagensProcessadas\": 3\n}\n\nPara dúvidas técnicas ou problemas durante a integração, entre em contato com o suporte do Catálogo Mobile.
\n","urlObject":{"path":["api","v2","integracao","webhook","inserirFotos","{{integrationCode}}",""],"host":["https://sistema.catalogomobile.com.br"],"query":[],"variable":[]}},"response":[],"_postman_id":"217ff04a-101a-4223-a855-153882f32ca8"},{"name":"WebHook - Envio de Pedidos (Do Catálogo para seu Sistema)","id":"89b9ec92-5b17-4f9f-baf5-6fd8f709da00","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"Bearer SEUTOKEN","description":"Token inserido na configuração das integrações no Catálogo Mobile
\n","type":"text"}],"body":{"mode":"raw","raw":"{\"itens\": [\n {\n \"quantidade\": \"11\",\n \"valor\": \"0.30\",\n \"descricao\": \"Caderno 35\",\n \"produto\": {\n \"id\": \"2172254\",\n \"skuMapeamento\": \"209210\",\n \"codigo\": \"108\"\n }\n }\n],\n\"codigo_pedido_catalogo\": \"417\",\n\"cpf_ou_cnpj_cliente\": \"02238862224\",\n\"whatsapp_cliente\": \"41226322314\",\n\"email_cliente\": \"thaina_teste@gmail.com\",\n\"email_vendedor\": \"ce@ce.com\",\n\"observacoes_pedido\": \"Descrição do pedido\",\n\"whatsapp_vendedor\": \"41996343222\",\n\"nome_vendedor\": \"Vendedor Preco2\",\n\"mensagem\": \"Novo pedido recebido:\\n\\n*1* - Caderno 35\\nCódigo: 108\\nQuantidade: 11\\nPreço(un): R$0,30\\n\\n*Total Pedido*: R$3,30\\n\\n*Informações do cliente:*\\nCPF/CNPJ: 03338862224\\nWhatsApp: (41) 99634-3314\\nEmail: thaina_teste@gmail.com\\nObservações do pedido: Descrição do pedido\",\n\"valor_total_pedido\": \"3.30\"\n}","options":{"raw":{"language":"json"}}},"url":"seuWebhook","description":"Enviaremos todos os pedidos recebidos no Catálogo Mobile para seu sistema.
\nInstruiremos seu cliente a adicionar um vendedor no Catálogo Mobile com o mesmo nome que no seu sistema, para que você possa fazer o vinculo no momento do pedido.
\nPOST https://sistema.catalogomobile.com.br/seuWebhook
Configure o webhook no Catálogo Mobile em https://sistema.catalogomobile.com.br/dashboard/integrations.
Em \"Opções Avançadas\", escolha \"Enviar pedido ao Webhook\" e insira o link do seu sistema para receber pedidos.
Authorization: Bearer {Token}\nContent-Type: application/json\n\nExemplo de Payload:
\n{\n \"itens\": [\n {\n \"quantidade\": \"11\",\n \"valor\": \"0.30\",\n \"descricao\": \"Caderno 35\",\n \"produto\": {\n \"id\": \"2172254\",\n \"skuMapeamento\": \"209210\",\n \"codigo\": \"108\"\n }\n }\n ],\n \"codigo_pedido_catalogo\": \"417\",\n \"cpf_ou_cnpj_cliente\": \"02238862224\",\n \"whatsapp_cliente\": \"41226322314\",\n \"email_cliente\": \"thaina_teste@gmail.com\",\n \"email_vendedor\": \"ce@ce.com\",\n \"observacoes_pedido\": \"Descrição do pedido\",\n \"whatsapp_vendedor\": \"41996343222\",\n \"nome_vendedor\": \"Vendedor Preco2\",\n \"mensagem\": \"Novo pedido recebido:\\n\\n*1* - Caderno 35\\nCódigo: 108\\nQuantidade: 11\\nPreço(un): R$0,30\\n\\n*Total Pedido*: R$3,30\\n\\n*Informações do cliente:*\\nCPF/CNPJ: 03338862224\\nWhatsApp: (41) 99634-3314\\nEmail: thaina_teste@gmail.com\\nObservações do pedido: Descrição do pedido\",\n \"valor_total_pedido\": \"3.30\"\n}\n\nCaso deseje processar o pedido recebido, utilize os campos para identificar o cliente, os itens solicitados e os dados do vendedor para fluxos de aprovação e faturamento.
\nToken inserido na configuração das integrações no Catálogo Mobile
\n","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://sistema.catalogomobile.com.br/api/v2/integracao/webhook/detalharProduto/{{integrationCode}}/idMapeamento/{{idMapeamento}}/\n","description":"Use este endpoint para buscar os detalhes de um produto já cadastrado no Catálogo Mobile.
\nA forma recomendada de consulta é pelo idMapeamento, que é o ID do produto no ERP/sistema de origem.
Este endpoint é uma consulta síncrona: a resposta retorna imediatamente os dados atuais do produto.
\nUse esta URL quando o seu sistema já conhece o ID interno do produto no ERP.
\nNo Catálogo Mobile, esse valor é salvo no campo products.imported_id.
GET https://sistema.catalogomobile.com.br/api/v2/integracao/webhook/detalharProduto/XJ3WIZ/code/101721/
\nUse esta URL como alternativa quando não houver idMapeamento disponível.
O campo code consulta o código/SKU do produto no Catálogo Mobile (products.code). Se houver produtos com código duplicado, será retornado o primeiro produto encontrado para a empresa da integração.
Envie o token da integração no header:
\nAuthorization: Bearer {token}
\nHTTP 200
\n{
\"data\": {
\"product_id\": 80758,
\"company_id\": 123,
\"name\": \"Caderno Universitário\",
\"code\": \"101721\",
\"price\": \"10.00\",
\"price_promo\": \"9.00\",
\"description\": \"Descrição do produto\",
\"active\": 1,
\"stock\": 150,
\"brand\": \"Marca Exemplo\",
\"categories\": [],
\"attributes\": [],
\"variations\": [],
\"foto1\": \"https://...\",
\"foto1-180x180\": \"https://...\"
}
}
Para novas integrações, use preferencialmente idMapeamento.
Use code apenas como fallback ou alternativa.
Token inserido na configuração das integrações no Catálogo Mobile
\n","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://sistema.catalogomobile.com.br/api/v2/integracao/webhook/listarPedidos/{{integrationCode}}/?data=YYYY-MM-DD\n","description":"Use este endpoint para listar os pedidos criados no Catálogo Mobile entre hoje e uma data inicial informada.
\nEste endpoint é uma consulta síncrona e retorna os pedidos agrupados por carrinho/pedido, com os itens dentro de cada pedido.
\nEnvie o token da integração no header:
\nAuthorization: Bearer {token}
\nA data deve ser igual ou anterior a hoje.
\nA busca aceita no máximo os últimos 7 dias.
\nO período pesquisado vai de data 00:00:00 até hoje 23:59:59, no timezone do sistema.
O endpoint tem limite de 3 requisições por segundo por URL/IP.
\nGET /api/v2/integracao/webhook/listarPedidos/XJ3WIZ/?data=2024-10-31
\nHTTP 200
\n{
\"data\": []
}
HTTP 200
\n{
\"data\": [
{
\"orderId\": \"417\",
\"cart_id\": 12345,
\"created_at\": \"2024-10-31T14:20:00.000000Z\",
\"status\": \"PENDING\",
\"currency\": \"BRL\",
\"seller_id\": 10,
\"seller_name\": \"Vendedor Exemplo\",
\"client\": {
\"name\": \"Cliente Exemplo\",
\"email\": \"cliente@exemplo.com\",
\"code\": \"123\",
\"phone\": \"41999999999\"
},
\"description\": \"Observações do pedido\",
\"cart\": {
\"id\": 12345,
\"total_value\": 100.0,
\"total_items\": 2,
\"discount_percent\": 0,
\"discount_value\": 0,
\"total_with_discount\": 100.0,
\"payment_option\": {
\"id\": null,
\"label\": null,
\"adjustment_percent\": 0,
\"discount_value\": 0
},
\"delivery_option\": {
\"id\": null,
\"label\": null,
\"fee_type\": null,
\"fee_value\": 0,
\"fee_display\": null
}
},
\"integration\": null,
\"delivery_channels\": null,
\"items\": [
{
\"id\": 999,
\"company_id\": 123,
\"product_id\": 80758,
\"product_name\": \"Caderno Universitário\",
\"product_code\": \"101721\",
\"product_price\": \"10.00\",
\"quantity\": 2,
\"specs\": null,
\"currency\": \"BRL\",
\"status\": \"PENDING\",
\"orderId\": \"417\",
\"cart_id\": 12345,
\"seller_id\": 10,
\"discount_percent\": 0,
\"discount_value\": 0,
\"total_with_discount\": 20.0
}
]
}
]
}