Gestión de empresas y credenciales
Da de alta o actualiza empresas y distingue la API key del intermediario de la credencial de cada empresa.
La integración utiliza dos credenciales con ámbitos diferentes. La API key del usuario identifica al intermediario que administra las empresas, mientras que cada empresa o profesional recibe su propia API key para operar con la API de KubiBAI y realizar operaciones de índole propia como emitir facturas.
Dos credenciales, dos responsabilidades
| Credencial | Encabezado HTTP | Finalidad |
|---|---|---|
| API key del usuario | X-Qbikode-UserApiKey |
Consultar datos de configuración y crear o actualizar las empresas gestionadas por el intermediario. |
| API key de la empresa | X-Qbikode-ClientApiKey |
Identificar a la empresa o profesional en las operaciones de facturación y demás endpoints asociados a ella. |
Flujo de alta
- Consulta los territorios TicketBAI disponibles para obtener el identificador que corresponde a la empresa.
- Envía los datos mediante
POST /clientcompanies, autenticando la petición conX-Qbikode-UserApiKey. - Conserva el
idy el valorapi_keyde la respuesta. - Usa ese
api_keycomoX-Qbikode-ClientApiKeyen las operaciones que se realicen en nombre de la empresa o profesional.
La respuesta incluye los datos guardados, el objeto
ticketbai_territory_data y la API key generada para la nueva empresa.
Datos de la empresa o profesional
Los siguientes campos son obligatorios tanto al crear como al actualizar:
is_individual:truepara una persona física yfalsepara una persona jurídica.full_name: nombre completo o razón social.tax_id_number: NIF o CIF.ticketbai_territory_id: identificador de uno de los territorios disponibles.
Cuando is_individual es true, también son obligatorios first_name y
last_name_1; last_name_2 es opcional y puede enviarse como null. Para una
persona jurídica, omite los tres campos de nombre y apellidos.
Al crear una empresa, tax_id_number debe ser único entre las empresas del
mismo intermediario.
Actualización
Para modificar una empresa existente utiliza POST /clientcompanies/{clientCompany},
donde {clientCompany} es el id recibido durante el alta.
La respuesta vuelve a incluir api_key, pero la actualización no genera una
credencial nueva: la empresa conserva su X-Qbikode-ClientApiKey.
Información del Software Garante
El endpoint Información de licencia del Software
Garante permite consultar los datos
del desarrollador, el software y su versión. Esta consulta también se
autentica con X-Qbikode-UserApiKey y no sustituye la API key propia de cada
empresa.