TI · Sistemas · Integración

Integración técnica y conectores

Para equipos de TI, operaciones y sistemas. Cómo se conecta Karggo con su infraestructura.

Karggo se integra con los sistemas y canales que su operación ya utiliza. Esta página describe los conectores soportados, formatos de archivo, parámetros de API y requisitos técnicos para equipos que necesitan evaluar la integración antes de implementar.

Conectores de entrada y salida

Karggo soporta múltiples protocolos de transferencia. Todos son configurables por cliente y operación.

In

SFTP / FTP

Transferencia segura de archivos hacia carpetas configuradas en sus servidores o los nuestros.

API REST

Endpoints para envío y recepción de archivos mediante HTTP/HTTPS con autenticación.

Correo electrónico

Recepción de archivos adjuntos desde buzones configurados (IMAP/POP3).

Carpetas compartidas

Monitoreo de carpetas locales o de red (SMB/NFS) con detección automática de nuevos archivos.

WebDAV

Protocolo WebDAV para integración con sistemas que lo requieran.

Archivos ZIP

Descompresión automática de archivos comprimidos con procesamiento de su contenido.

Out

SFTP / FTP

Entrega de archivos procesados a carpetas destino en sus servidores.

API REST

Envío de archivos y metadatos mediante webhooks o llamadas a sus endpoints.

Descarga web

Interfaz web para descarga manual de archivos procesados.

Sistemas destino

Integración directa con sistemas de gestión documental, ERP o repositorios corporativos.

Formatos de archivo soportados

Karggo procesa archivos en múltiples formatos. La extensión no limita las reglas de renombramiento.

  • PDF (simple, compuesto, con formularios)
  • XML (estructuras personalizadas, CFDI, pedimentos)
  • Excel (XLSX, XLS) y CSV
  • Word (DOCX, DOC)
  • Imágenes (JPG, PNG, TIFF)
  • Archivos comprimidos (ZIP, RAR, 7Z)
  • JSON y formatos estructurados
  • Cualquier archivo binario o de texto plano

API REST y automatización

Karggo expone endpoints para integración con sistemas externos. Autenticación mediante API keys o tokens OAuth2.

Envío de archivos

POST/api/files

para subir archivos con metadatos asociados (cliente, operación, tipo documental).

Consulta de estado

GET/api/files/{id}

para consultar el estado de procesamiento de un archivo.

Descarga de resultados

GET/api/files/{id}/output

para descargar archivos procesados y renombrados.

Webhooks

event

Notificaciones automáticas cuando un archivo cambia de estado (recibido, procesado, entregado, excepción).

Catálogos

GET/api/catalogs

para consultar clientes, operaciones, tipos documentales y destinos configurados.

Plantillas

GET/api/templates

para consultar las Plantillas Karggo disponibles y sus reglas.

Autenticación y seguridad

Karggo implementa estándares de seguridad para protección de datos y acceso.

  • API keys con rotación periódica
  • Tokens OAuth2 para integración con sistemas corporativos
  • HTTPS/TLS 1.2+ para todas las comunicaciones
  • IP whitelisting para conexiones SFTP/FTP
  • Cifrado de archivos en repositorio (AES-256)
  • Logs de auditoría de acceso y operaciones

Eventos y notificaciones

Karggo puede notificar a sus sistemas cuando ocurren eventos relevantes en el procesamiento de archivos.

Archivo recibido

Archivo procesado y renombrado

Archivo entregado a destino

Excepción detectada (faltante, duplicado, inválido)

Lote completado

Error de conexión o transferencia

Requisitos técnicos

Para implementar Karggo en su operación, considere los siguientes requisitos mínimos.

  1. Conectividad de red entre sus servidores y los nuestros (o viceversa)
  2. Cuentas de usuario con permisos de lectura/escritura en carpetas de intercambio
  3. Certificados SSL/TLS válidos para conexiones seguras
  4. Documentación de sus flujos actuales (orígenes, destinos, nomenclaturas)
  5. Muestras representativas de archivos para validación de reglas
  6. Contacto técnico de su equipo de TI para coordinación de integración

Solicitar documentación técnica completa

Agendar llamada con equipo técnico