API de datos de empresas para enriquecimiento y creación ERP
Conecta tus aplicaciones con el enriquecimiento de datos de empresas. Empieza con un correo corporativo, dominio o sitio web y elige entre recibir JSON o crear el registro directamente en el ERP con la misma API.
¿Qué permite hacer la API de datos de empresas?
La API de datos de empresas enriquece datos con información publicada en sitios web y comprueba un NIF-IVA disponible. Un endpoint síncrono ofrece dos modos: enrich devuelve la empresa como JSON; create también crea el registro en todas las conexiones ERP activas de la empresa. Una comprobación de IVA fallida activa un indicador y no detiene el proceso.
Dos resultados con una integración ERP
Enriquecer o crear
Usa enrich para incorporar el enriquecimiento de datos a tu aplicación. Usa create para crear clientes, clientes potenciales o proveedores si el conector los admite. Tras el enriquecimiento se requieren nombre de empresa, dominio y un NIF-IVA no vacío.
Claves y atribución de usuario
Los administradores de empresa y de sistema gestionan claves de la empresa con permiso de enriquecimiento o también de creación ERP. Cada solicitud real incluye el correo de un usuario existente para su atribución y consume la cuota habitual de la empresa.
Valores predeterminados y datos propios
Conserva los valores del payload ERP configurado y complétalos con campos compatibles o valores específicos de cada conexión. Los valores enviados permanecen en el borrador de la solicitud y no sobrescriben el catálogo compartido de empresas.
Cómo funciona
- 1
Crear una clave
Un administrador de empresa o de sistema abre Claves API en el menú de perfil y elige enriquecimiento o acceso con creación ERP.
- 2
Probar la demostración
Abre la documentación API desde el mismo menú. Las solicitudes válidas devuelven un ejemplo fijo sin consumir cuota ni consultar sitios web, servicios de IVA o sistemas ERP.
- 3
Elegir el modo
Tu aplicación de servidor envía correo, dominio o sitio web con la clave de empresa y el correo del usuario atribuido. Elige enrich o create. La creación utiliza todas las conexiones activas y requiere escrituras ERP habilitadas.
- 4
Revisar el resultado
Recibe la empresa enriquecida, el indicador de IVA y, tras una creación correcta, las referencias ERP. Conserva el mismo Idempotency-Key al reintentar una solicitud de creación.
Ejemplo: del formulario comercial al cliente potencial ERP
Una aplicación comercial interna recibe un correo de empresa. Solicita enrich para mostrar los datos como JSON. Si el flujo autorizado necesita un cliente potencial en el ERP, utiliza create con el tipo de registro y los valores de payload adecuados. Los registros ya asociados se devuelven sin cambios, en lugar de actualizarse.
El enriquecimiento web no es una verificación registral. La ausencia de datos mínimos o posibles duplicados ERP impiden la creación. Puede haber éxitos parciales entre conexiones; los fallos devuelven información segura y las escrituras completadas no se pueden deshacer aquí. Esta API no ofrece un webhook genérico ni un endpoint por lotes.
Preguntas frecuentes
¿El enriquecimiento y la creación ERP usan endpoints distintos?
¿Qué sistemas ERP pueden recibir el resultado?
¿Quién gestiona las claves y prueba solicitudes reales?
¿Una comprobación de IVA fallida bloquea la creación ERP?
¿Tiene una ficha o conexión en mente?
Configure su espacio de empresa o describa su ERP y la tarea desde Contacto.