Ayuda › Catálogo de integraciones

Catálogo de integraciones: ¿con qué se conecta HNR?

Esta página reúne en un solo lugar cómo se conecta HNR con bancos, transportistas, marketplaces, la administración tributaria, archivos contables y otros programas. La etiqueta delante de cada línea indica la realidad de hoy: qué funciona por sí solo, qué se activa con su propia cuenta o con un contrato y qué todavía no existe. Si una conexión no se ha probado con una cuenta real, se dice claramente.

1. Qué significan las etiquetas

• En usoFunciona hoy. No hace falta ninguna cuenta ni contrato externo; si se necesita algo, es su propio servidor, archivo o clave.
• Listo, pruébelo con su cuentaEl código de la conexión se escribió completo según la documentación oficial de la otra parte y superó las pruebas propias de HNR, pero no se ha probado con una cuenta real. Configure la primera conexión en el entorno de pruebas de la otra parte y verifíquela.
• Requiere contratoLa otra parte solo entrega su documentación técnica bajo contrato. El espacio ya está preparado en HNR; la conexión se completa cuando llegan la documentación y las credenciales.
• PróximamenteEn la cola de desarrollo; hoy no está disponible.
• No disponibleHoy no existe y tampoco está en la cola. Una vía por archivo (CSV, XLSX, XML) suele hacer el mismo trabajo.

2. Bancos

• En usoImportación de extractos bancarios — Se leen archivos MT940, CSV/Excel y DBS; hay perfiles de columnas listos para bancos turcos e indonesios y su propio banco se asigna una sola vez. Los movimientos se emparejan con facturas mediante una puntuación y el recibo se registra con su aprobación.
• En usoServicio bancario (correo y PDF) — Los correos de aviso de movimientos que envía el banco y los extractos en PDF los lee el servicio bancario, que funciona aparte; aquí también se siguen las liquidaciones de TPV.
• Listo, pruébelo con su cuentaConexión bancaria en vivo: banca abierta — En Turquía, el estándar ÖHVPS (servicio de información de cuentas de BKM); en Indonesia, el estándar SNAP de Bank Indonesia (BCA, Mandiri, BNI, BRI y SNAP genérico). Los movimientos se obtienen sin descargar extractos; se necesitan un acuerdo de proveedor autorizado y las claves que emite el banco.
• Requiere contratoServicios web corporativos de bancos turcos — Garanti BBVA, İş Bankası, Yapı Kredi, Akbank, Ziraat, Halkbank, VakıfBank, QNB, DenizBank y Kuveyt Türk aparecen en el catálogo. La documentación del servicio llega con el contrato de integración ERP firmado con la sucursal; ese mismo día se incorpora al controlador.
• En usoArchivo de pago de nóminas — A partir de la nómina se genera, mediante una plantilla, el archivo de texto de columnas fijas que pide el banco. Los bancos no publican este formato, así que usted valida la plantilla una vez con su banco.
• PróximamenteArchivo de órdenes de pago masivo a proveedores — Una instrucción de pago masivo al banco en un solo archivo, a partir del plan de pagos.

3. Transporte y logística

• En usoEnlace de seguimiento y etiquetas — Escribe una sola vez la dirección de seguimiento del transportista con el marcador {takip}; el número de seguimiento del envío se convierte en un enlace. La etiqueta de envío, la lista de empaque, las etiquetas de bulto y el albarán se imprimen como un único juego de documentos PDF.
• Requiere contratoAPI del transportista — Hoy no se puede crear el envío en el sistema del transportista ni consultar su estado automáticamente; el estado se escribe a mano en el envío. Cuando tenga un acuerdo de API con el transportista, el espacio para el controlador ya está listo.
• PróximamenteTarifas de flete y etiqueta de palé — Reparto del coste del envío entre pedidos y clientes con una tarifa por zona × kg/peso volumétrico, y etiqueta de palé SSCC/GS1-128.

4. Marketplaces

• Listo, pruébelo con su cuentaTrendyol, Hepsiburada, Tokopedia, Shopee — Descarga de pedidos, asignación de productos, envío de stock y precios, empaquetado y envío, devoluciones y liquidaciones. Se escribió según la documentación oficial de API de las plataformas y no se ha probado con una cuenta de tienda real; configure la primera conexión en el entorno de pruebas de la plataforma.
• En usoMarketplace de simulación — Ensaya todo el flujo con sus propias fichas de stock y pedidos de ejemplo sin tocar una tienda real.
• No disponibleOtras plataformas — No hay controlador para Amazon, N11, Çiçeksepeti, Lazada, TikTok Shop y similares; hoy los pedidos de estas plataformas se introducen a mano.

5. Documentos electrónicos y archivos oficiales

