Flujos, programación y push en el hub de integración
Cómo DPP Shield obtiene una fuente según una programación, qué autenticación admite cada flujo y cómo su sistema puede enviar los registros en su lugar.
Equipo editorial de DPP Shield · Actualizado:
Un mapeo recibe datos de tres maneras: usted sube un archivo, DPP Shield obtiene un flujo por HTTPS o SFTP según una programación, o su sistema envía los registros al punto de entrada push del mapeo con un token push. Las tres usan la misma vista previa, correspondencia y versionado.
Tres vías de entrada
Subir un archivo sirve para un envío puntual. Un flujo sirve para una fuente que DPP Shield puede alcanzar y autenticar por sí mismo; se ejecuta a mano, cada hora o cada día. El push sirve para una fuente que no se puede consultar - un sistema que exige solicitudes firmadas o una sesión, o una plataforma de integración que ya genera la exportación - y deja que ese sistema decida cuándo enviar.
Opciones de conexión de un flujo
Las credenciales se guardan cifradas y no se vuelven a mostrar. Se borran si la dirección del flujo cambia de host, para que una dirección modificada no pueda enviar su secreto a otro lugar. Los flujos solo alcanzan direcciones públicas.
Opciones admitidas
- HTTPS GET, o POST con cuerpo para consultas GraphQL, OData o SuiteQL.
- Sin autenticación, token bearer, credenciales basic o clave de API en la cabecera que indique.
- OAuth 2.0 con los grants client credentials o password, autenticación del cliente por cabecera basic o en el cuerpo, y scope opcional; se pide un token en cada ejecución.
- SFTP con contraseña o clave privada, frente a una clave de host fijada: Test feed muestra la clave que presenta el servidor, para compararla con la huella que le dé su administrador.
- En un cuerpo POST, escriba {{credential}} donde va el secreto; así se guarda cifrado en lugar de ir en el cuerpo.
Límites
Una ejecución lee hasta 5000 registros y una fuente de hasta 10 MB; un mapeo admite hasta 200 reglas y una tabla de equivalencias hasta 100 entradas. Divida las fuentes mayores por familia de productos o envíelas por lotes.
Enviar registros desde su sistema
Un token push solo puede enviar a su propio mapeo; no puede leer nada. Trátelo como una contraseña y guárdelo en el almacén de secretos de su plataforma de integración.
- En el mapeo, abra Feed and push y emita un token push. Empieza por dpm_ y se muestra una sola vez; emitir otro sustituye al anterior.
- Envíe POST https://api.dppshield.com/api/v1/public/integrations/<mapping id>/push con la cabecera Authorization: Bearer <token push>.
- Ponga los registros en el cuerpo exactamente como los lee el mapeo: CSV con Content-Type text/csv, XML con application/xml o JSON con application/json. Los cuerpos CSV y XML pueden llegar a 10 MB.
- Añada ?dryRun=true a la dirección para obtener la vista previa sin escribir nada.
- Lea la respuesta: es el resumen de la ejecución - registros, actualizados, creados, sin cambios, sin correspondencia y errores - y la ejecución aparece también en el historial con el origen push.
Cuando una ejecución no hace lo esperado
Los registros sin correspondencia indican que la clave difiere entre sistemas - ceros a la izquierda, espacios u otro identificador. Los errores indican el registro y el campo. Repita la vista previa tras cualquier cambio en la fuente, y recuerde que un valor de origen vacío nunca borra un campo.