Pular para o conteúdo

E-commerce

Integração com Mercado Livre, Shopee e gateway de pagamento

Pedidos, estoque, preços, pagamentos e conciliação sincronizados, sem redigitação e com log de cada transação. Para operações que já têm ERP, loja e gateway.

Conversa inicial gratuita · Resposta em até 1 dia útil

Fatos que sustentam este serviço

  • Mahout ERP: hub com Magento 2, Moip/Wirecard, Asaas e Melhor Envio

  • Open source: módulos oficiais PagSeguro e Mercado Pago para Magento 2, 214 mil instalações

  • NF-e via SEFAZ e conciliação bancária OFX no Mahout ERP

  • MPC: reenvio até a confirmação (at-least-once), com logs de entrega por tela

Reconhece esse cenário?

  • O marketplace vendeu um produto que já não tinha estoque, porque a atualização falhou e ninguém foi avisado.

  • O financeiro concilia pagamentos, taxas e repasses em planilha, e todo mês fecha com diferenças que ninguém explica.

  • O hub de integração cobre o básico, mas a sua regra de preço, de kit ou de depósito não cabe na configuração dele.

  • Quando a API do parceiro cai ou muda, pedidos somem no caminho e quem percebe primeiro é o cliente.

O que entregamos

  • Sincronização de pedidos

    Sincronização de pedidos

    Pedidos de marketplaces como Mercado Livre, Shopee e Amazon, integrados pela API oficial, entram no ERP com cliente, itens, frete e pagamento, e o status volta ao canal de origem.

  • Estoque e preços por canal

    Estoque e preços por canal

    Estoque e preços publicados em cada canal a partir do ERP, com regras por depósito, kit e margem, atualizados a cada movimentação para nenhum canal vender o que acabou.

  • Pagamentos: Pix, cartão e boleto

    Pagamentos: Pix, cartão e boleto

    Integração com o gateway escolhido, por checkout hospedado ou API, com webhooks validados, tratamento de estorno e chargeback e o status do pagamento refletido no pedido.

  • Conciliação financeira

    Conciliação financeira

    Cruzamento automático entre pedidos, recebimentos, taxas e repasses de gateways e marketplaces, com relatório de divergências para o financeiro tratar por exceção.

  • Tratamento de erro e reprocessamento

    Tratamento de erro e reprocessamento

    Filas, retentativas com espera progressiva, chaves de idempotência e fila de falhas com reprocessamento, para que uma mensagem não se perca nem seja aplicada duas vezes.

  • Logs, alertas e visão da operação

    Logs, alertas e visão da operação

    Log por transação com a requisição e a resposta de cada sistema, alertas de falha e uma visão do que está pendente e por quê.

Veja também: desenvolvimento de e-commerce, desenvolvimento de software sob medida e automação de processos com IA.

Arquitetura orientada a eventosCada domínio fica isolado atrás de uma API com contratos. Os serviços publicam eventos num barramento com filas e retries, e os workers cuidam de integrações e dados por tenant, sem acoplar um domínio ao outro.
Web, mobile, desktopapps e parceirosAPI e autenticaçãocontratos OpenAPIPedidosPagamentosEstoqueEventosKafka, filas, retriesWorkersDados por tenant

