Credenciales SES

Conjuntos con nombre de credenciales del servicio web de SES Hospedajes, uno por arrendador.

Por qué varios conjuntos

Una cuenta puede gestionar propiedades de distintos arrendadores, cada uno con su propio código de arrendador y usuario del servicio web de SES Hospedajes. Cada conjunto se crea una vez y se asigna por id a cuantas propiedades pertenezcan a ese arrendador (sesCredentialId en /properties). La propiedad que no tenga ninguno asignado usa el marcado como isDefault del tenant.

Siempre contra producción — no existe entorno de pruebas por tenant en la API pública. Verifica el código de arrendador y el usuario antes de crear el conjunto.

El objeto credencial

Objeto

{
  "id": "c4d9b7a3-…",
  "name": "Gestora Costa SL",
  "isDefault": true,
  "codigoArrendador": "A12345",
  "usuario": "gestora_costa",
  "aplicacion": "kinapi",
  "tipoPago": "PLATF",
  "hasPassword": true,
  "createdAt": "2026-07-01T09:00:00.000Z",
  "updatedAt": "2026-07-19T10:00:00.000Z"
}

La contraseña nunca se devuelve en ninguna respuesta, solo si hay una guardada (hasPassword).

Códigos válidos de tipoPago (catálogo TIPO_PAGO de SES)

Campo	Tipo	Descripción
`EFECT`	código	Efectivo.
`TARJT`	código	Tarjeta.
`PLATF`	código	Plataforma de pago (Booking, Airbnb…).
`TRANS`	código	Transferencia bancaria.
`MOVIL`	código	Pago móvil.
`DESTI`	código	Pago en destino.
`OTRO`	código	Otro.

Listar credenciales

GET/ses-credentials

curl

curl https://api.kinapi.es/api/v1/ses-credentials \
  -H "ocp-apim-subscription-key: TU_API_KEY"

Crear credenciales

POST/ses-credentials

Body

Campo	Tipo	Descripción
`name`requerido	string	Nombre del conjunto (p. ej. el arrendador al que pertenece).
`isDefault`	boolean	Marcarlo como predeterminado del tenant.
`codigoArrendador`requerido	string	Código de arrendador asignado por el Ministerio.
`usuario`requerido	string	Usuario del servicio web de SES Hospedajes.
`aplicacion`requerido	string	Identifica el software ante SES en cada llamada — normalmente el mismo para todos los arrendadores de la cuenta.
`tipoPago`requerido	string	Código del catálogo TIPO_PAGO de SES (ver tabla arriba). Cómo cobra este arrendador por defecto.
`contrasena`requerido	string	Contraseña del servicio web. No se devuelve en ninguna respuesta.

curl

curl -X POST https://api.kinapi.es/api/v1/ses-credentials \
  -H "ocp-apim-subscription-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "name": "Gestora Costa SL",
    "codigoArrendador": "A12345",
    "usuario": "gestora_costa",
    "aplicacion": "kinapi",
    "tipoPago": "PLATF",
    "contrasena": "…"
  }'

Consultar credenciales

GET/ses-credentials/{id}

Actualizar credenciales

PATCH/ses-credentials/{id}

Actualización parcial: solo se cambian los campos enviados. Omite contrasena para conservar la ya guardada.

curl

curl -X PATCH https://api.kinapi.es/api/v1/ses-credentials/c4d9b7a3-… \
  -H "ocp-apim-subscription-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "contrasena": "…nueva…" }'

Eliminar credenciales

DELETE/ses-credentials/{id}

Las propiedades que lo tenían asignado pasan a usar el predeterminado del tenant — si no queda ninguno, sus partes dejarán de poder enviarse hasta asignar otro.