Integrações

Pagamentos, SMS, WhatsApp, IA e outros sistemas

GálagoPay (pagamentos)

Gateway de pagamento próprio com 20+ bancos. Aceita PIX, cartão de crédito (parcelado em até 12x) e boleto.

Como configurar

  1. Em Configurações > Integrações > GálagoPay, clique em "Conectar conta"
  2. Você é redirecionado para a página de cadastro do GálagoPay
  3. Faça o cadastro de PJ (necessário CNPJ)
  4. Após aprovação (1-2 dias), os pagamentos ficam ativos

As taxas são definidas pelo GálagoPay (geralmente 1,99% PIX, 2,99% débito, 3,99% crédito à vista).

APIZap (WhatsApp automático)

Integração com WhatsApp via API Z-Pro/Evolution. Envia notificações automáticas de:

  • Novo pedido recebido (para o lojista)
  • Status do pedido (para o cliente)
  • Confirmação de pagamento
  • Avaliação pós-pedido

Como conectar

  1. Em Configurações > WhatsApp, clique em "Conectar"
  2. Escaneie o QR Code com o WhatsApp do celular do lojista
  3. Pronto — não precisa de token nem número manual

GálagoSMS (SMS)

Plataforma própria de envio de SMS via AWS Pinpoint. Usado para verificação de celular de afiliados e outros casos onde o WhatsApp não é suficiente.

Configurado no super-admin (não exposto ao lojista).

ChatMentor (IA)

Chatbot de IA para atendimento automatizado no catálogo. Disponível no plano Enterprise. Treina-se com seus produtos e responde perguntas comuns dos clientes.

Nota fiscal do pedido

Seu ERP ou emissor envia a nota emitida para o pedido que a originou, e ela fica disponível no painel para o lojista. Funciona com NF-e, NFC-e e NFS-e — o layout é identificado automaticamente, e número, série, valor, emitente e destinatário são lidos do próprio XML.

O integrador deve enviar os dois arquivos: o XML e o PDF (DANFE). O XML é o documento fiscal; o PDF é o que o lojista abre e imprime. O Katalog guarda e devolve o que você manda — não emite nota nem gera DANFE.

Detalhes de endpoint, formatos aceitos e regras em Notas fiscais do pedido.

Etiqueta de envio

O ERP ou integrador pode baixar a etiqueta de envio de um pedido, ou de vários num PDF só, já com número do pedido e código de barras, destinatário, volumes, rastreio e nota fiscal — em 10 × 15 cm (térmica) ou A4, em PDF ou ZPL (impressora Zebra). Endpoints em Etiqueta de envio do pedido.

No sentido contrário, quando o ERP compra o frete, ele envia a etiqueta oficial da transportadora (PDF ou ZPL, com código de rastreio) para o pedido, e o lojista imprime pelo painel. Mesmo modelo da nota fiscal: o Katalog guarda e devolve, não gera. Veja Etiqueta da transportadora.

API pública REST

Integre seu sistema externo (ERP, e-commerce, marketplace) com sua loja Katalog via REST. Endpoints disponíveis:

  • Listar, criar e atualizar produtos
  • Listar pedidos com filtros
  • Cadastrar e atualizar clientes
  • Movimentação de estoque (entrada, saída, ajuste)
  • Receber a nota fiscal do pedido (NF-e, NFC-e e NFS-e)
  • Gerar a etiqueta de envio do pedido (uma ou em lote, PDF ou ZPL)
  • Receber a etiqueta da transportadora com o código de rastreio
  • Listar categorias

Crie um token de API em Configurações > Tokens de API. Veja a documentação completa da API REST.

Para não ficar consultando a API, cadastre webhooks: o Katalog avisa sua URL quando um pedido é criado, muda de status, é pago ou cancelado, recebe nota fiscal ou etiqueta, e também quando a loja edita um pedido no painel (evento pedido.editado, com os itens e totais de antes e depois — ao receber, refaça o GET do pedido para atualizar quantidades, preços e total no seu sistema). Lista completa de eventos e formato do payload em Webhooks.

Exportação de dados

Você sempre pode exportar seus dados em CSV/JSON nas telas de:

  • Pedidos (filtra período e baixa)
  • Clientes
  • Produtos (com estoque)
  • Relatórios financeiros