Resultados e experiência

  • Mahout ERP Cloud

    Escopo:
    Hub de integrações

    Hub de integrações do ERP para e-commerce, pagamentos e frete, ao lado da emissão fiscal e da conciliação bancária.

    • Magento 2, Moip/Wirecard, Asaas e Melhor Envio
    • NF-e via SEFAZ e conciliação bancária OFX
    • 275recursos REST (~1.400 endpoints)
    • 3.400+testes PHPUnit

    Ler o case

  • PagSeguro e Mercado Pago para Magento 2

    Escopo:
    Open source (contribuições aceitas)

    Contribuições aceitas (merged) nos módulos oficiais de pagamento PagSeguro e Mercado Pago para Magento 2, além de outras bibliotecas open source.

    • Módulos oficiais: 214 mil instalações
    • php-mod/curl: 16,7 milhões de instalações
    • NFePHP: contribuições (700+ estrelas)
  • Ver mais resultados
  • ADT Solar / Sunpro

    Escopo:
    Integrações entre sistemas · experiência relacionada
    Período:
    2022–2023

    Experiência relacionada, em integrações: Sunlighten, o SaaS interno da operação de energia solar residencial, ligado a Salesforce, DocuSign e Airplane para automatizar o fluxo da venda à instalação.

    • Salesforce, DocuSign e Airplane integrados
    • Fluxo da venda à instalação automatizado
    • Node.js, Kubernetes e AWS Lambda

    Ler o case

  • MPC (Mobile Price Card)

    Escopo:
    Entrega confiável a dispositivos em loja

    Experiência relacionada, em confiabilidade de entrega: atualizações de promoção enviadas a dispositivos em loja com entrega at-least-once.

    • Confirmações (ack), retentativas automáticas e logs de entrega por tela
    • Plataforma em 20.000+ locais, em 30 países
    • 24operações REST documentadas em OpenAPI

    Ler o case

Tem um desafio parecido? Conte o problema e o prazo.

Pedir conversa inicial

Conversa inicial gratuita · Resposta em até 1 dia útil

Para quem é e para quem não é

Integração com marketplaces e gateways de pagamento é a conexão, por API, entre ERP, loja virtual, marketplaces e meios de pagamento, para que pedidos, estoque, preços, pagamentos e conciliação fluam sem redigitação. Contrate quando o hub pronto não cobre as suas regras ou quando falhas de sincronização já causam venda sem estoque, pedido perdido ou divergência financeira.

Indicado para

  • Operações que vendem em loja própria e em marketplaces e controlam estoque e financeiro em um ERP.
  • Empresas cujo hub pronto não cobre regras de preço, kit, depósito ou faturamento.
  • Times financeiros que precisam conciliar recebimentos, taxas e repasses por pedido, sem planilha.
  • Plataformas e SaaS, inclusive dos EUA, que precisam aceitar pagamentos no Brasil ou se conectar aos ERPs dos clientes.

Não indicado para

  • Quem vende em poucos canais com regras padrão: Bling, Tiny ou Olist integram por uma mensalidade, em dias.
  • Quem precisa de uma loja nova: esse trabalho está no serviço de e-commerce sob medida.
  • Sistemas cujo fornecedor não libera API nem outro ponto de integração: sem isso não há como conectar com segurança.
  • Quem busca certificação ou auditoria PCI DSS, a norma de segurança para dados de cartão: não somos auditores; desenhamos a integração para reduzir o seu escopo.

Como funciona e prazos

  1. Diagnóstico

    Diagnóstico

    Mapeamos sistemas, APIs, volumes e os pontos em que pedidos, estoque ou pagamentos divergem hoje. Você recebe o desenho dos fluxos, a recomendação entre hub pronto, conector nativo ou integração sob medida, o plano e a estimativa.

  2. Contratos e casos de erro

    Contratos e casos de erro

    Especificamos cada fluxo: campos, regras, a fonte da verdade de cada dado e o que acontece em cada falha (timeout, duplicidade, dado inválido). Você aprova os contratos e os critérios de aceite antes do código.

  3. Prova de conceito em sandbox

    Prova de conceito em sandbox

    Um fluxo ponta a ponta nos ambientes de teste dos parceiros, com casos de erro simulados. Você recebe a PoC em funcionamento, os logs dos testes e a recomendação de seguir, ajustar ou parar.

  4. Produção

    Produção

    Os demais fluxos em iterações curtas, com testes automatizados, monitoramento e ativação gradual por canal. Você recebe as integrações em produção, com logs, alertas e a rotina de reprocessamento documentada.

  5. Operação e evolução

    Operação e evolução

    Acompanhamos os primeiros ciclos de pedidos e de conciliação, ajustamos os alertas e documentamos a operação. Mudanças de API dos parceiros e novos canais podem seguir em retainer mensal.

