curl --request POST \
--url https://api.pruff.com/api/clients/datahub/enroll \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"identifier": "11111111-1",
"password": "ClaveEjemplo123",
"name": "Cliente Ejemplo SpA"
}
'{
"message": "Enrollment ok"
}Enrolar cliente
Enrola a un cliente en tu empresa. Con CLP, Pruff también obtiene su información tributaria del SII.
Para clientes en CLP (valor por defecto) envías el RUT y la clave del SII del cliente. Pruff valida la clave contra el SII antes de enrolar (esta validación puede tardar hasta unos 12 segundos) y, si es válida, registra al cliente y comienza a obtener su información en segundo plano. La activación del cliente y sus datos pueden tardar en estar disponibles después de la respuesta: justo después de enrolar, GET /datahub/isEnrolled/{identifier} puede mostrar active: false durante unos instantes. Si el SII no responde, recibes 503 y puedes reintentar.
Si el cliente ya estaba enrolado, se actualiza con la clave nueva. Si estaba pausado, se reactiva. Al enrolar de nuevo a un cliente, envía siempre su clave vigente. Si no envías clave (solo es posible en otras monedas), Pruff conserva la clave que el cliente ya tenía guardada.
Para otras monedas la clave es opcional y no se consulta al SII. identifier se valida según currency: RUT para CLP, UF y UTM; Nit para COP; RUC para PEN. Usa una de esas monedas con el identificador que le corresponde.
La clave del SII del cliente solo se usa para validar el acceso y obtener su información; nunca se devuelve en las respuestas.
curl --request POST \
--url https://api.pruff.com/api/clients/datahub/enroll \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"identifier": "11111111-1",
"password": "ClaveEjemplo123",
"name": "Cliente Ejemplo SpA"
}
'{
"message": "Enrollment ok"
}Cuerpo
Identificador tributario del cliente, sin puntos y con guion. Se valida según currency: RUT chileno con dígito verificador para CLP, UF y UTM; Nit colombiano para COP; RUC de 11 dígitos para PEN. Usa una de esas monedas con el identificador que le corresponde.
"11111111-1"
Clave del SII del cliente. Obligatoria cuando currency es CLP: Pruff la valida contra el SII antes de enrolar. Para las demás monedas es opcional y no se valida. Al enrolar de nuevo a un cliente, envía siempre su clave vigente. Si no envías la clave al enrolar de nuevo a un cliente que ya tenía una, Pruff conserva la que tenía guardada.
"ClaveEjemplo123"
Moneda del cliente. Determina cómo se valida identifier y si password es obligatoria. Para clientes chilenos usa CLP (valor por defecto), con el que Pruff obtiene su información tributaria del SII. La moneda se registra la primera vez que Pruff conoce al cliente; si ya lo conocía, no cambia la que tiene guardada.
CLP, UF, USD, EUR, UTM, COP, ARS, PEN, BRL, MXN Razón social del cliente. Se usa solo si el cliente aún no existe en Pruff y Pruff no encuentra su razón social en fuentes externas; en ese caso reemplaza el valor por defecto Razon Social Desconocida. Si el cliente ya existe, se ignora.
1"Cliente Ejemplo SpA"