ID Mobile — Recuperar documentos de facturación con consentimiento

Support DQE
Support DQE
  • Actualización

Utilice este endpoint para recuperar una factura o un justificante de domicilio del operador, con el consentimiento del usuario. El proceso consta de dos pasos: iniciar la solicitud de consentimiento y, a continuación, recuperar el documento.

Documentación relacionada de ID Mobile:

Paso 1 — Iniciar la solicitud de consentimiento

Solicitud GET

https://{SERVER_ADDRESS}/IDMOBILE/?number={NUM}&token={TOKEN}&mode={MODE}&name={NAME}&code_name={CODE_NAME}&licence={LICENCE_CODE}&scope=billing&redirect_uri={URL_REDIRECT}

Sustituya los valores entre llaves por su propia información:

Parámetro Descripción Obligatorio/Opcional
SERVER_ADDRESS Dirección del servidor de DQE que procesará los datos. Obligatorio
licence Número que se le asigna como código de licencia. Obligatorio
number Número de teléfono. Obligatorio
token Token obtenido mediante autenticación. Obligatorio
mode 2: autenticación por código. Obligatorio
name Nombre del partner en la base de datos de DQE Software, normalmente el nombre de su empresa. Obligatorio
code_name Campo opcional que contiene un código asociado a name. Opcional
scope Valor estático. Debe ser billing para este scope. Obligatorio
redirect_uri URL de redirección. DQE añade el token de sesión y el estado a la redirección. Opcional

Solicitud POST

https://{SERVER_ADDRESS}/IDMOBILE/

Añada los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded:

Parámetro Descripción Obligatorio/Opcional
licence Número que se le asigna como código de licencia. Obligatorio
number Número de teléfono. Obligatorio
token Token obtenido mediante autenticación. Obligatorio
mode 2: autenticación por código. Obligatorio
name Nombre del partner en la base de datos de DQE, normalmente el nombre de su empresa. Obligatorio
code_name Campo opcional que contiene un código asociado a name. Opcional
scope Valor estático. Debe ser billing para este scope. Obligatorio
redirect_uri URL de redirección. DQE añade el token de sesión y el estado a la redirección. Opcional

Respuesta

Éxito

Clave Descripción Tipo
status success: la información se recuperó correctamente. STRING
scope billing STRING
billing Justificante de domicilio codificado en Base64. STRING

Ejemplo:

{
  "status": "success",
  "scope": "billing",
  "billing": "N0YXJ0eHJlZgo0OTg2MQolJUVPRgoKLS1ZS0xJNTYpPUlSeFdNUzEoYXJpOWI/UklzLkRXZ1dwUF9FLS0K"
}

Pendiente

Clave Descripción Tipo
status pending: DQE está esperando la respuesta del operador. STRING
scope billing STRING

Ejemplo:

{
  "status": "pending",
  "scope": "billing"
}

Error

Error ID Error type Descripción
01 invalid request La solicitud no es válida.
02 invalid licence key La licencia no es válida.
04 invalid scope Scope no válido.
18 failed to retrieve data from operator No se recibieron datos tras la validación del OTP.
20 OTP incorrect La validación del OTP no se completó.
21 access denied La validación del OTP fue rechazada.
30 invalid or expired token El token ha caducado.
99 internal server error Error del servidor.

Paso 2 — Recuperar el documento de facturación

Solicitud GET

https://{SERVER_ADDRESS}/GET/?token={TOKEN}&Licence={LICENCE_CODE}&scope=client_idmobile
Parámetro Descripción Obligatorio/Opcional
SERVER_ADDRESS Dirección del servidor de DQE que procesará los datos. Obligatorio
Licence Número que se le asigna como código de licencia. Obligatorio
token Token obtenido mediante autenticación. Obligatorio
scope Valor estático. Debe ser client_idmobile para este scope. Obligatorio

Solicitud POST

https://{SERVER_ADDRESS}/GET/

Añada los siguientes parámetros en el cuerpo de la solicitud usando x-www-form-urlencoded:

Parámetro Descripción Obligatorio/Opcional
Licence Número que se le asigna como código de licencia. Obligatorio
token Token obtenido mediante autenticación. Obligatorio
scope Valor estático. Debe ser client_idmobile para este scope. Obligatorio

Respuesta

Éxito

Clave Descripción Tipo
status success: el documento se recuperó correctamente. STRING
scope billing STRING
billing Justificante de domicilio codificado en Base64. STRING

Ejemplo:

{
  "status": "success",
  "scope": "billing",
  "billing": "N0YXJ0eHJlZgo0OTg2MQolJUVPRgoKLS1ZS0xJNTYpPUlSeFdNUzEoYXJpOWI/UklzLkRXZ1dwUF9FLS0K"
}

Pendiente

Clave Descripción Tipo
status pending: DQE está esperando la respuesta del operador. STRING
scope billing STRING

Error

Error ID Error type Descripción
01 invalid request La solicitud no es válida.
02 invalid licence key La licencia no es válida.
04 invalid scope Scope no válido.
18 failed to retrieve data from operator No se recibieron datos tras la validación del OTP.
20 OTP incorrect La validación del OTP no se completó.
21 access denied La validación del OTP fue rechazada.
30 invalid or expired token El token ha caducado.
99 internal server error Error del servidor.

Ejemplo:

{
  "status": "error",
  "error_type": "internal server error",
  "error_id": "99"
}

Ver también

¿Fue útil este artículo?

Usuarios a los que les pareció útil: 0 de 0