A integração via API permite que os softwares que você utiliza enviem e recebam dados entre si. Se o seu site, a sua loja virtual, a infraestrutura de pagamentos, a transportadora, as contas nos marketplaces, o integrador de e-Fatura e o sistema contábil guardam a mesma informação separadamente, sua equipe está digitando os mesmos dados à mão em várias telas todos os dias. Nós conectamos esses sistemas por meio de suas APIs e fazemos os dados chegarem ao lugar certo, na hora certa e de forma rastreável.
Exemplos típicos deste serviço: gerar o envio na transportadora e mandar o código de rastreio ao cliente assim que o pagamento do pedido é aprovado, emitir a nota como e-Fatura ou e-Arşiv, atualizar os produtos na Trendyol e na Hepsiburada quando o estoque muda e registrar no CRM cada novo cadastro feito por formulário. Desenvolvemos sob medida as conexões que precisam seguir as regras do seu negócio, nos casos em que um plugin pronto não resolve.
Nesta página você encontra, por categoria e com o nome das empresas, os sistemas com os quais podemos integrar: integração de API de frete, integração de POS virtual, integração com marketplaces, integração de e-Fatura, conexões com sistemas contábeis e ERP, SMS, WhatsApp, mapas, inteligência artificial e muito mais. Em cada bloco explicamos também para que a integração serve na prática.
Para quem a integração via API é indicada?
- Empresas de e-commerce: lojas que querem gerenciar produtos, estoque, preços e pedidos em um só lugar, entre o próprio site e marketplaces como Trendyol, Hepsiburada, N11 e Amazon.
- Empresas que preparam envios todos os dias: negócios que querem parar de copiar à mão código de barras, etiqueta e código de rastreio da tela da transportadora.
- Equipes financeiras e contábeis: empresas que preferem a transferência automática a lançar as vendas uma a uma no Logo, Mikro, Paraşüt ou no integrador de e-Fatura.
- Empresas de serviços e assinaturas: quem quer unir em um único fluxo o pagamento online, a cobrança recorrente, a fatura automática e as notificações ao cliente.
- Quem quer abrir o próprio software: empresas que desejam oferecer uma API segura e documentada ao seu aplicativo móvel, aos revendedores ou aos parceiros de negócio.
- Organizações que usam vários sistemas: equipes que têm versões diferentes do mesmo dado no CRM, no ERP, no site e nas ferramentas internas.
O que o nosso serviço de APIs e integrações inclui?
Conexão com serviços prontos
Analisamos a documentação de API dos serviços de pagamento, frete, marketplace, contabilidade e comunicação, levantamos as condições de acesso e os limites de uso e adicionamos a conexão ao seu site, ao painel administrativo ou ao aplicativo móvel. Se o seu software foi desenvolvido por outra empresa, primeiro examinamos a estrutura do código e o acesso ao servidor.
Design de REST API e documentação
Se você quer abrir o seu próprio sistema, projetamos os endpoints, as estruturas de dados, os códigos de erro e as regras de paginação e autorização. Preparamos uma documentação com exemplos de requisição e resposta para cada endpoint; assim, sua equipe mobile ou seus parceiros fazem a conexão sem precisar adivinhar nada.
Webhooks e fluxos baseados em eventos
Fazemos com que um evento em um sistema acione outro imediatamente: o pedido é confirmado quando o pagamento é aprovado, o cliente recebe uma notificação quando o status do envio muda. Validamos a assinatura dos webhooks recebidos e, mesmo que a mesma notificação chegue duas vezes, a operação é executada uma única vez.
Mapeamento de dados e sincronização bidirecional
Definimos em uma tabela de mapeamento escrita qual campo corresponde a qual, qual sistema é a fonte principal e o que prevalece em caso de conflito. Diferenças de categoria, variação, alíquota de imposto e unidade são resolvidas nesta etapa, antes de escrever qualquer código.
Tarefas agendadas e transferência em lote
Para sistemas que não oferecem notificação em tempo real, configuramos tarefas que rodam em intervalos definidos. XMLs de fornecedores, listas de preços em lote, taxas de câmbio e arquivos de estoque são importados ou exportados regularmente por essas tarefas.
Telas no painel e monitoramento
Para que você acompanhe o status da integração no seu painel administrativo, podemos adicionar registros de operações, listas de erros e telas de reenvio manual. Quando um pedido não é transferido, a própria equipe vê o motivo e como reenviar o registro.
Integrações de pagamento e POS virtual
Integração de gateway de pagamento
Adicionamos o pagamento com cartão ao seu site ou aplicativo: autenticação 3D Secure, opções de parcelamento, reembolso total e parcial e, quando o provedor oferece, cartão salvo e pagamento recorrente. Não deixamos o resultado do pagamento depender apenas do redirecionamento do navegador; nós o confirmamos pela notificação que o provedor envia de servidor para servidor. Os dados do cartão não ficam no seu servidor; são coletados pelo formulário de pagamento seguro do provedor.
Integração de POS virtual bancário
Se você tem contrato de POS virtual diretamente com o seu banco, conectamos o pagamento à infraestrutura do banco sem intermediários. O escopo inclui o fluxo 3D Secure, a tabela de parcelamento por programa de cartão, a pré-autorização com captura posterior, o cancelamento e o reembolso. Se você trabalha com vários bancos, é possível direcionar cada transação ao POS certo conforme o tipo de cartão.
Integrações de API de frete e logística
Integração de API com transportadoras nacionais
Quando o pedido é aprovado, o envio é registrado automaticamente na transportadora; o código de barras e a etiqueta são impressos pelo seu painel, e o código de rastreio é incluído no pedido e no e-mail ou SMS enviado ao cliente. Os status de envio são atualizados por webhook ou por consultas periódicas. Cálculo de peso cubado e de frete, geração de código de devolução e informações de pagamento na entrega também são configurados na medida em que a API da empresa oferece. As integrações com Yurtiçi Kargo, Aras Kargo e MNG Kargo são os exemplos mais solicitados.
Integração com transportadoras internacionais
Se você envia para o exterior, conectamos ao seu sistema as etapas de cotação de frete, criação do envio, preparação da etiqueta e dos documentos aduaneiros, solicitação de coleta e rastreamento internacional. Na integração com a API da DHL Express, peso, dimensões e as informações de produto exigidas pela alfândega são obtidos automaticamente do pedido; a mesma abordagem vale para UPS, FedEx, Aramex e Royal Mail.
Integrações com marketplaces, e-Fatura e contabilidade
Integração com marketplaces
Você gerencia seus produtos em um só lugar e nós os enviamos aos marketplaces: mapeamento de categorias e atributos, atualização de estoque e preço, importação dos pedidos para o seu painel, envio dos dados de frete de volta ao marketplace e processos de cancelamento e devolução. A integração com a API da Trendyol, a integração com a Hepsiburada e a conexão com a Amazon SP-API são os exemplos mais solicitados. Também é possível definir regras de preço ou estoque específicas para cada marketplace.
Integração com plataformas de e-commerce
Se a sua loja está na Shopify, no WooCommerce ou em outra plataforma, conectamos os pedidos ao seu sistema contábil e o estoque ao seu sistema de depósito ou ERP. Usamos as mesmas conexões para migrar dados de produtos, clientes e pedidos quando você muda de uma plataforma para outra.
Integração de e-Fatura, e-Arşiv e e-İrsaliye
Quando a venda é concluída, o sistema consulta se o comprador é contribuinte do e-Fatura; conforme o resultado, a nota é emitida como e-Fatura ou e-Arşiv pelo seu integrador privado, o PDF é enviado ao cliente e o número da nota é registrado no pedido. O e-İrsaliye nas remessas, a importação das notas recebidas e os processos de cancelamento também são configurados de acordo com a API do integrador.
Integração com sistemas contábeis e ERP
Cadastros de clientes e fornecedores, fichas de estoque, pedidos, faturas e recebimentos são transferidos automaticamente para o seu sistema contábil ou ERP; se necessário, estoque e preços voltam no sentido inverso para o site. Como os registros são vinculados por chaves de correspondência, a mesma fatura nunca é gerada duas vezes. Para empresas no Reino Unido, também é possível configurar conexões com Xero, QuickBooks, QuickFile e Sage.
Comunicação, mapas, identidade e outras APIs
CRM e ferramentas de trabalho
Formulários do site, pedidos de orçamento e novos cadastros de clientes entram no seu CRM como contatos e oportunidades; quando a etapa de venda muda, sua equipe recebe uma notificação pelo Slack ou pelo Teams. Solicitações de suporte podem virar cards no Jira ou no Trello.
SMS, WhatsApp e mensagens
Confirmação de pedido, código de rastreio, lembrete de agendamento e códigos de verificação de uso único são enviados por SMS ou WhatsApp. Pelo WhatsApp Business Platform (Cloud API), configuramos mensagens com modelos aprovados; nas mensagens comerciais, o consentimento do destinatário é respeitado.
Envio de e-mails
Conectamos os e-mails transacionais, como pedido, fatura e redefinição de senha, a um serviço de envio e ajustamos os registros SPF, DKIM e DMARC para reduzir o risco de cair na caixa de spam. As listas de newsletter podem ser sincronizadas com o Mailchimp ou o Brevo.
Mapas e serviços de localização
Recursos como localizador de lojas e revendedores, preenchimento automático de endereço, conversão de endereço em coordenadas, taxa de entrega por distância e verificação de área de entrega são configurados com serviços de mapas.
Autenticação e login
Seus clientes podem entrar com a conta Google, Apple, Microsoft ou Facebook, sem criar senha; em aplicações corporativas, o login centralizado é configurado com OAuth 2.0 e OpenID Connect. Quando necessário, também adicionamos a validação do número de identidade turco (T.C. kimlik).
Ferramentas Google e mecanismos de busca
Conectamos os eventos do Google Analytics 4 e do Tag Manager para o rastreamento de conversões, o feed do Merchant Center para as listagens de produtos, o Calendar para os agendamentos e o Sheets para os relatórios. Páginas novas e atualizadas podem ser comunicadas ao Bing e ao Yandex pelo IndexNow.
Integração de inteligência artificial
Conectamos grandes modelos de linguagem ao seu sistema para tarefas como rascunhos de descrição de produtos, classificação de solicitações de suporte, resumo de documentos e busca semântica no seu próprio conteúdo. O modelo recebe apenas os dados necessários, e os resultados podem passar por aprovação humana antes da publicação.
Vídeo, reuniões e reservas
Vídeos de treinamento são publicados pelo YouTube, Vimeo ou Bunny Stream; para agendamentos online, o link do Zoom ou do Google Meet é criado automaticamente. Em meios de hospedagem, quartos, tarifas e reservas são sincronizados com o channel manager.
Notificações móveis e serviços para aplicativos
Conectamos ao seu aplicativo móvel serviços de notificação push, verificação de compras e assinaturas no app, relatórios de falhas e monitoramento de erros. As compras são verificadas pela validação do lado do servidor da própria loja de aplicativos.
Outras fontes de dados e protocolos
Também fazem parte deste escopo a atualização diária de preços com as taxas de câmbio do Banco Central da Turquia (TCMB), a importação de produtos em lote por XMLs de fornecedores e arquivos Excel ou CSV, a troca de arquivos via FTP ou SFTP, os serviços SOAP de sistemas corporativos legados e as APIs GraphQL.
Sobre as empresas listadas: são sistemas com os quais podemos integrar por meio de suas APIs; isso não significa parceria, revenda ou homologação oficial. Para a integração, você precisa ter sua própria conta e acesso à API na empresa correspondente. Sistemas que não estão na lista, mas têm API, também podem ser conectados.
REST, SOAP, webhook ou transferência de arquivos: qual método usar e quando?
| Método | Como funciona | Quando é indicado | Pontos de atenção |
|---|---|---|---|
| REST API | Requisição e resposta via HTTPS, geralmente em formato JSON | A maioria dos serviços de pagamento, marketplace, frete e CRM | Limites de uso, renovação de tokens, mudanças de versão |
| SOAP | Chamadas de serviço baseadas em XML, definidas por WSDL | Alguns serviços bancários, de frete, de e-Fatura e públicos, sistemas corporativos legados | Validação de esquema, certificados, controle de timeout |
| Webhook | O outro sistema envia uma notificação ao seu endereço quando ocorre um evento | Eventos em tempo real, como aprovação de pagamento, status de envio e alteração de pedido | Validação de assinatura, notificações repetidas, consulta de eventos perdidos |
| Transferência de arquivos (XML / CSV / FTP) | Os arquivos são gerados, enviados ou baixados em intervalos definidos | Listas de produtos de fornecedores, preços e estoque em lote, sistemas sem API | Verificação de formato, codificação de caracteres, arquivos incompletos |
Na maioria dos projetos, esses métodos são usados em conjunto: o pedido é enviado via REST, a mudança de status chega por webhook e o arquivo de estoque em lote é importado uma vez por dia. A escolha depende dos recursos que o outro sistema oferece e de quão atualizados os dados precisam estar.
Nossa abordagem técnica nas integrações
- Validação no servidor: todo dado vindo de um sistema externo é verificado quanto a formato, tipo e campos obrigatórios; registros com erro não entram no sistema.
- Resistência a requisições repetidas: mesmo que o mesmo pedido ou notificação chegue mais de uma vez, a operação é executada uma única vez.
- Fila e novas tentativas: quando o outro sistema fica temporariamente sem responder, as requisições são repetidas de forma controlada, e erros permanentes são notificados.
- Registros de operações: é possível rastrear qual dado foi enviado, quando e para qual sistema; a origem de um problema é encontrada com facilidade.
- Ambiente de testes primeiro: as conexões de pagamento, frete e e-Fatura são testadas antes nos ambientes de teste dos provedores e só depois vão para produção.
- Proteção das chaves secretas: as chaves de API ficam em arquivos de configuração inacessíveis pela web, e não no código; as permissões seguem o princípio do menor privilégio.
- Cuidado com dados pessoais: os dados transferidos se limitam ao que a operação exige, as conexões usam canais criptografados e os princípios da KVKK e do GDPR são respeitados.
- Respeito aos limites de uso: as operações em lote são divididas conforme os limites de requisição dos provedores, e consultas desnecessárias são reduzidas com cache.
Como funciona um projeto de integração via API?
- Descoberta: levantamos juntos os sistemas que você usa, as tarefas feitas manualmente e quais dados precisam ir para onde.
- Análise técnica: examinamos a documentação de API, as condições de acesso, os ambientes de teste e os limites de uso dos serviços a serem conectados.
- Escopo e orçamento: apresentamos uma proposta por escrito com tabela de mapeamento de dados, diagrama de fluxo, prazo e preço.
- Desenvolvimento e testes: montamos a integração no ambiente de testes e a validamos com cenários realistas e situações de erro.
- Entrada em produção: publicamos com as credenciais reais e acompanhamos as primeiras operações junto com você.
- Monitoramento e suporte: acompanhamos as mudanças de versão do lado do provedor e planejamos as atualizações necessárias.
Como é definido o preço de uma integração?
- Número de sistemas: a quantidade de serviços a conectar e a estrutura da API de cada um.
- Direção do fluxo de dados: se basta uma transferência em um sentido ou se é necessária sincronização bidirecional.
- Necessidade de atualização: se os dados serão transferidos em tempo real ou em intervalos definidos.
- Complexidade do mapeamento: quanto de conversão exigem as diferenças de categoria, variação, imposto e unidade.
- Recursos do provedor: a qualidade da documentação de API e a existência de ambiente de testes e suporte a webhooks.
- Painel e relatórios: se as telas de monitoramento, lista de erros e reenvio manual fazem parte do escopo.
Prazo e preço são definidos na proposta por escrito, após a descoberta e a análise técnica.
Por que a ADK Yazılım?
- Métodos que usamos na nossa própria infraestrutura: no nosso sistema de pedidos, pagamento com cartão, notificações de aprovação de pagamento, faturamento automático, e-mails e SMS funcionam integrados.
- Escopo, prazo e preço claros: quais dados serão transferidos, em qual sentido, e o que fica fora do escopo estão descritos na proposta.
- Código testado e seguro: cada integração é testada também com cenários de erro, e as informações sigilosas são protegidas.
- Sistemas locais e internacionais: além de POS virtual, e-Fatura e transportadoras turcas, conectamos serviços internacionais como Stripe, Xero e Royal Mail.
- Suporte após a publicação: fazemos as atualizações quando os provedores mudam; você envia suas solicitações de suporte pelo painel do cliente.