• En usoXML de factura electrónica (UBL-TR 1.2) — A partir de las facturas de venta y de devolución se genera y descarga el XML en los perfiles de factura básica y comercial; puede verificarse sin cuenta de integrador.
• Requiere contratoEnvío directo de documentos electrónicos — En Turquía, la e-Fatura se envía a través de un integrador privado: los controladores de Uyumsoft e İzibiz están escritos, sus direcciones se verifican al abrir la cuenta del integrador y el sello fiscal lo pone el integrador; el envío de e-Arşiv y e-İrsaliye se añade con el mismo contrato. En Indonesia, HNR no es un PJAP; usted mismo sube el archivo a Coretax.
• En usoArchivos de Coretax y e-Bupot (Indonesia) — Se generan el XML masivo de e-Faktur, el XML de devoluciones (retur), e-Bupot Unifikasi, PPh 21 (BPMP) y 1721-A1; cada archivo se valida contra el XSD de la DJP o, si no hay XSD publicado, contra un esquema derivado de la plantilla de la DJP, y no se entrega uno que no cumpla. Usted lo sube al portal.
• En usoArchivos de declaraciones oficiales — En Turquía, la parte de la SGK de la declaración conjunta de retenciones y cotizaciones (XML); en Indonesia, extractos de BPJS (SIPP, Edabu), SPT Masa PPN, LKPM, SAK EP e IT Inventory. El calendario de obligaciones recuerda los plazos.
• En usoLectura de facturas recibidas — El XML de e-Fatura o e-Faktur, el PDF o la foto del proveedor se convierte en un borrador de factura de compra; usted lo revisa y lo aprueba.

6. Contabilidad y transferencia de datos

• En usoExportación a CSV y Excel — Cada lista da CSV; los informes de empresa, los asientos contables, el balance de comprobación y los estados financieros también se descargan en Excel (XLSX).
• En usoNo hace falta otro programa contable — Facturas, cobros, cheques y confirmaciones de producción se contabilizan solos en el diario (Plan Uniforme de Cuentas de Turquía, SAK EP de Indonesia); el balance de comprobación, el balance general y la cuenta de resultados salen de HNR.
• En usoPuente con Logo (solo lectura) — El extracto de Logo Wings aparece al lado en la ficha de la cuenta y el informe de stock HNR↔Logo compara los dos sistemas. Hace falta un servidor Logo MCP; HNR no escribe en Logo.
• En usoTraspaso desde una base de datos HNR antigua — Con Importar base de datos en el asistente de primera instalación se trasladan las fichas, documentos, producción y adjuntos de una empresa HNR (Firebird) antigua, con informe de conciliación.
• En usoImportación desde archivos — Listas de precios y asignación de productos del marketplace (CSV/XLSX), informes de medición CMM (Q-DAS ASCII) y pedidos EDI de clientes (CSV/JSON → borrador de pedido). No hay mensajes EDIFACT/VDA ni transporte OFTP2.
• PróximamenteAsistente de importación desde otros programas — Cuentas, stock, saldos pendientes y listas de precios desde Logo, Mikro, Netsis, Nebim, Accurate, Jurnal, Zahir y Excel, con los formatos oficiales de exportación de cada programa.
• No disponibleArchivo de asientos para un programa contable externo y e-Defter — No hay un archivo listo para llevar el diario a Logo, Mikro, Luca o Accurate, ni presentación del libro electrónico e-Defter ante la GİB. Los asientos pueden sacarse en XLSX.

7. Comunicación y servicios externos

• En usoWhatsApp — El servicio de mensajes vincula su propio número con un código QR (a través de WhatsApp Web; no es la API oficial de WhatsApp Business). Se envían los PDF de ofertas, pedidos y facturas y las plantillas de mensajes del CRM.
• En usoCorreo electrónico — Las ofertas, los pedidos y las facturas se envían al cliente a través de su propio servidor SMTP.
• En usoTipos de cambio — En Turquía, los tipos del Banco Central (TCMB) se leen automáticamente. En Indonesia, el tipo de Bank Indonesia (JISDOR) se introduce a mano en la tabla de cambios; no hay lectura automática.
• En usoAgente HNR (IA) — El asistente de solo lectura funciona con la API de Anthropic Claude; la clave de API y los costes de uso son suyos.

8. API abierta, portales y base de datos

• En usoAPI HTTP (REST/JSON) — Todos los endpoints que usa la interfaz (más de 2.150 según el recuento del 2 de octubre de 2026) también están abiertos a otros programas. Cada petición lleva la clave de API de la instalación (Authorization: Bearer) y el token de sesión de un usuario (/api/auth/login → X-Oturum-Token); la operación se ejecuta con los permisos y la empresa de ese usuario. Una petición de escritura puede repetirse sin riesgo con Idempotency-Key.
• No disponibleDocumentación pública de la API y notificaciones de eventos (webhooks) — No hay documento OpenAPI/Swagger ni notificación saliente cuando algo cambia. La lista de endpoints se obtiene del equipo de instalación; para seguir los cambios se consulta el contador de actualizaciones.
• En usoPortales — Portal de clientes, portal de ofertas de proveedores, portal de subcontratistas, pedidos B2B, app de ventas de campo y portal del personal; cada uno funciona con su propio acceso y su propio límite de permisos.
• En usoMotores de base de datos — Firebird, PostgreSQL, CockroachDB, Microsoft SQL Server y Oracle; en la nube, PostgreSQL (Neon) y CockroachDB Cloud. El motor se elige al crear la empresa.