Catálogo de integrações: a que o HNR se conecta?

Esta página reúne num só lugar como o HNR se conecta a bancos, transportadoras, marketplaces, à administração fiscal, a arquivos contábeis e a outros programas. A etiqueta à frente de cada linha mostra a realidade de hoje: o que funciona sozinho, o que é ativado com a sua própria conta ou com um contrato e o que ainda não existe. Se uma conexão não foi testada com uma conta real, isso é dito claramente.

Atualidade. Este catálogo foi escrito em 2 de outubro de 2026 conferindo cada item com o próprio código do programa. Quando o estado de uma conexão muda, esta página também é atualizada.

1. O que significam as etiquetas

Em usoFunciona hoje. Não é preciso conta nem contrato externo; se algo for necessário, é o seu próprio servidor, arquivo ou chave.
Pronto, teste com a sua contaO código da conexão foi escrito por completo a partir da documentação oficial da outra parte e passou nos testes do próprio HNR, mas não foi testado com uma conta real. Faça a primeira conexão no ambiente de testes da outra parte e verifique.
Requer contratoA outra parte só fornece a documentação técnica mediante contrato. O espaço já está pronto no HNR; a conexão é concluída quando chegam a documentação e as credenciais.
Em breveNa fila de desenvolvimento; hoje não está disponível.
Não disponívelHoje não existe e também não está na fila. Uma via por arquivo (CSV, XLSX, XML) costuma fazer o mesmo trabalho.

2. Bancos

Em usoImportação de extratos bancários — São lidos arquivos MT940, CSV/Excel e DBS; há perfis de colunas prontos para bancos turcos e indonésios, e o seu próprio banco é mapeado uma única vez. Os lançamentos são casados com faturas por pontuação e o recibo é gravado com a sua aprovação.
Em usoServiço bancário (e-mail e PDF) — Os e-mails de aviso de movimentos enviados pelo banco e os extratos em PDF são lidos pelo serviço bancário, que funciona à parte; as liquidações de POS também são acompanhadas aqui.
Pronto, teste com a sua contaConexão bancária ao vivo: open banking — Na Turquia, o padrão ÖHVPS (serviço de informação de contas da BKM); na Indonésia, o padrão SNAP do Bank Indonesia (BCA, Mandiri, BNI, BRI e SNAP genérico). Os lançamentos são obtidos sem baixar extratos; são necessários um contrato de prestador autorizado e as chaves emitidas pelo banco.
Requer contratoServiços web corporativos de bancos turcos — Garanti BBVA, İş Bankası, Yapı Kredi, Akbank, Ziraat, Halkbank, VakıfBank, QNB, DenizBank e Kuveyt Türk aparecem no catálogo. A documentação do serviço vem com o contrato de integração ERP assinado com a agência; no mesmo dia é incorporada ao driver.
Em usoArquivo de pagamento de salários — A partir da folha de pagamento é gerado, por um modelo, o arquivo de texto de colunas fixas que o banco pede. Os bancos não publicam esse formato, então você valida o modelo uma vez com o seu banco.
Em breveArquivo de ordens de pagamento em lote a fornecedores — Uma instrução de pagamento em lote ao banco num único arquivo, a partir do plano de pagamentos.

Credenciais. As chaves emitidas pelo banco e pelo marketplace são guardadas criptografadas e nunca mais aparecem na tela. O HNR só envia pedidos à rede externa para uma conexão que você abriu.

3. Transporte e logística

Em usoLink de rastreio e etiquetas — Você escreve uma única vez o endereço de rastreio da transportadora com o marcador {takip}; o número de rastreio do envio vira um link clicável. A etiqueta de envio, a lista de embalagem, as etiquetas de volume e a guia de remessa saem como um único conjunto de documentos PDF.
Requer contratoAPI da transportadora — Hoje não é possível criar o envio no sistema da transportadora nem consultar o estado automaticamente; o estado é escrito à mão no envio. Quando houver um contrato de API com a transportadora, o espaço para o driver já está pronto.
Em breveTarifas de frete e etiqueta de palete — Rateio do custo do envio entre pedidos e clientes com tarifa por região × kg/peso cubado, e etiqueta de palete SSCC/GS1-128.

4. Marketplaces

Pronto, teste com a sua contaTrendyol, Hepsiburada, Tokopedia, Shopee — Download de pedidos, mapeamento de produtos, envio de estoque e preços, embalagem e envio, devoluções e repasses. Foi escrito a partir da documentação oficial de API das plataformas e não foi testado com uma conta de loja real; faça a primeira conexão no ambiente de testes da plataforma.
Em usoMarketplace de simulação — Ensaia todo o fluxo com as suas próprias fichas de estoque e pedidos de exemplo, sem tocar numa loja real.
Não disponívelOutras plataformas — Não há driver para Amazon, N11, Çiçeksepeti, Lazada, TikTok Shop e similares; hoje os pedidos dessas plataformas são lançados à mão.

5. Documentos eletrônicos e arquivos oficiais