Formatos típicos de contratação deste serviço
EscopoPrazo típicoModelo de contratação
Diagnóstico de integraçõesFluxos, APIs, pontos de falha, recomendação (hub, conector ou sob medida), plano e estimativa1–2 semanasProjeto de escopo fechado
Prova de conceitoUm fluxo ponta a ponta em sandbox, com casos de erro simulados2–4 semanasProjeto de escopo fechado
ProduçãoIntegrações de pedidos, estoque, preços, pagamentos ou conciliação, com logs, alertas e reprocessamento6–12 semanasEscopo fechado ou time & materials com teto
Sustentação e evoluçãoMudanças de API, novos canais e monitoramentoContínuoRetainer mensal fracionado

Prazos são faixas típicas. O diagnóstico define o escopo e a estimativa de cada projeto; o contrato pode ser em reais (BRL) ou dólares (USD).

Quer saber qual formato se aplica ao seu projeto?

Pedir conversa inicial

Conversa inicial gratuita · Resposta em até 1 dia útil

Detalhes técnicos

Como usamos IA com governança, o comparativo de decisão e a stack

IA com governança

Integração é código determinístico: a IA acelera a construção, mas não decide o destino de um pedido nem de um pagamento. Specs e testes vêm antes do código, e cada merge tem revisão humana.

  • Onde a IA entraAgentes de código (Claude Code, Codex, Cursor, Copilot, OpenCode) implementam conectores, mapeamentos e testes a partir de specs aprovadas.

  • O que o humano revisaContratos de API, regras de idempotência, tratamento de erro e cada merge passam por revisão humana sênior.

  • Quality gatesTestes de contrato e de integração em sandbox, com casos de falha simulados, antes de cada release.

  • IA na operaçãoClassificação de divergências e sugestão de correção podem entrar em uma fase posterior, sempre com aprovação humana.

  • Seus dadosCredenciais ficam em cofre de segredos, os dados do cliente nunca treinam modelos, e trabalhamos sob NDA.

Comparativo de decisão

Hub de integração pronto, conector nativo ou integração sob medida: quando usar cada um
CritérioHub de integração SaaS (Bling, Tiny, Olist)Conector nativo da plataformaIntegração sob medida
Quando faz sentidoCanais populares e regras padrão de preço e estoqueA plataforma ou o ERP já oferece o conector de que você precisaRegras próprias, sistemas sem conector ou volume que exige controle
CustosMensalidade, em geral por plano ou volume de pedidosIncluído na plataforma ou vendido como móduloDesenvolvimento inicial; depois, hospedagem e manutenção
Regras de negócioConfiguráveis dentro do que o hub prevêFixas: o fluxo é o que o fornecedor desenhouSeguem a sua operação: preço, kit, depósito e faturamento
Quando algo falhaDepende do painel e do suporte do hubDepende do suporte do fornecedorRetentativas, idempotência, logs por transação e reprocessamento sob o seu controle
Quem mantémO fornecedor do hubO fornecedor da plataformaSeu time ou parceiro, com testes e monitoramento

Stack e integrações

  • Magento 2
  • Mercado Pago
  • PagSeguro
  • Asaas
  • Melhor Envio
  • NF-e (NFePHP)
  • OFX
  • OpenAPI
  • Webhooks
  • Redis
  • RabbitMQ
  • Kafka
  • Laravel
  • Node.js
  • Salesforce
  • DocuSign

Perguntas frequentes sobre Integração com marketplaces e pagamentos

Bling/Tiny já integra com marketplace: quando preciso de integração sob medida?

Quando o hub não cobre uma regra que afeta venda ou caixa: preço por canal com margem própria, kits, vários depósitos, faturamento por filial ou um sistema que ele não conecta. Se Bling, Tiny ou Olist atendem aos seus canais e às suas regras, continue com eles: custa menos e fica pronto em dias. Também é comum manter o hub e construir sob medida só o fluxo que falta.

Quanto tempo leva uma integração com marketplace ou gateway de pagamento?

Os prazos típicos são: diagnóstico em 1 a 2 semanas, prova de conceito de um fluxo em sandbox em 2 a 4 semanas e integrações em produção em 6 a 12 semanas. O prazo depende do número de fluxos, da qualidade da documentação das APIs e do tempo de homologação exigido por cada parceiro, que não está sob o nosso controle.

