Autorizaciones de representación

Carga y actualiza la autorización necesaria para que KubiBAI actúe por vía telemática en nombre de una empresa o profesional.

Cuando KubiBAI actúa por vía telemática en nombre de una empresa o profesional, esa empresa debe cumplimentar una autorización de representación. El documento se carga de forma independiente para cada empresa representada y KubiBAI debe validarlo antes de permitir las operaciones sujetas a este control.

Formas de cargar la autorización

Puedes entregar el documento cumplimentado de tres formas:

1. Desde el panel web de KubiBAI, en la ficha de la empresa representada. En esa misma sección están disponibles las plantillas de autorización.
2. Mediante una petición multipart/form-data al endpoint POST /intermediateauth/update/multipart.
3. Mediante una petición JSON al endpoint POST /intermediateauth/update/json, incluyendo el archivo codificado en Base64.

Los dos endpoints requieren la API key de la empresa representada en el encabezado X-Qbikode-ClientApiKey. Se pueden utilizar aunque la autorización anterior no exista, esté pendiente de validación o haya sido rechazada.

Carga mediante multipart

La petición multipart/form-data contiene un único campo obligatorio, intermediate_auth_file, con el archivo de la autorización. Se admiten estos formatos:

• JPG o JPEG;
• PNG;
• PDF.

Consulta la estructura completa de la petición y sus respuestas en la Referencia API del endpoint multipart.

Carga mediante JSON

La alternativa JSON utiliza dos campos obligatorios:

• intermediate_auth_file: contenido completo del archivo codificado en Base64;
• file_format: formato original del archivo, con uno de los valores pdf, jpg o png.

El valor de file_format debe corresponderse con el tipo real del documento. Base64 solo permite transportar el archivo dentro del JSON: no cifra ni protege su contenido.

Consulta la estructura completa de la petición y sus respuestas en la Referencia API del endpoint JSON.

Validación y sustitución del documento

Cada nueva carga sustituye la autorización almacenada anteriormente y deja el nuevo documento pendiente de validación. Mientras permanezca en ese estado no podrán realizarse las operaciones con TicketBAI que requieran una autorización validada.

KubiBAI revisa el documento y notifica al intermediario cuando la autorización ha sido aprobada o rechazada. Si se rechaza, debe corregirse y cargarse de nuevo mediante cualquiera de las tres vías disponibles.