Em usoXML de fatura eletrônica (UBL-TR 1.2) — A partir das faturas de venda e de devolução, o XML nos perfis de fatura básica e comercial é gerado e baixado; pode ser verificado sem conta de integrador.
Requer contratoEnvio direto de documentos eletrônicos — Na Turquia, a e-Fatura segue por um integrador privado: os drivers da Uyumsoft e da İzibiz estão escritos, os endereços são verificados ao abrir a conta do integrador e o selo fiscal fica com o integrador; o envio de e-Arşiv e e-İrsaliye é acrescentado com o mesmo contrato. Na Indonésia, o HNR não é um PJAP; você mesmo envia o arquivo ao Coretax.
Em usoArquivos do Coretax e e-Bupot (Indonésia) — São gerados o XML em lote do e-Faktur, o XML de devoluções (retur), e-Bupot Unifikasi, PPh 21 (BPMP) e 1721-A1; cada arquivo é validado contra o XSD da DJP ou, quando não há XSD publicado, contra um esquema derivado do modelo da DJP, e um arquivo não conforme não é entregue. Você o envia ao portal.
Em usoArquivos de declarações oficiais — Na Turquia, a parte da SGK da declaração conjunta de retenções e contribuições (XML); na Indonésia, extratos de BPJS (SIPP, Edabu), SPT Masa PPN, LKPM, SAK EP e IT Inventory. O calendário de obrigações lembra os prazos.
Em usoLeitura de faturas recebidas — O XML de e-Fatura ou e-Faktur, o PDF ou a foto do fornecedor vira um rascunho de fatura de compra; você confere e aprova.

6. Contabilidade e transferência de dados

Em usoExportação para CSV e Excel — Toda lista gera CSV; relatórios da empresa, lançamentos contábeis, balancete e demonstrações financeiras também são baixados em Excel (XLSX).
Em usoNão é preciso outro programa contábil — Faturas, recebimentos, cheques e confirmações de produção são lançados no diário automaticamente (Plano Uniforme de Contas da Turquia, SAK EP da Indonésia); balancete, balanço e demonstração de resultados saem do HNR.
Em usoPonte com o Logo (somente leitura) — O extrato do Logo Wings aparece lado a lado na ficha da conta e o relatório de estoque HNR↔Logo compara os dois sistemas. É necessário um servidor Logo MCP; o HNR não grava no Logo.
Em usoTransferência de um banco de dados HNR antigo — Com Importar banco de dados no assistente de primeira instalação, as fichas, documentos, produção e anexos de uma empresa HNR (Firebird) antiga são transferidos com relatório de conciliação.
Em usoImportação de arquivos — Listas de preços e mapeamento de produtos do marketplace (CSV/XLSX), relatórios de medição CMM (Q-DAS ASCII) e pedidos EDI de clientes (CSV/JSON → rascunho de pedido). Mensagens EDIFACT/VDA e transporte OFTP2 não estão disponíveis.
Em breveAssistente de importação de outros programas — Contas, estoque, saldos em aberto e listas de preços do Logo, Mikro, Netsis, Nebim, Accurate, Jurnal, Zahir e Excel, usando os formatos oficiais de exportação de cada programa.
Não disponívelArquivo de lançamentos para programa contábil externo e e-Defter — Não há arquivo pronto para levar o diário ao Logo, Mikro, Luca ou Accurate, nem envio do livro eletrônico e-Defter à GİB. Os lançamentos podem ser extraídos em XLSX.

7. Comunicação e serviços externos

Em usoWhatsApp — O serviço de mensagens vincula o seu próprio número por código QR (via WhatsApp Web; não é a API oficial do WhatsApp Business). São enviados PDFs de cotações, pedidos e faturas e os modelos de mensagem do CRM.
Em usoE-mail — Cotações, pedidos e faturas são enviados ao cliente pelo seu próprio servidor SMTP.
Em usoTaxas de câmbio — Na Turquia, as taxas do Banco Central (TCMB) são lidas automaticamente. Na Indonésia, a taxa do Bank Indonesia (JISDOR) é lançada à mão na tabela de câmbio; não há leitura automática.
Em usoAgente HNR (IA) — O assistente somente leitura funciona com a API Anthropic Claude; a chave de API e os custos de uso são seus.

8. API aberta, portais e banco de dados

Em usoAPI HTTP (REST/JSON) — Todos os endpoints usados pela interface (mais de 2.150 pela contagem de 2 de outubro de 2026) também estão abertos a outros programas. Cada pedido leva a chave de API da instalação (Authorization: Bearer) e o token de sessão de um usuário (/api/auth/login → X-Oturum-Token); a operação roda com as permissões e a empresa desse usuário. Um pedido de gravação pode ser repetido com segurança usando Idempotency-Key.
Não disponívelDocumentação pública da API e notificações de eventos (webhooks) — Não há documento OpenAPI/Swagger nem notificação de saída quando algo muda. A lista de endpoints é obtida com a equipe de instalação; para acompanhar mudanças, consulta-se o contador de atualizações.
Em usoPortais — Portal do cliente, portal de cotações de fornecedores, portal de terceirizados, pedidos B2B, app de vendas externas e portal do colaborador; cada um funciona com seu próprio login e seu próprio limite de permissões.
Em usoMotores de banco de dados — Firebird, PostgreSQL, CockroachDB, Microsoft SQL Server e Oracle; na nuvem, PostgreSQL (Neon) e CockroachDB Cloud. O motor é escolhido ao criar a empresa.

Precisa de uma conexão que não está na lista? Tente primeiro a via por arquivo: o HNR recebe e entrega a maior parte dos dados em CSV, XLSX ou XML. Se não bastar, envie à equipe de instalação o nome da plataforma e a documentação técnica que tiver; um formato sem documentação nunca é inventado.