O que acontece quando a API do marketplace ou do gateway falha?

A mensagem fica em fila e é reenviada automaticamente, com espera progressiva, até o parceiro voltar. Cada operação carrega uma chave de idempotência, então a retentativa não duplica pedido nem cobrança. Se o erro persiste, a mensagem vai para uma fila de falhas, gera alerta e pode ser reprocessada depois da correção. Experiência relacionada: na MPC, implementamos esse padrão para atualizações de promoção em lojas, com entrega at-least-once, confirmações, retentativas automáticas e logs de entrega.

Como funciona a conciliação de pagamentos e repasses?

A integração cruza cada pedido com o recebimento, as taxas e o repasse informados pelo gateway ou pelo marketplace e aponta só as divergências. O financeiro deixa de conferir linha a linha e passa a tratar exceções: valor diferente, taxa inesperada, repasse em atraso, estorno. No Mahout ERP, que construímos, a conciliação bancária usava arquivos OFX, ao lado das integrações com Asaas e Moip/Wirecard.

Como ficam a segurança dos dados de cartão e o PCI DSS?

Desenhamos a integração para que os dados de cartão não passem pelos seus servidores: checkout hospedado ou campos do próprio gateway, com tokenização. Em termos gerais, o checkout hospedado deixa a menor parte do escopo PCI DSS com o lojista, a API com campos hospedados fica no meio, e processar o cartão diretamente exige o maior esforço. Não somos auditores e não certificamos conformidade: a validação é feita com o seu gateway ou adquirente.

Como aceitar Pix e outros pagamentos brasileiros em uma plataforma feita nos EUA?

Integrando a plataforma a um gateway ou provedor de pagamentos que opere no Brasil, que passa a oferecer Pix, cartão parcelado e boleto por API. Cuidamos da integração: criação da cobrança, webhooks de confirmação, estornos e conciliação. Entidade local, câmbio e impostos dependem do provedor escolhido e da sua assessoria. Experiência relacionada: contribuições aceitas nos módulos oficiais PagSeguro e Mercado Pago para Magento 2 e integrações com Asaas e Moip/Wirecard no Mahout ERP.

Meu ERP é antigo ou não tem conector pronto: dá para integrar?

Sim, desde que exista um ponto de integração: API, banco de dados, arquivos ou fila. No diagnóstico avaliamos qual deles é seguro e, se preciso, criamos uma camada de API na frente do ERP. Experiência relacionada: na Regal Rexnord, desenvolvemos módulos de pedidos que integravam aplicações ao SQL Server e ao ERP Logix; na ADT Solar, integramos Salesforce e DocuSign.

Quanto custa uma integração com gateway de pagamento ou marketplace?

Depende do número de fluxos (pedidos, estoque, preços, pagamentos, conciliação), da qualidade das APIs envolvidas e do nível de tratamento de erro e monitoramento exigido. Por isso não publicamos tabela de preços. O diagnóstico de 1 a 2 semanas define escopo e estimativa, e a proposta pode ser de escopo fechado ou time & materials com teto, em BRL ou USD. Considere também os custos recorrentes: hospedagem, taxas dos parceiros e manutenção quando as APIs mudam.

Sobre a Master Timm

Master Timm

Consultoria de TI especializada em IA

Conheça a Master Timm

Engenharia sênior do diagnóstico à entrega: quem desenha a arquitetura também escreve e revisa o código.

  • Mais de 20 anos de experiência em engenharia de software
  • Projetos para empresas dos EUA e do Brasil, em contratos B2B
  • Especificação, testes e documentação no repositório do cliente
  • Escopo fechado, time & materials com teto ou retainer, em BRL ou USD

Master Timm · Atualizado em

Vamos mapear as suas integrações

Na conversa inicial, olhamos os sistemas, os fluxos e onde eles falham hoje e dizemos com franqueza se um hub pronto resolve ou se vale integrar sob medida.

Pedir conversa inicial

Conversa inicial gratuita · Resposta em até 1 dia útil