API, claves y SDK

En el portal de desarrolladores, crea una clave para la empresa y selecciona solo los permisos que necesita tu integración. Guárdala de forma segura y utiliza Test para ensayar.

No pongas el secreto en el código del navegador ni lo compartas en capturas. La API está incluida en los planes, pero las operaciones siguen sujetas a módulos, permisos y capacidad.

401 apunta a la autenticación de la petición. 403 indica que el acceso no está permitido. Comprueba clave, empresa, entorno y permisos.

422 requiere revisar los campos o la regla de negocio indicada en la respuesta. 429 indica un límite de peticiones. Respeta la espera comunicada y reduce la frecuencia, en lugar de repetir en bucle.

Consulta primero si la operación anterior terminó. Usa Idempotency-Key en las operaciones compatibles y conserva la misma clave para reintentar la misma petición con el mismo contenido.

No reutilices esa clave con datos diferentes. Un conflicto de idempotencia exige revisar la petición. Los SDK y la documentación describen el contrato de cada operación.

Comprueba que la clave pertenezca a la misma empresa y al mismo entorno que estás consultando en la aplicación. Test y Live mantienen contextos distintos.

Revisa también el identificador enviado y los permisos documentales. Dar más permisos no corrige una referencia de otra empresa ni convierte datos de prueba en datos reales.